What problem does it solve?
Captures and organizes learnings, corrections, errors, and feature requests so teams and agents can continuously improve and avoid repeating the same mistakes. It provides a lightweight, consistent format for logging incidents and promoting broadly applicable insights into project memory.
Core Features & Use Cases
- Structured logging: Append standardized entries to .learnings/LEARNINGS.md, ERRORS.md, and FEATURE_REQUESTS.md to preserve context and suggested fixes.
- Promotion workflow: Guidelines for promoting recurring or high-value learnings into CLAUDE.md, AGENTS.md, SOUL.md, or other project-level files.
- Integration hooks: Optional hook scripts and workspace injection points to trigger reminders and automatic error detection in agent workflows.
- Use case: When a command fails, a user corrects the agent, or an API behaves unexpectedly, log an entry with context, metadata, and suggested action so fixes and best practices become discoverable.
Quick Start
Use the self-improvement skill to immediately log a correction or error to .learnings/LEARNINGS.md or .learnings/ERRORS.md after a failure or user correction.