Capturing Lessons Learned

Turn a closed work order into knowledge the next technician will actually find

5 min read
Print this section

A lesson learned is what your team knows after fixing something — written once, so nobody has to work it out again. FreeMaint builds each one from a work order you have already closed, then surfaces it automatically the next time someone opens a similar job.

Why it is not just the work order notes

It is generalised

A work order records one machine on one day. A lesson says what it applies to — "any centrifugal pump with a mechanical seal over 5 years old".

It is reviewed

Only a published lesson is searchable. A supervisor validates it first, so a wrong conclusion does not spread across the plant.

It carries prevention

The one thing a repair log never has: how to stop it happening again.

Capturing one from a work order

  1. Close the work order and fill in its Root cause and Completion notes. Everything else builds on those two fields.
  2. Open the work order and click "Create lesson from this work order" — or click the "Capture this as a lesson learned?" notification FreeMee sends you after a complex job.
  3. The form arrives already filled in: the description becomes the Symptom, the root cause and completion notes carry over, and the asset, category and failure codes come with them.
  4. Write the Prevention field. It is deliberately left blank — it is the part only you can write, and it is what makes this a lesson rather than a repair record.
  5. Save. The lesson is a draft: it is not searchable yet and FreeMee will not quote it.
  6. A supervisor or manager opens it and clicks Publish. From that moment it is findable by everyone.

Using AI

Improve with AI

Optional. It reads the work order and drafts the four blocks for you to review. It costs 2 AI credits, and nothing is charged if it fails — the free prefill always stays available.

Always review the draft

AI drafts are marked as such and always land as a draft. Check them against what actually happened before publishing.

Ask FreeMee

Ask "what did we learn about this pump?" or "lecciones aprendidas sobre bombas" in the chat and FreeMee answers from your published lessons first, then from past work orders.

How lessons find you

On the work order

Open any work order and matching lessons appear at the top — before you start the job, not after.

While creating a work order

As you type the title, FreeMaint shows lessons from similar work. Sometimes it means the job is not needed at all.

By failure code

If you tag work orders with failure codes, a lesson tagged with the same code is matched exactly. This is the strongest and fastest match.

By meaning, not just words

Search finds a lesson even when you describe the problem in different words from the person who wrote it.

Photos and documents

A picture is half of a one-point lesson. Open a lesson and add photos or documents (PDF, Word, Excel) under «Photos & documents» — up to 10 per lesson. The author can add them to their own lesson, supervisors and managers to any lesson. Everyone who can read the lesson sees them, on the web and in the mobile app.

Distributing a lesson and collecting « read and understood »

When everyone on a shift must know a lesson — rotations, holidays, new starters — send it to them rather than hoping they find it. Distributing is reserved to the people who can publish lessons.

  1. Publish the lesson, then click «Distribute».
  2. Pick people one by one, teams, or both. A team is expanded to its members at that moment: someone who joins it later is sent the lesson by distributing again. People without access to lessons are not added.
  3. Each person receives a notification — in the app, on their phone and by email — that opens the lesson.
  4. They read it and tap «I have read and understood». The date is recorded once and never changes.
  5. On the lesson, the «Read and understood» card shows who has confirmed and who is still pending. «Remind pending» sends the notification again to those pending (at most once every 12 hours per person), and a person picked by mistake can be withdrawn while still pending.

Start with the work orders you already closed with a real root cause — those become good lessons in about a minute each. Ten well-written lessons are worth more than a hundred thin ones.

Who can do what

Technicians

Read every published lesson and write new ones. They cannot publish or edit someone else's — they write a new one that replaces it.

Supervisors and managers

Everything above, plus reviewing and publishing.

Everyone else

Requesters, viewers and operators can read published lessons. The knowledge base only pays off if the people doing the work can read it.

Was this page helpful?