Architectural decision records

Store one actual decision per docs/adr/<domain>/<decision-slug>.md, without a global sequence number. Use meaningful names and the Michael Nygard sections: Status, Context, Decision and Consequences. Link each decision from its owning feature specification.

See the authoring guide for the distinction between specifications, roadmaps and isolated decisions.