diff options
Diffstat (limited to 'shared/agents/wf-worker.md')
| -rw-r--r-- | shared/agents/wf-worker.md | 7 |
1 files changed, 5 insertions, 2 deletions
diff --git a/shared/agents/wf-worker.md b/shared/agents/wf-worker.md index 82c8f14..898e10b 100644 --- a/shared/agents/wf-worker.md +++ b/shared/agents/wf-worker.md @@ -24,7 +24,10 @@ it prints the task, its refs and relations. `wf` = `python3 /projects/public/wor (`unittest … 2>&1 | grep -A15 '^FAIL\|^ERROR' | head -80`), never run then grep in two calls. - No background jobs (no `run_in_background`, no Monitor): long commands run in the foreground, or `wf res run` and wait for it in the foreground. The end of your turn is the end of your work. -- Blocked on a decision → `wf add -s awaiting "<question>"`, `wf status <id> blocked <a-id>`, stop. +- Owner absent, never wait or ask. Blocked on a decision → `wf add -s awaiting "<question>"`, `wf status <id> blocked <a-id>`, + stop, result `awaiting <a-id>`. Owner-only step (GUI, live game/device, decision made with the owner) → do the rest, + `wf add -s human -p <prio> -e <effort> "<step>. <why>"`, `wf set <id> --after <h-id>`, `wf status <id> clear`, `wf wip` + if WIP, stop, result `needs-owner <h-id>` (owner's `wf done <h-id>` makes it pickable again). - Slice job (`wf next`/`wf show` says effort > slice_above): no code; `wf add --parent <id>` slices ≤ 1h, each with Steps/Done/Ref + Model; `wf note`; `wf status <id> clear`; report outcome `sliced`. - Beyond your model → `wf set <id> --model <higher>`, `wf note <id> "<why>"`, `wf status <id> clear`, stop. - Told to wrap up → one call in the worktree: `wf wip <id> -m "<state + next step>" --commit "<msg + footer>" <paths>` (commits WIP, notes, status clear), stop. @@ -48,6 +51,6 @@ Your final message is exactly these 4 lines, no text before or after (details be entry, `wf note` or new tasks — the orchestrator never reads prose): id: <id> - result: done | done+gate-red <culprit> <fix-id> | awaiting <a-id> | handback <why> | wip + result: done | done+gate-red <culprit> <fix-id> | awaiting <a-id> | needs-owner <h-id> | handback <why> | wip commit: <merged sha or -> (copy `wf finish`'s last line `report: commit <sha> [books <sha>] [tool <sha>]`; never a git HEAD you looked up) followups: <ids from wf add, or none> |