# kbspec

> Framework de desarrollo con IA: cada requerimiento es un expediente trazable de ocho fases, la persona aprueba, las tareas corren en paralelo con verificación y kbspec mide lo que la IA consume y cuánto cuesta. Para GitHub Copilot, Claude Code y Cursor, sobre Azure DevOps o GitHub.

Documentación en español. La CLI es `kb`; el panel es la extensión de VS Code «kbspec Cockpit».

## Empezar

- [Actualizar y repartir](https://kbspec.kabatasoft.com/empezar/actualizar/): Qué hacer cuando sale una versión nueva —en la máquina, en el repositorio de documentación y en el inventario— y cómo se reparte al equipo.
- [Aplicaciones nuevas y épicas](https://kbspec.kabatasoft.com/empezar/apps-nuevas-y-epicas/): Una aplicación desde cero, un módulo grande o un requerimiento que no entra en un PR — el mismo camino que cualquier otro, con partes que se entregan solas.
- [Configurar kbspec conversando](https://kbspec.kabatasoft.com/empezar/configurar/): kbspec mira tu código, propone lo que puede inferir y pregunta solo lo que falta — el inventario, el tablero, las credenciales, las pruebas y la guía de cada aplicación, sin llenar markdown a mano.
- [La guía funcional y el asistente](https://kbspec.kabatasoft.com/empezar/guia-funcional/): Cómo funciona cada aplicación —módulos, pantallas, cálculos, cómo se hace cada cosa— escrito para el negocio, y un asistente que contesta con la sección justa.
- [Instalación](https://kbspec.kabatasoft.com/empezar/instalacion/): Qué necesita cada máquina, cómo se instala kbspec y cómo se comprueba que quedó listo.
- [El inventario y las fichas](https://kbspec.kabatasoft.com/empezar/inventario/): Cómo se carga qué aplicaciones hay, de qué componentes están hechas y dónde está su código — lo que el agente lee en vez de explorar el repositorio.
- [Tu primer requerimiento](https://kbspec.kabatasoft.com/empezar/primer-requerimiento/): Un requerimiento real de punta a punta —de una frase en el chat al Pull Request y la base de conocimiento—, con lo que escribe la persona, lo que hace kbspec y lo que queda en cada fase.
- [Configurar las pruebas E2E](https://kbspec.kabatasoft.com/empezar/pruebas-e2e/): La base de las pruebas de punta a punta de una aplicación —proyecto, login, usuarios, navegación— y cómo se comprueba que el ambiente está listo antes de escribir una sola prueba.
- [Qué es kbspec](https://kbspec.kabatasoft.com/empezar/que-es/): Método y medición para el desarrollo con IA. Un expediente por requerimiento, ocho fases, un solo CLI.

## El ciclo

- [El expediente](https://kbspec.kabatasoft.com/ciclo/el-expediente/): Los documentos, la bitácora encadenada y el consumo — todo de un requerimiento, en un lugar.
- [Las ocho fases](https://kbspec.kabatasoft.com/ciclo/las-ocho-fases/): De la captura a la entrega. Qué produce cada fase y qué la bloquea.
- [El prototipo que produce el requerimiento](https://kbspec.kabatasoft.com/ciclo/prototipo/): Cuando negocio sabe qué necesita pero no cómo debería verse, el prototipo deja de ilustrar el requerimiento y pasa a producirlo — y lo que se aprende mirándolo vuelve al expediente.
- [Las pruebas y la evidencia](https://kbspec.kabatasoft.com/ciclo/pruebas-y-evidencias/): Del caso de negocio (06) a la evidencia que exige cada componente, y al 07 que separa lo que se probó antes del PR de lo que validó el usuario después.
- [La UAT y las rondas de corrección](https://kbspec.kabatasoft.com/ciclo/uat-y-rondas/): El usuario prueba DESPUÉS del PR, en staging — y si reporta defectos, el ciclo completo se repite como ronda numerada.

## El método

- [La compuerta «listo»](https://kbspec.kabatasoft.com/metodo/compuerta-listo/): kb listo — el veredicto consolidado antes de implementar. Codear sobre un análisis flojo es retrabajo asegurado.
- [La elicitación](https://kbspec.kabatasoft.com/metodo/elicitacion/): El segundo pase estructurado antes de aprobar un documento — con métodos nombrados, registro en la bitácora, y una salida honesta para omitirlo.
- [Flujo E2E de kbspec](https://kbspec.kabatasoft.com/metodo/flujo-e2e/): El paso a paso de las pruebas E2E de un requerimiento, de la base de la app y los criterios del 02 a la grabación, el armado de las pruebas, la corrida y la revisión antes del Pull Request.
- [Las pruebas de fábrica](https://kbspec.kabatasoft.com/metodo/pruebas-de-fabrica/): El día cero de un equipo sin pruebas — kit E2E sembrado desde la ficha, frontend detectado con sus prácticas, y el arranque de las unitarias con comandos exactos.
- [La retrospectiva](https://kbspec.kabatasoft.com/metodo/retrospectiva/): kb retro — cerrar una épica dejando escrito qué se aprendió, con el costo medido ya pre-cargado.

## Planificar y medir

- [Cómo mide kbspec](https://kbspec.kabatasoft.com/planificar/como-mide-kbspec/): De dónde salen los números — la telemetría real, el consumo por fase, el costo, el flujo. Medido versus declarado, y qué nunca se guarda.
- [Qué es cada número](https://kbspec.kabatasoft.com/planificar/el-consumo/): Créditos facturados, estimación por tarifa y costo; de dónde sale cada número, las dos bases de Copilot que se leen, cómo se muestra y por qué ninguna cifra lleva separador de miles.
- [Menos tokens: un chat por tarea](https://kbspec.kabatasoft.com/planificar/menos-tokens/): Por qué el costo de Copilot crece con los turnos de una conversación y no con los documentos, y cómo kbspec corta la conversación solo, muestra el contexto y fuerza el modelo de cada fase.
- [Modelos por fase](https://kbspec.kabatasoft.com/planificar/modelos-por-fase/): Qué clase de modelo conviene en cada fase, cómo mapear los reales, y la detección medida de cuando una fase corrió con uno demasiado flojo.
- [Modelos recomendados y su costo](https://kbspec.kabatasoft.com/planificar/modelos-recomendados/): Qué modelo de Copilot poner en cada clase y en cada fase, con el precio de cada uno por millón de tokens y cuántos créditos cuesta un requerimiento con cada recomendación. Instantánea del 2 de octubre de 2026.
- [Pronóstico por flujo](https://kbspec.kabatasoft.com/planificar/pronostico-por-flujo/): Cuántos ítems entran en un sprint y cuánto costará — medido, con Monte Carlo, sin story points.

## Gobierno

- [El rastro que responde a una auditoría](https://kbspec.kabatasoft.com/gobierno/auditoria/): auditoria.jsonl encadenado y anclado fuera del archivo, el dossier que contesta lo que pregunta un supervisor, y las decisiones que solo puede registrar una persona.
- [La IA bajo política](https://kbspec.kabatasoft.com/gobierno/ia-bajo-politica/): Lo que se le declara a un supervisor —proveedor, datos, retención—, el modelo que corrió de verdad, cuánto costó y con qué tope, qué entra al expediente y qué sale de la máquina.

## Equipos y adopción

- [Buenas prácticas](https://kbspec.kabatasoft.com/equipos/buenas-practicas/): Qué mantener al día —inventario, fichas, mapa, glosario, contratos— para que el agente entienda cada aplicación sin explorarla, gaste menos y se equivoque menos.
- [Configuración del equipo](https://kbspec.kabatasoft.com/equipos/configuracion/): Los archivos que el equipo llena una vez y kbspec respeta en cada fase.
- [Convenciones](https://kbspec.kabatasoft.com/equipos/convenciones/): El tamaño XS/S/M/L, el control de cambios y las reglas que el equipo acuerda.
- [Dos requerimientos a la vez](https://kbspec.kabatasoft.com/equipos/dos-a-la-vez/): Cada requerimiento en su ventana y, al implementar, en su propia carpeta —un árbol de git por repositorio—, sin tocar tu copia del código.
- [Tareas en paralelo](https://kbspec.kabatasoft.com/equipos/lote-en-paralelo/): kb lote — las tareas del plan corren a la vez, cada una en su árbol y con su agente, con una autorización con tope y la integración en orden. El camino de fábrica desde 3.198.0.
- [Cómo se publica la documentación](https://kbspec.kabatasoft.com/equipos/publicar-documentacion/): Expedientes directo a la rama principal, base compartida por PR — y por qué el PR de código no nace antes que la documentación.
- [Importar un requerimiento de otro ambiente](https://kbspec.kabatasoft.com/equipos/traslado/): kb traslado — un requerimiento ya desarrollado en otro ambiente de kbspec se importa con sus documentos y su código, listo para revisar y aprobar.

## Integración

- [Azure DevOps](https://kbspec.kabatasoft.com/integracion/azure-devops/): Work items, sub-tareas y estados que se mueven solos.
- [Copilot, Claude y OpenCode](https://kbspec.kabatasoft.com/integracion/copilot-y-claude/): Cómo kbspec trabaja desde el chat, con skills, agentes de fase y soporte de primera clase para OpenCode.
- [Cursor](https://kbspec.kabatasoft.com/integracion/cursor/): kbspec gobierna el trabajo de Cursor igual que el de Copilot y Claude Code, con sus propios archivos y la compuerta en el esquema de hooks de Cursor.
- [GitHub](https://kbspec.kabatasoft.com/integracion/github/): Issues como work items, sub-issues como sub tareas, y el Pull Request por la API de GitHub — solo, o con el tablero en Azure DevOps.
- [IBM Bob](https://kbspec.kabatasoft.com/integracion/ibm-bob/): kbspec gobierna el trabajo de IBM Bob igual que el de Copilot y Claude Code, con sus propios archivos y una compuerta que TI puede imponer.
- [Servidor MCP](https://kbspec.kabatasoft.com/integracion/mcp/): La base de conocimiento de kbspec, disponible para cualquier agente.
- [kbspec como plugin de agente](https://kbspec.kabatasoft.com/integracion/plugin/): Para cuando la organización exige que las personalizaciones de Copilot vengan de un plugin — empaquetar, probar y activar el marketplace del equipo, sin reemplazar la instalación.
- [El PR se revisa sin clonar](https://kbspec.kabatasoft.com/integracion/pr-sin-clonar/): La hoja de aprobación por repositorio y los enlaces al wiki — el revisor llega a la evidencia con un clic.
- [Hablarle a kbspec](https://kbspec.kabatasoft.com/integracion/voz/): El dictado de VS Code corre en la máquina y entiende español; kbspec dice qué le falta a cada máquina, reparte el modelo y entiende lo que llega dictado.

## Extensión de VS Code

- [El panel de VS Code](https://kbspec.kabatasoft.com/extension/panel/): El panel de kbspec dentro de VS Code — todos los requerimientos abiertos, las pruebas en el Test Explorer, la revisión del PR en el código y la sesión en vivo.

## Referencia

- [Comandos kb](https://kbspec.kabatasoft.com/referencia/comandos/): Referencia rápida del CLI. La versión completa vive en AYUDA.md, que viaja con el framework.
- [Diagnóstico y rastro](https://kbspec.kabatasoft.com/referencia/diagnostico/): Qué hacer cuando «kb dice X y vos jurás Y» — la ruta resuelta, la evidencia con KB_DEBUG, el log del framework y el canal del panel.