CtrlK
BlogDocsLog inGet started
Tessl Logo

matthew-a-carr/write-adr

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

1.06x
Quality

97%

Does it follow best practices?

Impact

100%

1.06x

Average score across 2 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Evaluation results

100%

12%

Write an ADR for a New Charting Library

Write an ADR for a new charting library choice

Criteria
Without context
With context

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%

100%

Decide Whether a Bug Fix Needs an ADR

Correctly decline to write an ADR for a no-decision bug fix

Criteria
Without context
With context

Correctly declines

100%

100%

Cites no trigger met

100%

100%

Notes noise-ADR harm

100%

100%

Stops cleanly

100%

100%

Evaluated
Agent
Claude Code
Model
Claude Sonnet 4.6

Table of Contents