Documentation review and data consistency.

.claude/commands/word-generation.md

@@ -70,8 +70,18 @@ npm install @mermaid-js/mermaid-cli
 - **Color replacement**: Both `fill` and `stroke` attributes are replaced for colors `#ECECFF` and `#FFF4DD` (default Mermaid bar colors).
 - **Config file**: `mermaid.config.json` in root directory sets the base theme for all diagrams.
 
-### Error Handling
-
-- If `generate_mermaid_figures.py` fails: Check mmdc (mermaid-cli) is installed
-- If `apply_content.py` fails: Check beautifulsoup4 is installed
-- Report any errors with the specific step that failed
+### Error Handling
+
+- If `generate_mermaid_figures.py` fails: Check mmdc (mermaid-cli) is installed
+- If `apply_content.py` fails: Check beautifulsoup4 is installed
+- Report any errors with the specific step that failed
+
+### Observed Issues (Local)
+
+- `generate_mermaid_figures.py` may fail on macOS with errors like:
+  - `Running as root without --no-sandbox is not supported`
+  - `Failed to launch the browser process` / `MachPortRendezvousServer` permission errors
+- If that happens, verify the Puppeteer config in `tem/scripts/puppeteer_config.json` is picked up by `generate_mermaid_figures.py` and includes:
+  - `"args": ["--no-sandbox", "--disable-setuid-sandbox"]`
+  - `"executablePath"` pointing to the local Chrome binary, e.g. `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`
+- If the error persists, rerun Step 1 with escalated permissions.