graphviz-docs-compilerlisted

> Relies on BDK foundation (STARTUP_INSTRUCTIONS.md). Assumes environment discovery has already run (language, test runner, build tool are known). # Graphviz Docs Compiler Compile Graphviz diagrams in docs — converts `.dot` files to SVG, updates markdown references in-place. **Argument:** path to docs dir or `.md` file (`$ARGUMENTS`). Defaults to `docs/`. Use `$ARGUMENTS` as target path passed to `compile_diagrams.py`. ## Prerequisites `dot` must be in PATH. Script calls it directly via subprocess. ```bash # macOS brew install graphviz # Ubuntu/Debian sudo apt-get install graphviz # Verify installation dot -V ``` ## Quick Start Three modes: ```bash # Forward mode: Compile existing .dot files to SVG uv run python skills/graphviz-docs-compiler/scripts/compile_diagrams.py docs/ # Reverse mode: Extract diagrams from markdown to .dot files uv run python skills/graphviz-docs-compiler/scripts/compile_diagrams.py docs/ --mode reverse # Both mode: Extract from markdown, then compile all (recommended) uv run python skills/graphviz-docs-compiler/scripts/compile_diagrams.py docs/ --mode both ``` - **Forward**: `.dot` files → SVG → update markdown refs - **Reverse**: markdown code blocks → `.dot` files → SVG → update refs - **Both**: Reverse + Forward (extract all, compile all) ## File Organization ``` docs/ ├── module_name.md # Main documentation file └── module_name/ ├── diagrams/ │ ├── architecture.dot # Source Graphviz files │ ├── dataf