Platica, Luego Construye
Si abres Claude Code y te pones a construir directo, ya la regaste. Hay 3 cosas que tienes que hacer ANTES de tocar la primera línea de código — y la mayoría se las brinca. Aquí te las explico nivel principiante con analogías, y nivel experto con la teoría detrás. El trabajo pesado lo hace El Arquitecto, una herramienta gratis open source.
La herramienta del workflow
El Arquitecto es un repo open source que convierte a Claude Code en un meta-agente de planeación. Lo clonas dentro del folder de plática y te genera un blueprint de 16 secciones listo para que otro Claude Code lo construya sin preguntarte nada.
00 la regla de oro
No es el modelo, es el prompt
Si abres Claude Code y te pones a construir directo, ya la regaste. La diferencia entre una app que sale bien y una que sale rota no está en el modelo — está en lo que haces ANTES de escribir la primera línea de código.
Como dijo Toretto: no es el carro, es el conductor. Aplicado a Claude Code: no es Opus, no es Sonnet, no es Haiku — es tu prompt y tu estructura. Buen prompt + plan claro = Claude te construye lo que quieras. Prompt flojo + improvisación = horas debuggeando lo que él mismo escribió mal.
Las 3 prácticas en orden
- Empieza por la app — si apenas vas iniciando, déjate de la terminal por ahora.
- Platica antes de construir — folder “platica”, modelos chicos, El Arquitecto, exporta el plan.
- Construye en limpio — folder nuevo, Claude Code limpio, métele el plan y déjalo trabajar.
El resto de la guía explica cada paso a profundidad. Si eres principiante, vas a entender cada analogía. Si ya llevas tiempo construyendo con Claude, vas a ver por qué este workflow ahorra tokens, tiempo y dolores de cabeza — sin importar el tamaño del proyecto.
01 práctica 1
Si apenas empiezas, usa la app — no la terminal
La terminal asusta. Y no tiene por qué — pero al inicio te quita energía que necesitas para aprender lo que sí importa: cómo darle instrucciones a Claude. La app de Claude ya quedó increíble: tiene ventana de chat, drag-and-drop de archivos, modo plan, todo lo que necesitas para construir igual de bien que en la terminal.
✅ Quédate en la app si…
- • Es tu primer mes con Claude.
- • No estás cómodo escribiendo comandos.
- • Tu proyecto es una landing, una app simple, contenido o análisis.
- • Quieres ver el progreso visualmente, no en líneas de log.
🔧 Pásate a la terminal cuando…
- • Ya le agarraste la onda a la app.
- • Necesitas correr scripts, hooks o Cron Jobs en background.
- • Vas a usar plugins comunitarios o MCPs avanzados.
- • Quieres orquestar varios agentes en paralelo con
/loopo subagentes.
Analogía nivel principiante
Es como manejar carro. Empiezas en automático para aprender a sentir el camino. Cuando ya manejas dormido, te pasas al estándar — pero nadie aprende a manejar en estándar y subiendo una loma a la vez. Lo mismo con Claude: app primero, terminal después.
Recursos para arrancar bien
Guías ya hechas en la bóveda — instalación y primeros pasos.
02 práctica 2
Platica primero — con El Arquitecto
Aquí está el corazón del workflow. No abras Claude Code en el folder donde vas a construir. Crea un folder aparte que se llame platica, y úsalo solo para peletear la idea. Cuando ya esté el plan listo, lo exportas y te mueves al folder real.
¿Por qué un folder aparte?
Porque cuando platicas, dices cosas que después estorban. Probás ideas, las descartas, cambias de opinión. Si construyes en el mismo folder, Claude arrastra todo ese ruido. Folder limpio = ejecución limpia.
Paso 1 — Crea el folder y abre Claude Code ahí
macOS / Linux
mkdir ~/Desktop/platica && cd ~/Desktop/platica && claudeWindows (PowerShell)
mkdir $HOME/Desktop/platica; cd $HOME/Desktop/platica; claudePaso 2 — Cambia al modelo chico (Haiku o Sonnet 4.5)
Para platicar no necesitas Opus. Estás peloteando ideas, no construyendo arquitectura nuclear. Haiku 4.5 piensa rapidísimo y casi no te quema tokens. Sonnet 4.5 si quieres un poco más de profundidad. Opus déjalo para construir.
Cambiar de modelo dentro de Claude Code
/model haikuSi Claude empieza a sentirse lento o impreciso durante el peloteo, sube a Sonnet con /model sonnet. No abuses de Opus aquí.
Paso 3 — Instala El Arquitecto
El Arquitecto es una herramienta gratis que te hace las preguntas correctas y te genera un blueprint listo para construir. Lo clonas dentro del folder platica:
Clonar el repo de El Arquitecto
git clone https://github.com/Hainrixz/the-architect.gitUna vez clonado, Claude Code lee automáticamente el CLAUDE.md de El Arquitecto y entra en modo arquitecto.
Paso 4 — Pelotea la idea
Prompt para arrancar la conversación
Usa esta plantilla para que El Arquitecto entienda qué quieres y para quién.
Hola Arquitecto. Quiero construir [DESCRIBE TU IDEA EN 2-3 FRASES]. Mi público objetivo es [PARA QUIÉN]. La intención es [POR QUÉ LO QUIERES]. Mi nivel técnico es [PRINCIPIANTE / INTERMEDIO / EXPERTO]. Hazme las preguntas que necesites para clasificar el archetype y empezar el deep dive. No asumas nada — pregúntame lo que falte.
Paso 5 — Exporta el plan
Cuando ya pasaste por las 4 fases (Discovery → Deep Dive → Architecture → Generate), pídele que te genere el blueprint completo:
Prompt para exportar el blueprint
Pídele las 16 secciones del blueprint listas para construir en otro folder.
Perfecto, ya cubrimos discovery, deep dive y architecture. Genera el blueprint final completo. Quiero el archivo .md con las 16 secciones: 1. Vision & Success Metrics 2. Tech Stack + Rationale 3. Directory Structure 4. Data Models / SQL Schemas 5. API Endpoints 6. Frontend Components 7. Design System (colors, fonts, spacing) 8. Auth & Permissions 9. Environment Variables 10. Deployment 11. Testing Strategy 12. Build Order (paso a paso) 13. Edge Cases & Errors 14. Performance Considerations 15. Future Improvements 16. Glossary Guárdalo como blueprint.md en este folder. Que esté lo suficientemente claro para que un Claude Code en sesión limpia pueda construirlo sin preguntarme nada.
03 práctica 3
Construye en sesión limpia
Llegó el momento que importa. Folder nuevo, Claude Code limpio, plan adentro. Sin arrastrar nada de la conversación previa. Por eso sale bien.
Paso 1 — Copia el blueprint a un folder nuevo
Crea el folder donde vivirá tu proyecto y mueve solo el blueprint.md que generaste:
macOS / Linux
mkdir ~/Desktop/mi-proyecto && cp ~/Desktop/platica/blueprint.md ~/Desktop/mi-proyecto/Windows (PowerShell)
mkdir $HOME/Desktop/mi-proyecto; cp $HOME/Desktop/platica/blueprint.md $HOME/Desktop/mi-proyecto/Paso 2 — Abre Claude Code en el folder nuevo
Sesión limpia, modelo bueno
cd ~/Desktop/mi-proyecto && claude --model opusPara construir sí usas Opus. Es el que mejor sigue planes largos sin perder el hilo. Si tu plan es chico, Sonnet 4.5 también lo hace bien. Haiku para construir solo si es algo muy simple.
Paso 3 — Métele el plan y déjalo trabajar
Prompt para arrancar la construcción
Plantilla que le dice a Claude qué leer y cómo proceder. Sin ambigüedad.
Aquí está el blueprint que generé con El Arquitecto. Está en blueprint.md dentro de este folder. Léelo completo primero. Después constrúyelo paso a paso siguiendo la sección "Build Order". No te brinques pasos, no preguntes lo que ya está respondido en el blueprint, y no añadas features que no estén ahí. Si encuentras una decisión técnica que el blueprint no cubre, pregúntame antes de improvisar. Empieza con el setup inicial del proyecto.
Tip de oro
Si el blueprint dice “Build Order: 1) setup → 2) DB → 3) auth → …”, no le digas a Claude “hazlo todo ya”. Pídele que ejecute paso por paso y te muestre el resultado de cada uno. Así, si algo se rompe, sabes exactamente en qué paso fue — y puedes corregir solo eso, no toda la app.
Lo que NO debes hacer aquí
- ❌ No abras este Claude Code en el folder “platica” — arrastrarías el ruido de la conversación anterior.
- ❌ No le pidas que “mejore el plan” antes de construir — el plan ya pasó por El Arquitecto. Si quieres cambios, regresa al folder de plática y replantéalo.
- ❌ No le metas features extra a media construcción — termina lo del blueprint, valida que funcione, y luego itera.
04 la teoría
Por qué separar plática de construcción funciona
Esta separación parece de más — “¿por qué dos folders si puedo hacer todo en uno?” — pero es la diferencia entre que Claude te construya algo coherente o que te entregue un Frankenstein de ideas a medias.
🧒 Nivel principiante
Imagínate que estás construyendo una casa. Primero hablas con el arquitecto: dibujan los planos, deciden cuántos cuartos, dónde van las ventanas, qué materiales. Cuando los planos están listos, los llevas al maestro de obra. El maestro no te pregunta otra vez “¿quieres ventanas?” — solo construye lo que dicen los planos.
Si el arquitecto y el maestro fueran la misma persona — y trabajaran al mismo tiempo —, te empezarían a poner cimientos mientras todavía discuten el color del baño. Sale un desastre.
Eso es lo que pasa cuando platicas y construyes en la misma sesión de Claude Code.
🧠 Nivel experto
- • Contaminación de contexto. Toda la conversación de discovery (preguntas, hipótesis descartadas, branches mentales) queda en la ventana. Cuando Claude empieza a construir, sigue sopesando esas alternativas y termina mezclando decisiones que ya rechazaste.
- • Modelo equivocado para la fase equivocada. Platicar con Opus quema tokens sin razón. Construir con Haiku te da código pobre. Separar las fases te deja elegir el modelo correcto para cada una (Haiku/Sonnet pa' pelotear, Opus pa' construir).
- • Plan Mode no resuelve esto. Plan Mode te ayuda a planear UNA tarea, pero no te aísla del ruido del peloteo previo. La separación de folders es ortogonal a Plan Mode — y se complementan: usas Plan Mode dentro de la sesión de construcción para tareas concretas, no para diseñar la arquitectura desde cero.
- • Determinismo del prompt. Un blueprint exportado es determinístico: lo puedes pasar a otro Claude Code, a otro equipo, a otro humano. Una conversación no — vive solo en tu ventana.
La regla mental para acordarte
Plática = explorar. Construcción = ejecutar. Son dos modos del cerebro distintos, y Claude funciona igual: no le pidas que explore y ejecute al mismo tiempo. Le das uno, terminas, y le das el otro.
05 la herramienta
El Arquitecto, por dentro
El Arquitecto es un repo open source que convierte a Claude Code en un meta-agente de diseño de software. No escribe código — diseña el plano para que otro Claude Code lo escriba bien. Es la diferencia entre “hazme una app” y “construye exactamente este blueprint de 16 secciones”.
Las 4 fases del Arquitecto
01
Discovery
2-3 preguntas iniciales para entender el alcance y clasificar tu proyecto en uno de los 6 archetypes.
02
Deep Dive
Preguntas específicas según el archetype, mientras El Arquitecto investiga best practices con /deep-research.
03
Architecture
Te propone un tech stack completo con explicaciones. Tú confirmas o le dices qué cambiar.
04
Generate
Te genera el blueprint final — un .md de 16 secciones listo para construir.
Los 6 archetypes que reconoce
El Arquitecto no te trata igual si vas a hacer una landing que si vas a hacer un SaaS. Por eso clasifica primero, y después aplica las preguntas y el stack correctos para tu tipo de proyecto.
SaaS App
auth, billing, dashboard, multi-tenant
Marketing Site
landing, blog, SEO, formularios
Mobile App
iOS / Android / cross-platform
API / Backend
REST, GraphQL, microservicios
Internal Tool
dashboards, admin panels, CRMs
Content Platform
CMS, comunidad, marketplace
Las 16 secciones del blueprint
El output final es un blueprint.md con todo lo que Claude Code necesita para construir sin adivinanzas:
- Vision & Success Metrics
- Tech Stack + Rationale
- Directory Structure
- Data Models / SQL Schemas
- API Endpoints
- Frontend Components
- Design System (colors, fonts, spacing)
- Auth & Permissions
- Environment Variables
- Deployment
- Testing Strategy
- Build Order (paso a paso)
- Edge Cases & Errors
- Performance Considerations
- Future Improvements
- Glossary
La sección Build Order es la más importante: dicta el orden exacto en el que Claude debe construir. Sin ella, te empieza por el frontend y se traba cuando llega a la base de datos.
Modo Fast-Track
Si no quieres responder muchas preguntas, El Arquitecto tiene un modo “Fast-Track”: asume defaults inteligentes según tu archetype y te genera el blueprint en menos de 5 minutos. Bueno para MVPs y prototipos, no tanto para apps de producción.
Hainrixz/the-architect
Open source · MIT License
06 cierre
No es el carro, es el conductor
Acuérdate de la regla. No es el modelo, es el prompt. Como dijo Toretto, no es el carro, es el conductor. Buen prompt, buena estructura, te sale lo que quieras — sin importar si usas Haiku, Sonnet u Opus.
El resumen del workflow
- App primero si apenas empiezas. Terminal cuando ya le agarres la onda.
- Folder “platica” con Haiku/Sonnet 4.5 + El Arquitecto → exporta blueprint.
- Folder nuevo con Claude Code limpio + Opus → métele el blueprint y déjalo construir.
¿Qué sigue?
Si esto te sirvió, compártelo con alguien que apenas está empezando con Claude — los principiantes son los que más sufren cuando se saltan estos tres pasos. Y si ya construyes a diario, prueba el workflow una semana y dime si tu plan te dura más.
Una última cosa — la mentalidad
La gente que falla con Claude no falla por usar el modelo equivocado. Falla por querer hacer todo de una. Estructura primero, ejecución después. Plática primero, construcción después. Si te acuerdas de eso, ya ganaste la mitad.