lessons-learned

Run structured post-mortems to identify root causes and encode preventive measures.

127|22|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/flonat/claude-code-flonat --skill lessons-learned-flonat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lessons-learned
Source: https://github.com/flonat/claude-code-flonat/tree/main/skills/lessons-learned
Command: npx skills add https://github.com/flonat/claude-code-flonat --skill lessons-learned-flonat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured process for analyzing incidents, mistakes, or unproductive sessions to identify root causes and implement systematic improvements, preventing recurrence.

Core Features & Use Cases

  • Structured Retrospective: Guides users through incident definition, timeline reconstruction, root cause analysis (5 Whys), and contributing factor identification.
  • Actionable Fixes: Classifies and implements fixes directly into skills, guards, rules, or documentation.
  • Use Case: After a critical bug caused a service outage, use this Skill to conduct a post-mortem, identify the faulty code and process gaps, and create a new guardrail to prevent similar issues in the future.

Quick Start

Use the lessons-learned skill to start a retrospective for the recent deployment failure.

Frequently Asked Questions about lessons-learned

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I conduct a structured post-mortem after a critical incident?

To conduct a structured post-mortem, define the incident, reconstruct the timeline, perform root cause analysis using the 5 Whys method, and identify contributing factors to systematically encode preventive measures.

What is the best way to identify root causes of workflow inefficiencies?

The best way to identify root causes of workflow inefficiencies is through a structured retrospective that analyzes operational failures, applies the 5 Whys technique, and classifies actionable fixes into documentation or guards.

Can I use the 5 Whys technique for incident analysis to prevent future outages?

Yes, you can use the 5 Whys technique for incident analysis to identify root causes and implement preventive measures directly into skills, guards, rules, or documentation to prevent future outages.

How do I turn lessons learned from a deployment failure into systematic improvements?

To turn lessons learned into systematic improvements, facilitate a retrospective for the deployment failure, identify process gaps, and create new guardrails or documentation to prevent similar issues.

When do I need a retrospective process for stuck development sessions?

You need a retrospective process for stuck development sessions to analyze unproductive periods, identify contributing factors through root cause analysis, and implement systematic fixes into your workflow.

Does root cause analysis require any specific dependencies or environment setup?

No, root cause analysis through this structured retrospective process requires no external dependencies, allowing you to directly start analyzing incidents and encoding preventive measures without environment setup.