Rewrite format.md around turn files, the output.md order (# outcome, edge word, # handoff, detail), checks, configs, human stages and the land stage delivery gate (sh -c in a fresh detached worktree, clean checkouts incl. untracked, 64 KB output cap, opencode only). Align review guidance across practices, verification, orchestration and the feedback-loop example. Fix loop-limit semantics in control.md against runner.go, budget_tokens sizing, read for large inputs, blocked-else-error and one stage naming set. Move dated verification logs to docs/verification-history.md and brokered chat, TUI keys and harness internals to docs/operator-reference.md; label operator-only references in SKILL.md.
1.6 KiB
Recover a failed run
- Read
pipelines inspect ID --json, the failed stage's actual input/result, retained tool evidence, artifacts and Git diff. A timeout is not proof of lost work. - Separate code failure, environment/setup failure and result-format failure. Missing evidence is not a passing check; a failed result does not erase edits.
- Fix the specific cause directly or continue the original pipeline from the necessary stage. Preserve completed work and original history. Do not create another pipeline simply to merge a prepared commit.
- Verify the repair with a focused regression; run broader checks once relevant inputs settle. Do not raise retry/time budgets to hide a reproducible defect.
Use pipelines help retry to discover the installed options. When supported,
select a recorded stage/visit, bounded input correction and explicit compatible
version of the same pipeline. Verify actual retained stage input, not merely
successful admission. Do not silently restart from entry.
A clean preparation stage succeeds without an empty commit. A land stage with a
delivery gate succeeds with a clean checked candidate; the server lands afterward.
Read-only, nonvisual work does not require device screenshots. Visual acceptance
requires a ready fixture, verified connection and actual captured interactions.
Preserve exclusive fixture ownership; inspect tool/process termination before reuse. Stop and await exact owned fixture processes, not just a go-run parent. Do not disrupt another active fixture or restart a shared service over running work.
Report the exact blocker and next action briefly. Keep independent work moving.