agentleFS
enomoso-pmenomoso-pm/drawio-diagram-skills/skills/create-diagram-d-nodeedge/SKILL.md

create-diagram-d-nodeedge

Skill40 starsChanged 5 months agoMITView on GitHub

draw.ioノード+エッジ系(体制図/状態遷移/ジャーニー/構成図/画面遷移/インフラ/移行方式)を作成する

The file

Files
SKILL.md

draw.io ノード+エッジ系ワークフロー(WF-D-NodeEdge)

対象図種別

ID説明
plan_org_chart① プロジェクト体制図

| biz_state_transition | ⑤ ステータス遷移図 | | req_customer_journey | ⑥ カスタマージャーニー | | req_system_context | ⑦ システム構成図 | | base_screen_transition | ⑧ 画面遷移図 | | base_infra_architecture | ⑨ インフラ構成図 | | mig_data_flow | ⑬ データ移行方式図 |


前処理(必須)

  1. 図種別IDを確定
  2. Scopeを確定
  3. 抽象度(L1/L2)を確定
  4. ノード/エッジ数を概算(上限:40/60)
  5. グルーピング枠を先に決める

共通骨格(この順で作る)

  1. ノード一覧を確定(状態/画面/コンポーネント/工程…)
  2. グルーピング枠を先に置く
  3. 主要ルートのエッジを先に引く(例外は後)
  4. ラベルを付ける(アクション/条件/データ種)
  5. 色・線種・凡例・注記を最後に固定
  6. 整列(グリッド)→交差線削減

draw.io共通固定ルール

  1. XML形式で出力
  2. 余白確保: キャンバス上下左右40px以上、重なり禁止
  3. whiteSpace=wrap: 文字は枠内に収める
  4. グリッド: 10px、スナップON
  5. サイズ統一: 同種ノードは同サイズ(目安 W180px/H56px)

エッジ(矢印)規格(必須)

  • コネクタ: 直交(orthogonal)で統一
  • 線幅: 1.5pt固定
  • 線の色: 原則グレー固定(線で色分けしない。色はノードで表現)
  • ラベル位置: 矢印中央(重なる場合は線ではなく配置を直す)
  • Y字分岐禁止: 分岐は必ずひし形から2本出す(途中枝分かれ禁止)
  • 外周配線禁止: レーン境界に沿った大回りは禁止(ノードを寄せて最短化)
  • 交差上限: 交差が3本超えたら ①ノード再配置 → ②合流点追加 → ③分割提案

線種ルール

線種用途
実線(1.5pt)通常フロー
点線(dashed=1)戻り/ループのみ(例外表現に乱用禁止)

分岐ラベル(Yes/No)配置ルール(必須)

  1. ラベルは「ひし形から出る矢印」に付与する(処理ノードから直接Yes/Noは禁止)
  2. 基本は矢印中央だが、線に被る場合は 線から6〜10pxオフセットする
    • Yes:矢印の上側へオフセット
    • No:矢印の右側へオフセット
  3. それでも被る場合は、ラベルの置き場を作る
    • ひし形と接続先ノードの距離を 8〜16px 広げる(ひし形/接続先どちらを動かしてもよい)
  4. どうしても解消できない場合の最終手段:
    • 矢印ラベルを削除し、テキストオブジェクトで線の近くに配置(背景白推奨)

① 体制図(plan_org_chart)

レイアウト

  • 方向: 上→下(PM→責任者→メンバー)
  • 階層: 最大4階層まで
  • グルーピング枠: チーム/部署単位
  • 指揮命令ライン: 実線
  • 連携ライン: 点線

ノード構成

種別内容
責任者ノード役職 + 名前
メンバーノード担当領域 + 名前
外部連携会社名 or チーム名のみ

色

種別塗り枠
PMO/マネジメント#E3F2FD#1E88E5
企画/ビジネス#FFF8E1#FFB300
技術/開発#E8F5E9#43A047
品質/運用#E8F5E9#43A047
外部/ベンダー#F5F5F5#9E9E9E

特徴カード記載例

  • 〇名体制(PMO 1名、開発 X名、QA X名)
  • 責任者3名によるリスク分散
  • 外部ベンダーへの依存領域

⑤ 状態遷移図(biz_state_transition)

レイアウト

  • 状態: 角丸長方形(同サイズで揃える)
  • 開始: 小円(塗り #333333)
  • 終了: 二重円 または「終了」箱
  • 複合状態: グルーピング枠

線種

線種用途
実線正常遷移
点線戻り/例外遷移

色

種別塗り枠
通常状態#E3F2FD#1E88E5
進行中#FFF8E1#FFB300
完了終端#E8F5E9#43A047
例外終端#FFEBEE#D32F2F

分割境界

  • ドメイン単位(申請/審査/支払…)
  • 状態数で分割

⑥ カスタマージャーニー(req_customer_journey)v2.2

図種別選択

種別対象行数
顧客体験版ビジネス/企画向け5行(行動〜理想体験)
システム開発版開発チーム向け11行(UI要件・開発詳細を含む)

重要: 開発プロジェクトでは「システム開発版」を使用すること


基本方針(顧客提出耐性)

ルール説明
As-Is / To-Be を明示タイトルで区別(混線防止)
行動欄は「ユーザー動作」のみ性能値(3秒等)は実装メモへ
Ahaは「タスク成立」まで描く保存完了まで到達させる(必須)
各フェーズにChurn+KPI施策議論を具体化
UI要件で理想と開発を接続トレーサビリティ確保(必須)

フェーズ構成(5段階固定)

#フェーズ説明Aha要件
1認知ストア/SNS/口コミで発見-
2導入・登録インストール→初期設定完了-
3初回体験(Aha)価値を体感する瞬間「タスク成立(保存完了)」まで描く
4達成・報酬タスク完了→達成感-
5習慣化継続利用→定着-

行構成(システム開発版:11行)

上段:顧客体験ブロック(6行)

#行名背景色枠色内容例
1ユーザー行動#E3F2FD#BBDEFBストアで検索、レビュー閲覧
2タッチポイント#E3F2FD#BBDEFBApp Store / LP / 認証画面
3感情#BBDEFB#90CAF92→3 / 4→3→5(認識ミス)
4つまずき(Churn)#FFCDD2#EF9A9A登録面倒、認識ミスが直せない
5提供したい体験#FFECB3#FFE082確認1回・修正1回で保存完了
6UI要件#E1BEE7#CE93D81画面完結、タップで部分編集

下段:開発ブロック(5行)

#行名背景色枠色内容例
7システム挙動#F5F5F5#E0E0E0OCR→正規化→保存
8データ/状態#F5F5F5#E0E0E0Task(draft→saved), EditHistory
9計測イベント#F5F5F5#E0E0E0ocr_success, task_saved
10主要KPI#C8E6C9#A5D6A7初日タスク作成率、time_to_save
11実装メモ#F5F5F5#E0E0E0SLO: 認識3秒以内、失敗率5%以下

ジオメトリ(座標・サイズ)固定値

ページサイズ: 1540 x 1050
フォント: 標準10pt、内容8-9pt

■ 上部カード
  y=60, height=50
  インライン形式: ペルソナ / スタート / ゴール / 対象範囲

■ フェーズヘッダー(shape=step矢印)
  y=120, height=28
  列x: 170, 378, 586, 794, 1002
  width=208(全て同じ)

■ 感情凡例
  x=950, y=15, width=260, height=40
  (表の右端に揃える)

■ 左側縦ラベル
  顧客体験: x=40, y=148, width=28, height=235
  開発: x=40, y=393, width=28, height=255

■ 行ラベル列
  x=70, width=100

■ データ列(5列)
  x: 170, 378, 586, 794, 1002
  width: 208(全て同じ)

■ 区切り太線
  y=383, strokeWidth=2, strokeColor=#757575

■ 開発ブロック背景帯
  x=70, y=383, width=1140, height=270
  fillColor=#EEEEEE, opacity=50

■ 凡例
  x=70, y=660, width=1140, height=32

UI要件行ルール(トレーサビリティ確保:必須)

目的: 「提供したい体験」と「開発」を接続する

フェーズUI要件の内容(必須項目)
認知ストアスクリーンショット/動画/CTAの定義
導入・登録ゲスト開始可否、権限提示タイミング、スキップ可否
初回体験画面遷移数、編集方式(部分/全文)、フォールバック
達成・報酬完了操作(タップ/スワイプ)、Undo有無、演出頻度
習慣化通知頻度上限、抑制条件、代替導線(ウィジェット等)

注: UI要件が空のフェーズがあってはならない

感情曲線ルール

  • 途中の落ちを1箇所以上入れる(認識ミス・権限・通知疲れ等)
  • 落ち理由はタグ形式で控えめに表示(赤文字は避ける)
    • スタイル: rounded=1;fillColor=#FFEBEE;strokeColor=#FFCDD2;fontSize=7;fontColor=#C62828
  • 感情スコアは1〜5の全スケール凡例を右上に配置

スコア色

スコア塗り枠
5#E8F5E9#2E7D32
4#C8E6C9#43A047
3#FFF8E1#FBC02D
2#FFE0B2#FB8C00
1#FFEBEE#D32F2F

計測イベント設計ルール

各フェーズに最低3つのイベントを定義:

フェーズイベント例
認知store_view, lp_view, video_play, cta_click
導入・登録install, signup_start, guest_start, permission_prompt/denied
初回体験capture_start, ocr_success, ocr_fail, edit_applied, task_saved
達成・報酬task_completed, undo_used, complete_latency
習慣化push_sent, push_open, push_optout, fatigue_signal, widget_use

KPI設計ルール

各フェーズに主KPI 1つ + 補助KPI 1-2つを定義:

フェーズ主KPI補助KPI
認知閲覧→インストール率video_play率, CTAクリック率
導入・登録登録完了率time_to_first_task, ゲスト→ログイン転換率
初回体験初日タスク作成率ocr_fail率, edit率, time_to_save
達成・報酬完了タップ率Undo使用率, complete_latency
習慣化D7/D30継続率push_optout率, widget_use率

ビジュアルルール

項目仕様
上部カードインライン形式(ラベル+値をテキストオブジェクトで)
フェーズヘッダーshape=step矢印、列座標に揃える
行ヘッダー縦ラベルの右に配置、幅100px固定
セル内容2行まで、フォント8-9pt
区切り線顧客体験/開発の境界に2px太線
開発背景帯薄グレー(#EEEEEE、透明度50%)
凡例下部に配置、表幅と同じ
右余白習慣化列の右端が表の右端(余白なし)

セルフチェック(システム開発版ジャーニー専用)

  • タイトルが「システム開発版」を明示している
  • 行動欄が「ユーザー動作」のみになっている
  • Ahaが「タスク成立(保存完了)」まで描かれている
  • 各フェーズにChurn 1行がある
  • 各フェーズにUI要件が定義されている(空フェーズなし)
  • 各フェーズに計測イベントが3つ以上ある
  • 各フェーズにKPI(主+補助)がある
  • 感情曲線に途中の落ちが1箇所以上ある(タグ形式)
  • フェーズ矢印が列座標に揃っている
  • 区切り太線が顧客体験/開発の境界にある
  • 開発ブロックに薄グレー背景帯がある
  • 凡例が下部にあり、UI要件色が含まれている
  • 右余白がない(習慣化列が表右端)

分割境界

  • アクター別(初心者/熟練者)
  • フェーズ群別(獲得/継続)
  • ペルソナ別(別シートに分ける)

⑦ システム構成図(req_system_context)

レイアウト

  • 中央: 自システム
  • 周囲: アクター/外部システム
  • 境界線: 明示必須
  • 矢印ラベル: 「何の情報」を書く

色

種別塗り枠
自システム#E3F2FD#1E88E5
アクター(人)#FFF8E1#FFB300
外部システム#E8F5E9#43A047
データストア#F3E5F5#8E24AA
境界透明#90A4AE

分割境界

  • 外部連携が多い場合(決済/通知/認証…)

⑧ 画面遷移図(base_screen_transition)

レイアウト

  • 方向: 左→右を基本
  • 開始ノード: 小円→初期画面
  • 戻り/キャンセル: 点線

色

種別塗り枠
主要画面#E3F2FD#1E88E5
サブ画面#FAFAFA#757575
モーダル#FFF8E1#FFB300
エラー画面#FFEBEE#D32F2F
開始ノード#333333#333333

分割境界

  • 画面群(オンボーディング/ホーム/設定…)

⑨ インフラ構成図(base_infra_architecture)

レイアウト(階層枠)

  • Region > VPC > AZ > Subnet(Public/Private)
  • 矢印にプロトコル(HTTPS/SQL等)
  • 不明は TBD と注記

色

種別塗り枠
Region枠透明#90A4AE
VPC枠#FAFAFA#607D8B
Public Subnet#FFF3E0#FB8C00
Private Subnet#E8F5E9#43A047
Data(DB/Cache)#F3E5F5#8E24AA
監視/運用#E3F2FD#1E88E5

分割境界

  • 環境(dev/stg/prod)
  • VPC単位

⑬ データ移行方式図(mig_data_flow)

レイアウト

  • 左: 旧システム
  • 中央: ETL経路
  • 右: 新システム
  • 矢印ラベル: データの形(RawDump/CSV/Normalized)
  • 検証ポイント: 工程として入れる

色

種別塗り枠
旧システム#FFEBEE#D32F2F
ETL/変換#FFF3E0#FB8C00
検証#FFF8E1#FFB300
新システム#E8F5E9#43A047
一時領域#E3F2FD#1E88E5

分割境界

  • データ種別(マスタ/トランザクション)
  • 経路別(バッチ/手動)

共通セルフチェック

  • ノード/エッジが上限以内
  • エッジが直交で統一され、全てグレーである
  • 交差線が最小限(3本超なら分割提案)
  • 分岐ラベルが線に被っていない(オフセット/距離調整/テキストで解決)
  • 色が凡例と一致(エッジで色分けしていない)
  • 未確定が灰色 or TBD注記

図種別ごとの追加チェック

⑤ 状態遷移

  • 開始/終端が明確
  • 例外遷移で矛盾なし
  • 状態ボックスが同サイズ

⑥ ジャーニー

  • タスクがユーザー行動の言葉
  • スコアが全て同じでない
  • 根拠(調査/仮)が明示

⑦ システム構成

  • 外部連携が「何を」まで読める
  • 境界が曖昧でない

⑧ 画面遷移

  • 戻り/キャンセルが落ちていない
  • 画面とモーダルが区別できる
  • 開始ノード→初期画面がある

⑨ インフラ構成

  • PrivateがPublicに混ざっていない
  • 通信方向が逆転していない

⑬ 移行方式

  • 「どこで変換」が一目で分かる
  • ロールバック前提が注記

コンサル品質チェック

  • 3秒で結論(何の図で何が分かる)が伝わる
  • 読む順番が自然(左→右、上→下)
  • 交差線が最小化されている
  • 同じ種類の箱はサイズが揃っている(W180px/H56px目安)
  • "対象外"が明記され、誤解余地が潰れている
  • 図の主張が1つに絞られている

参照

  • 共通規格(VDS・L定義・線種表・色ルール・命名規則)は /select-diagram を参照

雛形テンプレート

タスク管理アプリ題材の完成例(複製して土台に使う):

  • assets/システム構成_template.drawio(構成図。Client→App→Data→External の層構造、Cloud/External境界、OAuth・Push の因果ルール、配信=破線)
  • assets/画面遷移_template.drawio(画面遷移図。初期/終了状態、戻り遷移=破線)
  • assets/体制図_template.drawio(体制図。報告線/承認線/兼務=破線)

ファイル命名例

[プロジェクト名]_[日本語名]_v{MAJOR}.{MINOR}.drawio
  • TaskFlow_タスクステータス遷移_v1.0.drawio
  • TaskFlow_カスタマージャーニー_v2.1.drawio
  • TaskFlow_画面遷移図_v1.0.drawio

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.