← ClaudeAtlas

adr-writelisted

Use when a technical choice gets made that someone will argue about again - "we went with Postgres over Mongo", "we're dropping the queue", "let's use Fastify". Drafts the decision record from what you say plus what the code and discovery notes already show, then asks only what neither can answer. This writes a record for a decision just taken; "why did we do it this way?" about a past one is answered from the records that already exist, not by writing a new one.
repository-standards/core · ★ 4 · API & Backend · score 77
Install: claude install-skill repository-standards/core
# adr-write A technical decision was made. This writes the record **with** the user rather than handing them a template - they say what they remember, the agent drafts, they correct. ## Is it an ADR at all? Three questions, in this order: 1. **Would someone reasonably have chosen otherwise?** If not, it is a convention, and it belongs in `AGENTS.md` where the next person will look. One obviously-right answer does not need a record; it needs a line in the rules. 2. **Is it expensive to reverse?** A process tweak - who bumps a version, what a commit message says - is a one-line revert even when contestable: it belongs in `CONTRIBUTING.md`, or `SPEC.md` if normative, not in a full ADR. Reserve the Context/Options/Consequences shape for decisions costly enough that reconstructing *why* matters later - architecture, data model, external contracts, a dependency. 3. **Who would overrule it - an architect or a product owner?** An architect means ADR. A product owner means **BDR** and `bdr-write` is the skill. The test itself is R5, and the standard works it through in [decision records (by reference)](https://github.com/repository-standards/core/blob/main/docs/tree/docs-decision-records.md). If both would overrule it, write the BDR and let the ADR reference it. Say which way you routed and why, in one line. A user who disagrees will say so, and that is cheaper than discovering it in review. ## As short as the decision actually is Length is a cost, no