Cómo mide kbspec

Todo lo que kbspec afirma con números sale de una sola cadena de medición. Esta página es el mapa.

La cadena completa

Telemetría real (Copilot / Claude)
        ↓  tokens por llamada, con su modelo
consumo.jsonl  — por expediente, POR FASE
        ↓
kb tokens      → costo en créditos: lo facturado por Copilot, y la tarifa solo donde no lo trae
kb tokens --anatomia → por conversación, agente, modelo, herramienta y tarea
kb tokens --organizacion → lo que GitHub facturó, por modelo y usuario (API oficial)
kb flujo       → throughput: ítems cerrados por sprint (de la bitácora)
kb pronostico  → Monte Carlo sobre ese histórico, con costo por ítem
kb modelo --revisar → la clase que corrió cada fase vs. la recomendada
kb metricas    → todo cruzado con defectos, lead time y adopción

Medido, no estimado

Los tokens se leen de la telemetría del asistente — nunca se inventan ni se extrapolan. Registrar dos veces no duplica: cada tramo guarda hasta dónde contó.
El reparto por fase usa los cierres de fase de la bitácora (la única línea de tiempo confiable con hora): lo consumido antes de cada cierre pertenece a esa fase.
El throughput cuenta eventos datados que la bitácora ya escribe (cierres de tarea y de fase). Nadie anota nada aparte.
Los modelos utilitarios (los que el asistente usa para tareas internas, con tarifa cero) quedan fuera del total: no son trabajo tuyo.
En Copilot los tokens en caché —leídos y escritos— son un subconjunto de la entrada: lo que se cobra a tarifa plena es la entrada neta, y la caché con su propia tarifa. Y cada llamada trae los créditos que Copilot facturó, que es el número que cuadra con GitHub; el costo por tarifa es la estimación, y solo cubre lo que no trae lo facturado.
Las dos bases de Copilot. El chat de VS Code escribe en agent-traces.db; la ventana de agentes y la CLI de Copilot, en ~/.copilot/session-store.db. kbspec lee las dos — registrar, la sesión en vivo, la anatomía, el modelo del rastro—: medir solo una dejaba la mitad de la cuenta sin que nada lo dijera.
Una sola cifra, con su base. facturado, estimado o mixto (lo facturado más la estimación del resto, con ≈): la misma en la terminal, el panel, la portada, el documento de entrega, la épica, el CSV y el MCP. Medido el 2/10/2026, con una corrida real del lote, la estimación y lo facturado coincidieron al nano-AIU: si no coinciden, la tarifa no es la del contrato y kb tokens lo dice (Calibración).

Declarado, y dicho como tal

Lo único que depende de la palabra del agente es el modelo con que declara cerrar cada fase — y cada pantalla que lo usa lo dice explícitamente. Para la verdad medida está kb modelo --revisar.

Lo que nunca se guarda

El consumo son solo metadatos: cuántos tokens, en qué fase, hasta qué mensaje. Nunca qué se dijo. Y las métricas no miden personas: el reporte no agrega ni expone el responsable: — en el momento en que se puede ordenar desarrolladores por un número, la gente escribe para el número y el dato se muere.

Estadísticas por sprint, mes y año

kb estadisticas --por sprint

Requerimientos, entregados, tokens de entrada y salida, costo en USD y developers por período. La fuente son los propios expedientes —frontmatter y consumo.jsonl, costeado con las mismas reglas de kb tokens—: todo auditable abriendo la carpeta. El sprint se etiqueta al crear cada expediente, con el ancla del equipo (sprint_inicio en TABLERO.md) y la ventana escrita para que el developer la revise.