Claude Code pluginv0.1.0MIT
adr-consensus
Drive an Architecture Decision Record to an implementation-readiness verdict — READY, NEEDS_DECISION or NOT_READY — through repeated rounds of independent review, scoped revision and whole-document consistency sweeps.
01
The review quorum
Any of opus, fable, sonnet and haiku can fill any seat. Saved per project; a per-run flag overrides it.
| Seat | Duty | Default |
|---|---|---|
| Reviewer 1 | Readiness, checked against the codebase and supporting documents | opus |
| Reviewer 2 | Readiness, with attention on framing, assumptions and unexamined alternatives | fable |
| Architect | Answers every objection: applies the smallest scoped edit, or rebuts it with reasons | sonnet |
| Sweeper | Keeps the whole document self-consistent and every revision in scope | haiku |
| Arbiter | Writes the verdict document; the verdict itself is computed, not chosen | your session's model |
All seats are Anthropic models. Different model tiers and two reviewer lenses reduce anchoring, but they are not a review by a different model family.
02
Skills
| Skill | What it does |
|---|---|
/adr-consensus:adr_consensus | Runs the review loop on one ADR and writes a plain-language verdict document next to it |
/adr-consensus:adr_format | Writes a new ADR, or reshapes an existing document, into the three-section format the review requires |
/adr-consensus:quorum_select | Asks which model fills each review seat and saves the choice for this project |
03
Before you run it
Requirements
- Claude Code with workflows available
python3on PATH- The ADR lives in a git repository, with exactly three sections: Problem Space, Solution, Plan
What a run changes
- Commits the ADR on its own first, as a recovery point
- Rewrites the ADR in place, once per round, and writes a verdict file beside it
- Never pushes, branches, merges or resets
Rounds default to 7 and are a ceiling, not a quota: the run stops as soon as the panel reaches consensus or stalls.
04
Install
claude plugin marketplace add rational-agents-ai/rational_agents_plugins --scope projectclaude plugin install adr-consensus@rational-agents --scope projectRun from the repository you want the plugins in. Recorded in its .claude/settings.json, so everyone who works there gets the same setup.