A battle-tested memory architecture for solo operators who use Claude Code as their pair — so it actually remembers what you taught it, and stops blowing things up the same way twice.
CLAUDE.md is 600 lines and somehow still misses the one rule that matters.The problem isn't Claude. It's that nobody told you how to structure what it should remember.
A 4-type taxonomy, a why-line discipline, a verification step before acting, and a set of templates you can drop into ~/.claude/ today.
The format is small. The discipline is everything. Every entry answers why and how to apply — without those, future Claude over-applies the rule to edge cases.
---
name: Integration tests must hit a real DB
description: why mocking the database failed us in 2024-Q3
type: feedback
---
Never mock the database in integration tests.
**Why:** Q3 2024 incident. Mocked tests passed; the production
migration dropped a column the worker still read. Two-hour outage.
**How to apply:** any test marked @integration. Spin up the test
container, run the migration, assert state. Mocks are for unit only.
That's the format. That's the discipline. Multiply by 40.
No drip campaign. No upsells. You get one email the day the kit goes live, with the early-bird link.