mirror of
https://github.com/bmadcode/BMAD-METHOD.git
synced 2025-12-29 16:14:59 +00:00
38 lines
1.1 KiB
Markdown
38 lines
1.1 KiB
Markdown
|
# Workflow Diagram Maintenance
|
||
|
|
|
||
|
|
## Regenerating SVG from Excalidraw
|
||
|
|
|
||
|
|
When you edit `workflow-method-greenfield.excalidraw`, regenerate the SVG:
|
||
|
|
|
||
|
|
1. Open https://excalidraw.com/
|
||
|
|
2. Load the `.excalidraw` file
|
||
|
|
3. Click menu (☰) → Export image → SVG
|
||
|
|
4. **Set "Scale" to 1x** (default is 2x)
|
||
|
|
5. Click "Export"
|
||
|
|
6. Save as `workflow-method-greenfield.svg`
|
||
|
|
7. **Validate the changes** (see below)
|
||
|
|
8. Commit both files together
|
||
|
|
|
||
|
|
**Important:**
|
||
|
|
|
||
|
|
- Always use **1x scale** to maintain consistent dimensions
|
||
|
|
- Automated export tools (`excalidraw-to-svg`) are broken - use manual export only
|
||
|
|
|
||
|
|
## Visual Validation
|
||
|
|
|
||
|
|
After regenerating the SVG, validate that it renders correctly:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
./tools/validate-svg-changes.sh src/modules/bmm/docs/images/workflow-method-greenfield.svg
|
||
|
|
```
|
||
|
|
|
||
|
|
This script:
|
||
|
|
|
||
|
|
- Checks for required dependencies (Playwright, ImageMagick)
|
||
|
|
- Installs Playwright locally if needed (no package.json pollution)
|
||
|
|
- Renders old vs new SVG using browser-accurate rendering
|
||
|
|
- Compares pixel-by-pixel and generates a diff image
|
||
|
|
- Outputs a prompt for AI visual analysis (paste into Gemini/Claude)
|
||
|
|
|
||
|
|
**Threshold**: <0.01% difference is acceptable (anti-aliasing variations)
|