manual page/ ADRs
ADR-0159 - Companion and task binding
Context
A task could claim any source spec and still check clean. Review companions bypassed their own hard checks. The task method required dependency order, but C022 did not.
Decision
- Task checks bind a spec. Every checked task receives an explicit
--speccompanion. The spec must be ready, clear its hard checks, and match the task'ssource:list. One companion may bind several task paths only when they all name that spec. - Review companions clear their hard checks. A review does not reconcile against a malformed spec or task. Companion warnings remain advisory.
- C022 owns dependency handoff.
Run orderis required exactly once. It carries non-emptyStarts after:andMay run with:values;Noneis explicit and valid. - The contract advances to
0.21.0. No check ID is added or repurposed. C022 gains the shape it already claimed; companion failures remain usage errors. - MCP stays thin.
specPathmay accompany task paths or one review.taskPathremains valid only for one review. The adapter forwards; the CLI decides validity.
Narrowed decisions
- ADR-0143: task source specs join explicit review companions.
- ADR-0152: C022 includes dependency handoff.
- ADR-0153: exact compatibility advances to
0.21.0. - ADR-0154: spec-backed task authority is enforced at check time.
- ADR-0158: companions must be valid before their identity can bind another artifact.
Consequences
- Missing, stale, draft, malformed, or mismatched task sources cannot dispatch cleanly.
- A review cannot launder a malformed companion into a clean reconciliation.
- Split tasks always state their dependency position.
Status
Accepted (2026-07-13). Narrows ADR-0143 and ADR-0152 through ADR-0154 and ADR-0158.
Need a starting point? Install the skills