El expediente

Cada requerimiento vive en su expediente: una carpeta con un conjunto cerrado de documentos, una bitácora auditable y el consumo medido.

Los documentos

Archivo	Contenido
00-INDICE.md	Estado, enlaces y tabla de avance (generado)
01-solicitud.md	Solicitud original, insumos, preguntas abiertas
02-requerimiento.md	RF/RN/RNF y criterios de aceptación
03-analisis-tecnico.md	Arquitectura, matriz de impacto, ADRs, riesgos
04-plan-tareas.md	WBS, tareas T-NN, IDs de work items
05-bitacora.md	Registro de implementación, una entrada por tarea
06-plan-pruebas.md	Casos CP-NN en lenguaje de negocio
07-resultados-pruebas.md	Resultados, evidencias, hallazgos H-NN
08-entrega.md	Ramas, PRs, despliegue, rollback
09-manual-usuario.md	Documentación para el usuario final

Cuáles son obligatorios depende del tamaño (XS/S/M/L), que no mide esfuerzo sino profundidad documental. Ver Convenciones.

La bitácora encadenada

auditoria.jsonl registra cada evento del expediente —cierres de fase y de tarea, decisiones, aprobaciones— encadenado por hash. Nada se pierde y nada se puede reescribir sin que se note. Es la fuente de verdad que alimenta las métricas y el pronóstico.

Solo lleva hechos suyos

Un rastro sirve si lo que hay adentro es del requerimiento. Dos reglas lo sostienen:

• El hecho va al expediente sobre el que se trabajó, no al que esté abierto. Validar otra carpeta con un expediente abierto no deja la huella en el abierto.
• Nada se anota en un expediente de otra documentación.

Lo que ya está escrito no se reescribe

Si una bitácora quedó con eventos que no son suyos, kbspec no los borra. La cadena se verifica entera y una firma vieja tiene que seguir verificando: reescribir un rastro de auditoría es exactamente lo que no se hace.

Lo que hace kb auditoria --dossier es que dejen de engañar. Separa los hechos de este requerimiento del total, dice cuántos eventos son ajenos y por qué siguen ahí, y marca cada fila ajena en la línea de tiempo —que es la sección que se lee una por una, donde el resumen de arriba no alcanza—.

El mismo número en cualquier máquina

La bitácora se fusiona entre máquinas, así que un evento legítimo puede llegar con una ruta de Windows que en otra máquina no existe. Por eso la clasificación se hace por el nombre del expediente, que viaja con el evento: un dossier cuyo número cambia según quién lo genere no le responde a un supervisor, que es para lo único que existe.

Y es conservadora: un evento que no nombra ningún expediente no se acusa. Subcontar es preferible a marcar como ajeno un hecho real.

El consumo medido

consumo.jsonl guarda, por fase y por modelo, cuántos tokens costó el trabajo — leído de la telemetría real de Copilot o Claude, nunca inventado. De ahí salen el costo y el pronóstico por flujo.