@ingeniomaps/cauce 0.25.0 → 0.27.0

package/template/planning/rules/system/code-shape.md

@@ -13,7 +13,19 @@ No reformatear, renombrar ni reparar elementos ajenos a la tarea.
 Extraer responsabilidades cuando una unidad deja de poder entenderse y probarse aisladamente; no usar
 límites numéricos como sustituto del juicio.
 
-## R11 — Comentarios que explican el porqué
+## R11 — Comentarios con destinatario
 
-Un comentario dice por qué el código es así, no qué hace: si el código ya lo dice, sobra. Cada razón
-vive en un solo lugar, y un bloque de más de tres líneas tiene que justificar su largo.
+Un comentario existe para lo que no se ve leyendo el código, y se escribe para alguien que lo va a
+preguntar o a deshacer sin saberlo. Si nadie lo preguntaría, sobra: tener un porqué no alcanza, porque
+una convención también lo tiene.
+
+Cada razón vive en un solo lugar, el que la vio nacer; repetida en otro archivo, una copia se pudre y
+nada falla.
+
+- **Dentro de una unidad**: el porqué. La restricción, el caso que la forzó, lo que se probó antes.
+- **Encabezando una unidad**: qué garantiza, un nivel por encima del código, para poder usarla sin
+  leerla entera. Su largo lo fija ese contrato.
+- **Donde ningún nombre alcanza**: la fuente de un algoritmo o una norma, qué es un valor opaco, por
+  qué algo se aparta del idioma habitual, y qué quedó a medias.
+
+Un comentario que cuesta escribir suele estar señalando el código, no la falta de palabras.

package/template/planning/rules/system/conduct.md

@@ -51,9 +51,42 @@ Son dos ejes distintos y el registro va en los dos: marcar como supuesto un núm
 mecanismo del que ese número se deriva. Un parámetro declarado supuesto sigue prometiendo el efecto que se le
 atribuye, y esa atribución es la que lleva registro.
 
+El registro viaja con la afirmación, no con el documento que la explica. Una lección, una regla propuesta, una
+fila de acciones humanas o un paso de runbook existen para leerse solos, así que una afirmación de mecanismo que
+sale del informe hacia uno de ellos lleva su registro o no sale. Ahí es donde más se pierde: el informe clasifica
+con cuidado y el artefacto derivado repite la afirmación en plano, ya sin nada que la acote, y es el que alguien
+va a leer dentro de un mes.
+
+Y el disparador es a dónde va la afirmación, no cuán discutible parece. Quien elige qué clasificar clasifica lo
+que espera que le discutan, y deja plano lo que sostiene su propio procedimiento — que es justamente lo que nadie
+va a revisar.
+
 La verificación llega hasta donde R12 permite: fuente pública, `--help`, `--version`, una invocación inocua.
 Nunca conectarse a un sistema real ni ejecutar la operación cuyo efecto se describe. Si el mecanismo sólo se
 establece ejecutando lo destructivo, queda en hipótesis; acá la abstención vale más que el dato.
 
 No se infiere el default de una herramienta desde otra del mismo paquete, ni una regla de una jurisdicción
 desde otra. Una negativa correcta sostenida en un mecanismo falso queda tan comprometida como el mecanismo.
+
+## R15 — Lo que el contrato enumera no desaparece del entregable
+
+Una entrega puede estar incompleta; lo que no puede es parecer completa. Cuando el contrato enumera las
+dimensiones que una entrega cubre —los criterios de un scorecard, los ejes de un descubrimiento, los campos
+de un contrato de release, las secciones de un informe—, dejar una afuera sin que se vea produce algo que se
+lee entero y no lo está. Nadie va a pedir después lo que falta, porque nada indica que faltaba.
+
+El daño no está en la omisión sino en su forma. Una rúbrica cuyos pesos suman 100 %, una guía con todas sus
+preguntas, una plantilla con todos sus campos llenos: la estructura afirma completitud aunque ninguna frase
+lo diga, y quien decide sobre eso no tiene cómo saber que había una dimensión más.
+
+Una ausencia no deja rastro, así que no se detecta leyendo lo escrito: **antes de entregar se contrasta el
+entregable contra la enumeración del contrato**, dimensión por dimensión. Es mecánico y barato, y es lo
+único que la encuentra — revisar lo que está nunca muestra lo que no está.
+
+La dimensión que todavía no se puede cubrir no se borra: queda en el entregable con qué la activa, qué
+evidencia la cierra y quién la revisa. Declararla ausente alcanza sólo cuando cubrirla es imposible y no
+apenas prematuro, y esa declaración va donde iba la dimensión, no en una nota al pie: sirve para que la
+lea quien decide, no para dejar constancia de que se sabía.
+
+Es la contraparte de R13, y las dos terminan igual. Ahí lo que no se entrega es lo que sí se podía; acá lo
+que se entrega tapa lo que faltó. En los dos casos alguien decide con menos de lo que cree tener.