diagram-review

name	diagram-review
description	Use after generating diagram.drawio (Step 4) to review the XML against project rules and style docs

Diagram Review

Overview

draw.io XML のレビューを 2 フェーズ で行う。

1. 構造レビュー（Step 4.5）: XML 生成直後に自動実行。ドキュメントに照らして構造・スタイルをチェック
2. ビジュアルレビュー（Step 5.5）: 人間が draw.io に貼り付けた後、スクリーンショットで見た目を確認

When to Use

• Step 4.5: XML 生成完了直後に自動実行する
• Step 5.5: 人間がスクリーンショットを提供したときに自動実行する
• 人間が明示的に「レビューして」と言った場合にも実行可能

---

Phase 1: 構造レビュー（Step 4.5）

Process

1. 対象の diagram.drawio を読む
2. 対応する diagram.md（Mermaid）を読む
3. 以下のドキュメントを読み、現在のルールを取得する:
   • docs/rules/conventions.md
   • docs/styles/layout.md
   • docs/styles/elements.md
4. カテゴリごとにチェックし、問題を収集する
5. 問題があれば一覧で報告、なければ「レビュー OK」

Review Categories

各カテゴリはドキュメント参照で判定する。固定チェックリストではなく、ドキュメントの現在の内容がルールになる。

カテゴリ	参照先	チェック観点
構成パターン	rules/conventions.md	End User+AC セット配置、CIS 配置位置、オンプレ接続 3 点セット、サービスボックスからの矢印集約
ラベル・言語	rules/conventions.md	要素名が英語か、矢印ラベルが許可リスト内か
コンテナの塗り	styles/elements.md	L0-L3 の交互ルール（#EBF8FF / #ffffff）に従っているか
アイコン形式	styles/elements.md + layout.md	SAP アイコンのサイズ・html=1;の有無、Generic Icon がプレースホルダ形式か（既知アスペクト比の適用含む）、ラベルが別セルか
コンテナサイズ	styles/layout.md	ラベル付きコンテナの上部余白（テキストラベル: 50〜60px）、SAP アイコンのラベルはみ出し分を含めた下部・側面余白、子要素が 1 つの場合の中心揃え
座標整合	styles/layout.md	直線矢印で結ぶ要素の中心座標が一致しているか
エッジ接続点	styles/layout.md	trust / authenticate 等の重要エッジで entryX/Y, exitX/Y が明示されているか
必須要素	diagram.md との突合	Mermaid に定義された全ノード・エッジが XML に存在するか

Output Format

問題がある場合:

## Diagram Review (構造)

- [ ] **構成パターン**: Cloud Connector が S/4HANA の箱の外に配置されている（conventions.md §8）
- [ ] **座標整合**: SPA と DEST の中心 Y が 2px ずれている（layout.md §4）

上記を修正しますか？

問題がない場合:

## Diagram Review (構造)

レビュー OK — draw.io に貼り付けてスクリーンショットを共有してください

---

Phase 2: ビジュアルレビュー（Step 5.5）

Trigger

人間が draw.io に XML を貼り付けた後、スクリーンショットを会話に貼り付けることでトリガーされる。Claude は画像を Read で読み込み、以下の観点でチェックする。

チェック観点

カテゴリ	チェック内容
ラベルはみ出し	SAP サービスアイコンのラベルがコンテナ枠からはみ出していないか
ラベル重なり	隣接するアイコンのラベル同士が重なっていないか
コンテナ余白	コンテナの上下左右に適切な余白があるか（詰まりすぎ・空きすぎ）
矢印の直線性	直線であるべき矢印が折れ曲がっていないか
要素の視認性	テキストが読める大きさか、アイコンが潰れていないか

Process

1. スクリーンショット画像を確認する
2. 上記チェック観点で問題を洗い出す
3. 問題があれば具体的な指摘と修正案を報告、なければ「ビジュアルレビュー OK」

Output Format

問題がある場合:

## Diagram Review (ビジュアル)

- [ ] **ラベルはみ出し**: Cloud Connector のラベルが S4 ボックス下端からはみ出している → S4 の高さを拡張
- [ ] **矢印の直線性**: trust 矢印が折れ曲がっている → Sub と CIS の中心 X がずれている

修正しますか？

問題がない場合:

## Diagram Review (ビジュアル)

ビジュアルレビュー OK