How does the skill identify potential lessons?

The skill automatically scans project results and build summaries for issues encountered and decisions made, presenting them as editable suggestions.

Does it support parallel development agents?

Yes, by storing lessons in a standardized file, it creates a shared memory that helps parallel agents avoid repeating known anti-patterns.

What qualifies as a high-quality lesson?

A high-quality lesson is specific, actionable, and reusable. It avoids generic truisms and ephemeral details like line numbers or temporary file paths.

Where are the lessons stored?

Lessons are primarily saved in a structured .shipyard/LESSONS.md file and can be optionally appended to CLAUDE.md for immediate AI context.

Lessons Learned & Retrospectives

Name: Lessons Learned & Retrospectives
Author: lgbarn

bylgbarn

•

Productivity & Workflow

Captures and institutionalizes project insights to improve code quality and workflow efficiency across development phases.

The Lessons Learned skill automates the process of technical knowledge capture by extracting discoveries, patterns, and pitfalls during the project lifecycle. It parses build summaries to suggest lessons, formats them into a structured LESSONS.md file, and optionally updates CLAUDE.md to ensure future AI agents benefit from past experiences. By enforcing high quality standards for entries, it prevents generic platitudes and focuses on actionable, transferable technical knowledge that prevents the repetition of past mistakes.

Key Features

0138 GitHub stars

02Chronological storage in a dedicated LESSONS.md file

03Quality enforcement to ensure entries are specific and actionable

04Automated lesson extraction from build artifacts and phase summaries

05Seamless integration with CLAUDE.md for agent-accessible context

06Structured retrospective prompts focusing on successes, discoveries, and pitfalls

Use Cases

01Standardizing project retrospectives within a structured development lifecycle

02Documenting complex tool workarounds to prevent regressions in future development phases

03Formalizing non-obvious architectural decisions for team or future-self reference

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lgbarn/shipyard lessons-learned

For use in Claude.ai and ChatGPT

Download Skill