Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
{
"schema_version": 3,
"diagram_type": "lifecycle",
"meta": {
"title": "Agent Run Lifecycle",
"output": "examples/lifecycle-agent-run.html",
"animation": "trace",
"quality_profile": "showcase"
},
"mainPath": ["queued", "planning", "executing", "reviewing", "completed"],
"states": [
{ "id": "queued", "type": "start", "label": "Queued", "sublabel": "request accepted", "tag": "entry", "step": "01" },
{ "id": "planning", "type": "active", "label": "Planning", "sublabel": "build task graph", "tag": "model", "step": "02" },
{ "id": "executing", "type": "active", "label": "Executing", "sublabel": "tool calls", "tag": "work", "step": "03" },
{ "id": "reviewing", "type": "decision", "label": "Reviewing", "sublabel": "quality gate", "tag": "check", "step": "04" },
{ "id": "completed", "type": "success", "label": "Completed", "sublabel": "final response", "tag": "done", "step": "05" },
{ "id": "approval", "type": "waiting", "label": "Needs Approval", "sublabel": "human gate", "tag": "pause" },
{ "id": "failed", "type": "failure", "label": "Failed", "sublabel": "recoverable error", "tag": "retryable" },
{ "id": "blocked", "type": "waiting", "label": "Blocked", "sublabel": "missing input", "tag": "wait" },
{ "id": "cancelled", "type": "failure", "label": "Cancelled", "sublabel": "user stopped", "tag": "terminal" },
{ "id": "expired", "type": "failure", "label": "Expired", "sublabel": "timeout", "tag": "terminal" }
],
"transitions": [
{ "id": "queued-planning", "from": "queued", "to": "planning", "label": "start" },
{ "id": "planning-executing", "from": "planning", "to": "executing", "label": "plan ready" },
{ "id": "executing-reviewing", "from": "executing", "to": "reviewing", "label": "steps done" },
{ "id": "reviewing-completed", "from": "reviewing", "to": "completed", "label": "pass" },
{ "id": "executing-approval", "from": "executing", "to": "approval", "label": "risky tool", "variant": "security" },
{ "id": "approval-executing", "from": "approval", "to": "executing", "label": "approved" },
{ "id": "approval-cancelled", "from": "approval", "to": "cancelled", "label": "user denies", "variant": "security" },
{ "id": "executing-failed", "from": "executing", "to": "failed", "label": "tool error", "variant": "security" },
{ "id": "failed-executing", "from": "failed", "to": "executing", "label": "retry", "variant": "dashed" },
{ "id": "reviewing-blocked", "from": "reviewing", "to": "blocked", "label": "needs input" },
{ "id": "blocked-reviewing", "from": "blocked", "to": "reviewing", "label": "input given" },
{ "id": "blocked-expired", "from": "blocked", "to": "expired", "label": "no reply 24h", "variant": "security" }
],
"cards": [
{
"dot": "emerald",
"title": "Main Path + Waits",
"items": [
"The run has five ordered phases from queue to completion",
"Approval and missing input pause the run without ending it"
]
},
{
"dot": "rose",
"title": "Recovery + Terminal Exits",
"items": [
"Failed loops back while retry budget remains",
"Cancelled and Expired are terminal exits with no return path"
]
}
]
}