sparklabx/drawio-ai-kit

  

AWS、Azure、GCPアーキテクチャに最適化された、構造的に正確かつ美的に標準化された draw.io 図を生成できるオーケストレーションおよび検証フレームワークです。

これは、存在しないステンシルIDを生成して空の形状になるなど、一般的なAIエージェントの幻覚を3つの主要な要素を用いて軽減します。

1. 宣言的カタログ — ステンシルID(mxgraph.aws4.*)をそれぞれの分類法や標準カラーパレットに draw.io マッピングする単一の真実の情報源。
2. デザイン原則 — 建築およびレイアウトの規則(skills/drawio/references/principles.md)を成文化したもの。
3. Structural Validator — シリアライズ前にステンシル参照が有効で設計原則が満たされていることを保証するために、ダイアグラムXMLを監査する静的解析エンジンです。

AIに自己完結型のdrawio-aiCLI(1つのバンドルファイル、追加インストール不要)を通じてAIに露出させました。

ショーケース

プラットフォームごとに1つの図 — すべてキットによって端から端まで生成され、手作業の座標は不要、実際のステンシル、検証済み、視力確認済み。完全なセットはexamples/に収録されています。

クイックスタート

要件: Node.js ≥20.6 または バン1.4+。

  

An orchestration and validation framework enabling AI agents to generate structurally precise and aesthetically standardized draw.io diagrams, optimized for AWS, Azure & GCP architectures.

It mitigates common AI agent hallucinations (such as generating non-existent stencil IDs that result in empty shapes) using three key components:

1. Declarative Catalog — A single source of truth mapping draw.io stencil IDs (mxgraph.aws4.*) to their respective taxonomies and canonical color palettes.
2. Design Principles — Codified architectural and layout rules (skills/drawio/references/principles.md).
3. Structural Validator — A static analysis engine that audits diagram XML to guarantee stencil references are valid and design principles are satisfied prior to serialization.

Exposed to the AI via the self-contained drawio-ai CLI (one bundled file, nothing extra to install).

Showcase

One diagram per platform — all generated end-to-end by the kit: no hand-placed coordinates, real stencils, validated, vision-checked. Full set in examples/.

Quick start

Requirements: Node.js ≥20.6 or Bun 1.4+. Nothing else to install.

Bun-only machine (no node)? The CLI’s shebang is #!/usr/bin/env node (the Windows-safe standard), so install.sh writes ~/.local/bin/drawio-ai as a wrapper that runs bun /dist/cli.mjs. Re-run install.sh after bun update -g. With a manual bun add -g, run bun $(bun pm bin -g)/../install/global/node_modules/drawio-ai-kit/dist/cli.mjs or install Node.

1. One-liner (CLI + skill)

curl -fsSL https://raw.githubusercontent.com/sparklabx/drawio-ai-kit/refs/heads/main/install.sh | sh