Write a new Architecture Decision Record following CONSTITUTION §7, wire it into the `docs/decisions/README.md` index, and update the status lines of any ADR it supersedes. Use when a change meets an ADR trigger in AGENTS.md ("When to write an ADR"), when a human says "write an ADR for X", or when called by `implement-spec` / `draft-spec` at the point a decision is made. Edits files — it creates the ADR and the index row in the same change as the code it documents.
90
97%
Does it follow best practices?
Impact
100%
1.06xAverage score across 2 eval scenarios
Passed
No known issues
Write an ADR for a new charting library choice
ADR warranted — library choice
100%
100%
Correct next number (058)
100%
100%
Self-describing kebab-case filename
100%
100%
Exactly the three required sections
100%
100%
Status is Accepted
100%
100%
Decision stated as fact
87%
100%
README index row added
41%
100%
Commit message format
80%
100%
Alternatives handled cleanly
80%
100%
Consequences names trade-offs
100%
100%
No implementation detail
87%
100%
Correctly decline to write an ADR for a no-decision bug fix
Correctly declines
100%
100%
Cites no trigger met
100%
100%
Notes noise-ADR harm
100%
100%
Stops cleanly
100%
100%