| name | workflow-diagram |
| description | Generates a Mermaid workflow diagram showing process steps, decisions, and state transitions. Use when documenting CI/CD pipelines or lifecycle processes. |
Workflow Diagram
Generate a Mermaid flowchart showing process workflows,
pipelines, or state machines from code or documentation.
When To Use
- Visualizing CI/CD or deployment pipelines
- Documenting multi-step development workflows
- Mapping state machines or lifecycle processes
- Answering "what steps happen when X runs?"
When NOT To Use
- Data moving between components (use
cartograph:data-flow)
- Component structure (use
cartograph:architecture-diagram)
Workflow
Step 1: Explore the Codebase
Dispatch the codebase explorer agent:
Agent(cartograph:codebase-explorer)
Prompt: Explore [scope] and return a structural model.
Focus on process steps, conditional logic, state
transitions, and pipeline stages for a workflow diagram.
Look for: Makefiles, CI configs, hook chains, command
sequences, and lifecycle methods.
Step 2: Generate Mermaid Syntax
Transform the structural model into a Mermaid flowchart
with decision nodes and process steps.
Rules for workflow diagrams:
- Use
flowchart TD for sequential processes
- Use
flowchart LR for pipelines with parallel tracks
- Use shapes to distinguish step types:
[Rectangle] for process steps{Diamond} for decision points([Stadium]) for start/end states[[Subroutine]] for sub-processes- for join/sync points
