subagent-watchdog-stall-on-ui-template-tracklisted
Install: claude install-skill wan-huiyan/agent-traffic-control
# Subagent watchdog stall on UI/template tracks
## Problem
You dispatched a `general-purpose` subagent (or any agent running in the
background via the Agent tool) to write a new UI screen — a route +
Jinja template + a few tests. The agent reads existing patterns, plans
template structure, drafts the template, iterates on test failures...
and stalls. You get:
```
status: failed
summary: Agent "Phase C: Screen 03 live workspace" failed: Agent stalled:
no progress for 600s (stream watchdog did not recover)
result: "Now let me look at the routes I'll consume (render, bundle,
upload) and existing templates."
```
The result fragment shows it was mid-investigation. The worktree may
contain partial edits.
## Context / Trigger Conditions
Recognise this trap when:
- The dispatched task is UI/template-heavy. Specifically: lots of file
reads (template patterns, view models, helpers) + Jinja/HTML/CSS
authoring + iterative test-write → run → fix → repeat loops.
- The agent's last reported output is "Now let me ..." or similar —
i.e. a tool-call prefix, not a result.
- Total elapsed time before stall is in the 10-15 minute range.
- Re-running the same prompt produces the same stall (verified on the
S16 Phase C retry — second attempt died at "Now let me look at the
routes I'll consume...").
- Comparable backend-only subagents in the same session completed
successfully (e.g. Phase B render path took ~16 minutes and emitted
101 tool uses without stalling).
## Why the