prompt分享写md文档时候多用图表

agent写md文档的时候不太主动用图表，会导致整个叙事不适合人看，特别是复杂流程和进度的时候，加上这个会好很多大伙试试，有用记得给个心心。

## Visual Documentation First



**Show, don't just tell. Use Diagram-as-Code to reduce cognitive load.**



- **Diagrams over text:** If explaining a flow, architecture, or dependency takes more than 3 paragraphs, draw a diagram instead.

- **Choose the right tool:**

  - `mermaid` (Default): Flowcharts, sequences, simple state machines.

  - `d2`: High-level system architecture, modern network topologies.

  - `plantuml`: Strict UML, C4 models.

  - `dot`: Dense dependency trees, code-level call graphs.

- **Progressive disclosure:** Start macro, then go micro. If a diagram becomes a massive "spiderweb", split it into one high-level map + targeted sub-diagrams.

- **Anchor to reality:** Always map abstract concepts in your diagrams to actual code artifacts (e.g., mention `src/router.ts` or `users` table directly in/around the diagram).