iterate-lessons-log

Original：🇺🇸 English

Translated

Creates a structured lessons learned entry for organizational memory. Use after projects, incidents, or significant learnings to capture knowledge for future teams and initiatives.

5installs

Sourceproduct-on-purpose/pm-skills

Added on2026-04-29

NPX Install

npx skill4agent add product-on-purpose/pm-skills iterate-lessons-log

SKILL.md Content

View Translation Comparison →

Lessons Log

A lessons log entry captures significant learning from projects, incidents, or experiences in a format that's useful to future teams who weren't there. Unlike retrospectives (which focus on team improvement), lessons logs focus on organizational knowledge that transcends individual teams.patterns, anti-patterns, and hard-won wisdom.

When to Use

After completing a significant project or initiative
Following a major incident, outage, or failure
When you realize something important that others should know
After discovering a pattern that keeps recurring
When experienced team members leave (capture their knowledge)
During post-mortems to preserve learnings

Instructions

When asked to create a lessons log entry, follow these steps:

Choose a Descriptive Title Write a title that someone searching for this topic would find. Include keywords that describe the situation and the learning. Avoid generic titles like "Project X lessons."
Provide Context Explain the situation fully enough that someone who wasn't there can understand it. Include the project, timeline, team, and any relevant constraints. Future readers need this context to assess applicability.
Describe What Happened Write a factual account of what occurred. Be specific about actions taken, decisions made, and outcomes observed. Avoid blame.focus on events and systems.
Extract the Lesson Articulate what you learned clearly. The lesson should be actionable.something others can apply. Distinguish between what you observed and your interpretation of why it matters.
Formulate Recommendations Provide specific guidance for future teams facing similar situations. What should they do? What should they avoid? What questions should they ask?
Define Applicability Help readers know when this lesson applies. What situations trigger relevance? What context makes it more or less applicable?
Add Tags for Searchability Include keywords and categories that will help future searchers find this entry. Think about what someone would search for when facing a similar situation.

Output Format

Use the template in

references/TEMPLATE.md

to structure the output.

Quality Checklist

Before finalizing, verify:

Title is descriptive and searchable
Context is complete enough for someone who wasn't there
Lesson is clearly articulated and actionable
Recommendations are specific, not vague
Entry stands alone (doesn't require external context)
Tags enable future discovery

Examples

See

references/EXAMPLE.md

for a completed example.