devops-network-diagramlisted
Install: claude install-skill th3r-dev/th3-skills
# devops-network-diagram
The team keeps **every version on one draw.io page**, one board per page tile (`pageWidth` ×
`pageHeight`, e.g. A2 landscape 2336 × 1654 px): Non-prod 1.1.3 beside Prod 1.1.5, then 1.1.6 and
1.1.7 stacked under it. A board is the tile that holds a `Version x.y.z Update dd/mm/yyyy` label,
and its title is the text ending with `System Diagram` (`--title-suffix` to change).
That layout is why a plain `draw.io -x -f pdf` is wrong: it prints every tile, blank ones included.
Everything below goes through one script that understands boards:
```bash
B="uv run skills/devops/network-diagram/scripts/drawio_board.py"
$B list <file.drawio> # boards: tile, version, date, cells, title
$B clone <file.drawio> --from 1.1.7 --version 1.1.8 --date 06/11/2026 # draft board, in place, .bak kept
$B export <file.drawio> --version 1.1.8 [--out DIR] [--name "{title} {env} {version} - {ddmmyy}"] [--title "…"]
$B trace <final.pdf> --out X.drawio [--assign X,Y=slug] # PDF -> editable drawio (source lost)
$B compare <final.pdf> <candidate.pdf> [--no-image-check] [--diff-png d.png] # benchmark, exit 1 on FAIL
$B --env-map "Production=Prd,Non Production=Uat" export … # global options go before the subcommand
```
Needs the draw.io desktop app (`/Applications/draw.io.app`, or `drawio` on PATH). Output defaults to
`./diagram-out/` — keep diagrams out of the skills repo.
## Get the source
The team `.drawio`