Conceptos

Carriles y métodos

Cada pedido pasa por uno de tres carriles; el método decide cuánta prueba necesita un cambio.

El agente dice el carril antes de empezar, para que puedas corregirlo a tiempo.

CarrilCuándoQué pasa
ResponderPreguntas, exploraciónSolo lectura.
Vía rápida (skill feature)≤ 3 archivos y sin cambios de esquema, permisos ni dineroUn archivo de feature en work/features/ con tareas y evidencia; un cambio de comportamiento también edita su spec viva.
Spec (skill spec)Todo lo más grande o arriesgadoUn cambio: propuesta + specs delta → tu aprobación → plan → tareas → implementación → verificación de cada escenario → fusión en las specs vivas.

El trabajo de vía rápida que supera el límite pasa al carril spec. Marcar una tarea siempre requiere evidencia: el comando ejecutado y su resultado.

Métodos

Se eligen al instalar (methodology en agent-kit.json):

MétodoQué exige
SDDCada escenario se prueba con un test o una comprobación reproducible; se escriben tests donde la lógica lo justifica.
SDD + TDDUn test que falla antes de cada cambio de comportamiento (skill tdd: rojo → verde → refactor, casos elegidos con ZOMBIES). agent-kit tdd status lista la lógica cambiada sin tests y preflight la bloquea.

Las rutas en testIgnore (por ejemplo, manejadores de rutas delgados) quedan fuera de la comprobación de TDD.