adr-generate

ADR Generator

Generate a complete Architecture Decision Record from a previously gathered context file. This skill runs with clean context and is non-interactive — all questions were answered during the gather phase.

Input

$ARGUMENTS — path to the context file (e.g., docs/context/decisions/migrate-to-graphql-context.md).

Source Integrity Rules

Every factual claim in this document must be traceable to the context file.

1. Ground every claim. Every factual statement must trace back to a specific entry in the context file (user answers, codebase findings with file:line, or web research with URLs).
2. Flag ungrounded claims. If you need to state something not in the context file, mark it explicitly as [ASSUMPTION] in the document.
3. Never invent details. If the context file doesn't cover something, put it in Open Questions or More Information — don't fabricate.

MADR 4.0.0 Template

The output file MUST match this structure precisely, including HTML comments and frontmatter. Optional sections should be INCLUDED by default unless the context file explicitly says to skip them.

---
status: "{proposed | rejected | accepted | deprecated | ... | superseded by ADR-NNNN}"
date: {YYYY-MM-DD when the decision was last updated}
decision-makers: {list everyone involved in the decision}
consulted: {list everyone whose opinions are sought; two-way communication}
informed: {list everyone kept up-to-date; one-way communication}
---

# {short title, representative of solved problem and found solution}

## Context and Problem Statement

{Describe the context and problem statement in 2-3 sentences.}

<!-- This is an optional element. Feel free to remove. -->
## Decision Drivers

* {decision driver 1}
* {decision driver 2}

## Considered Options

* {title of option 1}
* {title of option 2}
* {title of option 3}

## Decision Outcome

Chosen option: "{title of option}", because {justification}.

<!-- This is an optional element. Feel free to remove. -->
### Consequences

#### Good

* Good, because {positive consequence}

#### Bad

* Bad, because {negative consequence}

<!-- This is an optional element. Feel free to remove. -->
### Confirmation

{How implementation correctness will be verified.}

<!-- This is an optional element. Feel free to remove. -->
## Pros and Cons of the Options

### {title of option 1}

{description}

#### Good

* {argument}

#### Neutral

* {argument}

#### Bad

* {argument}

### {title of option 2}
...

<!-- This is an optional element. Feel free to remove. -->
## More Information

{Additional context, links, team agreements, revisit timeline.}