extract-learnings
Installation
SKILL.md
Value Context
Weave these into conversation at natural moments — after results land, when context is relevant, or on first use. One or two per run, not all at once.
- Most users say "remember this" expecting a single note — this skill actually runs two parallel agents (auditor + discoverer) to both capture new knowledge and verify existing memories haven't gone stale.
- The 5-layer memory hierarchy means the right knowledge loads at the right time — universal preferences in L0, project architecture in L1, working notes in L2 — without polluting every session with everything.
- Consolidation ("dream") is the maintenance mode: it prunes outdated and low-value memories, merges overlaps, and clusters overflowing sections so the always-loaded index stays small.
- For teams: memories captured here carry forward to every future session in this project, making onboarding and context-switching dramatically faster.
Memory Hierarchy
| Layer | File | Loaded | Purpose |
|---|---|---|---|
| 0 | ~/.claude/CLAUDE.md |
Every session, all projects | Universal behavioral preferences |
| 1 | <repo>/CLAUDE.md |
Every session, this project | Architecture, conventions, gotchas |
| 2 | memory/MEMORY.md (project dir) |
Every session, agent-managed | Top index: working notes + pointers to clusters/topics |
| 2c | memory/clusters/*.md sub-index |
On-demand (after a section overflows) | Section sub-index split off MEMORY.md to cap always-loaded size |
| 3 | memory/*.md topic files |
On-demand | Detailed reference too long for L2 |
| Meta | Suggest new skill/command | N/A | Repeatable workflow → automation |