workflow-debuggerlisted

Diagnose why a Claude Code Workflow-tool RUN failed or behaved oddly, from its on-disk run journal, and decide whether a `resumeFromRunId` re-launch will actually help. Invoke when a workflow launched but errored, returned a wrong or partial result, seems stuck, or the user asks "why did my workflow fail", "debug my workflow run", "the workflow errored / died", "can I resume this run", "what happened in run wf_…", or wants a run's journal read and explained. It reads the structured journal Claude Code writes for every run (the per-agent `agent-*.jsonl` transcripts are only a fallback), classifies the failure mode, and recommends — honestly — when resuming replays cached work and when it would save nothing. Out of scope: AUTHORING or restructuring a workflow script (that is the workflow-composer skill) and checking whether a Claude Code upgrade changed the runtime surface (that is the upgrade-canary skill).
home-dev-lab/workflow-toolbox · ★ 0 · AI & Automation · score 65

Install: claude install-skill home-dev-lab/workflow-toolbox

# Workflow debugger — diagnose a Workflow run from its journal When Claude Code's Workflow tool runs a script, it writes a **run journal** to disk: ```text ~/.claude/projects/<project-slug>/<sessionId>/workflows/wf_<runId>.json ``` That journal — not the launch message, not the per-agent transcripts — is the single structured record of what happened: the final `status`, the `error` (with stack) if it threw, every `agent()` call's state and token cost, the phases, and the totals. This skill reads it, says **what went wrong**, and decides **whether `resumeFromRunId` helps**. > **Journal-first.** Claude Code's own Workflow-tool docs name the per-agent > `agent-<id>.jsonl` transcripts as the FALLBACK "when no journal is available". So this > skill diagnoses from `wf_<runId>.json` and only drills into a transcript when you need > one agent's full reasoning. ## Run it ```bash # primary (plugin install — the bundled, zero-dependency CLI; nothing to install): node "${CLAUDE_PLUGIN_ROOT}/bin/wt-debug.mjs" [runId|latest|<journal-path>] [--json] [--project <slug>] # npm alternative (any project with @workflow-toolbox/build installed) — and the # only path for the audit REPORT, which the bundled bin does not do: npx workflow-toolbox debug [runId|latest|<journal-path>] [--json] [--project <slug>] npx workflow-toolbox report [runId|latest|<journal-path>] [--project <slug>] [--out <dir>] [--quiet] ``` (`pnpm exec workflow-toolbox …` is the equivalent of `npx workflow-toolbox …` in