@ingeniomaps/cauce 0.33.0 → 0.34.0

package/CHANGELOG.md

@@ -14,6 +14,33 @@ desde este repositorio no va, porque el que lee no puede actuar sobre eso. Cuand
 unas pocas líneas casi siempre es porque cuenta cómo se descubrió el problema o por qué se eligió el
 diseño — eso vive en el commit y en el código.
 
+## [0.34.0] - 2026-08-19
+
+### Añadido
+
+- **R16: el costo es el contexto, no las palabras.** Regla nueva del sistema, en
+  `planning/rules/system/process.md`, así que rige en cada tarea la haga quien la haga. Cada llamada
+  reenvía el contexto entero: gasta más quien da más vueltas que quien escribe más. Comandos
+  independientes en una sola invocación, el CLI antes que el archivo, el fragmento antes que el archivo
+  entero, un subagente sólo cuando el trabajo no entra en la corrida actual, y un archivo se lee una vez
+  y se escribe entero en vez de releerlo para confirmar.
+
+  Cierra con la parte que la hace segura y que una regla de eficiencia escrita a las apuras suele
+  omitir: **verificar es la excepción y no se negocia**. Ahorrar una llamada nunca justifica afirmar sin
+  haber comprobado —R14 no admite descuentos— ni dar por terminado lo que no se corrió.
+
+  No nombra precios, ventanas de caché ni cuándo limpiar una conversación: eso lo fija el runner, y una
+  regla del sistema que lo nombrara envejecería con su próxima versión en todas las instancias a la vez.
+
+### Cambiado
+
+- **El arranque acota las vueltas dentro de cada fase, no sólo cuántas fases hay.** El techo de tres
+  agentes limitaba cuántos contextos se cargan, no cuántas veces se reenvía cada uno. Medido en una
+  corrida real: la fase que escribe gastó veinte vueltas —seis lecturas y tres ediciones— para producir
+  cuatro archivos, y los tres agentes sumaron tres millones de tokens de caché, un cuarto de la sesión.
+  Ahora cada fase sabe qué cuesta: leer una vez y sólo para escribir, escribir entero de una, no releer
+  para comprobar, y correr `check` una sola vez.
+
 ## [0.33.0] - 2026-08-19
 
 ### Corregido

package/automatization/workflows/onboard.js

@@ -50,6 +50,11 @@ const BASE = `Nunca inventes clientes, métricas, ingresos, plazos ni responsabl
   `recorras directorios, no leas código fuente y no abras más archivos que los que vas a escribir. Esto ` +
   `es un arranque de cinco minutos, no una auditoría: lo que no esté a la vista se marca como supuesto o ` +
   `queda como pregunta abierta, que es más barato y más honesto que averiguarlo.\n\n` +
+  `Lo que cuesta no son las palabras que escribís sino las vueltas que das: cada llamada arrastra tu ` +
+  `contexto entero. Leé un archivo una sola vez y sólo si vas a escribirlo; escribilo completo de una, sin ` +
+  `editarlo después; no lo releas para comprobar que quedó —si la escritura falla, te enterás—. Medido en ` +
+  `una corrida real: la fase que escribe gastó veinte vueltas con seis lecturas y tres ediciones para ` +
+  `producir cuatro archivos.\n\n` +
   `El arranque tiene tres objetivos y ninguno más: entender qué es este proyecto, dejar la instancia ` +
   `correcta para él —contexto, mapa, raíces, lo que espera a una persona— y que la primera tarea pueda ` +
   `empezar. El análisis profundo llega después, cuando alguien pida algo concreto; adelantarlo acá ` +
@@ -200,8 +205,11 @@ const epic = await agent(
     : 'La primera historia es traer los repos y declararlos en workspaceRoots.'} ` +
   `En "## Riesgos y decisiones humanas" citá las filas que quedaron en HUMAN_ACTIONS. No toques ` +
   `BACKLOG.md.\n\n` +
+  `El contrato de una épica está en ${P}/PROTOCOL.md; si necesitás verlo, leé esa sección y no el archivo ` +
+  `entero, y escribí la épica de una sola vez.\n\n` +
   `Cerrá corriendo "node tools/ops.js check planning" desde ${ROOT} y, si falla, reparando sólo lo que ` +
-  `esta corrida escribió; nunca debilites un criterio para forzar el verde.`,
+  `esta corrida escribió; nunca debilites un criterio para forzar el verde. Una sola corrida de check: si ` +
+  `pasó, terminaste.`,
   { schema: { type: 'object', additionalProperties: false, required: ['file', 'passed'],
     properties: {
       file: { type: 'string' }, passed: { type: 'boolean' }, details: { type: 'string' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ingeniomaps/cauce",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Sistema portable de planificación y ejecución verificable para cualquier proyecto",
   "keywords": [
     "planning",

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

@@ -15,3 +15,15 @@ Buscar fallos de corrección, seguridad, compatibilidad y operabilidad antes de
 ## R4 — Sincronización de estados
 
 El estado se mueve de forma atómica entre contratos; nunca se copia para representar progreso.
+
+## R16 — El costo es el contexto, no las palabras
+
+Cada llamada reenvía el contexto entero, así que gasta más quien da más vueltas que quien escribe más.
+Los comandos independientes van en una sola invocación; el CLI antes que el archivo; el fragmento antes
+que el archivo entero; un subagente o un workflow sólo cuando el trabajo no entra en la corrida actual.
+
+Se lee para escribir, no para confirmar: un archivo se lee una vez y se escribe entero. Releerlo para
+comprobar que quedó no comprueba nada que un error no hubiera dicho.
+
+Verificar es la excepción, y no se negocia. Ahorrar una llamada nunca justifica afirmar sin haber
+comprobado —R14 no admite descuentos— ni dar por terminado lo que no se corrió.