self-improving-agentlisted

# Self-Improving Agent Curate session memory, promote recurring patterns to permanent config, and extract reusable skills. ## Memory Stack Three tiers, from most permanent to most ephemeral: 1. **CLAUDE.md** (you write) -- Project-wide rules, preferences, conventions. Survives across all sessions. 2. **MEMORY.md** (Claude writes) -- Observations, patterns, corrections accumulated during sessions. Review candidates. 3. **Session Memory** -- In-context learnings that exist only for the current session. Lost on exit unless promoted. ## Commands | Command | Action | |---------|--------| | `/si:review` | Scan MEMORY.md for promotion candidates. Show each with recurrence count and recommendation. | | `/si:promote` | Promote a specific pattern from MEMORY.md to CLAUDE.md or `.claude/rules/`. Remove from MEMORY.md after promotion. | | `/si:extract` | Generate a complete skill from a recurring pattern (creates `skills/<name>/SKILL.md`). | | `/si:status` | Show memory stats: entries in MEMORY.md, staleness, promotion candidates, session observations. | | `/si:remember` | Capture a specific observation to MEMORY.md with timestamp and context. | ## Promotion Lifecycle See [promotion-lifecycle.md](./promotion-lifecycle.md) for detailed rules. Summary: discover -> recurs 2-3x -> review flags -> promote to CLAUDE.md or rules -> remove from MEMORY.md. ## MEMORY.md Format ```markdown ## Patterns - [2026-04-01] Always use `--no-ff` for feature merges (seen 3x) - [2026-04-03] Tests