Mermaid diagrams are even better because you don't waste characters on the visual representation but rather the relationships between them. It's the difference between
graph TD
User -->|Enters Credentials| Frontend[React App]
Frontend -->|POST /auth| API[NodeJS Service]
API -->|Query| DB[(PostgreSQL)]
API --x|Invalid| Frontend
DB -->|User Object| API
API -->|JWT| Frontend
LLMs nowadays can understand png diagrams too.
But not all CLIs handle pngs as easily as a text diagram. Syncing images is also multiple times slower.
png diagrams should never be the default.
They can’t update it though. In docs it makes sense to use that as a basis and have the Llm update it when needed
Mermaid diagrams are even better because you don't waste characters on the visual representation but rather the relationships between them. It's the difference between
and
Plus while an LLM can understand relationships via pure ASCII or an image, it's just easier to give it the relationship data directly.
3 replies →
more tokens, less reliable, dont work in all CLI agent harnesses