Cómo uso Mermaid para comunicarme con producto, arquitecturar con devs y documentar todo al mismo tiempo

Hay un momento en la carrera de casi todo desarrollador en el que te das cuenta de que el código ya no es el problema más difícil. El problema más difícil es explicarle a alguien de producto por qué el sistema funciona como funciona, o por qué un cambio que parece sencillo en realidad tiene diez implicaciones que no se ven a simple vista. Durante mucho tiempo, mis herramientas para eso eran las mismas de siempre: una pizarra, una presentación armada de prisa, o en el mejor caso, un diagrama en draw.io que tardaba más en hacerse que en volverse obsoleto. El problema con esas herramientas no es que sean malas — es que viven desconectadas del código, del repositorio y de la realidad del sistema. En cuanto algo cambia, el diagrama miente. Hasta que vi algo que cambió mi forma de trabajar. La revelación: código que genera diagramas Fue mi jefe quien me mostró por primera vez lo que Mermaid podía hacer. Había construido un script en Python que leía el esquema de la base de datos y generaba a