dsh-maestro-diagram

Architecture diagrams are rarely hard to produce but hard to keep honest: styles drift, edges go stale relative to the code, and reviewers have no objective way to verify correctness. dsh-maestro-diagram tackles exactly that gap by treating GitHub-native Mermaid as the single source of truth and layering deterministic verification and drift detection on top, so every diagram can prove its own compliance instead of relying on the subjective call of a model.

The plugin exposes three capabilities. mermaid_verify performs line-by-line syntax and anti-pattern checks on Mermaid blocks (legacy graph syntax, shadow nodes, and similar issues), returning structured errors and warnings. mermaid_drift cross-references diagram entities against the codebase, surfacing nodes that exist in the diagram but not in code and vice versa, with a readable summary. For client-facing deliverables, an editorial HTML+SVG export enforces density and accent-color discipline (density 4/10, one to two accents) and produces a self-contained file with zero JavaScript.

It is built for staff- and senior-level engineers who maintain architecture documentation in GitHub repos, technical writers who need repeatable diagram output, and solo developers who want a diagrams-as-documentation workflow that holds up under peer review.