La guía funcional y el asistente

La ficha de arquitectura dice cómo está hecha una aplicación. La guía funcional dice cómo se usa y qué hace, en el idioma del negocio: es lo que consulta un usuario que quiere saber cómo funciona un módulo, una pantalla o un cálculo, y lo que lee el asistente para contestarle.

Dónde vive y cómo es

En el repositorio de documentación, al lado de la ficha: aplicaciones/<APP>/funcionalidades/.

La portada (README.md): qué es la aplicación, quién la usa, sus módulos, responsables de negocio y técnico, cómo se entra y las preguntas frecuentes.
Una página por módulo, con secciones que responden una pregunta cada una:

Sección	Cómo se escribe
`### Pantalla: Registro de pedidos`	para qué sirve, quién la usa, cómo se llega, qué se puede hacer y sus validaciones
`### Cálculo: Comisión del ejecutivo`	fórmula y ejemplo con números — sin ejemplo no está terminado
`### Cómo anulo un pedido`	los pasos, y lo que se ve al final
`### ¿Por qué no me deja cobrar…?`	la respuesta corta, con la regla que la explica

El manual completo del formato: kb funcional guia.

Cómo se arma y cómo se mantiene viva

kb mapa construir VENTAS            # las pantallas que tiene el código
kb funcional VENTAS sembrar         # la portada y una página por módulo, con una sección por pantalla
kb funcional VENTAS                 # qué le falta: secciones por completar, pantallas sin sección, páginas vencidas

El esqueleto lo arma kbspec, desde el inventario y el mapa del código. Las secciones nacen vacías.
Las completa quien conoce el negocio, o el agente a partir del código y de los expedientes que tocaron esa pantalla —el requerimiento y el manual de usuario están en lenguaje de negocio—, y una persona lo confirma. Un cálculo no se deduce del código: se escribe desde la regla de negocio o se pregunta.
Cada entrega la mantiene al día: al cerrar un requerimiento, /kb-entrega reescribe la sección que cambió para que describa cómo funciona hoy. Una pantalla nueva en el código sin sección propia aparece en kb funcional, y sembrar --completar la agrega.
Cualquiera la corrige cuando quiera: es un documento del equipo y pasa por Pull Request como el resto.

El asistente: una sección, no un documento

kb preguntar "cómo se calcula el recargo por mora"
kb preguntar "dónde está el código de cobros" --app VENTAS
kb preguntar "quién aprueba los cambios de VENTAS"

kb preguntar busca en la guía funcional, en las reglas de negocio, en la ficha de arquitectura, en el inventario y en el glosario, y devuelve las secciones que contestan, cada una con su fuente (cobros.md#cálculo-recargo-por-mora). No carga documentos enteros: por eso contesta preguntas de cualquier nivel —cómo se usa una pantalla, cómo se calcula algo, en qué repositorio está el código, quién responde— con poco contexto. Si nada lo cubre, lo dice: no está escrito.

En el chat, el agente KB lo usa solo: preguntale cómo funciona algo.
En el panel: Preguntar cómo funciona una aplicación, en la vista de aplicaciones.
Para cualquier asistente que hable MCP —Copilot, Claude, un agente de Copilot Studio—, el servidor MCP lo publica como kb_preguntar.
Para otro buscador, kb preguntar --exportar conocimiento.jsonl deja todo lo que sabe en una línea JSON por sección: aplicación, fuente, tipo, título, texto y de dónde sale.