diagram-maker

1# Diagram Maker
2 
3Create diagrams as artifacts, not prose. Choose one output mode:
4 
5- `clean-svg`: educational concepts, physical systems, processes, lifecycle, simple data flow.
6- `architecture-svg`: software/cloud/infra topology, services, databases, queues, trust zones.
7- `excalidraw`: editable hand-drawn whiteboard, flowchart, sequence, architecture sketch.
8 
9Routing
10 
11- User wants editable/collaborative: choose Excalidraw.
12- User wants polished standalone browser output: choose SVG/HTML.
13- Software architecture with infra components: choose architecture SVG.
14- Science, product, process, concept map, physical object: choose clean SVG.
15- Unsure: ask one short question only if output format matters; otherwise choose clean SVG.
16 
17Workflow
18 
191. Extract nodes, groups, labels, and directed relationships.
202. Pick layout first: left-to-right, top-down, hub-spoke, swimlanes, layered stack, sequence.
213. Keep labels short. Prefer 5-9 main elements over dense diagrams.
224. Generate the file at the requested path. If none is provided, use `diagram.html` or
23   `diagram.excalidraw` in the current working directory.
245. Do not overwrite an existing file by default. Choose an unused suffixed name such as
25   `diagram-2.html`, or ask before replacing the existing file.
266. Verify syntax by opening or parsing the output when feasible.
27 
28SVG/HTML rules
29 
30- Single standalone `.html` file with inline CSS and inline SVG.
31…