01Arranco por el primer paso y agrego de a uno
No dejo que la IA me llene el mapa sola. La primera vez lo hizo y lo tuve que borrar completo.
01
Por qué un diagrama
Un párrafo se lee de mil formas
Cuando le pedía algo grande en un mensaje largo, cada agente entendía una cosa distinta y yo me iba el día dándole feedback.
Lo que me pasó
Le pedí una interfaz para editar con IA y se me estaba volviendo otro CapCut. Me tocó frenar y empezar de nuevo, esta vez con el mapa.
Lo que cambió
Le dejo de una vez las pantallas, los flujos y las APIs que tiene que consumir. La velocidad de desarrollo me subió hasta 10 veces y hoy llevo varios proyectos de clientes al mismo tiempo.
02
Cómo se lee
Cuatro reglas. Con eso el agente ya no adivina.
Cada caja es un paso
Una acción concreta, dicha como la viviría el usuario: «subes tus tomas», «te avisa cuánto va a tardar».
Cada rombo es una decisión
De ahí salen los caminos. Y cuando algo falla, una flecha vuelve atrás: ese camino es el que casi nadie dibuja.
Los colores dicen quién hace cada cosa
yo, la app sola y la IA. Así se ve de un vistazo dónde se gastan tokens y dónde espera a una persona.
Al lado de cada paso, un mockup
Un dibujo de cómo se ve esa pantalla, anclado a su caja. Es lo que más le ahorra preguntas al agente.
03
El orden en que lo armo
02En cada paso le pido su opinión
Si lo aprueba, si lo cambiaría o qué le falta. Muchas de las mejores decisiones del mapa salieron de esa conversación.
03Primero la decisión que cambia todo
En mi caso, si el usuario va paso a paso o deja que un agente edite el video completo. Recorro una rama hasta el final antes de abrir la otra.
04Cuando un paso no se entiende, le pongo la pantalla al lado
Si tengo que explicarlo con palabras, va mockup.
05El diagrama manda
Se lo paso al agente que construye y él reparte el trabajo entre varios agentes al mismo tiempo. Si algo de lo construido se aparta del mapa, se corrige primero en el diagrama.
04
Las skills y herramientas que usé
Claude Code
Ahí armo el diagrama conversando, paso por paso, y ahí mismo vive el proyecto que se va a construir.
Artifacts de Claude
El diagrama es una página privada que se actualiza en el mismo link cada vez que cambiamos algo. La reviso hasta desde el celular.
Mermaid
Un lenguaje para escribir diagramas en texto: cajas, rombos y flechas. La IA lo escribe y lo corrige sin que yo dibuje nada.
Subagentes
Con el mapa listo, el agente principal reparte las ramas entre varios agentes que trabajan en paralelo, y otro revisa lo que hicieron sin haberlo escrito.
05
Lo que no se ve, y es lo difícil
Dibujar cajas es fácil. Esto es lo que define si el mapa sirve o es solo un dibujo bonito.
Qué se pregunta y qué no
Cada pregunta de más es fricción para el usuario. Solo entra lo que de verdad cambia el resultado.
Los caminos de error
Qué pasa si el computador se duerme, si se acaba el cupo de la IA o si una pieza falla a mitad de camino.
Repartir sin que se pisen
Qué agente toca qué parte, para que el trabajo en paralelo no termine en archivos rotos.
Que lo construido no se aparte
El agente siempre quiere adelantarse. Hay que revisar contra el mapa, no contra lo que uno recuerda.
¿Lo armamos para tu proyecto?
En una consultoría 1 a 1 traes tu idea y la bajamos juntos a un diagrama, con sus pantallas y cómo pasárselo a tus agentes para que lo construyan. Escríbeme y lo hablamos.