lesson-learned

Extract actionable software engineering lessons from git commits and diffs.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/program-the-brain-not-the-heartbeat/dotfiles --skill lesson-learned-program-the-brain-not-the-heartbeat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: lesson-learned
Source: https://github.com/program-the-brain-not-the-heartbeat/dotfiles/tree/main/config/claude/skills/lesson-learned
Command: npx skills add https://github.com/program-the-brain-not-the-heartbeat/dotfiles --skill lesson-learned-program-the-brain-not-the-heartbeat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Extract actionable software engineering lessons from your recent code changes, turning reflections into concrete improvements.

Core Features & Use Cases

  • Git-history-driven analysis across a feature branch, main, or a user-specified commit range.
  • Principles-based insights mapped to the SE principles catalog, with references to actual files and changes.
  • Actionable takeaways presented in a structured format suitable for post-change reviews and team learning.
  • Use Case: After a feature or bug fix, generate a concise lesson that you can apply to the next task.

Quick Start

Run the lesson-learned skill in a git repository to generate actionable engineering takeaways.

Frequently Asked Questions about lesson-learned

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

FAQPage Schema
How do I extract lessons learned from git commit history?▼

To extract lessons from git history, analyze recent commits and diffs to identify actionable software engineering principles. This process maps code observations to named patterns, delivering concise takeaways.

Can I analyze a specific feature branch for code review lessons?▼

Yes, you can analyze a specific feature branch, main, or user-specified commit range. The analysis reviews diffs across languages to generate concise engineering lessons with explicit file references.

What is the best way to map code diffs to software engineering principles?▼

Mapping code diffs to software engineering principles involves analyzing changes from debugging or refactoring sessions and identifying matching patterns. It yields structured takeaways suitable for team learning.

Do I need a specific language setup to analyze git diffs for actionable takeaways?▼

No specific language setup is required, as the analysis applies across languages. You only need a git repository with recent commits, diffs, and messages to generate actionable takeaways.

Does this work for debugging sessions and refactoring code changes?▼

Yes, this works for debugging sessions, refactoring, and feature work. By analyzing the git diff and commit messages from these changes, it identifies named software engineering principles and delivers concise lessons.