manual page/ ADRs
ADR-0154 - Spec-backed tasks and review closure
Context
Task CI evidence, blocker-list parsing, task authority, and review acceptance each had more than one plausible representation. That ambiguity let valid packets fail and invalid terminal states pass.
Decision
- C023 CI evidence is visibly labeled. A task's CI evidence is a URL following
CI:orCI link:. An unlabeled URL is not C023 evidence. - C024 recognizes Markdown list forms. Canonical blocker labels are recognized after
unordered and ordered list markers.
noneandn/aremain resolved values. - Every task is spec-backed. The source spec owns scoped requirements. A change plan may add wave and preservation context but cannot replace the spec in a task or review.
- Review structure stays deterministic and unnumbered. Review ID and Requirement coverage are non-empty; decision and assessment values use their declared enums; waivers appear only on accepted reviews and exactly cover Unsupported and Unverified requirement rows; accepted reviews contain no non-empty Open decisions section or Blocked assessment. Blocked cannot be waived.
- The checks contract remains 0.18.0. No C-code is added, removed, renamed, or reused.
Narrowed decisions
Consequences
- Task CI and blocker evidence parse consistently with their fixtures.
- Change-plan tasks and reviews retain one requirement authority.
- Accepted review state has one mechanically reconcilable waiver and decision shape.
Status
Accepted (2026-07-13).
Need a starting point? Install the skills