FLUJO DE TRABAJO BASADO EN ESPECIFICACIONES DE CLAUDE
El flujo de trabajo exacto de tres etapas que ejecuto en cada compilación asistida por Claude. Desde lluvia de ideas hasta especificación e implementación, con los controles que detectan fallos temprano.
Por qué importa el enfoque basado en especificaciones
La generación de código con Claude es lo suficientemente rápida como para que el cuello de botella ya no sea escribir. El cuello de botella es saber exactamente qué quieres antes de que Claude lo escriba. El flujo de trabajo basado en especificaciones adelanta el pensamiento para que la fase de implementación se convierta en ejecución en lugar de exploración.
Los equipos que envían bien con Claude son aquellos que construyeron disciplina de especificaciones antes de que existieran las herramientas de IA. Los equipos que luchan son los que intentan omitir la especificación pidiendo a Claude que lo resuelva.
Etapa 1: lluvia de ideas estructurada
Describo el problema a Claude en tres o cuatro oraciones. Luego le pido a Claude que plantee cinco preguntas cuyas respuestas cambiarían el diseño. Las contesto. Luego le pido a Claude que resuma la especificación de producto resultante en 200 palabras.
Esta etapa toma 30 a 60 minutos y produce una especificación escrita de la que fluye el resto del trabajo. Las cinco preguntas son usualmente las que habría saltado si hubiera ido directo al código; exponerlas a través de la etapa de lluvia de ideas es todo el valor.
Etapa 2: decisiones técnicas
Con la especificación en mano, le pido a Claude que identifique las decisiones arquitectónicas que tienen el mayor impacto hacia adelante. Forma de la base de datos, superficie de la API, estrategia de renderizado, modelo de despliegue. Para cada una, Claude propone dos o tres opciones con sus compensaciones.
Yo elijo. Las decisiones van en el mismo documento para que la fase de construcción tenga una única fuente de verdad. Las decisiones tomadas en esta etapa son 10 veces más baratas de revisar que las decisiones descubiertas durante la implementación.
Etapa 3: implementación dirigida por especificación
La generación de código es la última etapa y es la más rápida porque la especificación ya está completa. Claude escribe el esquema, las consultas, los componentes, las rutas, los tests, en ese orden aproximadamente. Reviso cada commit.
La mayoría de revisiones ponen a la luz un pequeño refactor o un caso extremo faltante; las reescrituras completas son raras cuando la especificación estaba clara. El ritmo es dos a cinco veces más rápido que la ingeniería sin ayuda en trabajo greenfield.
Las compuertas que atrapan fallos
Tres compuertas de revisión entre la lluvia de ideas y el código desplegado:
Compuerta de especificación: antes de que se escriba código alguno, la especificación de 200 palabras se lee de punta a punta. Cualquier cosa ambigua se aclara. Cualquier cosa aspiracional se elimina.
Compuerta de arquitectura: antes de que se ejecute cualquier migración de base de datos, las decisiones de arquitectura se revisan contra la especificación. Todo lo que no sirva la especificación se reconsidera.
Compuerta de commit: cada commit escrito por Claude recibe una revisión humana antes de fusionarse. La revisión es más rápida que escribir el código tú mismo, pero es obligatoria. Claude no aprueba sus propias pull requests.
Cuando lo impulsado por especificación no funciona
Trabajo exploratorio o de investigación donde el objetivo es aprender qué es posible en lugar de construir algo conocido. Para estos, la etapa de especificación produce especificaciones vagas que restringen a Claude de manera contraproducente. En su lugar, el patrón correcto es el chat iterativo con artefactos concretos.
Correcciones de bugs donde la causa es desconocida. La etapa de especificación asume que conoces el destino; el debugging es averiguar dónde estás. Para debugging, ve directo al patrón de debugging sistemático (reproducir, aislar, diagnosticar, corregir) y salta la especificación.
Pulido de UI donde cada iteración es pequeña y la retroalimentación visual es la señal. Para estos, Claude en Cursor con hot reload y diff lado a lado es la herramienta correcta, no una especificación escrita.