Decisions
Architecture decisions are recorded, numbered and dated. A rule with no recorded reason is a rule the next person deletes.
| ADR | Decision |
|---|---|
| 0001 | Consent is the eighth admission gate, and sits between authorization and policy. |
| 0002 | The stack was adjudicated by an adversarial panel, not chosen. |
| 0003 | Domains, and which address may send what. |
| 0004 | set_config stays reachable on the hosted database; the transaction fingerprint is the control. |
What a decision record contains
The context, the forcing fact, the decision, and what would change it. That last section matters most: a decision recorded without its expiry conditions becomes folklore.
Where a decision was contested, the dissent is recorded rather than buried. ADR-0002 was a two-to-one split, and the minority position is written down with the reasoning that would flip it.