Better hinting that mermaid diagrams should be treated as files?

[robfromboulder]

Currently in testing you have to say "generate a mermaid diagram file" or Claude may show you the syntax for the mermaid diagram instead of rendering it inline so it's easy to view