sparklabx/drawio-ai-kit

  

Фреймворк оркестрации и валидации, позволяющий агентам ИИ генерировать **структурно точные и эстетически стандартизированные draw.io диаграммы, оптимизированные для архитектур AWS, Azure и GCP.

Он смягчает распространённые галлюцинации агентов ИИ (например, генерирование несуществующих трафаретных идентификаторов, приводящих к пустым формам) с помощью трёх ключевых компонентов:

1. Декларативный каталог — Единственный источник отображения истинности draw.io трафаретных идентификаторов (mxgraph.aws4.*) в соответствующие таксономии и канонические цветовые палитры.
2. Принципы проектирования — Кодифицированные архитектурные и планировочные правила (skills/drawio/references/principles.md).
3. Структурный валидатор — Статический аналитический движок, который проверяет XML диаграмм, чтобы гарантировать валидность ссылок на трафареты и соблюдение принципов проектирования до сериализации.

Открыт для ИИ через автономный drawio-ai CLI (один файл в комплекте, ничего дополнительного для установки).

Шоукейс

Одна диаграмма на платформу — все генерируются сквозь конец набором: нет ручных координат, нет реальных трафаретов, проверено, проверено визуально. Полный набор в examples/.

Быстрый старт

Требования: Node.js ≥20.6 или Bun 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