Knowledge capture: writing things down before the person leaves
Knowledge capture fails as a documentation project and works as a habit attached to real work. Where to start, what to skip, and why the expert is the wrong person to write it.
Lessons learned sessions produce documents nobody opens. The fix is to write fewer lessons, aimed at a specific decision someone will make again.
A lessons learned review looks back at a project or a period and asks what should be done differently next time. Almost every organisation runs them and almost none benefits, because the output is a document filed in a folder that the next project team does not know exists — and would not read if they did.
The failure is not the meeting. It is that a lesson written as a general observation cannot be applied, and that nobody has decided who would apply it or when. "Communication could have been better" is not a lesson; "the client's legal review took three weeks and we had planned for three days — add it to the schedule template" is.
The test of a lesson is whether it can be attached to something. A lesson that changes the estimating template, the kick-off checklist, the standard contract or the onboarding form will be applied automatically the next time someone uses that artefact. A lesson that lives only in a document relies on someone remembering to read it, which is the mechanism that has already failed.
The instinct is a central repository of lessons learned, searchable by project. In practice these become archives — comprehensive, well-intentioned, and unopened. The alternative is to push each lesson into the place where the relevant decision is made: the estimating spreadsheet, the kick-off checklist, the statement of work template, the onboarding form. The repository still has value as a record, but the mechanism that actually changes behaviour is embedding, not filing. If you only have energy for one, embed.
In Ettex, the session notes fit Ettex Notes — one note per review, with checklists inside the note so each lesson's action becomes an item with visible progress, tags to keep a project series together, backlinks so a lesson can point at the document it changes, reminders for the follow-up check, and version history showing what was added after the meeting. The artefacts the lessons modify live in Ettex Docs with version history, so a change is traceable to the review that caused it; the actions can be tracked as cards in Ettex Board; and a register of lessons across projects, if you want one, fits Ettex Records as a typed table.
The boundary: Ettex has no knowledge-management or retrospective feature. There is no lessons repository, no tagging engine that surfaces relevant past lessons when a new project starts, no prompts and no analytics across projects. Notes, checklists and links are what you get — and the discipline of embedding a lesson into a template is a habit rather than a feature.
Collecting them is only useful if somebody checks the outcome later. A post implementation review does that three to six months after go-live: benefits measured against what was promised at approval, and each finding converted into one owned change.
Capturing what happened is only half of it. A decision log records what was chosen, by whom, and — the part always left out — which options were rejected and why, which is what settles the argument when somebody proposes one of them again two years later.
A structured look back at a project or milestone to identify what should change next time, with each lesson turned into a specific action against a specific artefact.
Within a week of the milestone or project ending. Later reviews recall outcomes but not causes, which is where the useful detail lives.
Three to five with real consequences. Long lists are a reliable predictor that nothing will be implemented.
Embed each one in the artefact where the decision recurs — the estimating template, the kick-off checklist, the contract — rather than filing it in a repository.
Yes. What worked and should be repeated is just as actionable, and covering both directions makes the session safer and more honest.
As a record, yes; as the mechanism for change, no. Repositories go unread — embedding is what alters behaviour.
A lessons learned review is worth an hour if it produces four lessons, each attached to a template someone will use again, with an owner and a date — and a check a month later that the change was actually made.
Knowledge capture fails as a documentation project and works as a habit attached to real work. Where to start, what to skip, and why the expert is the wrong person to write it.
A decision log records what was decided, by whom, and what was rejected. The format that takes two minutes, and why the rejected options are the part worth keeping.
An annual general meeting has rules about notice, quorum and voting that decide whether its resolutions are valid. What to get right, and what small companies can skip.