Spec-driven development para agentes de IA

zero.

Delegás una feature entera a un agente. zero la convierte en una corrida trazable — explora, planifica, construye y exige un veredicto antes de declarar éxito.

release
v0.1.26
licencia
MIT
fases
4
tests
349 OK
01 · Contrato

Por qué existe.

Delegar una feature a un agente es fácil. Saber qué hizo, por qué, y si realmente funciona — eso es lo difícil.

Cuando un agente trabaja solo, la sesión se vuelve una caja negra: prompts, diffs y suposiciones mezclados. Termina diciendo "listo" sin que nadie pueda auditar el camino. El problema no es que la IA se equivoque. Es que cierra sin que se note.

zero no promete que el agente siempre acierte. Promete algo más útil: que no avance sin contexto, no implemente sin plan, y no cierre sin evidencia. Vuelve explícito el trabajo que normalmente queda escondido.


Es un contrato de cuatro fases. Cada una deja un artefacto. Cada una se puede leer después. Y al final, un revisor con mirada fresca decide — no el mismo agente que construyó.

02 · Pipeline

Cuatro fases.

01
explore
Lee el repo, encuentra restricciones y deja un mapa antes de tocar un solo archivo.
02
plan
Define propuesta, spec, diseño y tareas chicas — cada una con su presupuesto de revisión.
03
build
Implementa con foco, registra decisiones y usa tests donde cambia el riesgo real.
04
veredicto
Un revisor fresco juzga la corrida con mirada adversarial y emite una de tres salidas:
pasa corregir replantear
Sin un veredicto pasa, la corrida no se vende como terminada.
03 · Garantías

Lo que asegura.

el loop · autotune

El pipeline se afina solo.

Cada veredicto — pasa, corregir, replantear — se atribuye al modelo que corrió esa fase. zero acumula esos resultados y los reevalúa: aprende qué modelo rinde explorando, cuál planificando, cuál revisando.

Con eso reescribe el perfil de modelos por fase, solo. No elegís un modelo y cruzás los dedos — el pipeline mide su propio desempeño y se reperfila corrida a corrida.

honestidad
Sin veredicto positivo, no hay falso cierre.
cap duro
Si no verifica dentro del límite, zero frena y lo dice.
specs canónicas
.sdd/specs/ evoluciona con deltas y audit trail.
run-memory
Cada corrida lee y escribe en Cortex: recuerda fallos, decisiones y fixes.
skill-learning
El trabajo terminado se destila en skills reutilizables.
modelos por fase
El autotune ajusta el modelo de cada fase según resultados reales.
continuidad
/forge --continue retoma la fase incompleta sin reiniciar.
compatibilidad
Mismo contrato en Claude Code · pi · OpenCode · Codex.
04 · Correr

Un comando.

Instalá la capa para tu agente — el ejemplo usa pi. También disponible para Claude Code, OpenCode y Codex.

pi install npm:@gonrocca/zero-pi
pi
/forge "agregá login con OAuth"

Más a fondo — npm, comparativa SDD, memoria de corridas, github.