# Architecture Decision Records One file per decision, numbered, never deleted. A superseded ADR gets its status changed and a pointer to what replaced it — the reasoning that was rejected is the expensive half to rediscover. ## Format ``` # N. Title in plain language - **Status:** Proposed | Accepted | Superseded by ADR-XXXX - **Date:** YYYY-MM-DD - **Deciders:** ## Context what is true today, with evidence ## Considered Options numbered, each with why it was rejected ## Decision what we are doing ## Consequences what follows, including what gets harder ## References code, data, prior art ``` State evidence, not assertion. "Zero of 124 modules declare `brain` as a dependency" outranks "the dependency rule is not followed". ## Index | ADR | Title | Status | |-----|-------|--------| | [0001](0001-mesh-brokers-nodes-host-agents-think.md) | The mesh brokers capabilities; nodes host; agents think | Accepted |