learn-from-mistakes

Log retrospective entries to .claude/learnings.md after human sign-off.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/rolopez23/agent-harness --skill learn-from-mistakes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: learn-from-mistakes
Source: https://github.com/rolopez23/agent-harness/tree/main/skills/learn-from-mistakes
Command: npx skills add https://github.com/rolopez23/agent-harness --skill learn-from-mistakes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Runs after human sign-off on a chunk. Logs human corrections, missed cases, and implementation holes for pattern tracking. Does not fix anything — the goal is to accumulate insight over time. When the same class of mistake occurs 3 or more times, surfaces a concrete suggestion to update AGENTS.md or an existing skill. Trigger after a human marks a chunk complete, when the user says "log what went wrong", "retrospective", "what did we miss", or "learn from this".

Core Features & Use Cases

  • Logs events after sign-off to capture corrections, missed cases, and implementation gaps for pattern tracking.
  • Aggregates patterns to surface concrete suggestions for updating AGENTS.md or improving skills.
  • Writes learning entries to .claude/learnings.md to enable trend analysis and future improvements.

Quick Start

Log retrospective entries after sign-off to capture corrections and patterns for future improvement.

Frequently Asked Questions about learn-from-mistakes

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

FAQPage Schema
How do I log retrospective entries to track recurring development mistakes?

Record retrospective logs after human sign-off to capture corrections, missed cases, and implementation gaps for pattern tracking. Entries are written to .claude/learnings.md with the date, feature, description, and a pattern tag for trend analysis.

What is the best way to track implementation gaps after a code review sign-off?

Track implementation gaps by logging human corrections and missed cases after sign-off. This accumulates insight over time, and when the same mistake occurs three or more times, it surfaces a concrete suggestion to update AGENTS.md or improve existing skills.

How does pattern aggregation work for improving software quality over time?

Pattern aggregation works by logging retrospective entries with short pattern tags into .claude/learnings.md. When recurring patterns appear three or more times, the system surfaces concrete suggestions to update AGENTS.md or improve skills for future work.

When should I trigger a retrospective log in my software engineering workflow?

Trigger a retrospective log after a human marks a chunk complete, or when the user says "log what went wrong", "retrospective", "what did we miss", or "learn from this". It runs post sign-off to capture corrections without fixing anything directly.

Does logging retrospective entries automatically fix implementation holes in my code?

No, logging retrospective entries does not fix anything. The goal is to accumulate insight over time for pattern tracking. It captures corrections and implementation gaps, surfacing suggestions to update AGENTS.md or improve skills when patterns recur.

Can I use retrospective logs to update AGENTS.md and improve existing skills?

Yes, retrospective logs aggregate patterns over time. When the same class of mistake occurs three or more times, the system surfaces a concrete suggestion to update AGENTS.md or improve an existing skill based on the captured corrections and missed cases.