summaryrefslogtreecommitdiff
path: root/skills/pi-subagent/SKILL.md
diff options
context:
space:
mode:
authorIgor Soarez <igor@soarez.org>2026-10-27 11:36:43 +0200
committerIgor Soarez <igor@soarez.org>2026-10-27 11:36:43 +0200
commitb5100c2e088ef5c966b114f968847de779ed852f (patch)
treee48e72e9342da54d343dc7141508ac0574950301 /skills/pi-subagent/SKILL.md
parent11adcd3f5c6b2d60578096b039426ab21d171bda (diff)
sz-final-review-loop: wait with a wake armed, not blocked in sz-wait-for
The loop's agents blocked in a foreground sz-wait-for because nothing could bring an agent back from a background one. Both harnesses now can: pi's alarm fires when a when_done command exits, and Claude Code starts a new turn when a run_in_background Bash task exits (checked on 2.1.310). So an agent arms sz-wait-for as a wake and ends its turn: no context resent every 30 minutes to re-arm, the human can talk to it while it waits, and "arm, then signal" becomes literal. The foreground wait stays for a harness with neither. The invariant is unchanged in substance: never idle, where idle now means the other side's turn with no wake armed. sz-wait-for stays the watcher, for its settle window. pi-subagent: ยง5 says how to be woken in Claude Code too.
Diffstat (limited to 'skills/pi-subagent/SKILL.md')
-rw-r--r--skills/pi-subagent/SKILL.md5
1 files changed, 4 insertions, 1 deletions
diff --git a/skills/pi-subagent/SKILL.md b/skills/pi-subagent/SKILL.md
index 06862c0..9245b0e 100644
--- a/skills/pi-subagent/SKILL.md
+++ b/skills/pi-subagent/SKILL.md
@@ -173,7 +173,10 @@ alarm action=set when_exits=[<pids>] in_minutes=<the --timeout, in minutes, + 5>
alarm for all is the point.
- The alarm sees no exit status. `status.sh` has it.
- The deadline is a backstop, in case a run hangs past its own timeout.
-- Without the `alarm` tool (print or RPC mode), monitor with `status.sh`.
+- In Claude Code, which has no `alarm` but wakes you when a background Bash
+ task exits: launch the whole job as one `run_in_background` command that
+ starts the runs with `&` and ends with `wait`, and end your turn.
+- Without either (pi in print or RPC mode), monitor with `status.sh`.
**Don't sit on the wait loop.** With an alarm set, there's nothing to wait
for. Otherwise, launching early is only worth it if you use the time: do your