| license | BSL-1.1 |
| name | dag-replay-debugger |
| description | Time-travel debugging for DAG executions. Inspect agent state at any node, replay decisions with modified inputs, compare execution traces side-by-side, and identify where reasoning diverged. Inspired by LangGraph Studio's state-editing model and Temporal's event history. Activate on "debug DAG", "replay execution", "time travel debug", "inspect node state", "what went wrong at step", "compare runs", "execution diff". NOT for live monitoring (use dag-runtime + websocket-streaming), failure analysis (use dag-ops), or general code debugging. |
| allowed-tools | Read,Grep,Glob |
| metadata | {"category":"DAG Framework","tags":["dag","replay","debugger","debug-dag","replay-execution"]} |
| category | Agent & Orchestration |
| tags | ["dag","replay","debugging","trace","inspection"] |
DAG Replay Debugger
Time-travel debugging for DAG executions. Inspect any node's full state (inputs, prompt, output, reasoning), replay from any checkpoint with modifications, and compare execution traces.
When to Use
✅ Use for:
- Post-mortem analysis of failed or low-quality DAG executions
- Inspecting exactly what a node received and produced
- Replaying from a checkpoint with modified inputs or skills
- Comparing two execution traces to find where they diverged
- Understanding WHY a node made a specific decision
❌ NOT for:
- Live monitoring of running DAGs (use
websocket-streaming)
- Automated failure recovery (use
dag-mutation-strategist)
- Profiling cost/performance (use
dag-ops)
Core Capabilities
1. State Inspection
At any node in a completed execution, view:
┌──────────────────────────────────────────────────────┐
│ Node: analyze-codebase (Wave 2) │
│ Status: completed ✓ Duration: 4.2s Cost: $0.028 │
│ │
│ Model: claude-sonnet-4-5 │
│ Skills loaded: code-review-skill, react-server-... │
│ │
│ ▸ System Prompt (3,421 tokens) [Expand] │
│ ▸ User Message (1,205 tokens) [Expand] │
│ ▸ Input from upstream nodes [Expand] │
│ ▸ Full output (1,847 tokens) [Expand] │
│ ▸ Evaluator scores [Expand] │
│ Self: 0.85 Peer: 0.78 Downstream: accepted │
│ ▸ Context Store entries used [Expand] │
│ │
│ [Replay from here] [Edit & Replay] [Compare] │
└──────────────────────────────────────────────────────┘
2. Replay from Checkpoint
Pick any completed node and re-execute from that point forward:
- Same inputs: Useful for non-deterministic debugging (did the model just get unlucky?)
- Modified inputs: Edit the upstream output, then replay to see if downstream behaves differently
- Modified skills: Swap in a different skill version, then replay to compare output quality
- Modified model: Try the same node with Haiku vs. Sonnet to validate routing decisions
flowchart LR
A[Select checkpoint node] --> B{Modification?}
B -->|None| C[Replay from here, same inputs]
B -->|Edit input| D[Modify upstream output]
B -->|Swap skill| E[Change skill assignment]
B -->|Change model| F[Change model tier]
D --> G[Re-execute node + downstream]
E --> G
F --> G
C --> G
G --> H[Compare with original execution]
