This skill provides guidance for scoring ADRs on a 0-10 quality scale to determine readiness for release.
Scoring Scale:
- 0-3 — Poor quality: Missing major elements, vague, or contradictory
- 4-5 — Below average: Has basic structure but significant gaps or unclear sections
- 6-7 — Acceptable: Complete structure with minor issues or room for improvement
- 8-9 — Good quality: Well-defined ADR with clear context, decision, and consequences
- 10 — Excellent: Comprehensive, unambiguous, and exemplary ADR
Validation Checklist:
An ADR is ready for release if ALL of the following are true:
- Has a clear title — short noun phrase describing the decision (not empty or placeholder text)
- Has meaningful context — explains the forces at play (technical, political, social, project constraints)
- Has a clear decision — states the decision with active voice ("We will...")
- Has consequences — lists both positive and negative consequences
- No blocking issues — no obvious contradictions, impossibilities, or missing critical information