5090f1cf4e
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.
28 lines
1.6 KiB
Markdown
28 lines
1.6 KiB
Markdown
# Recover a failed run
|
|
|
|
1. 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.
|
|
2. Separate code failure, environment/setup failure and result-format failure.
|
|
Missing evidence is not a passing check; a failed result does not erase edits.
|
|
3. 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.
|
|
4. 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.
|