Documentación respaldada por evidencia
Una afirmación es documentación solo cuando lleva los medios para verificarla. Este skill es el estándar y el mapa: diez cánones, y dónde está definido, aplicado y sembrado cada uno.
Es un navegador, no una copia secundaria. Cada ley a continuación tiene exactamente un hogar — ese es el canon 3, y un navegador que reafirmara la doctrina rompería la regla que está indexando. La declaración completa de cada canon, su fundamento y su aplicación viven en documentation.md → Los cánones.
Los diez cánones
- Una afirmación lleva su dirección —
archivo:línea, un comando con su salida, un nombre de prueba; una lección nombra su commit. - Los números se calculan, nunca se reafirman.
- Cada hecho tiene exactamente un hogar — los demás enlazan, nunca reafirman.
- Una referencia se resuelve desde donde se lee el documento — no desde donde vive.
- Un verde que nadie vio volverse rojo no es evidencia.
- Una verificación prueba su alcance y nada más allá.
- El silencio no es un pase — pregúntate qué imprime un mecanismo cuando no miró.
- Una estimación nunca se anuncia como una medición — una regla establece su condición de evidencia.
- Lo que no se verificó se imprime junto a lo que sí se verificó.
- El documento se entrega en el cambio que lo hizo verdadero — y una corrección se añade, nunca se sobrescribe.
Son epistémicos: lo que hace que una afirmación sea documentación. La capa operativa — qué hacer ante un desencadenante dado, con una verificación y un criterio de salida — se encuentra en learned.md. Cuando ambos parecen decir lo mismo, el canon es el por qué y la regla es el cómo.
A dónde ir después
| Si estás a punto de… | Lee | Porque… |
|---|---|---|
| configurar la documentación de un proyecto desde cero | documentation.md → El inventario | cuatro preguntas respondidas antes de la primera línea de trabajo |
| registrar una decisión para que sobreviva a su autor | Registros e ids + templates/decisions.md | ids de solo añadido, marcadores de borde, un hogar para cada decisión |
| cambiar algo y no huérfanar la documentación | El Bucle de Documentación + La matriz de propagación | qué documentos debe un cambio, empezando por la fila de metadatos |
| decidir dónde pertenece un hecho | Fuente única de verdad | dos hogares discrepan el día que uno de ellos se actualiza |
| construir una verificación que no pueda mentir | gates.md | tres ejes, la escalera de aplicación, armado progresivo, sondeo |
| confiar en un mecanismo que reporta éxito | gates.md → Éxito falso | el fallo que elimina la razón para mirar |
| conectar una verificación en las herramientas del propio agente | hooks.md | el contrato del hook, y por qué un guardián caído permite la acción |
| auditar la documentación que ya tiene un proyecto | setup.md | siete pasadas, la más barata primero, la salida es un plan de correcciones |
| llevar una lección a la siguiente ejecución | retrospective.md | sello primero (el disparador frío lo lee), luego poda hasta un máximo de diez; cada lección nombra su commit |
| sembrar una puerta en un proyecto anfitrión | templates/docgate.sh | siembra verde: latente donde aún no hay entrada |
| afirmar que un agente se comporta | tdd.md → Cuando la cosa bajo prueba es un agente — nombrado en lugar de enlazado, porque los enlaces fuera del directorio de este navegador se rompen cuando un empaquetador envía este skill solo | la dirección es un id de traza y la aserción que se ejecutó (canon 1); un juez que nadie vio discrepar es un verde que nadie vio volverse rojo (canon 5) |
| llevar un cambio completo hasta la aceptación | task-pipeline | este skill es el estándar; ese es cómo un cambio llega al repositorio |
Cuándo aplica esto
El límite es "se leerá como verdadero." Un registro de decisión, un README, un informe de aceptación, un runbook, un changelog para usuarios, un hallazgo de auditoría, una afirmación de que algo fue verificado.
No a través de este skill: un borrador, pensar en voz alta, una respuesta en un chat, un mensaje de commit, un comentario de código. Exigir un archivo:línea para "déjame verificar eso" es la forma más rápida de enseñar a un agente a esquivar la regla donde realmente protege algo.
Frase de rechazo — "без доков" / "bajo palabra". Funciona en una tarea que de otro modo pasaría por aquí: hazlo directamente y di en voz alta que la afirmación no tiene respaldo, en lugar de presentar una estimación como una medición (canon 8).
La única prueba
Antes de que un documento se entregue, léelo buscando la frase que te daría vergüenza si alguien preguntara "¿cómo lo sabes?" — y dale a esa frase su dirección, o elimínala. Todo lo anterior es esa pregunta, hecha mecánica.