GSD-Lite: Una Máquina de Estados para el Código de Claude que Impone TDD y Previene la Omisión de Pruebas

GSD-Lite es un servidor MCP de código abierto que se acopla a Claude Code y ejecuta proyectos a través de una máquina de flujo de trabajo de 12 estados. La herramienta tiene licencia MIT y consta de aproximadamente 15 archivos fuente en total.

Cómo funciona

Después de planificar qué construir en conversación con Claude, GSD-Lite toma el control automáticamente: escribe código, lo revisa, lo verifica, avanza a la siguiente fase. El ciclo de ejecución sigue este patrón:

• El orquestador selecciona la siguiente tarea
• El ejecutor escribe el código (TDD, punto de control)
• El revisor verifica (contexto separado, especificaciones + calidad)
• ¿Aceptado? Siguiente tarea. ¿Rechazado? Rehacer.
• ¿Todas las tareas completadas? Verificación de puerta de fase
• ¿La puerta pasa? Siguiente fase
• ¿Todas las fases completadas? Has terminado

Características principales

Aplicación de TDD: La "Ley de Hierro" está integrada en cada asignación de tarea: sin código de producción sin una prueba fallida primero. El mensaje enumera las racionalizaciones exactas que Claude usa para omitir pruebas ("Esto es solo un cambio de configuración", "Las pruebas existentes ya cubren esto") y las marca como excusas conocidas.

Contextos de agente separados: Las revisiones se ejecutan en un contexto de agente separado donde el revisor nunca ve el razonamiento del ejecutor, solo la diferencia y las especificaciones de la tarea. Esto evita aprobaciones automáticas y ayuda a detectar errores reales.

Agente depurador: Cuando una tarea falla 3 veces, en lugar de otro reintento, se envía un agente depurador. Este agente separado reproduce el fallo, formula hipótesis, las prueba, identifica dónde debe ir la corrección y luego proporciona hallazgos al ejecutor.

Seguimiento de dependencias: Si una tarea cambia la firma de una API, cualquier cosa posterior se invalida y se vuelve a poner en cola automáticamente.

Detalles técnicos

El sistema utiliza 6 comandos, 4 agentes y 11 herramientas MCP. El estado se gestiona en un archivo JSON con validación de esquema y conflictos de versión manejados mediante concurrencia optimista.

Por qué no la versión original

La primera versión tenía 32 comandos, 12 agentes, más de 100 archivos fuente y un instalador de 2400 líneas. El autor la descartó y la reescribió desde cero porque la mayor parte de esa complejidad consumía ventana de contexto sin proporcionar valor.

Hallazgos inesperados

El enfoque anti-racionalización funciona: enumerar frases específicas que Claude usa para omitir pasos directamente en el mensaje del agente redujo la tasa de omisión. El autor señala que los ejemplos negativos parecen guiar mejor al modelo que simplemente decir "siempre escribe pruebas". La persistencia de sesión fue el desafío de implementación más difícil.