workflow-diagram

ワークフロー図

コードまたはドキュメントから、プロセスのワークフロー、 パイプライン、またはステートマシンを示す Mermaid フローチャートを生成します。

使用する場合

• CI/CD またはデプロイのパイプラインを視覚化する
• 複数ステップの開発ワークフローを文書化する
• ステートマシンまたはライフサイクルのプロセスを図示する
• 「X の実行時にどのような手順が発生するか」という質問に回答する

使用しない場合

• コンポーネント間でのデータの移動（cartograph:data-flow を使用）
• コンポーネントの構造（cartograph:architecture-diagram を使用）

ワークフロー

ステップ 1：コードベースを調査する

コードベースエクスプローラーエージェントを呼び出します。

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.

ステップ 2：Mermaid 構文を生成する

構造モデルを、判断ノードと処理ステップを含む Mermaid フローチャートに変換します。

ワークフロー図のルール：

• 順次処理には flowchart TD を使用します
• 並列トラックを含むパイプラインには flowchart LR を使用します
• ステップの種類を区別するために図形を使います：
  • [Rectangle] は処理ステップ
  • {Diamond} は判断ポイント
  • ([Stadium]) は開始／終了状態
  • [[Subroutine]] はサブプロセス
  • ((Circle)) は合流／同期ポイント
• 遷移条件には -->|label| を使用します
• 並列トラックをサブグラフにまとめます
• 結果ごとに色分けします：
  • 通常の経路はハッピーパス
  • エラー／フォールバック経路は点線（-.->）
  • クリティカルパスは太線（==>）
• ノード数は最大 20 個に制限します

出力例：

flowchart TD
    start([Start: PR Created])
    lint[Run Linters]
    test[Run Tests]
    review{Code Review}
    approve[Approved]
    changes[Request Changes]
    merge([Merge to Main])

    start --> lint --> test
    test --> review
    review -->|pass| approve --> merge
    review -->|fail| changes -.-> lint

ステップ 3：MCP 経由でレンダリングする

Mermaid Chart MCP を呼び出してレンダリングします。

mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram
  prompt: "Workflow diagram of [scope/process]"
  mermaidCode: [generated syntax]
  diagramType: "flowchart"
  clientName: "claude-code"

レンダリングに失敗した場合は、構文を修正して再試行します（最大 2 回）。

ステップ 4：結果を提示する

レンダリングされた図を、ワークフローの段階と判断ポイントを簡潔に説明する文章（2～3 文）とともに表示します。

完了条件

• 条件分岐を表すひし形の {Decision} ノードを少なくとも 1 つ含む Mermaid の flowchart 構文が生成されている
• mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram が呼び出され、エラーなく完了している（または再試行を行い、その結果が報告されている）
• ソースにエラー経路がある場合、エラー／フォールバック経路が点線の矢印（-.->）で、ハッピーパスの矢印と区別して描画されている
• ノード数が 20 個以下である。ステップ数がそれを超える場合、サブプロセスは [[Subroutine]] ノードにまとめられている
• ワークフローの段階と判断ポイントを説明する 2～3 文が、図とともに表示されている