# summary

Render decision records as Markdown ADRs.

# description

Reads decision records from `.setup-agents/state/decisions.jsonl` and writes human-reviewable Markdown ADRs to `docs/adr/`.

The JSONL log stays the canonical source; `docs/adr/` is a derived render. Each record is written to `docs/adr/ADR-<id>.md` so the record id is recoverable from the filename. This command never mutates `decisions.jsonl`.

# flags.id.summary

Decision record id to render.

# flags.id.description

Render only the decision record with this id.

# flags.all.summary

Render every decision record.

# flags.all.description

Render all decision records found in the decision log.

# examples

- Render every decision record as an ADR:

  <%= config.bin %> <%= command.id %> --all

- Render a single decision record:

  <%= config.bin %> <%= command.id %> --id setup-agents-decision-1700000000000-abc123

# error.noSelector

Specify --id <decisionId> to render one record or --all to render every decision record.

# error.notFound

No decision record found with id: %s

# info.empty

No decision records found.

# info.wrote

Wrote %s ADR file(s) to %s:

# info.wroteEntry

%s