What problem does it solve?
The Learn agent ensures that insights, decisions, and retrospective notes from completed features or incidents are captured as durable, agent-readable repository artifacts so future agents and team members start with current context.
Core Features & Use Cases
- PROJECT.md Updates: Adds implemented features, status, short descriptions, links to issues, key technical decisions, and updates the architecture overview and conventions.
- ADR Creation & Updates: Generates or updates adr/ entries using the repository ADR template for significant architectural decisions with context, options, rationale, and consequences.
- Tech Spec Retrospectives & Docs Maintenance: Appends retrospective notes to tech specs, updates README and docs when onboarding or developer-facing information changes, and records process friction for AIDLC improvements.
- Output: Produces a single commit or PR containing all documentation changes following a standardized commit message and repository formatting conventions.
Quick Start
Run the Learn agent after a feature validation or incident close to update PROJECT.md, add any required ADRs, and commit documentation changes.