verify
Use when a plan's tasks are landed and its branch needs the gate before a pull request, the scripted checks, the branch review and repairing what it finds. Not for landing a task, which build owns, or
SKILL.mdskills/verify/SKILL.md
GitHubVerify
The loop
- Run the gate.
node "${CLAUDE_SKILL_DIR}/scripts/verify.mjs" --plan <plan path> --root <checkout> --base <base> --reviews-onlyfirst.- Then in one message: the full run in the background, step 2's dispatch; end the turn, no ScheduleWakeup, Monitor or sleep.
- No plan file → end the turn: ask for its path, name
build's no-plan route; never hand-run checks orship. SKIP,WARN,FIX-ONLYorSESSIONline → readreferences/gate-lines.md.FAILorUNPLANNEDline → end the turn with script's report; rerun no check.- Step 3 starts after the full run prints no
FAILorUNPLANNED.
- Review the branch. Skip
REVIEW Branchif reviewer readsnone.- Else dispatch one
exo:review-branch:exo-kind: review-deepfirst unless line names no kind, thenDISPATCH Branchfields. - Add three to five questions from Goal and each task's
Data:,Risk:, Acceptance. - Add
DISPATCH Overlapdispatch withOVERLAPlines whenOVERLAPlists more thannone, all in one message. - Run
node "${CLAUDE_SKILL_DIR}/scripts/merge-reviews.mjs" --root <checkout> --report <each report path>, eachCODE-RULESpath included; its first line is step 3's verdict,FINDINGlinesquestion,note,reportfindings. CODEX=pick-reviewer.mjs --codexresult:offer→ ask once for acodex execsecond review of plan and diff, appending its findings to findings path before step 3; else say nothing.--land→ skip that offer.
- Else dispatch one
- Repair the findings.
FINDINGSwithfix=1or more, orconcern=1or more, goes to theexo:fix-reviewagent, with no model override, filled dispatch line,../build/review-fixer-prompt.mdby path.concern=1or more withfix=0→ still dispatch; the fixer, not the lead, writes each concern's failing test, marking it unproven only if it passes.fix=0andconcern=0→ step 4, also withnotefindings; noexo:fix-reviewdispatch, rerun or fix commit.- Else, after dispatch →
references/repair.md.
- Offer the finish. End on
ship, unless a request or plan rules out a push; then say nothing left the machine.defectlines → first book each perreferences/lessons.md.--land→ pass--landtoship.
References
| File | Read it when |
|---|---|
references/review-rules.md |
Each BLOCKED return or resume. Step 2 dispatches from DISPATCH fields, passes review-rules= unread. |
references/repair.md |
Step 3. |
references/lessons.md |
Step 4, a defect. |
references/gate-lines.md |
Step 1. |
references/plan-checks.md |
Never: reviewer reads it. |
../route-skills/references/closing.md |
Before final message. |
Report: REPORT gets Changed, chores, report and note findings. Message: report rule in ../route-skills/references/closing.md, three lines pointing at REPORT path, question findings, one decision: FAIL, else question, else ship.