ADR Reconciler
Audit the current decision records before proposing new text.
Read
dev-docs/agents/adr-governance.mddev-docs/agents/adr-workflow.mddev-docs/specs/adr-index.md- Target ADRs under
dev-docs/adr/ - Related files under
dev-docs/specs/,tests/, andsrc/
Workflow
- Select the target ADRs from changed domains, explicit ADR IDs, or related index entries.
- Read each ADR claim and the linked specs, tests, and implementation paths.
- Build an evidence matrix for every finding:
adrspecssrctests
- Classify findings as one of:
policy-driftmissing-adr-updatemissing-evidencestale-reference
- Recommend the next action:
update-adrnew-adrupdate-specsadd-testsno-action
Output Contract
Return a concise audit result with:
scopeadrsspecssrctests
findings
Each finding should include:
typeseverityclaimaffected ADRsevidence matrixadrspecssrctests
recommended action
Do not silently rewrite ADR text. If the finding implies a new or changed policy, route back through adr-suggester and adr-drafter.