Saltearse al contenido

Comandos kb

El CLI kb es el único que escribe en el expediente. Todo comando acepta --json para herramientas. Esta es la referencia rápida; la completa —con la tabla de excepciones— está en AYUDA.md (kb ayuda, o kb ayuda --web).

ComandoQué hace
kb init <TICKET> "<título>" --tamano XS|S|M|LCrea un expediente nuevo y abre la sesión. XS: el cambio menor, una página
kb init … --en-la-copiaEl código de este requerimiento en la copia del inventario, como antes de 3.205.0, y no en su carpeta propia
kb init … --wid <N>El work item del tablero que ES este requerimiento, cuando su título no nombra el ticket o lo nombran varios: queda anotado y manda (después, kb tablero wid <N>)
kb abrir <TICKET>Retoma un expediente existente; si toca varios repositorios, lo abre en su ventana
kb abrir <TICKET> --otra-ventanaLo abre en su propia ventana sin tocar el requerimiento abierto en esta; no crea ramas
kb ventanaEl requerimiento abierto, en su ventana —su workspace—, si conviene
kb lectura [limpiar [TICKET]]Las copias de solo lectura de los requerimientos: cuánto ocupan, y borra las de los cerrados hace más de 30 días
kb renombrar <TICKET>El ticket temporal pasa al real: carpeta, documentos, pase y sesión, con el renombre en el rastro. Sin --si muestra el plan; con ramas ya creadas se niega
kb traslado exportar · importar <paquete> · verificarImporta un requerimiento ya desarrollado en otro ambiente de kbspec, con sus documentos listos para aprobar; exportar arma el paquete del otro lado. Sin --si, el plan. Importar un requerimiento de otro ambiente
kb estadoTodo lo que el agente necesita para orientarse
kb publicar ["msg"]Sube el expediente directo a la principal — al cierre de cada fase; el wiki se actualiza solo
kb publicar-base [-m]Los cambios compartidos (inventario, plantillas, config) por rama corta + PR con revisores
kb cerrarCierra la sesión del día
kb checkEstado de la instalación y qué sigue
ComandoQué hace
kb ramas en un requerimiento nuevoSu propia carpeta: un árbol de git por repositorio en <raíz>/<TICKET>/ (C:\kbw en Windows, ~/kbw en macOS y Linux), con la rama del ticket publicada y la configuración local copiada; tu copia no se toca. Los que empezaron antes de 3.205.0 siguen en la copia
kb ramas --traer-paseTrae lo nuevo del pase a la carpeta del requerimiento; si choca, queda para resolver ahí, con los archivos nombrados. kb ramas y kb pr avisan antes si el pase avanzó y el merge chocaría
kb ramas --traer <ruta…>Copia de tu copia a la carpeta del requerimiento la configuración local que no se versiona, sin pisar nada
kb ramasLa rama de trabajo lista y publicada en cada repo. Si hay cambios sin commitear, ofrece tres salidas y espera que elijas · --arbol abre el requerimiento en una carpeta aparte · --commit "<mensaje>" commitea acá y se cambia. En el árbol de una sesión de la ventana de agentes lo deja al día con la rama de trabajo (lo pone en su punta si recién nace; si ya trabajó, trae lo que integraron las demás) · --al-crear lo corre VS Code al crear ese árbol
kb tarea <T-NN> --iniciarArranca la tarea en un turno: rama, 🔄 y work item, digest de esa tarea, dónde va cada cosa, esquema de los archivos de referencia y aviso de modelo
kb tarea <T-NN> --hecho "…"Cierra la tarea en un turno: exige el build en verde, completa la bitácora, commitea en la rama de trabajo y marca ✅ (--sin-cerrar en lote, --sin-evidencia "<motivo>" a conciencia). Antes de commitear mira lo que entra: credenciales y secretos agregados no se commitean. Si la tarea debilita pruebas —borra, omite, quita aserciones, baja un umbral— pide --pruebas-motivo "…"
kb tarea <T-NN>Cierra (o reabre) una tarea del plan
kb listo¿El expediente está listo para implementar? LISTO / CON REPAROS / NO LISTO
kb listo --fase 2|3¿Alcanza la información para ENTRAR a esa fase? Solo sus mínimos — la plantilla intacta no pasa
kb elicitar <método>Segundo pase estructurado sobre un documento antes de aprobarlo
kb pruebasCorre las pruebas E2E (con preflight y ambiente)
kb pruebas init --app <APP>Siembra el proyecto E2E de la app (pruebas-e2e/) desde la ficha — el día cero (preparar lo llama solo)
kb pruebas prepararDeja la máquina lista: el proyecto E2E si falta, las dependencias fijadas con npm ci, el navegador que lanza
kb pruebas baseLa base E2E de la app, idéntica en cada rama de pase: la trae de la rama donde se validó (la referencia de la ficha), sin las pruebas de otro requerimiento ni lo de su máquina, y se integra a develop sin conflictos · --publicar deja la de esta rama como referencia · --verificar compara · --desde <rama> / --remoto <URL>
kb pruebas levantarEl ambiente local de las E2E arriba mientras se trabaja: las dependencias de la ficha juntas y después la app, cada una cuando responde su ruta de salud; las corridas lo reutilizan. Con un requerimiento abierto, solo lo común y lo de sus módulos (--modulo <M>, --modulo todos). Ctrl+C —o cerrar la terminal— lo baja · --fondo / --bajar para un agente (--fondo sale con 3 si una dependencia de otro ambiente no responde) · --en-orden · --logs
kb pruebas origenDe dónde sale cada dependencia que el requerimiento no cambia: la rama base en una copia de lectura (de fábrica), el clon del developer, otra rama, o el ambiente publicado sin levantarla. La ficha dice el del equipo; el developer lo confirma o lo cambia para su requerimiento
kb pruebas registroEl registro de las E2E de esta máquina: las corridas y cómo terminaron, sus tiempos, las fallas por clase, los reprocesos, cuánto tarda cada servidor en levantar y la configuración con que corrió cada una. --exportar <archivo> lo deja, sin secretos, para mandarlo
kb pruebas validarPrueba la base de punta a punta antes de escribir pruebas —ficha, máquina, certificado, login de cada usuario, cada pantalla— y da el primer paso rojo con su arreglo
kb pruebas demoLa misma base contra una app de prueba que trae kbspec: ¿el problema es la máquina o la app?
kb pruebas grabarRecorrés la app con el grabador de Playwright: el login y la entrada van a la ficha (o se comparan), y las pruebas salen de los criterios del brief con el camino y los controles grabados. Varias grabaciones, una por perfil (--para, --lista, --descartar, --rehacer)
kb pruebas mapaUn borrador del Mapa de navegación desde el código (rutas, menús, Web.sitemap)
kb pruebas login --asistidoEl login que no se automatiza (SSO con MFA) lo hace la persona una vez; la sesión se reusa mientras sirva
kb pruebas estrategia [--aplicar]Con qué framework se escriben las unitarias; en cero, con comandos de arranque
kb pruebas doctorPreflight: detecta el frontend y apunta a sus prácticas
kb pruebas ambienteSondea esta máquina una vez —Node, navegador que lanza, proxy, qué contesta la app— y deja el perfil que usan las corridas
kb pruebas login --verificarPrueba el login aislado, con una captura por usuario
kb pruebas condicionesLo que hay que probar, derivado del 02: feliz, falla, permiso denegado, límites, obligatorios — cada uno con su oráculo
kb escalar <S|M|L>El cambio creció: sube el tamaño, con el porqué en el rastro de auditoría
kb pruebas sesionLa app pausada para el CLI de Playwright, con el usuario y el ambiente correctos: el camino principal para escribir y sanar E2E
kb pruebas agentesEl generador oficial de Playwright con el plan de kbspec, sin el planner ni el healer — solo si el MCP está habilitado
kb pruebas rutasDónde van a quedar los archivos de prueba, según la ficha, y qué hay escrito fuera
kb pruebas --faltantesNo repite lo que ya tiene evidencia en verde posterior al último cambio del repositorio
kb pruebas --solo compilar --acotadoCompila solo lo de la tarea en curso (o, sin una, lo de la matriz de impacto) y sus dependientes. En Angular (ng … o nx … <proyecto>, también detrás de volta run o cross-env), la configuración development, los specs de lo cambiado y ESLint sobre esos archivos. Lo completo va una vez, al final
kb paralelo <TICKET>Carpeta aparte (worktree) con su propia rama para trabajar otro requerimiento, con kbspec adentro —para los que empezaron antes de 3.205.0; los nuevos ya trabajan en su carpeta— · --cerrar publica lo pendiente y quita sus carpetas
kb paralelo --listar · --limpiarLos árboles derivados que hay —incluidos los que crea la ventana de agentes de VS Code— y sacar los sueltos
kb hojaLa hoja de aprobación del PR, por repositorio: qué evidencia exige su ficha y cómo salió (--cuerpo muestra el texto del PR)
kb uat importar <json>Vuelca al 07 lo que devolvió el usuario, con sus capturas
kb uat reabrir --hallazgo "H-NN: …"Defectos en staging: ronda de corrección — tareas T-C, fase atrás, otro PR
kb exportar [--docs]El brief curado para exportes a medida: presentación, resumen ejecutivo, modelo ER
/kb-entrega (skill)Prepara la entrega y la base de conocimiento
kb retro <ÉPICA>Retrospectiva de una épica
kb retro --entorno [--ultimos N]Por qué tropezó el agente, contado del rastro: lo que se repite y qué cambiar; --aceptar N lo deja como aprendizaje
ComandoQué hace
kb flujoRitmo real de entrega: ítems cerrados por sprint
kb pronostico [--items N | --backlog]Monte Carlo: cuántos por sprint, o en cuántos sprints se drena N
kb modelo [fase] [--revisar] [--mapear …]Qué clase de modelo conviene, medición y mapeo
kb modelo --validarTarifas al día y MODELOS.md contra el catálogo de Copilot y contra lo que VS Code ofrece en la máquina — lo mismo que kb init corre antes de crear
kb tokensCuánto consumió el requerimiento, con su costo: lo facturado por Copilot donde lo hay y la estimación por tarifa solo del resto, con su base y la calibración
kb tokens --anatomiaEl diagnóstico del consumo, de las dos bases de Copilot: por conversación, agente, modelo, herramienta y tarea; créditos facturados; contrafactual de modelo
kb tokens --diagnosticoPor qué el consumo sale en cero: recorre la cadena entera y dice dónde se cortó
kb tokens --diagnostico --para-iaEl diagnóstico completo del consumo, para dárselo a una IA: lo que cobró Copilot contra lo anotado, conversación por conversación
kb tokens --conciliar-sesiones [--aplicar]Las sesiones de la ventana de agentes con más anotado que lo que Copilot cobró; con --aplicar, las filas de más salen a consumo-anulado.jsonl, con el motivo
El chat de VS Code, de sus registrosLo que la base de trazas del chat no tiene se mide de los registros de cada conversación (chatSessions), con los créditos que Copilot factura por pedido, una vez cada uno y para el requerimiento de esa conversación
kb tokens --vivoLa conversación que trabaja ahora —del chat de VS Code o de la ventana de agentes—: contexto, % de la ventana, créditos facturados, herramientas y modelo contra la fase
kb tokens --organizacionLos créditos que GitHub facturó a la organización, por modelo y usuario
kb presupuestoCuánto va el requerimiento contra lo que cuesta uno igual en el equipo (p75 de los entregados del mismo tamaño); avisa al 80 % y al 120 %
kb presupuesto autorizar --hasta N --motivo "…"Una persona autoriza seguir pasado el tope, cuando el equipo exige presupuesto (MODELOS.md)
kb chat registrar <export.json>El chat exportado por VS Code, guardado en el expediente con modelo, tokens y créditos por pedido
kb metricasCómo va el proceso sobre todos los expedientes
kb estadisticas [--por sprint|mes|anio]Requerimientos, entregados, tokens, costo y devs por período
ComandoQué hace
kb tablero check --escribirConecta el expediente con Azure DevOps
kb tablero loginAutenticarse por navegador (Entra ID), sin az — queda guardado y se renueva solo
kb tablero sincronizarRefleja el expediente en el tablero: las tareas cuelgan siempre del work item del requerimiento (con su iteración y su área), con la descripción en HTML y el número de cada tarea en su ficha
kb tablero ticket "<título>"Crea el work item de un requerimiento nuevo
kb tablero url <URL> [--codigo]Fija organización y proyecto desde la URL de un work item, tablero, repositorio o wiki; con --codigo, dónde vive el código
kb wiki [--escribir|--publicar]La URL del wiki que enlazan los PR: la deduce del remoto, la escribe o publica el wiki
kb actualizar [--revisar]Trae e instala la versión que publica tu equipo (rama del repositorio o .tgz del repo de documentación)
kb distribuir [--push]Publica el instalador para el equipo: la rama kbspec/instalador y el manifiesto
kb integracion probar [--escribir] [--repositorio <URL>]Qué se puede y qué no contra el tablero y cada repositorio (identidad, permisos, PR), con la corrección
kb integracion reporte [--escribir] [--salida <archivo>]Un archivo con las credenciales, la configuración, las últimas llamadas y el patrón por credencial y método; sin secretos
kb integracion asistentePaso a paso para conectar el tablero, verificando después de cada paso
kb cuestionario --para "<quién>"Las preguntas abiertas del 01, como hoja para quien puede contestarlas
kb configuracion --asistenteConfigurar conversando: explora, propone y solo pregunta lo que falta
kb glosario · --agregar · --evitarEl lenguaje del negocio que los agentes leen antes de responder, y las palabras que el equipo no usa: kb validar avisa dónde aparecen
kb integracion credencial --tablero · --codigoUn PAT por organización, para cuando las tareas y el código viven en organizaciones distintas de Azure DevOps — deduce cuál, dice qué scope necesita y lo prueba al guardarlo
kb integracion credencialesLas fuentes de credencial una por una, con el porqué; nunca el valor
kb integracion log [--ultimos N]La bitácora de cada llamada al tablero y a los repositorios
kb integracion login · logoutLo mismo que kb tablero login; borrar el login guardado
kb integracion hosts [--agregar <host>]A qué servidores les manda credenciales esta máquina: Microsoft y la propia siempre; un Azure DevOps de la casa, solo si se declara acá (no en TABLERO.md)
ComandoQué hace
kb init-docs "<ruta>"Crea o conecta el repositorio de documentación
kb init-repo [--ia opencode]Prepara un repositorio de código; al final dice qué quedó sin commitear. Con OpenCode presente siembra opencode.json y su plugin de compuerta
kb updateRegenera skills, agentes y prompts; termina con código distinto de 0 si no pudo traer la versión nueva
kb perfil / kb modeloConsultan la configuración vigente
kb auditoriaLee y verifica la bitácora encadenada, también contra sus anclas fuera del archivo (etiquetas kbspec-rastro/… que sube kb publicar); --base <ref> la compara con la de la rama destino del PR
kb mcpLevanta el servidor MCP
kb ayudaLa guía completa (--web la abre con diagramas)

Generada desde el árbol de comandos de la CLI (kb --help): si un comando existe, está acá; si está acá, existe. La descripción larga de cada uno vive en AYUDA.md (kb ayuda).

ComandoQué hace
kb abrirretoma un expediente: trae la documentación, abre la sesión y deja las ramas de trabajo listas
kb agentsgenera AGENTS.md y los prompts de Copilot
kb alcancequé se toca y qué ramas se van a crear
kb appsinventario de apps; con un término, resuelve el nombre
kb apps verificar [APP] [--aplicar]el inventario contra el código: lo que cada componente consume de verdad, rutas, base de datos sin scripts y lo que le falta a cada ficha
kb preparacion [APP…] [--refrescar] [--estado]qué le falta a cada app del requerimiento para que el agente lea y no explore: diez chequeos (ficha, confirmación, huecos, clasificación, índice, inventario, herramientas, referencias, E2E, estándares) escritos por app en preparacion-<APP>.md, con los pasos en orden y quién da cada uno; vence por fecha, por el código o por la ficha, y la reutiliza el próximo requerimiento
kb apps actualizar [--ver]fichas e inventario al formato de esta versión (lo hacen solos kb update y kb instalar)
kb aprendizajeanota lo que el requerimiento enseñó para la base de conocimiento —una regla de código, un estándar, un módulo o un componente nuevo, un término— o lo resuelve: --en-la-base <archivo> o --no-va "<porqué>"
kb aprendizajeslo aprendido en el requerimiento, lo que kbspec detecta y nadie anotó, y lo que la base tiene sin publicar; kb finalizar no cierra con algo pendiente
kb aprobaruna persona aprueba un punto de aprobación —el alcance, la solución— o un documento, después de revisarlo: con el agente, lo escribe ella en el chat —«aprobado alcance»— y kbspec lo registra; desde una terminal, lo confirma ahí; firma con la identidad de la sesión del sistema y queda atada a la versión aprobada. --estado y --diff solo miran: cómo está cada aprobación, y qué cambió desde la aprobada (la busca en el historial de git)
kb aprobacioneslos puntos de aprobación del expediente y cuál espera; antes de aprobar, qué falta y quién lo resuelve; detalladas para aprobar de a un documento
kb cambiocon la implementación abierta, el cambio en curso: qué documentos aprobados cambiaron y todo lo que falta para aprobarlos juntos. listo arregla lo mecánico —las filas del tablero, la verificación y los casos de las tareas nuevas—, revisa todo junto y, si no falta nada, deja pedir una sola frase: «aprobado cambio»
kb ejecucioncómo se implementan las tareas: en paralelo (de fábrica con un 04: «aprobado solución» lanza el lote) o secuencial, de a una
kb aceptaruna persona acepta una brecha o un hallazgo con su motivo —«acepto RF-03: por qué»—: deja de frenar y queda en el rastro
kb revisionla vista de revisión de un punto de aprobación, en HTML; con --hallazgo, el agente registra lo que encontró leyendo
kb vigentelo que vale hoy de la captura, calculado: decisiones vigentes, preguntas, supuestos e insumos
kb impactoqué revisar si cambia una decisión, una regla o un requisito
kb arquitecturacompara la ficha de arquitectura contra el código; <APP> --ver, la página de su arquitectura —componentes, plataforma, lo decidido, lo que falta y sus épicas—
kb auditoriabitácora de auditoría del expediente: qué se corrió y quién
kb informe [TICKET]cómo se comportó kbspec en el requerimiento, en un .md para que lo analice una IA (no registra nada nuevo)
kb ayudareferencia rápida; —web abre la guía con diagramas; con imprime solo esa sección de AYUDA y CONVENCIONES
kb bitacorasiembra en el 05 la entrada de una tarea con lo que git y el expediente ya saben (archivos, commits, evidencias)
kb cerrarpublica el trabajo (expediente y código) y cierra la sesión
kb checkverifica requisitos, instalación y puesta a punto de este repositorio
kb init-repo --pipelineescribe azure-pipelines-kb-pr.yml con las ramas de la estrategia (la de producción de ese repositorio y las de integración): el check kbspec/expediente como Build Validation
kb apps nueva <NOMBRE> · --desde <captura> [--aplicar]¿de verdad es nueva? · dar de alta una aplicación, módulo o componente que todavía no existe: inventario por crear, ficha con lo decidido y portada de la guía funcional
kb apps repo <COMP> [--crear]el repositorio de un componente por crear: dónde va, su rama y el comando para el servidor; --crear, la carpeta con git y kbspec
kb apps editar <CÓD> --estado activoquitar la marca por crear cuando el código existe
kb apps editar <APP> --rama-base <rama>la rama de producción de un componente, si no es la de la estrategia (main de fábrica)
kb diagnosticoadónde se fue el tiempo en las sesiones del agente, las herramientas que corrieron sin compuerta, las relecturas, cada gancho por dentro y —con --medir— cuánto tarda la máquina en arrancar cada cosa; termina con qué conviene
kb punto · kb diff --desde · kb volverpuntos de restauración: una foto del código en cada aprobación y cada tarea; qué cambió desde ahí; volver (lo decide la persona)
kb git <lo de git>un git sin vuelta atrás (reset --hard, clean -f, push --force, --no-verify…), confirmado por la persona en la ventana de kbspec: el gancho se lo niega al agente y le propone esto
kb check --ganchossi las compuertas actúan en la máquina: cuánto tardan los ganchos, cuántos pasaron de 30 s, las veces que kbspec contestó por plazo, las sesiones que quedaron esperando a la persona y las herramientas que la compuerta no reconoce
kb check --seguridadlo que un auditor pregunta de la máquina: escapes puestos, permisos de las credenciales, a qué servidores irían, qué sale a internet — sin mostrar un valor
kb check --vozqué le falta a la máquina para dictarle a kbspec con el dictado de VS Code: versión, políticas, ajustes y el modelo. Hablarle a kbspec
kb check --studiosi la máquina cumple con kbspec Studio: extensiones y si la política las deja, el perfil, las políticas de VS Code y las managed settings de Copilot, los ganchos de kbspec gestionados o sueltos, el plugin y el servidor MCP
kb checklistpreguntas a responder según lo que el cambio toca
kb configuraciontodo lo que kbspec tiene configurado, en un lugar
kb configuracion --item <id> · --wikiun ítem de la puesta a punto · la página del wiki
kb configuracion descubrir [<carpeta>] [--app X]lo que el código y git contestan de la puesta a punto —aplicaciones, partes, stack, pruebas, responsables, plataforma, prefijo, ramas—, con su certeza y las preguntas para una persona; no escribe nada (/kb-configurar lo conduce)
kb configuracion --prefijo <PREFIJO>el prefijo de los tickets, anotado en ~/.kb/config
kb configuracion probar · diff <ARCHIVO>lo que la configuración no dice como está escrita (defectos que no existen, filas descartadas, claves que no se leen) · qué mejoró el framework en una semilla
kb estandareslos estándares de programación: base recomendada, lo que hace el código, el documento interno y su calidad
kb estandares base|detectar|revisar|importarla base de una tecnología (y --comparar con el código) · lo que el código ya hace · lo que le falta a cada regla · el documento de la casa, para citarlo
kb cicloel ciclo que rige para el equipo: por fase, su nombre, el agente que la lleva, la compuerta y los pasos propios (aplicaciones/CICLO.md)
kb lotelas tareas del plan en olas para correr en paralelo: qué va junto, qué lo impide y en qué estado está cada una
kb lote preparar|correr|verificar|integrar|finalun árbol y una rama por tarea con su brief · los agentes con la CLI de Copilot · la verificación de cada tarea en su árbol · el merge a la rama de trabajo · todo junto
kb lote revisar [--cerrar]la revisión del conjunto integrado: el paquete, los choques entre tareas y, con --cerrar, una tarea de corrección con lo abierto
kb lote autorizar --hasta <créditos>una persona autoriza el lote sin supervisión, para este plan y hasta un tope de créditos —en el chat, «aprobado lote <créditos>», que aprueba también el plan—; sin eso kb lote correr no lanza nada
kb lote informeel veredicto de un lote: en paralelo o no, cuánto más rápido, verificado e integrado, qué modelo usó cada tarea y cuánto costó, según los registros de Copilot (ventana de agentes y chat)
kb lote demo --modelo <id>una prueba armada en una carpeta propia para validar en esta máquina que las tareas corren en paralelo con ese modelo, sin tocar la configuración real
kb plugin empaquetar|probar|activar|desactivarkbspec como plugin de agente (Agent Plugins 1.0), a pedido: el marketplace con lo que rige para el equipo, su revisión, y su activación en .github/copilot/settings.json — la instalación de siempre no cambia
kb studio [perfil|plantillas]kbspec Studio, sin fork de VS Code: el perfil de VS Code (kbspec.code-profile: extensiones del stack, los ajustes de kbspec y la tarea del árbol) y las políticas para TI —VS Code en sus tres formatos y las managed settings de GitHub, con su LEEME—. Solo genera archivos
kb ciclo aprobar|correr|probaruna aprobación con --por (una persona) · el comando de un paso, con su evidencia · lo que no va a funcionar como está escrito
kb configuracion fijar|verificar|personalizarcambiar un valor · la confirmación de una persona · crear un archivo con su contenido de fábrica
kb contextoqué leer antes de tocar una app, y si sigue vigente
kb investigaruna duda que solo responde el código, en cualquier fase: abre la nota investigaciones/I-NN con el plan de lectura
kb investigacionlisto I-NN le muestra al developer el resumen y el archivo; decidir I-NN referencia|no-aplica|incorporar (de la persona); nueva (los tres caminos sin requerimiento), abrir/cerrar/convertir INV-…, traer <origen>
kb investigacioneslas investigaciones del expediente, con su estado y su decisión
kb contratos sembrar|buscarlos contratos de una API desde su OpenAPI —el que el código ya tiene, sin levantar el servicio—, o una operación sola
kb derivacompara el análisis con lo realmente modificado (las pruebas y la documentación no son deriva)
kb desinstalarquita el framework de esta máquina
kb diarioel insumo del standup: quién tiene qué, qué se movió y qué está trabado
kb elicitarmétodos de razonamiento para un segundo pase sobre un documento antes de aprobarlo (pre-mortem, inversión, red-team…)
kb empaquetararma el paquete limpio para publicar o compartir
kb epicauna iniciativa que se entrega en partes, no de una vez
kb epica EP-NNNN partes --desde <json> [--aplicar] · revisarvarias partes de una vez · si está lista para arrancar (horizontales, L, cimiento)
kb epica EP-NNNN fundamentos [--aprobar] · interfaz [--ver]lo que hace falta para empezar a programar una app nueva, en el inventario · la guía visual de la app
kb epica EP-NNNN requerimientos [--tickets …] [--temporales] [--aplicar]un requerimiento por parte, ligado a la épica y por tomar (kb abrir)
kb epica EP-NNNN tablero [--wid N | --crear] · prototipola épica en el tablero, con sus requerimientos debajo · el prototipo de cada parte
kb caminoantes de kb init: si la app existe, está por crear o no está, si hay una épica con partes libres, el tamaño (o la épica) con su porqué y los pasos
kb partirun requerimiento que creció se vuelve épica: el de la sesión queda como su primera parte
kb erddiagrama de entidades desde las fichas EN (opcional)
kb estadisticaspor sprint, mes o año: requerimientos, entregados, tokens, costo y devs
kb estadoqué expediente está abierto, en qué punto va y a qué sprint pertenece (el de su work item)
kb estrategiaestrategias de ramas: cuáles hay, cuál rige, cuál usar
kb estructura [<APP>]dónde va cada cosa nueva y qué ya hay ahí — antes de crear un archivo o carpeta
kb bandejalos requerimientos abiertos en esta máquina y lo que espera cada uno (—json)
kb comentarioslo que G-Bot, la revisión y DBA dicen del código, con archivo y línea (—json)
kb expedienteslista los requerimientos y su estado (—json)
kb preguntar "<pregunta>" [--app X] [--tipo …]contesta con las secciones que responden —guía funcional, reglas, ficha, inventario, glosario— y su fuente; --exportar <archivo.jsonl> lo deja todo para otro asistente
kb funcional [<APP>] [sembrar [--completar]] · guiala guía funcional de una aplicación: qué le falta · el esqueleto desde el inventario y las pantallas del código · el manual del formato
kb buscar <texto…>busca DENTRO de los documentos — «¿alguien ya resolvió esto?». Se piden todas las palabras, sin importar tildes; entre comillas, la frase exacta (--todo, --json)
kb exportarinsumos curados para componer un exporte personalizado (presentación, resumen ejecutivo, modelo de datos)
kb ficha sembrar|compactar|cosechar|guiala ficha de arquitectura: sembrarla con la evidencia del código, dejarla en solo datos, proponer sus huecos desde las reglas del equipo, y su manual por sección
kb finalizarda el requerimiento por terminado: verifica, marca ENTREGADO y COMPLETADO, publica y cierra
kb flujoritmo real de entrega: ítems cerrados por sprint (throughput)
kb grafografo navegable de la base de conocimiento (visor OKF)
kb hojala hoja de aprobación de cada repositorio: qué evidencia se le exige y cómo salió
kb hooklo ejecuta VS Code al cerrar una fase (Agent Mode)
kb htmlgenera expediente.html por demanda para leer y revisar — con el ciclo y el impacto ya dibujados; kb publicar no lo genera
kb html --indicetodo el repositorio en dos páginas navegables con barra lateral y buscador: configuracion.html y requerimientos.html; rehace además el expediente.html de TODOS los requerimientos
kb idslos identificadores del expediente como símbolos de código: dónde se define cada uno (archivo, línea, texto), quién lo cita, con qué se relaciona y su brecha — lo que usa el editor para ir a la definición, ver las referencias y autocompletar
kb uat importarvuelca al 07 el archivo que devolvió el usuario
kb initcrea el expediente de un requerimiento y abre la sesión
kb instalardeja la máquina lista y la vuelve a dejar lista: detecta, pregunta lo que falte, prepara cada repositorio (kb update hace lo mismo)
kb init-docscrea el repositorio central de DOCUMENTACIÓN
kb init-repoprepara un repositorio de CÓDIGO
kb insumoregistra en entradas/ un documento del usuario; si trae tarjetas, cuentas IBAN o secretos entra enmascarado (o no entra)
kb interfazficha de interfaz de una app: la redacta leyendo el código
kb libreuna persona habilita escribir código sin requerimiento abierto en este repositorio, por unas horas (--estado, --cerrar); sin eso, la compuerta lo niega con cualquier agente
kb listo¿el expediente está listo para implementar? veredicto consolidado antes de la fase 5
kb mapa construir|buscar|similares|vecindario|estado|indice|recetael mapa estructural de una app: qué archivo hace qué y qué está conectado con qué —del componente a la tabla, entre lenguajes—, con la confianza de cada vínculo y su vigencia contra tu copia, sin recorrer el repositorio
kb mcpservidor MCP: expone la base de conocimiento a cualquier agente; publica las herramientas de la fase del requerimiento abierto —kb mcp --herramientas dice cuáles—, y todas con KB_MCP_TODAS=1
kb metricascómo va el proceso: flujo, calidad y adopción
kb modeloqué clase de modelo conviene en cada fase, y por qué
kb paneltodo lo que el panel de VS Code pinta, en un solo JSON
kb paraleloprepara una carpeta aparte (git worktree) para trabajar OTRO requerimiento en paralelo, con su propia rama
kb pasefija o cambia el pase (PN) del expediente — mueve la fila entre pases/*.md
kb perfilperfiles de documentación: cuánto se escribe en cada fase
kb plan-uatgenera el plan de pruebas EN BLANCO para el usuario final — después de kb pr aprobado
kb prueba-ciclo [--app portal|simple] [--escenarios …] [--presupuesto USD] [--motor claude|copilot] [--hasta <fase>] [--continuar] [--limpiar]la prueba del ciclo completo, sola: arma una carpeta propia —de fábrica, un portal Angular con módulos federados y tres APIs .NET— y lleva un requerimiento de la solicitud al borrador del PR con el agente de siempre; kbspec hace de persona, corre escenarios del ambiente (APIs caídas o con errores, un módulo sin servir, todo ya levantado) y deja un diagnóstico (tiempos por fase, comandos lentos, compuertas, escenarios, costo) en <carpeta>/diagnostico/
kb plantillasplantillas del expediente: personalizarlas sin bifurcar el framework, ver si el framework las adelantó, y abrir desde ellas el documento de cada fase (abrir, completar)
kb prarma el Pull Request con las ramas, el work item y los revisores ya resueltos — en el proyecto del código, con enlace a cada evidencia y las capturas incrustadas
kb pr estado --publicarel check kbspec/expediente en el PR del código: verde si el expediente lo respalda (trazabilidad, tareas, P0, rastro), rojo con los motivos; una política de rama lo puede exigir
kb pr plantilla [--escribir]la plantilla del equipo para este PR, resuelta (aplicaciones/pull-requests/)
kb pr --hacia <rama> · --repositorio <URL>el PR de otro salto de la cadena · la URL del repositorio cuando el remoto no la dice
kb pr gbot leer --esperar [--de ARCHIVO]trae del PR la revisión de G-Bot apenas la publica —o, con --de, la importa de un archivo guardado a mano— —solo los issues: las sugerencias de mejora se cuentan y no se implementan—, con el número con que G-Bot va a contar cada uno
kb pr gbot decidir <#> --aplica|--no-aplica --porque "…"la decisión de cada issue; un «no aplica» exige la justificación técnica
kb pr gbot responder [--publicar]arma la respuesta con todos los issues —en la forma que lee el seguimiento de G-Bot, una sola sección—, la verifica como la va a leer G-Bot y la muestra; con --publicar la publica la persona, exactamente lo que se mostró
kb pr gbot cerrarsin issues en la última revisión de G-Bot: escribe la evidencia E08 desde los datos de cada ronda
kb pr hilos leer · decidir <#> --aplica|--no-aplica --porque "…"los comentarios del revisor en el PR, uno por uno, con el mismo ciclo que G-Bot
kb pr cambios --hilosuna tarea T-R por cada comentario del revisor que aplica (lo confirma la persona)
kb pr hilos responder [--publicar]responde cada hilo —con la tarea y el commit— y lo marca Resuelto o No se corregirá; lo publica la persona
kb vbel visto bueno de los scripts de base de datos con el equipo de DBA, después del PR aprobado: dónde está el trámite
kb vb preparar [--adjuntos N]reparte los scripts del ticket en partes —ningún objeto partido, en orden de dependencias, y recién entonces el tope de adjuntos— y escribe el documento de cada una con la plantilla del equipo (aplicaciones/VISTO-BUENO.md)
kb vb solicitaruna tarea por parte en el tablero de DBA (vb_proyecto) con los scripts adjuntos —cada uno enlazado desde el orden de ejecución—, el pase como etiqueta y la iteración vigente de ese tablero; lo confirma la persona
kb vb leer · analizar [#…] · decidir <#> --aplica|--no-aplica --porque "…" [--segun "…"]las observaciones de los DBA (texto de un tercero: se señala lo que da órdenes y no se ejecuta nada) y el estado de cada tarea; la ficha de cada una contra el 02, el 03 y el estándar de BD; la decisión con su respaldo —lo que aplica abre la ronda de corrección (T-C)—
kb vb responder [--publicar] · cerrarla respuesta de cada tarea, que publica la persona después de leerla (los scripts que cambiaron reemplazan al adjunto anterior y el comentario lo dice); con todas las partes aprobadas, la evidencia, el 00, el 08 y el work item del requerimiento
kb sqlproj [--requerimiento PN-X]el proyecto SQL de Visual Studio (.sqlproj) sincronizado desde los scripts del ticket —solo los objetos que ellos tocan, nunca la base compartida—: la vista previa con el diff
kb sqlproj --aplicar [--aprobar-eliminaciones]escribe lo del plan y lo incluye en el .sqlproj; los DROP solo con aprobación; si la compilación falla, restaura todo. Sin commit ni PR
kb sqlproj descubrir <carpetas…> --config <archivo>qué .sln, .sqlproj y carpetas de scripts hay, y el borrador de aplicaciones/<APP>/sqlproj.json
kb preciostarifas por modelo; —actualizar las trae de GitHub
kb pronosticocuántos ítems por sprint, o cuántos sprints para N — Monte Carlo
kb prototipovista previa del diseño de pantallas (opcional)
kb prototipo --explorarEl prototipo antes de que haya qué especificar: tres variantes que discuten la estructura, para un módulo nuevo
kb prototipo --comportamientoPara cuando la pregunta es cómo se comporta y no cómo se ve: un flujo que se aprieta, con recorridos guiados
kb prototipo --decidirCierra la ronda: qué variante ganó, qué preguntas contestó y cuáles abrió, de vuelta en el expediente
kb prototipo --capturar <URL>abre la pantalla con ventana, deja elegir un elemento con el mouse y guarda su HTML, estilos computados y un recorte — para cuando no hay prototipo contra el cual medir
kb pruebascorre los comandos de la ficha y guarda la evidencia
kb publicarcommitea y sube el expediente para que otros lo vean
kb publicar-basepublica solo los cambios compartidos (inventario, plantillas, estándares, skills) sin un requerimiento
kb ramasdeja la rama de trabajo lista en cada repo del expediente
kb uat reabrirhallazgos en staging: abre la ronda de corrección (tareas nuevas, fase atrás, otro PR)
kb recursosla base de conocimiento como documentos adjuntables
kb refinamientoel acta ítem por ítem: nueva, sesion, verificar (ticket y pase), ejecutar (de la persona: comenta o crea el ticket), pendientes, ticket, tomar (crea el expediente y exige el pase), y consumo
kb renombrarel ticket temporal pasa al real: carpeta, documentos, pase, índices y sesión, con el renombre en el rastro
kb vozel paquete del modelo del dictado de VS Code: TI lo publica (publicar), cada developer lo trae verificado (instalar)
kb trasladoexporta un requerimiento —documentos y código— en un paquete, y lo importa en otro ambiente de kbspec
kb reparar-docsdeja en orden el repositorio de documentación si una publicación lo dejó a medias (conflictos, rebase, stash): lo que kbspec rehace solo se arregla solo, lo que escribió una persona se nombra y no se toca
kb reporte-pruebasexporta unitarias + E2E (con capturas) + plan: html/docx/pdf
kb solicitudtrae al 01 lo que la tarea del tablero ya dice (descripción, criterios de aceptación, área, solicitante), sus comentarios y sus adjuntos (a entradas/); lo que no se puede bajar se dice para registrarlo a mano — kb init lo hace solo
kb retrocrea la retrospectiva de una épica (qué se entregó, qué se aprendió, qué se promueve a la base de conocimiento)
kb revisardependencias vulnerables del requerimiento
kb revisar --paquetedeja el diff a revisar en un archivo por componente, para pasarle la ruta a cada lente en vez del contenido
kb revisar --cruzada [--modelo X] · --cruzada --registrara pedido, apagada de fábrica: revisar con un modelo de otra familia que la que escribió el código (y que la clasificación del dato permita); --registrar deja la E09 con quién revisó
kb revisar --hallazgo "…" · --hallazgos · --cerrar R-NN · --descartar R-NNanota los hallazgos de la revisión de código en el 05 (antes vivían solo en el chat). Un hallazgo Alta abierto frena kb pr; descartar exige el motivo
kb skillslas skills del equipo —del framework, propias y modificadas— y lo que hay que decidir después de un update
kb skills nueva|modificar|habilitar|deshabilitar <nombre>el administrador las cambia en el repositorio de documentación; llega a todos con kb update y un update del framework no lo pisa
kb skills reglaslas reglas duras de cada skill, con su porqué
kb spec¿el 02 dice lo suficiente y de forma verificable? Requisito por requisito: criterio de aceptación, ejemplo de cada regla con fórmula, y nada apoyado en un adjetivo sin cuantificar
kb skills probar --emitirlos escenarios de presión que ponen a prueba esas reglas; --resultado <json> dice cuáles aguantaron
kb skills probar --correr [--modelo <id>] [--veces N]los mismos escenarios, corridos solos con la CLI de Copilot en una carpeta limpia y con la skill como instrucciones; aguanta si todas las corridas eligen bien
kb sistemasqué componentes toca el expediente (los que ramifica kb ramas): los fija en todos sus documentos
kb tableroverifica el tablero (Azure DevOps) y descubre sus estados
kb tareainicia, cierra (--hecho, con la compuerta) o reabre tareas del plan
kb tokenscuánto consumió el requerimiento, por fase
kb chatel chat exportado por VS Code, guardado en el expediente
kb uatresultados de la validación del usuario
kb updateactualiza el framework
kb usuariosusuarios de prueba de una app (para elegir con cuál correr)
kb lecturalas copias de lectura de los requerimientos: cuánto ocupan; limpiar borra las olvidadas
kb validaraudita el expediente; código ≠ 0 si hay brechas
kb ventanael requerimiento abierto en su ventana: arma su workspace y lo abre, si conviene
kb versionmuestra la versión
kb wikila URL del wiki que enlazan los PR: detectarla, escribirla o publicar el wiki
kbspec es un producto de Kabata Soft contacto@kabatasoft.com © 2026 Kabata Soft S.A. Todos los derechos reservados.