sysmap-to-mirolisted
Install: claude install-skill songstack/sysmap-to-miro
# sysmap-to-miro
Turn a codebase or system description into **editable Miro objects** — not a
screenshot. Shapes (or AWS/GCP/Azure icons) from components, connectors from
connections, titled white zones from boundaries.
## Prerequisites
- **archify** available (the [archify](https://github.com/tt-a1i/archify) skill),
or an existing archify `*.architecture.json` IR.
- A **connected Miro MCP** (`/mcp` → authenticate `claude.ai Miro`).
- Node ≥ 18 for the bundled converter.
## Workflow
1. **Get the IR.** Use archify to produce and validate an `*.architecture.json`
(components, connections, boundaries, with geometry), or use one supplied.
2. **Build the board plan:**
```
node bin/ir-to-miro.mjs <ir.architecture.json> --iconset <none|aws|gcp|azure|custom>
```
Emits frames, nodes (x/y/w/h, type, label, sublabel, and `icon` when an icon
set is chosen), and connectors (label, style, emphasis).
3. **Create the board.** Confirm the name with the user first, then `board_create`
(`invocation_source: "skill"`). Keep the returned board URL.
4. **Materialize — ORDER MATTERS (see Rendering rules):**
1. **Frames + title first.** `layout_create` the boundary frames (`fill=#ffffff`
for white zones) plus a title/subtitle TEXT. Frames MUST be created before
any node — Miro has no API "send to back", so later items render on top.
2. **Nodes on top.**
- `iconset: none` → a `SHAPE` per node (`layout_create`), typed shape/colour.
- `iconset