manual page/ ADRs
ADR-0107 — Fast-track solo review via staleness detection, not an agent verdict
- Sections
- 4
- Format
- Markdown
- Order
- 143 / 156
Context
Solo / AI-heavy use is the hardest adoption case: the no-self-verdict gate (ADR-0077 D8, ADR-0056, ADR-0095, ADR-0099) is load-bearing but assumes a human who will look, so solo users pay full ceremony per change. suspec-works#72.1 proposed a provisional agent verdict — but a self-issued verdict, even timed, is exactly what the framework refuses. Ratified from RFC-fast-track-verdict.
Decision
Keep the human/independent gate; add an evidence-hash staleness signal — never an agent verdict.
- The review packet pins the reviewed commit SHA + an evidence hash (over the diff + the cited
evidence).
suspec checkre-validates the hash on any later check; a SHA/hash mismatch flips the packet toStale— the lifecycle marker that already exists (advanced-lifecycle: "prior Pass no longer trusted after text or evidence path changed") — and re-routes to re-review (warns; does not hard-block merge). - The solo flow: the independent reviewer agent (
suspec-reviewer, fresh context, no verdict) prepares the packet + the hash; the human ratifies fast because the prep is done and any later drift auto-flags. The verdict stays the human's; automation removes the toil, not the judgment. - Reconcile-only until measured — no
checks.yamlchange lands here (ADR-0063). Level: convention now / toolable when the hash re-validation ships.
This reframes #72.1's "verdict + expiry + escalate" as detection + escalation — the protective intent survives; the no-self-verdict principle is untouched.
Consequences
- Preserves no-self-verdict (the generator never scores its own loop); speeds solo prep + ratification.
- Build deferred (suspec-cli reconcile feature: the hash + the
Stalere-validation). Reuses the existingStalemarker — no new lifecycle token. - Open at implementation: exactly what the hash covers (diff / evidence cells / spec text). Recorded as a follow-up, not blocking the decision.
Affected obligations / constraints
- Reaffirms: ADR-0077 D8 / ADR-0056 / ADR-0095 / ADR-0099 (the human owns the verdict; no
self-verdict). Reuses: the
Stalereview marker. - Does NOT change: the verdict model (Pass/Fail/Unverified/Blocked), or the checks contract.
Starter kit: Set up a workspace