What problem does it solve?
Valuable lessons learned during AI-assisted coding sessions are usually lost when the session ends, forcing teams to rediscover the same pitfalls repeatedly. This Skill captures evidence-backed findings and routes each one to its single canonical owner so knowledge survives across sessions.
Core Features & Use Cases
- Canonical routing: Directs each finding to the right destination—mechanical guards (tests, linters), attention.md for high-frequency facts, ADRs for structural decisions, existing project docs, or dated lesson files under .codestable/lessons/.
- Lesson lifecycle management: Tracks lessons through observed, validated, and retired statuses with strict promotion rules requiring independent verification, preventing self-certified or stale knowledge.
- Write discipline and deduplication: Enforces a roughly 50-lesson budget, merges duplicates, treats legacy compound/ knowledge as read-only, and requires explicit user authorization before writing.
- Use Case: After debugging a tricky test-flakiness issue, tell the agent to remember the root cause; it verifies the evidence, checks for duplicates, and writes a scoped lesson file that future sessions can grep and apply.
Quick Start
Ask the agent to remember the lesson or pitfall you just discovered in this session, and it will verify the evidence and store it in the appropriate project memory location.