lesson-learned

Overview

A Claude Code skill from the softaworks/agent-toolkit that analyzes recent code changes via git history and extracts concrete software engineering lessons. Rather than lecturing, it acts as a mirror -- showing developers what their code already demonstrates by mapping changes to specific principles from a curated software engineering principles catalog.

Key Features

• Git-Based Analysis - Automatically determines scope (feature branch, last N commits, specific commit, or working changes) and gathers relevant diffs and commit messages
• Principle Mapping - Maps identified patterns to specific software engineering principles from a bundled reference catalog, with an optional anti-patterns reference
• Structured Output - Presents lessons in a consistent template: what happened in the code, the principle at work, specific code references, and next-step suggestions
• Multiple Scope Modes - Supports feature branch vs main analysis, specific commit examination, and working changes before commit
• Evidence-Based - Quotes actual code, references real file names and line changes rather than providing generic advice

Who is this for?

This skill is designed for developers who want to extract actionable software engineering insights from their own code changes, turning daily development work into learning opportunities. It is particularly valuable for individual developers practicing continuous improvement or team leads who want to facilitate code-based learning discussions during retrospectives.