Capitulo 18: Workflow Spec-Driven

< Volver al Indice del Tutorial

Spacecake brilla especialmente en el desarrollo guiado por especificaciones (spec-driven development). La combinacion de editor WYSIWYG, terminal integrado y panel de tareas crea un entorno ideal para este flujo de trabajo.

Que es spec-driven development

Spec-driven development consiste en escribir las especificaciones antes del codigo. Defines que debe hacer el sistema, cuales son las restricciones y cuales son los criterios de aceptacion. Luego, Claude Code lee esas especificaciones y las implementa.

La ventaja es que el codigo resultante cumple con requisitos claros y documentados, en lugar de emerger de instrucciones ambiguas en un chat.

Por que Spacecake es ideal para este flujo

Spacecake reune varias capacidades que encajan naturalmente en el desarrollo guiado por specs:

• Editor WYSIWYG: escribes specs legibles y bien formateadas, con encabezados, listas, tablas y bloques de codigo. No necesitas preocuparte por la sintaxis markdown mientras redactas.
• Plan mode por defecto: Claude Code opera en plan mode, lo que significa que piensa y propone antes de actuar. Esto te da la oportunidad de revisar el plan antes de que se ejecute codigo.
• Ctrl+G para editar planes: cuando Claude genera un plan, presiona Ctrl+G para abrirlo en el editor WYSIWYG. Ahi puedes editarlo visualmente, reorganizar secciones, agregar detalles o eliminar pasos innecesarios.
• Checklists interactivos: puedes incluir checklists en las specs y en los planes para trackear progreso. Los checkboxes son interactivos en el editor.
• Mermaid diagrams: para specs que necesitan diagramas de arquitectura, flujo o secuencia, puedes incluir bloques Mermaid que se renderizan visualmente.

CLAUDE.md como ancla del proyecto

El archivo CLAUDE.md en la raiz de tu proyecto es la base del flujo spec-driven. Claude Code lo lee automaticamente al inicio de cada sesion. En el defines:

• Reglas y convenciones del proyecto.
• Estructura del repositorio.
• Comandos de desarrollo comunes.
• Restricciones tecnicas.

Editalo directamente en Spacecake con el editor visual. Cada vez que agregas una regla o ajustas una convencion, Claude la respeta en todas las sesiones futuras.

Flujo de trabajo completo

Paso 1: Crear la especificacion

Abre un archivo nuevo en Spacecake y escribe la especificacion en markdown. Incluye:

• Requisitos funcionales: que debe hacer el sistema.
• Restricciones tecnicas: tecnologias, patrones, limites.
• Criterios de aceptacion: como verificar que la implementacion es correcta.
• Diagramas (opcional): usa bloques Mermaid para visualizar arquitectura o flujos.

Escribe en el editor WYSIWYG para aprovechar el formato visual. Usa encabezados para organizar las secciones y checklists para los criterios de aceptacion.

Paso 2: Revisar con Claude

En plan mode, pide a Claude Code que lea la spec y proponga un plan de implementacion. Claude analizara los requisitos y generara un plan estructurado con los pasos necesarios.

Paso 3: Editar el plan

Presiona Ctrl+G para abrir el plan en el editor WYSIWYG. Revisa cada paso, ajusta el orden, agrega detalles que falten o elimina pasos que no apliquen. El editor visual hace que esta revision sea rapida y clara.

Paso 4: Implementar

Cambia a normal mode en Claude Code. Claude implementara el plan paso a paso, creando archivos, escribiendo codigo y ejecutando comandos segun lo especificado.

Paso 5: Verificar

Claude ejecuta tests y valida la implementacion contra la especificacion original. Los criterios de aceptacion que definiste en el paso 1 sirven como checklist de verificacion.

Paso 6: Iterar

Si algo no cumple la spec, ajusta los requisitos o el plan y repite el ciclo. La iteracion es rapida porque todo esta en el mismo entorno: spec, plan, codigo y terminal.

Referencia a Spec Kit

GitHub Spec Kit es un framework formal para spec-driven development que estructura las especificaciones en formatos estandarizados. Para mas detalles sobre como organizar specs profesionalmente, consulta el tutorial de Spec Kit.

Planes como documentacion viva

Los planes que Claude genera en Spacecake son archivos markdown que puedes guardar como parte de la documentacion de tu proyecto. En lugar de perder los planes en el historial del chat, guardalos en una carpeta docs/ o specs/ de tu repositorio.

Con el tiempo, estos planes forman un registro de decisiones tecnicas: por que se implemento algo de cierta manera, que alternativas se consideraron y cuales fueron las restricciones.

Ventaja sobre terminal puro

El ciclo spec -> plan -> implement -> verify es significativamente mas productivo cuando puedes editar visualmente en cada paso. En un flujo puramente de terminal:

• Escribir specs es engorroso sin formato visual.
• Revisar planes requiere leer bloques largos de texto plano.
• Editar planes implica copiar, pegar y reformatear manualmente.

En Spacecake, cada paso tiene soporte visual nativo. Escribes con WYSIWYG, revisas con Ctrl+G, editas con drag and drop de secciones, y verificas con checklists interactivos. La friccion se reduce en cada iteracion.

---

Siguiente: Capitulo 19: Atajos y Personalizacion —>