FLUJO DE TRABAJO BASADO EN ESPECIFICACIONES DE CLAUDE
El flujo de trabajo exacto de tres fases que sigo en cada proyecto en el que me ayuda Claude. De la lluvia de ideas a las especificaciones y a la implementación, con controles que detectan los fallos en una fase temprana.
← Todas las guías Todas las guías de este tema
Por qué es importante basarse en las especificaciones
La generación de código con Claude es tan rápida que el cuello de botella ya no es escribir. El cuello de botella es saber exactamente lo que quieres antes de que Claude lo escriba. El flujo de trabajo basado en especificaciones anticipa la reflexión, de modo que la fase de implementación se convierte en ejecución en lugar de exploración.
Los equipos que obtienen buenos resultados con Claude son aquellos que ya habían desarrollado una disciplina en la elaboración de especificaciones antes de que existieran las herramientas de IA. Los equipos que tienen dificultades son aquellos que intentan saltarse la fase de elaboración de especificaciones y le piden a Claude que se las invente.
Fase 1: lluvia de ideas estructurada
Le describo el problema a Claude en tres o cuatro frases. A continuación, le pido a Claude que plantee cinco preguntas cuyas respuestas cambiarían el diseño. Yo respondo a esas preguntas. Después, le pido a Claude que resuma las especificaciones del producto resultantes en 200 palabras.
Esta fase dura entre 30 y 60 minutos y da como resultado un documento de especificaciones a partir del cual se desarrolla el resto del trabajo. Las cinco preguntas son, por lo general, aquellas que me habría saltado si hubiera empezado directamente a programar; sacarlas a la luz durante la fase de lluvia de ideas es precisamente lo que aporta todo el valor.
Fase 2: decisiones técnicas
Con las especificaciones en la mano, le pido a Claude que identifique las decisiones arquitectónicas que tendrán un mayor impacto en las fases posteriores del proceso: la estructura de la base de datos, la superficie de la API, la estrategia de renderizado y el modelo de implementación. Para cada una de ellas, Claude propone dos o tres opciones con sus respectivas ventajas e inconvenientes.
Yo elijo. Las decisiones se recogen en el mismo documento, de modo que la fase de desarrollo cuente con una única fuente de información fiable. Las decisiones tomadas en esta fase resultan diez veces más baratas de revisar que las que se detectan durante la implementación.
Fase 3: implementación basada en especificaciones
La generación de código es la última fase y es la más rápida, ya que las especificaciones ya están completas. Claude escribe el esquema, las consultas, los componentes, las rutas y las pruebas, más o menos en ese orden. Yo reviso cada commit.
La mayoría de las revisiones ponen de manifiesto una pequeña refactorización o un caso extremo que se había pasado por alto; las reescrituras completas son poco frecuentes cuando las especificaciones eran claras. El ritmo es entre dos y cinco veces más rápido que el de la ingeniería sin ayuda en proyectos totalmente nuevos.
Las barreras que detienen los fallos
Tres etapas de revisión entre la fase de ideas y el código final:
«Spec gate»: antes de escribir cualquier código, se lee de principio a fin el documento de especificaciones de 200 palabras. Se aclara cualquier punto ambiguo. Se elimina cualquier elemento que sea meramente aspirativo.
Control de arquitectura: antes de que se ejecute cualquier migración de base de datos, se revisan las decisiones de arquitectura comparándolas con las especificaciones. Todo lo que no se ajuste a las especificaciones se reconsidera.
Control de confirmaciones: cada confirmación realizada por Claude se somete a una revisión humana antes de fusionarse. La revisión es más rápida que escribir el código uno mismo, pero no se puede omitir. Claude no aprueba sus propias solicitudes de incorporación de cambios.
Cuando el enfoque basado en especificaciones no funciona
Trabajo de carácter exploratorio o de investigación cuyo objetivo es descubrir lo que es posible, más que crear algo ya conocido. En estos casos, la fase de especificación da lugar a especificaciones vagas que limitan a Claude de forma contraproducente. En su lugar, el patrón adecuado es el diálogo iterativo con artefactos concretos.
Corrección de errores cuya causa se desconoce. La fase de especificación da por hecho que sabes cuál es el destino; la depuración consiste en averiguar dónde te encuentras. Para depurar, pasa directamente al patrón de depuración sistemática (reproducir, aislar, diagnosticar, corregir) y omite la especificación.
Perfeccionamiento de la interfaz de usuario en el que cada iteración es pequeña y la retroalimentación visual es la señal. Para ello, Claude en Cursor, con recarga en caliente y comparación lado a lado, es la herramienta adecuada, no un pliego de condiciones escrito.