Self-Improving Agent

Auto-memory captures. This plugin curates.

Claude Code's auto-memory (v2.1.32+) automatically records project patterns, debugging insights, and your preferences in MEMORY.md. This plugin adds the intelligence layer: it analyzes what Claude has learned, promotes proven patterns into project rules, and extracts recurring solutions into reusable skills.

Quick Reference

Command	What it does
INLINECODE1	Analyze MEMORY.md — find promotion candidates, stale entries, consolidation opportunities
INLINECODE2

Graduate a pattern from MEMORY.md → CLAUDE.md or .claude/rules/ | | /si:extract | Turn a proven pattern into a standalone skill | | /si:status | Memory health dashboard — line counts, topic files, recommendations | | /si:remember | Explicitly save important knowledge to auto-memory |

How It Fits Together

CODEBLOCK0

Installation

Claude Code (Plugin)

CODEBLOCK1

OpenClaw

CODEBLOCK2

Codex CLI

CODEBLOCK3

Memory Architecture

Where things live

File	Who writes	Scope	Loaded
INLINECODE7	You (+ /si:promote)	Project rules	Full file, every session
INLINECODE9

You | Global preferences | Full file, every session | | ~/.claude/projects/<path>/memory/MEMORY.md | Claude (auto) | Project learnings | First 200 lines | | ~/.claude/projects/<path>/memory/*.md | Claude (overflow) | Topic-specific notes | On demand | | .claude/rules/*.md | You (+ /si:promote) | Scoped rules | When matching files open |

The promotion lifecycle

CODEBLOCK4

Core Concepts

Auto-memory is capture, not curation

Auto-memory is excellent at recording what Claude learns. But it has no judgment about:

• - Which learnings are temporary vs. permanent
• Which patterns should become enforced rules
• When the 200-line limit is wasting space on stale entries
• Which solutions are good enough to become reusable skills

That's what this plugin does.

Promotion = graduation

When you promote a learning, it moves from Claude's scratchpad (MEMORY.md) to your project's rule system (CLAUDE.md or .claude/rules/). The difference matters:

• - MEMORY.md: "I noticed this project uses pnpm" (background context)
• CLAUDE.md: "Use pnpm, not npm" (enforced instruction)

Promoted rules have higher priority and load in full (not truncated at 200 lines).

Rules directory for scoped knowledge

Not everything belongs in CLAUDE.md. Use .claude/rules/ for patterns that only apply to specific file types:

CODEBLOCK5

This loads only when Claude works with API test files — zero overhead otherwise.

Agents

memory-analyst

Analyzes MEMORY.md and topic files to identify:

• - Entries that recur across sessions (promotion candidates)
• Stale entries referencing deleted files or old patterns
• Related entries that should be consolidated
• Gaps between what MEMORY.md knows and what CLAUDE.md enforces

skill-extractor

Takes a proven pattern and generates a complete skill:

• - SKILL.md with proper frontmatter
• Reference documentation
• Examples and edge cases
• Ready for /plugin install or INLINECODE17

Hooks

error-capture (PostToolUse → Bash)

Monitors command output for errors. When detected, appends a structured entry to auto-memory with:

• - The command that failed
• Error output (truncated)
• Timestamp and context
• Suggested category

Token overhead: Zero on success. ~30 tokens only when an error is detected.

Platform Support

Platform	Memory System	Plugin Works?
Claude Code	Auto-memory (MEMORY.md)	✅ Full support
OpenClaw

workspace/MEMORY.md | ✅ Adapted (reads workspace memory) | | Codex CLI | AGENTS.md | ✅ Adapted (reads AGENTS.md patterns) | | GitHub Copilot | .github/copilot-instructions.md | ⚠️ Manual promotion only |

Related

• - Claude Code Memory Docs
• pskoett/self-improving-agent — inspiration
• playwright-pro — sister plugin in this repo