Prompt file imported from h3nok/DOT (
.github/prompts/new-adr.prompt.md). Fill in{{decision}}before use. Copyright stays with the author.
Write an ADR in docs/blueprint/adr/ for: {{decision}}
Steps:
- Read
docs/blueprint/adr/0000-template.mdand the two most recent ADRs for voice. - List existing ADRs and take the next unused number. Never renumber existing ones.
- Check whether this decision supersedes or amends an existing ADR. If so, say which, and state the relationship in both files.
- Write the ADR:
- Context — the forces and the pressure that makes this decision necessary. Include what will go wrong if it is left undecided.
- Decision — imperative, specific, and testable. Enumerate what is prohibited and what is permitted.
- Consequences — positives, real negatives (what this costs us), and the trigger that would make us revisit.
- Alternatives considered — a table with Pros / Cons / Verdict.
- State how the decision is enforced: a test, a lint rule, a schema constraint, or a CI check. If it cannot be enforced mechanically, say so explicitly.
- Name the manifesto laws (L1–L12) it serves.
- Set Status to
Proposedand the date to today. - Register it in the decision log table in
docs/blueprint/README.md.
Do not implement the decision in the same change.