docs: standardize verification handoffs and lane claims

This commit is contained in:
alex wiesner
2026-03-13 21:41:00 +00:00
parent a3045255a7
commit c02e386846
5 changed files with 52 additions and 19 deletions

View File

@@ -19,15 +19,25 @@ Use this skill before declaring work done, handing off, or approving readiness.
## Evidence Standard
- Include exact commands run.
- Include pass/fail outcomes and key output.
- Tie evidence to each acceptance condition.
Use the compact verification summary shape for every evidence entry:
- **Goal** what is being verified
- **Mode** `smoke` (intermediate checkpoints) or `full` (final completion)
- **Command/Check** exact command or manual check performed
- **Result** `pass`, `fail`, `blocked`, or `not_run`
- **Key Evidence** concise proof (output snippet, hash, assertion count)
- **Artifacts** paths to logs/screenshots, or `none`
- **Residual Risk** known gaps, or `none`
Keep raw logs out of primary context by default. When a check fails, summarize the failure first and then point to the raw evidence. Include full output only when explicitly requested.
Tie each evidence entry to an acceptance condition from the plan.
## Role Expectations
- Builder and tester: no completion claim without concrete verification evidence.
- Reviewer: reject completion claims that are not evidence-backed.
- Coder: point to verification evidence from assigned lane before signaling done.
- Builder and tester: no completion claim without verification evidence in the compact shape above.
- Reviewer: reject completion claims that lack structured evidence or lane-ownership boundaries.
- Coder: include compact-shape verification evidence from the assigned lane before signaling done.
## If Verification Fails