The .architecture system

An agent that wakes up cold each session has no memory of the project except what's in the repo. If the repo is just code, the agent re-derives intent from scratch every time — and gets it wrong, because intent isn't always recoverable from a diff. The .architecture/ directory is the workaround.

The premise is one sentence: architecture is the source of truth, code reflects it. A bug isn't fixed by writing the patch — it's fixed by updating its yaml record with a fix_approach, then writing code that implements that approach.