Bitácora SOFTWARE502

Del Caos al Control

Fecha: 16 de Noviembre de 2026

Tema: Del Caos al Control: Por qué la Revolución del Desarrollo con IA Necesita Metodología (Scrum + Spec-Driven Development)

SSDD: cómo dirigir agentes de IA con Scrum y especificaciones

Un framework de código abierto para que Claude Code, Codex y otros agentes construyan software que puedas revisar, auditar y mantener.

Con un agente de código puedes levantar una aplicación funcional en una tarde. El problema llega tres semanas después: el proyecto ya tiene miles de líneas, nadie recuerda por qué existe la mitad de ellas, un cambio pequeño rompe algo que funcionaba y el agente "arregla" el error inventando una regla de negocio que nadie pidió.

La IA escribe código muy rápido. Sin dirección, lo que acelera es la deuda técnica.

En Software502 construimos SSDD (Scrum + Spec-Driven Development) para resolver exactamente eso: un framework abierto que le da al agente un proceso, un contrato y límites, y te deja a ti las decisiones.

El problema no es la IA, es la falta de contrato

Cuando un equipo trabaja con agentes a base de prompts sueltos, suele chocar con tres cosas:

La pregunta útil ya no es cómo lograr que la IA escriba más código, sino cómo gobernar ese código para que sea predecible y auditable.

Qué es SSDD

SSDD combina dos prácticas conocidas:

La premisa es simple: el agente no decide qué construir. Ejecuta, muy rápido, un contrato que una persona aprobó.

Ese contrato es un documento de requisitos y criterios de aceptación (DERCAS), alineado con la norma ISO/IEC/IEEE 29148, donde cada requisito tiene un identificador y cada criterio está escrito en formato Dado / Cuando / Entonces.

Cómo funciona

SSDD se instala en tu repositorio y agrega comandos a tu agente. El trabajo avanza en cuatro momentos, y cada uno termina con una aprobación humana:

Momento Qué hace el agente Qué apruebas tú
1. Definir Analiza la idea, redacta requisitos, diseña pantallas y arquitectura El alcance y las decisiones técnicas
2. Planificar Divide el trabajo en historias pequeñas y prepara el entorno El objetivo y el contenido del sprint
3. Construir Por cada historia: especifica, escribe las pruebas, luego el código El pull request y la aceptación de la historia
4. Entregar Prepara el pipeline, el despliegue y el monitoreo El paso a producción

Así se ve una historia de usuario de principio a fin:

/implementar HU-001
/auditar HU-001
/aceptar HU-001 --por "Ana López"

El primer comando escribe la especificación, las pruebas y el código. El segundo lanza una auditoría de calidad y seguridad. El tercero lo ejecutas tú cuando verificaste que cumple.

Lo que lo hace diferente

Las aprobaciones son reales, no decorativas. Ninguna fase inicia si la anterior no fue aprobada por una persona con nombre. Y si alguien edita un documento ya aprobado, la aprobación caduca hasta que se revise de nuevo. Es control de cambios sin burocracia.

La trazabilidad la verifica una máquina. Un script comprueba la cadena completa: cada requisito tiene criterios de aceptación, cada historia responde a un requisito y cada criterio tiene una prueba que lo nombra. Si falta un eslabón, el build falla.

Las pruebas van primero. El agente escribe la prueba de cada criterio, confirma que falla y solo entonces implementa. El código existe para cumplir el contrato, no al revés.

Quien programa no audita. La revisión de seguridad corre en una sesión separada, sin acceso a la conversación donde se escribió el código.

El rigor se ajusta al cambio. Un producto nuevo recorre el ciclo completo. Una funcionalidad sobre un proyecto existente usa un carril corto. Un hotfix solo exige una prueba de regresión y la auditoría.

No te ata a un agente. Funciona con Claude Code, Codex, OpenCode, Antigravity y Pi. El estado del proyecto vive en tu repositorio, así que puedes cambiar de herramienta a mitad del camino.

Con y sin SSDD

Prompts sueltos Con SSDD
Punto de partida Una instrucción en el chat Un requisito con criterios de aceptación
Quién decide el alcance El modelo, por omisión Una persona, por escrito
Revisión de código Adivinar qué se intentó Comparar contra la especificación
Cambio de alcance Pasa inadvertido Invalida la aprobación
Evidencia para una auditoría La conversación, si se guardó Requisito → criterio → historia → prueba

Para quién es

SSDD está pensado para ti si:

Probablemente no lo necesitas para un prototipo de fin de semana o un script de un solo uso. Para eso, un prompt basta.

Empieza en dos minutos

git clone https://github.com/jssandoval/scrum-sdd.git
./scrum-sdd/install.sh /ruta/a/tu-proyecto

Abre tu agente en el proyecto y escribe:

/descubrir Una app para que talleres mecánicos agenden citas por WhatsApp

El agente analiza la idea y se detiene para que la revises. Desde ahí, /estado te dice siempre cuál es el siguiente paso.

Solo necesitas Python 3 y uno de los agentes soportados. No hay dependencias adicionales ni servicios externos.

Dónde estamos

SSDD está en su versión 0.4.7 y es software libre bajo licencia MIT: puedes usarlo, modificarlo y llevarlo a proyectos comerciales. Es un proyecto joven. Lo publicamos ahora porque preferimos mejorarlo con equipos reales que pulirlo en privado, y tu experiencia usándolo es lo que más nos sirve.

Pruébalo

El código, las plantillas y la guía completa están en github.com/jssandoval/scrum-sdd. Instálalo en tu próximo proyecto, abre un issue con lo que encuentres y, si te resulta útil, déjanos una estrella.

¿Quieres implementarlo en tu equipo? En Software502 te acompañamos con la adopción, la capacitación y la adaptación a tu proceso. Escríbenos.