Skip to content

hoangsonww/Claude-Code-Agent-Monitor / plugins/ccam-workflows/skills/error-propagation

error-propagation

Verified

Trace error propagation through a multi-agent session by agent depth — where failures originated, the depth at which they appeared, and how they cascaded up to parent agents — using the Agent Monitor workflow intelligence API and the session event stream. Use when a multi-agent run failed and you need to find the origin and blast radius of the failure.

Error Propagation

Trace where a multi-agent session's failures started and how far they spread.

Input

The user provides: $ARGUMENTS

A session ID. If empty, fetch GET /api/sessions?limit=1, but prefer the most recent session whose status is error or abandoned; state which one you picked.

Data Sources

EndpointReturns
GET /api/workflows/{sessionId}The errorPropagation dataset: failures grouped by agent depth, with originating depth and cascade paths to parents
GET /api/events?session_id={sessionId}The event stream — corroborate with APIError, SubagentStop, and failing PostToolUse events (event_type, tool_name, summary, timestamp)

Report Sections

1. Failure Summary

From errorPropagation: total errors, the depth where the first error originated, and how many distinct agents were affected. Origin depth: d · Errors: N · Agents affected: M

2. Errors by Depth

DepthErrors originatedErrors inherited from childrenNet failing agents
Show whether failures concentrate deep in the tree (leaf subagents) or shallow (orchestrator).

3. Cascade Paths

For each originating failure, the path it propagated along: debugger (depth 2, tool failure) → code-review (depth 1, marked error) → root (depth 0, aborted) Tie each step to a concrete event from /api/events (event_type + tool_name + timestamp) where available.

4. Error Taxonomy

Break errors down by type from the event stream: APIError vs failing tool calls vs SubagentStop with error status. Note the most frequent tool involved in failures.

5. Containment Assessment

Whether failures were contained at the depth where they originated or leaked to parents. Name any parent that aborted solely because a child failed — a candidate for better error handling / isolation.

Output

  • Markdown tables for the depth breakdown; a fenced list for cascade paths.
  • Timestamps for the first and last error.
  • Cite only errors present in errorPropagation and the event stream; never invent failures or causes.
  • If the session has no errors, say so plainly and stop.
  • If the dashboard is unreachable, tell the user to start it with npm start from the repo root.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall