Markdown Mermaid Writing

This codifies a strong opinion: structure and relationships should live as Mermaid diagrams in markdown files, not as images or Python plots. You get 24 diagram types, from flowcharts and sequence diagrams to Sankey and packet diagrams, plus templates for common docs like ADRs and research papers. The bet is that text-based diagrams diff cleanly in git, render natively on GitHub and Notion, use fewer tokens than prose, and stay editable without regeneration. Phase 1 is always Mermaid. Phase 2 (Python charts) and Phase 3 (polished visuals) are optional downstream steps. If you're writing scientific documentation or architectural diagrams and want a version-control-first workflow, this gives you the references and templates to make Mermaid your default.