← ClaudeAtlas

adr-gatelisted

Pre-review/pre-commit gate that enforces ADR and spec linkage for non-trivial changes — a change that makes an architectural decision must leave a decision record
lciacci/tessera · ★ 0 · Code & Development · score 66
Install: claude install-skill lciacci/tessera
# ADR Gate — Pre-Review / Pre-Commit Decision-Record Enforcement **Every non-trivial change must trace to a decision.** This gate runs *before* a code review (native `/code-review` or otherwise) and before committing architectural work. It links changes to an ADR (Architecture Decision Record) or spec, and — when a change makes a decision that no ADR captures — it drafts one so the decision is not lost in a diff. This is the reactive counterpart to `framework-evaluation` / `/evaluate-framework`: that skill produces ADRs *proactively* when evaluating an external tool; this gate catches decisions made *implicitly*, in code, that were never written down. It is the same discipline as `doccheck` (docs must stay honest) applied to *why the code exists*, not *what the docs claim*. **Harvested from `code-review`'s former `adr-gate.md` sub-file (deleted in the same change, per ADR-0008) and corrected to Tessera's real ADR machinery.** --- ## Tessera's ADR machinery (what this gate is grounded in — not generic) - **`docs/adr/`** — numbered `NNNN-<slug>.md`, sequential, never reused. - **`docs/adr/README.md`** — the index. **Every on-disk ADR MUST appear here** — `scripts/doccheck.py`'s `adr-index-complete` asserts it, and the **pre-commit hook blocks the commit** if an ADR is missing from the index. *So: any ADR this gate creates or drafts must be added to the index in the same change, or the commit fails.* - **`docs/adr/_template.md`** — the structure for eval ADRs. Internal-dec