docs(agent): add stuck-subagent intervention rule

2026-03-12 21:23:25 +00:00
parent 2a46de2287
commit 060da7ea1d
2 changed files with 13 additions and 0 deletions
@@ -190,6 +190,18 @@ Handoff rule:
  - relevant files / ids / commands
  - what counts as success for the next pass

+Subagent drift / stuck rule:
+- if a fresh implementation subagent is no longer making crisp progress, inspect before waiting longer
+- treat these as intervention triggers:
+  - the run is still active after a reasonable window for the task and has not updated `WIP.md`
+  - the run is looping on broad reads/re-verification without landing state updates or commits
+  - the completion result is unusable, missing evidence, or obviously unrelated to the assigned pass
+- when triggered:
+  1. inspect the subagent session/history once
+  2. if meaningful progress is still happening, let it finish
+  3. otherwise kill the run, verify the workspace directly, finish the pass in the main session, and update `WIP.md` yourself
+  4. record the behavior in memory if it reveals a repeatable failure mode
+
 Delegation helper:
 - Use `skills/delegation-router/SKILL.md` as the local quick policy for choosing direct vs subagent vs ACP and selecting model tier.