Draw.io Diagram Forge
Generate draw.io editable diagrams using AI-powered workflow.
When to Use
- •Creating architecture diagrams (Azure, AWS)
- •Converting flowcharts from text descriptions
- •Transforming images/screenshots into editable format
- •Generating swimlane, sequence diagrams
Prerequisites
| Tool | Required |
|---|---|
| VS Code | Yes |
| Draw.io Integration | Yes |
| GitHub Copilot | Yes |
Quick Start
code
Create a login flow diagram
code
Generate an Azure Hub-Spoke architecture diagram
code
From inputs/requirements.md, create a system diagram
Output Formats
| Extension | Description | When to Use |
|---|---|---|
*.drawio | Native format | Recommended |
*.drawio.svg | SVG + metadata | Markdown/Web |
*.drawio.png | PNG + metadata | Image with edit |
Output: outputs/
Workflow
code
USER INPUT → ORCHESTRATOR → MANIFEST GATEWAY → SVG FORGE → COMPLETED
Quality Gates
| Score | Action |
|---|---|
| 90-100 | Proceed |
| 70-84 | Fix and retry |
| 50-69 | Simplify |
| 0-29 | Ask user |
Limits
| Limit | Value |
|---|---|
| Manifest revision | 2 |
| SVG revision | 2 |
| Total timeout | 45min |
Cloud Icons
Enable in VS Code
- •Open
.drawiofile - •Click "+ More Shapes" (bottom-left)
- •Enable: Azure, AWS
- •Apply
Azure Format (Critical)
xml
<!-- WRONG --> <mxCell style="shape=mxgraph.azure.front_door;..." /> <!-- CORRECT --> <mxCell style="aspect=fixed;image=img/lib/azure2/networking/Front_Doors.svg;..." />
References
| File | Description |
|---|---|
| mxcell-structure.md | mxCell XML structure |
| cloud-icons.md | Azure/AWS icon guide |
| style-guide.md | Node colors, edge styles |
Scripts
| Script | Description |
|---|---|
scripts/validate_drawio.py | Validate mxCell structure |
Troubleshooting
| Issue | Solution |
|---|---|
| Blank in draw.io | Check content attribute |
| Edges not visible | Verify node IDs |
| Icons missing | Enable Azure/AWS shapes |