parallel-impl-agent-dies-mid-stream-verify-working-tree

Verifies actual working-tree output when a parallel subagent dies mid-stream despite reporting completion.

3|Updated May 8, 2026
One-click install
npx skills add https://github.com/wan-huiyan/agent-traffic-control --skill parallel-impl-agent-dies-mid-stream-verify-working-tree-wan-huiyan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: parallel-impl-agent-dies-mid-stream-verify-working-tree
Source: https://github.com/wan-huiyan/agent-traffic-control/tree/main/plugins/agent-traffic-control/skills/parallel-impl-agent-dies-mid-stream-verify-working-tree
Command: npx skills add https://github.com/wan-huiyan/agent-traffic-control --skill parallel-impl-agent-dies-mid-stream-verify-working-tree-wan-huiyan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you fan out multiple parallel implementation agents and one stalls mid-stream, the harness may still report "completed (exit code 0)" even though the agent wrote nothing. Integrating on that false status ships a hole in your codebase. This Skill provides a reconciliation protocol to detect dead agents and recover correctly. ## Core Features & Use Cases - Claimed-vs-actual reconciliation: Check git status and grep each agent's target file for the expected change before integrating, instead of trusting the completion status. - Three recovery variants: Covers the shared-file case (finish the dead agent's task yourself), the checkpointed-pipeline case (reconcile against origin/<branch> and open PRs, re-dispatch only missing stages, never use resumeFromRunId), and the reviewer/analyst case (SendMessage a finalize-only resume to the same agent id). - 3-strike escalation rule: If the same stage dies three times, stop re-dispatching and do it in the main loop in small, individually verified steps. - Use Case: You dispatched 3 parallel agents to edit disjoint files; one returns API Error: Response stalled mid-stream with a "completed" notification. Before committing, you grep each target file, find one agent wrote nothing, and finish its task yourself in the main loop. ## Quick Start Ask the assistant to verify each parallel agent's claimed work against the actual working tree with git status and grep before integrating their combined output.

Frequently Asked Questions about parallel-impl-agent-dies-mid-stream-verify-working-tree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify a parallel subagent actually wrote code before integrating?▼

Run git status --short and grep each agent's target file for the expected change, such as a new function name. A missing edit plus no new test file means the agent died, regardless of any "completed (exit 0)" notification from the harness.

Why does a stalled agent still report completed with exit code 0?▼

The exit code reflects the shell wrapper terminating, not the agent's work landing. A mid-stream API stall can leave zero durable output — untouched target files and pending todos — while the harness still emits a completion notification.

Should I use resumeFromRunId when a pipeline agent dies mid-stream?▼

No. resumeFromRunId re-runs everything downstream of the first changed call, duplicating stages already committed and pushed. Instead, check git log on origin and open PRs, then re-dispatch only the missing stages with a targeted mini-workflow.

How do I recover a stalled reviewer or analyst agent's output?▼

Read the partial result in the failure notification first, then SendMessage the same agent id with a finalize-only prompt telling it to write findings from existing notes without re-reading files or consulting advisors. This recovers the deliverable in one cheap turn.

When should I stop re-dispatching a failing stage?▼

After the same stage dies three times, stop re-dispatching and do the work in the main loop in small, individually verified steps. Three failures indicate the stage is too large for one agent context.