Validate Mermaid diagrams render correctly before shipping. Open the HTML
artifact in a browser and check every diagram visually — syntax errors show
as broken renders, not error messages.
See
resources/mermaid-authoring.md
for the full authoring rules (quoting,
line breaks, reserved words, themes).
Check that relative links between pages resolve. When building a multi-page
artifact or KB, broken cross-references silently rot — verify each link
target exists before committing.