El Harness: por qué la spec y la arquitectura no son suficientes
Mi workflow completo: de idea a producto en producción con IA
Hace un año tardaba 2-3 semanas en tener algo desplegado desde una idea nueva.
Hoy tardo 2-3 días.
No porque use mejores modelos. Porque cambié el workflow.
Acá está el proceso completo, sin omitir nada.
Fase 1 — Captura (30 minutos)
Antes de abrir el editor, abro un documento en blanco y respondo tres preguntas:
- ¿Qué problema concreto resuelve esto?
- ¿Quién lo va a usar y en qué contexto exacto?
- ¿Qué tiene que funcionar sí o sí para que sea útil desde el día uno?
Solo eso. Sin pensar en tech stack. Sin pensar en arquitectura.
Si no puedo responder las tres en 30 minutos, la idea no está lista para construirse.
Fase 2 — Spec (1-2 horas)
Con las respuestas anteriores, genero la spec técnica.
La spec tiene 6 secciones: Visión, Usuarios, Funcionalidades, Flujos, Arquitectura y NFRs.
No la escribo yo desde cero. La genero con un agente que toma mis respuestas de la Fase 1 como input.
Luego la reviso y ajusto lo que el agente asumió mal.
El output: un documento de 2-3 páginas que define qué se construye, para quién, y cómo debe comportarse.
Fase 3 — Plan técnico (30 minutos)
Con la spec lista, otro agente genera el plan de implementación.
No “empieza a codear”. Define:
- Las fases del proyecto en orden
- Qué necesita estar listo antes de cada fase
- Los riesgos técnicos por módulo
Reviso el plan. Lo ajusto si algo no tiene sentido. Firma.
Fase 4 — Implementación (el grueso)
Aquí entra Claude Code.
No le doy el prompt “hazme la app”. Le doy la spec + el plan + el task específico a implementar en esa sesión.
Un task. Una sesión. Un output verificable.
Si el task es “implementar autenticación con GitHub OAuth”, eso es todo lo que hace esa sesión.
Al final de cada sesión, verifico que lo que se construyó cumple el criterio de aceptación de la spec.
Si no lo cumple, corrijo antes de avanzar. No acumulo deuda de contexto.
Fase 5 — Deploy y validación (1-2 horas)
Deploy con el stack que use el proyecto (Railway, Vercel, Supabase).
Luego muestro el producto a 2-3 personas del perfil objetivo y les hago una sola pregunta:
“¿Qué haría que esto fuera indispensable para ti?”
No “¿te gusta?” ni “¿qué mejorarías?”.
Esa pregunta específica te da el siguiente ciclo de iteración o te dice que pivotes.
Lo que hace que este workflow funcione no es la IA.
Es que la IA nunca opera sin contexto estructurado.
Cada agente recibe exactamente lo que necesita para hacer su parte. Nada más. Nada menos.
Sin eso, la IA improvisa. Y cuando improvisa, construye lo que interpreta, no lo que necesitas.
Si quieres ver este workflow ejecutado en vivo sobre un proyecto real — Stripe webhook receiver + Supabase, desde la spec hasta el deploy — eso es exactamente lo que hacemos el 9 de julio.
