El humano dirige.
La IA ejecuta.
kbspec mide.
El framework que le pone método al desarrollo con IA: cada requerimiento es un expediente trazable de ocho fases. Vos aprobás escribiendo en el chat, las tareas corren en paralelo y verificadas, y el consumo, el costo y el ritmo quedan medidos de verdad.
kbspec explicado: por quién lo hizo y en cuatro minutos de animación.
Qué problema aparece en cada paso del desarrollo con IA y qué pone kbspec para resolverlo.
kbspec, explicado
Ronny Artavia, de Kabata Soft, explica qué es kbspec, por qué existe y cómo cambia el trabajo del desarrollador con IA.
La presentación ejecutiva
De la base de conocimiento a la entrega: ocho fases, compuertas, pruebas, Pull Request, auditoría y costo medido.
Escribir código con IA es 10× más rápido. Entregarlo, no.
El asistente acelera una sola parte del trabajo. Lo demás —entender, revisar, medir, coordinar— sigue ahí, y ahora pesa más.
La revisión, no la escritura
Con agentes, los PRs crecen 154% y el tiempo de revisión 91%. Generar código dejó de ser el problema; confiar en él es el nuevo.
Fuente: datos de industria sobre agentesIr más rápido, sentirlo
Un ensayo controlado midió desarrolladores 19% más lentos con IA — que creían haber ido 20% más rápido. La auto-estimación ya no sirve.
Fuente: METR RCT, 2025¿Cuánto costó, de verdad?
Los frameworks spec-driven descomponen y ordenan, pero ninguno mide el consumo ni el costo real del modelo. El dato no existe.
BMAD · Spec Kit · KiroCuatro cosas que ningún prompt te da solo.
Mide de verdad
Tokens, créditos y ritmo, medidos por requerimiento y por fase desde la telemetría real —el chat, la ventana de agentes y Claude Code—. Pronóstico por flujo con Monte Carlo. No estimás: medís.
Método con compuertas
Ocho fases, de la captura a la entrega, y tres aprobaciones que escribe una persona: alcance, solución y pruebas. Antes de cada herramienta del agente, kbspec juzga si la fase lo permite; kb listo no deja implementar sobre un análisis flojo.
Trazabilidad total
Un expediente por requerimiento, con bitácora encadenada por hash y anclada fuera del archivo. Nada se pierde, nada se inventa: el «por qué» de cada decisión queda escrito, y el dossier se lo contesta a un auditor.
Nativo de tu stack
GitHub Copilot y Claude Code —también IBM Bob y OpenCode—, con Azure DevOps o GitHub como tablero y como repositorio. Un solo CLI en Python, el único que escribe; las skills, el plugin, el servidor MCP y el panel de VS Code lo invocan.
Aprobás el plan una vez. Las tareas corren en paralelo.
Cada tarea en su propia carpeta, con su rama, su agente y su modelo. kbspec verifica cada una y la integra en orden; vos revisás el resultado una sola vez, al final.
Autorizás con un tope
Aprobar la solución autoriza el lote con un tope de créditos. Si se llega al tope, kbspec corta a todos los agentes.
«aprobado solución»Cada tarea en su árbol
Las que no comparten archivos van juntas, en olas. Cada una con su agente —Copilot o Claude Code— y las compuertas de kbspec juzgando cada herramienta.
kb lote correr --todoVerificada e integrada
Pasa la verificación que declara el plan y queda integrada en la rama del requerimiento. Una tarea que no consultó las compuertas no se da por buena; si dos chocan, se dice y no se mezcla nada a medias.
kb lote verificar · integrarUna validación al final
Revisás el conjunto, no veinte interrupciones. Y tu copia del código no se toca: el requerimiento trabaja en su propia carpeta.
«aprobado cierre»Se construye una vez. La usa todo el equipo.
Un repositorio central con el inventario de aplicaciones: de cada una, el mapa completo —componentes, cómo compila, cómo se inicia, cómo se entra y cómo se navega—. Es lo que el asistente necesita para construir y probar sin adivinar. Medido sobre un frontend real: explorar el repositorio cuesta unos 110.000 tokens; leer la ficha, unos 3.000.
El mapa de cada aplicación
Para qué sirve, quién la usa, sus componentes y cómo se conectan. Cómo se compila, cómo se levanta, cómo se inicia sesión y cómo se navega: lo que hace falta para programar y correr las pruebas E2E.
kb apps · kb ficha · kb mapaLas normas de la institución
Estándares, reglas de programación, reglas de base de datos y scripts, las plantillas de cada documento y las skills que definen el comportamiento. Un administrador aprueba cada cambio.
aplicaciones/ · plantillas/ · skillsCada requerimiento la mejora
Al cerrar un requerimiento, lo aprendido vuelve a la base: fichas al día, reglas nuevas, decisiones. El siguiente empieza con más contexto que el anterior.
kb retro · kb publicar-baseOcho fases. Una sesión decide en cuál estás.
Nadie tiene que memorizar comandos: se escribe lo que se quiere y el framework decide la fase y qué sigue. Las decisiones las escribe una persona en el chat; lo demás lo hace el agente, y kbspec no lo deja saltear nada.
Lo que llega a revisión ya viene probado, y se nota.
La revisión es el nuevo cuello de botella. kbspec la acorta llegando con la prueba hecha y la evidencia a un clic.
Sobre una base validada
Cada aplicación tiene su base de pruebas de punta a punta —login propio o SSO, usuarios, navegación— y el ambiente se levanta solo. Las pruebas salen de los criterios aprobados, una por condición.
El flujo E2E →Sin archivo, no cuenta
Compilación, lint, unitarias, E2E, base de datos, revisión de seguridad: las automáticas las produce kbspec y las manuales se adjuntan tal cual salieron. Lo que no tiene archivo queda sin marcar en el PR.
Las pruebas y la evidencia →Se revisa sin clonar
Revisores obligatorios, la hoja de aprobación por repositorio y cada comentario del revisor —o de G-Bot— respondido en su hilo, en una ronda. En Azure DevOps y en GitHub.
El PR sin clonar →El dato propio, no el benchmark ajeno.
kbspec lee la telemetría real de Copilot —el chat y la ventana de agentes— y de Claude Code, la reparte por requerimiento y la cruza con lo que salió. Tres respuestas que antes eran opinión.
Ritmo real
Ítems cerrados por sprint, del histórico de las bitácoras.
16-Ago a 29-Ago ████████████ 16
02-Ago a 15-Ago ██████████ 13
Ritmo 13.3/sprint · rango 8–16
Pronóstico honesto
Monte Carlo sobre tu historia. Confianza, no adivinanza.
50% → ≤ 4 sprints
85% → ≤ 5 sprints (08-Nov)
costo ≈ $142 medido
Modelo por fase
Detecta si una fase corrió con un modelo demasiado flojo.
3. Análisis usó rapido
recomienda RAZONAMIENTO
→ el análisis flojo se paga después
La IA, bajo la política de la casa.
En una organización regulada, las preguntas no son técnicas: qué datos ve el modelo, quién aprobó, cuánto costó y quién puede apagar un control. kbspec las contesta con datos, no con promesas.
Controles que nadie apaga
TI fija la política en la máquina —GPO, Intune o un perfil de macOS—: compuertas obligatorias, versión mínima, rutas que el agente no lee, y si un requerimiento puede salir del ambiente.
La IA bajo política →Qué modelo, con qué dato
La clasificación de cada aplicación decide qué modelos pueden trabajar con su código. Un secreto no llega a escribirse nunca; tarjetas e IBAN entran enmascarados al expediente, y con los documentos de identidad TI fija si se avisa o se niega.
Lo que el agente no lee →Quién decidió, firmado
Cada aprobación queda a nombre de una persona, con la identidad que dice el servidor; quien aprueba no es quien escribió el código. La bitácora está encadenada, anclada fuera del archivo y llega al SIEM.
El rastro que responde a una auditoría →Como trabaja tu equipo, no como dice un tutorial.
Varios requerimientos, sin cruzarse
Cada requerimiento en su ventana y en su propia carpeta, con su rama. Un arreglo urgente en tu copia y dos requerimientos abiertos conviven sin pisarse el código ni el consumo.
Dos requerimientos a la vez →Tus reglas, versionadas
Las ramas, cuánto se documenta, las plantillas, los estándares de código y las preguntas de cada fase son del equipo: viven versionados en su repositorio de documentación y kbspec los respeta en cada paso.
La configuración del equipo →Azure DevOps o GitHub; Copilot o Claude Code
El mismo ciclo con cualquiera de los dos tableros y repositorios, y con cualquiera de los dos asistentes. Work items y sub tareas, ramas por estrategia, PR y estados que se mueven solos.
GitHub y Azure DevOps →Hablale al agente
Con el dictado de VS Code, que procesa el audio en la máquina. kbspec dice qué le falta a cada máquina y entiende lo dictado: «aprobado cero dos» es «aprobado 02».
Hablarle a kbspec →La descomposición la hacen todos. La medición, no.
kbspec comparte lo bueno del enfoque spec-driven —y agrega la capa que los demás dejan afuera.
| Capacidad | kbspec | BMAD | Spec Kit | Kiro |
|---|---|---|---|---|
| Ciclo con fases y compuertas | Sí | Parcial | — | Parcial |
| Descomposición en tareas | Sí | Sí | Sí | Sí |
| Mide consumo y costo del modelo | Sí | No | No | No |
| Pronóstico por flujo (Monte Carlo) | Sí | Conteo | No | No |
| Recomienda y mide el modelo por fase | Sí | No | No | No |
| Bitácora encadenada y auditable | Sí | No | No | No |
| Nativo de Azure DevOps | Sí | No | No | No |
| Español de primera clase | Sí | No | No | No |
Se escribe lo que se quiere. El framework hace el resto.
# En el chat: «KB-4471 — el usuario necesita ver sus perfiles por módulo» $ kb init KB-4471 "Perfiles por módulo" --tamano M --pase PN-00500 --aplicacion PORTAL ✓ expediente creado · fase captura · work item enlazado # La persona escribe: «aprobado alcance» · «aprobado solución» $ kb lote correr --todo ✓ ola 1: T-01 · T-02 · T-03 en paralelo — verificadas e integradas ✓ ola 2: T-04 — verificada e integrada $ kb pruebas # compilación, unitarias y E2E, con su evidencia $ kb pr --aplicar # revisores obligatorios y la hoja de aprobación $ kb pronostico --backlog 85% de confianza → ≤ 5 sprints (para el 08-Nov) costo de modelo estimado: ≈ $142 · medido
Lo que casi todos preguntan.
¿kbspec reemplaza a Copilot o a Claude?
No. kbspec es el método y la medición alrededor de ellos. El asistente sigue escribiendo el código; kbspec le da la estructura, las compuertas y el dato de cuánto costó y cuánto rinde.
¿Por qué no usa story points?
Porque estiman el tiempo de una persona programando — y con IA esa cuenta se rompe. kbspec mide el flujo real (ítems cerrados por sprint) y proyecta con Monte Carlo, que es adonde llegaron los frameworks spec-driven serios. Sin planning poker.
¿Qué necesito para empezar?
Python 3.9 o superior, Git, Node 20 o superior —para instalarlo por npm y para las pruebas E2E— y tu asistente: Copilot o Claude Code. La CLI usa solo la biblioteca estándar de Python. Un comando lo instala y /kb-instalar te guía desde el chat.
¿Sirve para un equipo o solo para una persona?
Para las dos. El expediente y la bitácora son de cada requerimiento; la configuración (modelos, perfiles, convenciones, tablero) es del equipo y vive versionada en el repositorio de documentación.
¿Azure DevOps o GitHub?
Los dos, como tablero y como repositorio, de fábrica. kbspec enlaza el work item del requerimiento —o el issue—, crea una sub tarea por cada T-NN, arma las ramas según la estrategia del equipo, crea el PR con sus revisores y mueve los estados conforme avanza el ciclo.
¿kbspec manda mi código a algún lado?
No agrega ningún destino: el código lo procesa tu asistente, como siempre. TI puede impedir que kbspec salga a internet por su cuenta, fijar a qué servidores le manda credenciales y qué modelos pueden trabajar con cada clasificación de datos. Lo que se le declara a un supervisor —proveedor, datos, retención— queda escrito.
Ponele número a tu desarrollo con IA.
La documentación completa, la guía de instalación y la referencia de comandos — todo en un solo lugar.