Configuración del equipo

La configuración vive versionada en el repositorio de documentación (aplicaciones/), editable por el equipo sin tocar código. kbspec la lee en cada fase.

Para recorrerla en orden no hace falta abrir archivo por archivo:

kb configuracion              # la puesta a punto: qué falta, para qué sirve y cómo se completa
kb configuracion probar       # lo que no va a funcionar como está escrito

La puesta a punto va en seis etapas —la máquina, lo mínimo, calidad, gobierno, el método y la medición— y cada ítem dice su estado. predeterminado quiere decir que rige lo de fábrica y no hay que tocarlo. Lo pendiente lo completa quien administra kbspec con /kb-configurar <ítem>, y lo confirma una persona con kb configuracion verificar <ítem> --por "<nombre>".

Lo que siembra kb init-docs

Archivo	Para qué
INVENTARIO.md	Las aplicaciones y sus fichas de arquitectura: de qué componentes está hecha cada una y en qué repositorio vive. De ahí salen las ramas (kb apps)
TABLERO.md	Conexión con Azure DevOps —o con GitHub, plataforma: github— y el largo del sprint (sprint_dias). Ver Azure DevOps
RAMAS.md	Convención de ramas y modo de trabajo con Git (kb estrategia)
PERFILES.md	Cuánto se documenta y con cuánto detalle — sin cambiar el ciclo ni la trazabilidad (kb perfil)
CHECKLISTS.md	Preguntas a responder según lo que el cambio toca (interfaz, datos, integración, seguridad, migración)
MODELOS.md	Qué clase de modelo conviene en cada fase y a qué modelos reales la mapea el equipo, y el presupuesto por requerimiento. Ver Modelos por fase
PRECIOS.md	Tarifas por modelo, para costear el consumo en dólares y créditos. Las que faltan se completan solas una vez por día (kb precios)
IA.md	La política de IA: proveedor, si los datos entrenan modelos, qué puede salir hacia el modelo, retención y quién la aprobó. Ver La IA bajo política
PULL-REQUEST.md	Qué evidencia exige el PR según el tipo de componente, mientras su ficha no lo diga, y cómo se redacta la descripción
VISTO-BUENO.md	La tarea de visto bueno que ve el equipo de DBA: el título, la descripción (contexto, objetivos, orden de ejecución con cada script enlazado a su adjunto, detalle) y las respuestas a sus observaciones
pull-requests/	Las plantillas del PR según adónde va (el pase, develop, main), la aplicación o el equipo. Ver El PR se revisa sin clonar
PUBLICACION.md	Cómo sube sus cambios este repositorio: directo o por PR, hacia qué rama y con qué revisores. Ver Publicar la documentación
SKILLS.md	Las skills que no se usan como vienen —propias, modificadas, deshabilitadas— y qué va a los repositorios de código: el servidor MCP y las skills de administración (kb skills)
ELICITACION.md	Los métodos del segundo pase sobre un documento antes de aprobarlo (kb elicitar). Ver La elicitación
GLOSARIO.md	El vocabulario del negocio: los agentes lo leen para no inventar nombres (kb glosario)
estandares/	Las reglas de programación: comunes.md, base-de-datos.md y una por tipo de componente (kb estandares)

kb init-docs --minimo siembra solo cuatro —el inventario, el tablero, la política de IA y las reglas comunes—. Lo demás rige igual que si estuviera, y se crea con kb configuracion personalizar <ARCHIVO> el día que alguien lo quiera cambiar.

Lo que se crea a pedido

Archivo	Para qué	Cómo
<APP>/arquitectura.md	La ficha de cada aplicación: lo que el agente lee en vez de explorar el repositorio. Solo datos; su manual, kb ficha guia	kb ficha sembrar <APP> · kb ficha cosechar <APP>
<APP>/indice-<APP>.md · indice/	Generado del código: áreas, APIs, dónde va cada cosa con un ejemplo a imitar. No se edita	kb mapa construir <APP>
<APP>/interfaz.md	Stack, componentes y patrones de la interfaz, leídos del código	kb interfaz sembrar <APP>
<APP>/contratos.md	Los endpoints reales de un servicio, desde su OpenAPI	kb contratos sembrar <APP> (lee el spec del código)
CICLO.md	Nombres, agentes y pasos propios de cada fase, y cuántas tareas corren a la vez en el lote. Endurecer rige apenas se escribe; relajar, solo si llegó por PR (kb ciclo)	kb configuracion personalizar CICLO
MARCA.md	Organización, color, logo y pie en lo que se exporta: el expediente navegable, el dossier, el reporte de pruebas, la app de UAT	kb configuracion personalizar MARCA
plantillas/	La versión del equipo de una plantilla: un documento del expediente, las compactas del cambio menor (xs/), el dossier de auditoría, la app de UAT	kb plantillas personalizar <NN>, o el archivo propio en esa carpeta; kb plantillas probar dice si perdió algo que kbspec lee
skills/	Las skills propias y la versión del equipo de una del framework	kb skills nueva|modificar <nombre>

Consejo

Los cambios acá cambian cómo trabaja el agente, sin tocar el CLI. Un archivo ilegible nunca hace desaparecer la funcionalidad en silencio: rige el valor interno por defecto, y kb configuracion probar dice qué no entendió.

Cuando el framework mejora un archivo sembrado

La base de cada archivo sembrado queda en aplicaciones/.semillas.json. Lo que nadie tocó se pone al día con kb update; lo que el equipo personalizó y el framework mejoró se avisa, y kb configuracion diff <ARCHIVO> muestra qué cambió.