El ciclo de kbspec tiene ocho fases. Una sesión decide en cuál estás; nadie tiene que saberla de memoria. Cada fase produce un documento del expediente y algunas tienen una compuerta que no se puede saltar. Las aprobaciones son por puntos y las escribe una persona en el chat —«aprobado alcance», «aprobado solución», «aprobado pruebas»—; un L aprueba además el análisis aparte.
Fase
Produce
Compuerta
1 · Captura
La solicitud y las preguntas abiertas
La fase no cierra con preguntas abiertas bloqueantes
2 · Requerimiento
RF/RN/RNF y criterios de aceptación
«aprobado alcance» (el 01 y el 02) — es el contrato · con elicitación aplicada u omitida con motivo
3 · Análisis técnico
Matriz de impacto, ADRs, riesgos
—
4 · Plan de tareas
WBS, tareas T-NN, work items y los casos del 06
«aprobado solución» (el 03, el 04 y el 06): aprueba el plan y autoriza el lote con un tope
5 · Implementación
Las tareas en paralelo, cada una en su árbol, verificadas e integradas (el lote); de a una si se pide
Entre la 6 y la 7 hay una parada que no es una fase —no produce un documento— pero es
donde el requerimiento pasa días: la revisión del Pull Request. El orden real
sorprende: se entrega completo, el revisor aprueba, se publica a staging, y ahí recién
prueba el usuario de negocio. El expediente registra en qué estado está el PR, así que
al cerrar la fase 6 el panel dice qué sigue en vez de quedar mudo:
Ventana de terminal
kbpr--aplicar# lo crea y lo anota en el expediente
kbprestado# dónde está y qué toca hacer
kbpraprobado# arranca la fase 7
kbprcambios--motivo"…"# pidió cambios: abre la ronda de corrección
La tabla de arriba dice qué produce cada fase. Este diagrama baja un nivel: los pasos de
cada una y —lo que de verdad se pregunta al trabajar— qué queda escrito al terminar
cada paso. Ninguna fase avanza porque alguien la dio por hecha: avanza porque dejó un
archivo que la siguiente puede leer.
Un chat por fase; en la implementación, uno por tarea
Cada herramienta que corre el agente reenvía la conversación entera al modelo, así que
el costo de un chat crece con el cuadrado de sus turnos. Al cerrar una fase —y en la
fase 5, cada tarea— la extensión de VS Code abre un chat nuevo con el agente y el modelo
de la fase siguiente y el primer paso escrito. El detalle está en
Menos tokens.
Antes de que el usuario apruebe el requerimiento (fase 2), todo se corrige libremente. Después de la aprobación, cada cambio queda registrado como control de cambios en el mismo ticket. Después de entregar, todo cambio nuevo es un ticket nuevo. La regla evita que el alcance se mueva en silencio.
Un requerimiento a la vez por carpeta de trabajo. Con una sesión abierta, kb init y kb abrir sobre otro ticket fallan a propósito. Para llevar dos en paralelo, cada uno va en su ventana y, al implementar, en su propia carpeta: Dos requerimientos a la vez.
kbspec es un producto de Kabata Soft contacto@kabatasoft.com © 2026 Kabata Soft S.A. Todos los derechos reservados.