GitHub renders mermaid client-side and many previewers do not, so the flowchart showed as a code block. Commit the rendered SVG (safe, no scripts) and keep the mermaid source as an HTML comment for editing.
