sparklabx/drawio-ai-kit

何を解決するか

AIエージェントは正確な draw.io ダイアグラムを作成する際にしばしば困難に直面し、存在しないステンシルIDを誤認したり、アーキテクチャのレイアウト標準を守れなかったりします。このキットは、AIが生成する図が構造的に正確で、視覚的に標準化され、有効なクラウドアーキテクチャステンシルを使用することを保証するフレームワークを提供します。

仕組み

このプロジェクトは、AIエージェントを導くための3つのアプローチを採用しています：

1. 宣言的カタログ：draw.io ステンシルIDを正しい分類と色にマッピングする信頼できるソース。AIが形状を勝手に発明することを防ぎます。
2. 設計原則：AIが従うべき形式化されたアーキテクチャおよびレイアウトルール。
3. 構造検証エンジン：図のXMLを静的解析し、ステンシル参照が有効で、設計原則が満たされているかを確認するエンジン。ファイルが最終化される前に検証を行います。

エージェントはゼロ依存のCLI（drawio-ai）を通じてこれらのツールとやり取りします。また、AIが直接ピクセル座標を推測する必要がないように、定義されたトポロジー（例：ネットワーク、パイプライン、メッシュ）に基づいて空間座標をプログラムで計算するレイアウトエンジンもサポートしています。

対象ユーザー

AIエージェント（例：Claude Code や Gemini CLI）を使用してAWS、Azure、GCP、Databricksのアーキテクチャ図、およびBPMNプロセスマップの作成を自動化するクラウドアーキテクトや開発者。

特徴

• マルチクラウド対応：AWS、Azure、GCP、Databricks専用のドメインスキル。
• ゼロ依存CLI：ステンシルの検索、XMLの検証、図のレンダリングをすべて内蔵した自己完結型ツール。
• 自動レイアウト：論理的なトポロジーに基づいてサイズと間隔を自動的に処理するレイアウトエンジン。
• 視覚ベースの修正：AIが図をPNGにレンダリングし、視覚機能を使って自己修正できる「レンダリング→分析→修正」のループをサポート。