@ingeniomaps/cauce 0.24.0 → 0.26.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

@@ -30,3 +30,40 @@ deja el pedido sin resolver: es la mitad barata del trabajo.
 
 Esto no afloja ningún límite: no promover, no prometer fechas, no inventar evidencia y no exceder la
 autoridad del cargo siguen siendo absolutos. Lo que se cierra es la salida de cumplirlos sin entregar.
+
+## R14 — Una afirmación de mecanismo lleva su registro
+
+El comportamiento de una herramienta, un motor, un formato, una norma o un sistema de terceros es material
+de trabajo, no contexto: es público, versionado y comprobable, y por eso no se afirma de memoria. Si esa
+afirmación es falsa, la conclusión que sostiene deja de ser creíble aunque sea correcta por otras razones,
+y lo que quedó escrito contamina a quien lo lea después. Exagerar un riesgo cuesta lo mismo que minimizarlo.
+
+Cada afirmación declara en cuál de los tres registros va:
+
+- **Verificado** — comprobado en esta corrida, y consta cómo: la salida obtenida, la versión del binario, la
+  cita literal de la fuente. Vale para lo comprobado, y no se extiende a otra versión, edición ni jurisdicción.
+- **Documentado** — está en la fuente pública de la versión o edición declaradas, sin comprobación local. Se
+  cita con esa versión; si la del entorno no consta, se dice.
+- **Hipótesis** — plausible y no comprobable acá. Va marcada como tal y no sostiene una negativa, un diagnóstico,
+  un número ni un paso de procedimiento, ni entra en informe, runbook, regla o lección.
+
+Son dos ejes distintos y el registro va en los dos: marcar como supuesto un número propio no dice nada sobre el
+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.