Skip to content
Council

Export an Architecture Decision Record (ADR)

ADRs (Architecture Decision Records) are short documents that capture technical decisions, the options considered, and why one was chosen. Council can export any debate directly in ADR format.

Export as ADR

Section titled “Export as ADR”
Terminal window
council export strategy-review --format adr --output docs/adr/0007-european-expansion.md

ADR structure

Section titled “ADR structure”

The ADR includes:

  • Title and date
  • Status (proposed/accepted/superseded)
  • Context (the question debated)
  • Decision (the recommendation)
  • Consequences (tradeoffs and risks)

Other export formats

Section titled “Other export formats”
Terminal window
# Markdown transcript (default)
council export strategy-review --format markdown --output debate.md


# JSON (machine-readable)
council export strategy-review --format json --output debate.ndjson

When to use

Section titled “When to use”

This bridges the gap between discussion and engineering documentation — you can debate in Council and commit the result alongside your code.

Section titled “Related”