01 Por qué separar conversación y construcción
Cuando diseñas y programas en la misma sesión, todo lo que dijiste mientras pensabas se queda en el contexto: ideas descartadas, cambios de opinión, preguntas abiertas que nunca cerraste. Al empezar a construir, Claude sigue arrastrando ese ruido y mezcla decisiones que ya habías rechazado. Además, gastas el modelo más caro en una fase que no lo necesita.
La solución es tratar el proyecto como lo haría un estudio de arquitectura: primero los planos, después la obra, y con equipos distintos. En Claude Code eso se traduce en dos carpetas y dos sesiones.
| Fase de diseño | Fase de construcción | |
|---|---|---|
| Objetivo | Explorar, decidir, dejarlo por escrito | Ejecutar el plan sin improvisar |
| Carpeta | Una de trabajo, por ejemplo diseno-proyecto | Una nueva, solo con el plano |
| Modelo | Sonnet o Haiku: rápido y barato | Opus (o Sonnet si el plan es pequeño) |
| Resultado | Un plano en Markdown | El proyecto funcionando y verificado |
02 Antes de empezar: ¿app o terminal?
Si estás empezando, usa Claude Code desde la pestaña Code de la app de escritorio: eliges la carpeta con un clic, ves los cambios de forma visual y tienes el mismo modo plan. La terminal compensa cuando necesitas scripts, tareas programadas, varias sesiones en paralelo o automatizaciones. El flujo de esta guía funciona igual en ambas.
03 Fase 1: diseña en una carpeta aparte
-
1
Crea la carpeta de diseño
Una carpeta vacía solo para conversar sobre el proyecto. Nada de código aquí.
-
2
Elige un modelo ligero
Para hacer preguntas y comparar opciones no necesitas el modelo más potente. Cambia con /model sonnet (o /model haiku si quieres gastar aún menos).
-
3
Instala The Architect
Es un plugin que no programa: te entrevista, elige el stack, comprueba versiones y escribe un plano autocontenido.
-
4
Haz la entrevista
Usa /architect-quick si ya sabes el stack o el proyecto es pequeño (tres preguntas), o /architect para un proyecto serio (entre 12 y 16 preguntas).
-
5
Revisa el plano
Se guarda en ./blueprints/. Léelo entero: si algo no te encaja, corrígelo aquí, no durante la construcción.
/plugin marketplace add Hainrixz/the-architect
/plugin install the-architect@soyenriquerocha/architect Quiero construir [describe la idea en dos o tres frases]. Es para [quién lo va a usar] y lo necesito porque [objetivo de negocio]. Mi nivel técnico es [principiante / intermedio / avanzado]. Restricciones: [presupuesto, alojamiento, plazos, datos personales]. Pregúntame todo lo que falte; no rellenes huecos con suposiciones.04 Fase 2: construye en una sesión limpia
-
1
Crea la carpeta del proyecto
Una carpeta nueva donde vivirá el código. Copia dentro solo el plano generado.
-
2
Abre una sesión nueva ahí
Sin historial previo: el plano debe bastar por sí solo. Si te ves explicando cosas que no están en él, vuelve a la fase de diseño.
-
3
Usa el modelo más capaz
Para seguir un plan largo sin perder el hilo, arranca con Opus. Para proyectos pequeños, Sonnet suele bastar.
-
4
Construye por pasos
Pide que siga el orden de construcción del plano y se detenga tras cada paso con su verificación. Si algo falla, sabrás exactamente dónde.
mkdir ~/proyectos/reservas-clinica
cp -r ~/proyectos/diseno-reservas/blueprints ~/proyectos/reservas-clinica/
cd ~/proyectos/reservas-clinica
claude --model opusEn ./blueprints/ tienes el plano completo de este proyecto. Léelo entero antes de empezar. Después ejecuta el orden de construcción paso a paso: al terminar cada paso, ejecuta su comando de verificación, enséñame el resultado y espera mi confirmación. No añadas funciones que no estén en el plano. Si encuentras una decisión que el plano no cubre, para y pregúntame en lugar de improvisar.05 Errores que estropean el flujo
- ✓Construir en la carpeta de diseño: arrastras todo el ruido de la conversación.
- ✓Pedir en la sesión de construcción que «mejore el plan»: si hay que cambiarlo, se cambia en la fase de diseño y se exporta de nuevo.
- ✓Añadir funciones a mitad de la obra: termina lo del plano, valida y luego itera.
- ✓Pedir «hazlo todo de una vez»: pierdes la capacidad de saber qué paso rompió qué.
- ✓Usar el modelo más caro para conversar y el más barato para construir: es justo al revés.
06 Si no quieres instalar nada
El principio funciona sin The Architect. Usa el modo plan para la conversación inicial y pide al final un documento Markdown con visión, stack, modelo de datos, variables de entorno, orden de construcción con criterios de aceptación y riesgos. Guárdalo como archivo, ejecuta /clear o abre una sesión nueva en la carpeta del proyecto y construye desde ese documento. Lo importante no es la herramienta, sino que el plan quede por escrito y la construcción empiece sin ruido.
Preguntas frecuentes
El modo plan sirve para planificar una tarea dentro de una sesión, pero no limpia el contexto de la conversación previa. Separar carpetas y sesiones es complementario: diseñas fuera y, dentro de la construcción, puedes usar el modo plan para pasos concretos.
Uno rápido (Sonnet o Haiku) para conversar y el más capaz que tengas (Opus) para construir planes largos. Con /model cambias en cualquier momento.
Sí, con /architect-quick o con un plan corto en Markdown. Incluso una landing sale mejor si antes has decidido estructura, textos y formulario.
Sí, y es una de sus ventajas: un plano escrito es reutilizable por otro desarrollador, otro equipo o una sesión automática, mientras que una conversación solo vive en tu ventana.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.