Todos los checks de la capa mecánica, con su pilar, su tope de puntos y el esfuerzo que cuesta cerrarlos. Publicada y versionada, porque un score que no se puede auditar es una opinión con decimales.
Documentación
25· 4 checks
Instrucciones para agentes
14· 5 checks
Ejecutabilidad
26· 7 checks
Historia
20· 5 checks
Estructura
15· 5 checks
26 checks · Versión de la rúbrica 1.16
Los 26 checks, repartidos por lo que cuesta cerrarlos. Casi la mitad del puntaje está en cosas que se escriben una vez: un archivo de instrucciones, un README, un .env.example.
Son los mismos checks y los mismos 100 puntos de las tablas de abajo, agrupados por la columna Esfuerzo que ya traen. No hay ningún dato nuevo acá: hay otra forma de leer el mismo.
Escribe el mapa una vez, no en cada prompt. Por qué importa →
| Check | Puntos | Esfuerzo |
|---|---|---|
Cobertura de la documentación1.1-doc-coverage | 15 | medio |
Documentación al día1.2-doc-freshness | 5 | bajo |
README de la raíz1.3-readme | 3 | bajo |
Documentación navegable1.4-doc-structure | 2 | bajo |
Deja las instrucciones donde el agente las busca. Por qué importa →
| Check | Puntos | Esfuerzo |
|---|---|---|
Instrucciones para agentes2.1-agent-instructions | 4 | bajo |
Coherencia entre adaptadores2.2-adapter-consistency | 3 | bajo |
Enlaces de la doc vivos2.3-doc-links | 3 | bajo |
Contexto siempre activo2.7-always-on-context | 2 | medio |
Cómo verificar, dicho al agente2.8-verify-loop | 2 | bajo |
Que el agente pueda correr y verificarse solo. Por qué importa →
| Check | Puntos | Esfuerzo |
|---|---|---|
Volumen de tests2.4-tests | 3 | alto |
Integración continua2.5-ci | 4 | medio |
Amplitud de los tests2.6-test-breadth | 4 | alto |
Instalación reproducible5.1-reproducible-install | 4 | bajo |
Comandos descubribles5.2-discoverable-commands | 4 | bajo |
Variables de entorno declaradas5.3-env-example | 4 | bajo |
Verificador estricto5.4-strictness | 3 | medio |
Cuida los archivos donde siempre se rompe. Por qué importa →
| Check | Puntos | Esfuerzo |
|---|---|---|
Archivos de riesgo3.1-hotspots | 7 | alto |
Conocimiento concentrado3.2-knowledge-concentration | 5 | medio |
Áreas abandonadas3.3-zombie-areas | 3 | medio |
Trazabilidad de los commits3.4-commit-traceability | 2 | bajo |
La doc acompaña al trabajo3.5-doc-drift | 3 | bajo |
Que quepa en una ventana de contexto. Por qué importa →
| Check | Puntos | Esfuerzo |
|---|---|---|
Archivos gigantes4.1-giant-files | 5 | alto |
Dependencias commiteadas4.2-vendored | 3 | bajo |
Navegabilidad del árbol4.3-navigability | 4 | medio |
Librerías con el mismo rol6.1-duplicate-role | 1 | medio |
Archivos duplicados6.2-duplicate-files | 2 | bajo |
Porque un instrumento que no se puede inspeccionar no es un instrumento, es un veredicto. Si vas a dejar que un número te diga que tu repositorio está a medias, tienes derecho a ver de dónde sale cada punto — y a discutirlo. La rúbrica cambia, por eso lleva versión.
Cada check reprobado devuelve su playbook —qué hacer y con qué criterio se cierra— para que tu agente lo ejecute.
Estos checks miden presencia. Si lo que está dice la verdad lo juzga la capa profunda, con su propia rúbrica.
Capa profunda — juzga sustancia