@ingeniomaps/cauce 0.53.2 → 0.55.0

package/CHANGELOG.md

@@ -14,6 +14,92 @@ 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.55.0] - 2026-09-02
+
+### Corregido
+
+- **`upgrade` ya no pisa lo que `init --force` conservó.** Adoptar Cauce en un repositorio que ya tiene
+  contenido es `init --force` y después `upgrade`. El primero conserva tus archivos y lo cumple; el
+  segundo los reemplazaba sin avisar e imprimía que no había tocado nada propio. El registro se grababa
+  hasheando el disco, así que un archivo conservado quedaba anotado como entregado por Cauce con **tu**
+  contenido, y la comparación no veía ninguna diferencia. Ahora se anota el digest de lo que el molde
+  habría escrito: tu archivo se ve como lo que es —una edición local— y `upgrade` se detiene
+  nombrándolo. **Qué cambia para vos**: el primer `upgrade` después de una adopción con `--force` se
+  detiene listando esos archivos. Resolvelos a mano, o repetí con `--force` para descartarlos, que
+  ahora además los enumera en la salida.
+- **Tu guard propio sobrevive a `automation install`.** `AGENTS.md` te dice que lo pongas en
+  `automatization/hooks/guard-<nombre>.sh` y promete que sobrevive a cada actualización. Sobrevivía al
+  `upgrade` y no a la reinstalación del runner: lo nuestro se reconocía por la carpeta, así que
+  cualquier `guard-*.sh` de ahí se desregistraba antes de fusionar. El archivo quedaba en disco, el
+  guard dejaba de correr y lo único que se veía era una línea diciendo que se había quitado una entrada
+  obsoleta. Ahora se reconoce por lo que efectivamente entregamos: los guards que el motor trae, más
+  los que esta instancia anotó haber recibido —el manifiesto gana una entrada por runner con el wiring
+  que dejó puesto, y por eso una entrada nuestra se sigue retirando el día que el motor deje de traer
+  ese guard—. **Si moviste tu guard fuera de esa carpeta para sortearlo, ya podés devolverlo.**
+- **`automation doctor` deja de llamar divergente a una configuración completa.** Un hook propio sumado
+  *dentro* de un grupo que escribió el toolkit dejaba a `doctor` en rojo aunque estuvieran todas las
+  entradas esperadas: comparaba el grupo entero serializado, así que uno con un hook de más contaba
+  como ausente. Ahora compara por `matcher` y contenido. Lo que falta se sigue reportando igual.
+- **`upgrade --check` avisa de lo que tenés editado aunque la versión coincida.** Salía por un camino
+  corto que informaba «al día» sin llegar a listarlo, que es el estado normal entre actualizaciones
+  —`init` fija la versión exacta—: el único modo que no toca nada era también el único que no podía
+  anticipar el conflicto. **Qué cambia para vos**: `--check` ahora sale 1 cuando hay archivos del
+  sistema editados, un caso donde antes salía 0. Si lo tenés en un script, revisá esa condición.
+
+### Cambiado
+
+- **`init` e `init .` eligen el mismo modo en el mismo directorio.** El default salía de si escribiste
+  el argumento, no de a dónde apunta: en `acme-ops/`, `init` daba `sidecar` e `init .` daba `embedded`.
+  No es cosmético — en `embedded` la raíz del workspace pasa a ser la carpeta ops misma, así que
+  `guard-workspace-boundary` deja de reconocer los repos hermanos y el wiring del runner se escribe
+  adentro en vez de al lado, donde abrís tu herramienta. Ahora lo decide el destino resuelto, con la
+  misma regla que ya elegía dónde aterrizar: una carpeta llamada `ops` o terminada en `-ops` **es** la
+  instancia. **Qué cambia para vos**: `init .` en una carpeta así ahora da `sidecar`, donde antes daba
+  `embedded`. El caso embebido sigue disponible pidiéndolo: `init . --mode embedded`.
+
+## [0.54.0] - 2026-09-02
+
+### Agregado
+
+- **Un proyecto puede declarar la puerta que lo verifica.** `ops.config.json` acepta el comando que
+  comprueba tu código —`gates`—, y el contrato de una tarea viaja con ella hasta quien la ejecuta.
+  Antes cada cargo lo adivinaba desde el árbol. Si no lo declarás, todo sigue como estaba.
+- **Una propuesta mensual se puede archivar en vez de aplicar.** Es el tercer destino que faltaba:
+  mirarla y decidir que no cambia nada. Antes eso se hacía mergeando sin firmar, que la dejaba
+  `proposed` para siempre e indistinguible de una que espera trabajo. `learn <cargo> --archived`.
+- **Una propuesta firmada y sin aplicar lo dice.** Antes se contaba igual que una que nadie miró.
+
+### Cambiado
+
+- **Los 53 cargos traen el paso de entrega de R14.** Antes de dar por entregado, el cargo recorre los
+  artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de
+  runbook— y comprueba que cada afirmación sobre el comportamiento de una herramienta, norma o sistema
+  de terceros llegó con su registro. En 19 cargos la regla además se movió a la sección de reglas: donde
+  estaba, se leía como una nota de colaboración. **No hace falta que hagas nada**: el catálogo se
+  resuelve desde la dependencia.
+
+  El motivo, medido sobre 198 registros de evaluación: esa conducta se lleva el 47 % de los casos rojos
+  del catálogo, en 25 de los 53 cargos, casi cinco veces lo que su superficie explica. Y falla siempre
+  en el mismo lugar —el informe clasifica con cuidado y la copia sale en plano al artefacto derivado—,
+  que es lo que este paso va a mirar. **Que el cambio lo corrija no está demostrado**, y conviene que lo
+  sepas antes de leerlo como una mejora: la tasa de recuperación por varianza entre corridas es del
+  83 %, así que las dos mediciones que salieron a favor tenían un 69 % de salir igual sin cambio alguno.
+
+- **`planning/rules/system/conduct.md` se reemplaza y R13 gana un borde.** Faltar contexto es no saber
+  **cómo** —qué formato, qué borde, qué valor—, y eso se supone y se entrega marcado. No saber **qué se
+  quiere ni para qué** es otra cosa: ahí el borrador deja de ser barato, porque todo lo que se construya
+  encima hereda la suposición y quien lo reciba no tiene cómo ver que el objetivo era supuesto. Lo que
+  separa los dos casos es si la respuesta existe escrita en algún lado. Si venías apoyándote en R13 para
+  arrancar sin objetivo, esto lo acota.
+
+### Corregido
+
+- **Sellar una propuesta ahora marca el documento entero.** La salida temprana miraba sólo `status:` del
+  frontmatter, así que si algo movía ese campo antes que el sello, el cuerpo quedaba en «- Estado:
+  aprobada» para siempre: el frontmatter decía una cosa y el cuerpo la contraria, dentro del mismo
+  documento. **Si tenés propuestas aplicadas con esa contradicción, `learn <cargo> --applied --period
+  AAAA-MM` ahora las cierra bien.**
+
 ## [0.53.2] - 2026-08-29
 
 ### Cambiado

package/README.md

@@ -51,7 +51,7 @@ instala la dependencia, deja el wiring del runner puesto y valida la instancia a
 ✓ claude: adaptador operativo (0 advertencia(s))
 ✓ planning válido: 0 épica(s), 0 tarea(s) en cola, 0 terminada(s)
 
-2 servicio(s) en /home/vos/mi-repo: apps/api, apps/web
+2 servicio(s) en el workspace: apps/api, apps/web
 
 ¿De qué trata este proyecto? Una línea alcanza.
 

package/agents/README.md

@@ -47,3 +47,27 @@ el catálogo tenía el día del fork, no contra lo que escribiste después.
 
 `evaluate <slug>` corre los casos adversariales del cargo contra su contrato. Lo que se evalúa desde una
 empresa tiene que ser un cargo suyo —propio o adoptado—, y su instancia ya es el lugar donde trabajar.
+
+### Un caso en rojo dice algo, y casi nunca que el cargo esté roto
+
+Los casos vienen con el catálogo; los veredictos, no. El primero que corras es tuyo, y va a decirte una
+de tres cosas — separarlas es lo que evita arreglar lo que no estaba mal.
+
+**El cargo no cumplió lo que su contrato ya pedía.** Es el caso más común y no pide cambiar nada: se
+vuelve a correr. En el catálogo, dos cargos que arrastraban un rojo lo cerraron así, sin tocarles una
+línea. Se reconoce porque el veredicto nombra un comportamiento que el contrato enumera y dice que no se
+observó.
+
+**El contrato tiene un hueco.** El veredicto lo dice con todas las letras: registra que ninguna conducta
+enumerada cubre lo que ahí falló. Eso sí pide un cambio, y el camino es la propuesta mensual del cargo —
+no editar `expected-behaviors.yaml` a mano, porque un contrato que cambia sin veredicto que lo respalde
+deja de poder medirse.
+
+**Fue varianza.** Existe y no es raro: un mismo caso puede pasar dos veces y fallar la tercera sin que
+nada cambie. Por eso un rojo aislado no autoriza a concluir; y por eso repetir la corrida esperando otro
+número no es medir. Lo que distingue una varianza de un defecto es que el defecto se repite **por la
+misma razón**, no que se repita el rojo.
+
+Lo que un rojo nunca significa es que el paquete venga fallado. El cargo es un contrato y el caso es la
+medición: que la medición encuentre algo es para lo que existe, y un cargo con un caso en rojo se sigue
+usando mientras se sepa por qué.

package/agents/roles/system/accounting-specialist/SKILL.md

@@ -115,3 +115,5 @@ crédito, centro de costo, área funcional y razón social por línea, con la su
 criterio de imputación con su fuente y edición; el camino de trazabilidad desde el evento hasta la línea, con los eslabones faltantes marcados;
 supuestos y alternativas descartadas; excepciones abiertas con monto, fecha y owner; y quién debe revisar, aprobar y
 registrar, dejando constancia de que el asiento se entrega sin registrar.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/ai-governance-lead/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para inventa
 ## Entrega mínima
 
 Incluir sistema/versiones/purpose/no usos/owners, datos/outputs/autonomía/tools, personas y mercados, lifecycle roles/jurisdicciones/obligaciones, clasificación y razonamiento, impacto/beneficios/harms/alternativas, controles/evidencia/gaps, terceros/GPAI, transparency/oversight/redress, gate/reviewers/autoridad/expiración, exceptions/residual risk, monitoreo/change triggers/incidentes/decommission y fuentes legales con fecha/estado.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/ai-product-manager/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para opportu
 ## Entrega mínima
 
 Incluir problem/user/outcome/baseline; opciones AI/no-AI/build-buy; stakes/afectados; journey/disclosure/control/appeal; nivel de automatización; system contract/data/model/tools; value/risk hypotheses con guardrails y stop criteria; taxonomy; evals/slices/thresholds; privacy/security/IP; economics; pilot/readiness/rollback; monitoring/incident/retirement; owners, autoridad, jurisdicciones, evidencia y pendientes.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/analytics-engineer/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para contrat
 ## Entrega mínima
 
 Incluir decisión/consumidores/owners; fuentes/lineage/clasificación y autoridad; grain/entidad/keys/cardinalidad; timestamps/timezone/moneda/historia; modelo dimensional con sus facts y dimensions; contratos de métricas; transformación propuesta; tests/reconciliación; freshness/SLA y volumen; materialización/incrementalidad/backfill; costo; consumidores/compatibilidad/deprecación; acceso; rollout/rollback; evidencia, supuestos y pendientes.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/backend-engineer/SKILL.md

@@ -48,6 +48,8 @@ Leer [references/operating-model.md](references/operating-model.md) para criteri
   su aserción en vez de darla por buena.
 - Lo que aparece durante el trabajo y el plan no previó entra con la prueba que lo fija, o para y queda
   registrado cuando es una parte del diseño que falta; nunca en el código a secas.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -56,8 +58,6 @@ Leer [references/operating-model.md](references/operating-model.md) para criteri
 - Revisar amenazas con Security Engineer y datos con Privacy/Compliance.
 - Coordinar migraciones, capacidad y observabilidad con DevOps/SRE.
 - Entregar a QA fixtures, contratos y recorridos verificables sin atajos de producción.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -78,3 +78,5 @@ Leer [references/operating-model.md](references/operating-model.md) para criteri
 ## Entrega mínima
 
 Incluir operación y propósito, comportamiento e invariantes entregados, lint, tipos, migraciones y build con su exit code real, contratos, compatibilidad y migraciones afectados, actor y autorización aplicada, entrada con sus límites y validación en la frontera, lecturas y escrituras, decisiones de transacción, concurrencia, idempotencia y retries, respuesta y errores, efectos externos y compensación, estrategia de fallo/recuperación, privacidad y auditoría, observabilidad, pruebas ejecutadas con resultado y riesgos residuales.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/backend-engineer/learning/HISTORY.md

@@ -2,3 +2,4 @@
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | @ingeniomaps (Manuel Pinzon) | Nada: el período se revisó y se decidió no cambiar ningún contrato. |

package/agents/roles/system/business-strategist/SKILL.md

@@ -43,6 +43,8 @@ Leer [references/operating-model.md](references/operating-model.md) al formular
 - Modelar ingresos, margen, adquisición, retención, capital y capacidad con definiciones compatibles y rangos.
 - Separar métricas de resultado, leading indicators y guardrails contra efectos secundarios.
 - Tratar forecast como escenario condicionado, no como certeza; actualizar creencias con evidencia nueva.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -51,8 +53,6 @@ Leer [references/operating-model.md](references/operating-model.md) al formular
 - Contrastar adquisición y posicionamiento con Marketing, Sales y Customer Success.
 - Revisar economía, caja y exposición con Financial Controller.
 - Escalar obligaciones, datos, contratos y riesgo con Security, Privacy/Compliance y responsables legales.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -73,3 +73,5 @@ Leer [references/operating-model.md](references/operating-model.md) al formular
 ## Entrega mínima
 
 Incluir decisión y horizonte, diagnóstico, segmentos y alternativas, evidencia y supuestos, opciones con trade-offs y renuncias, economía por escenarios, elección recomendada, ventaja o mecanismo defendible, capacidades, secuencia y owners, indicadores/guardrails, condiciones de salida y decisiones que requieren aprobación.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/cloud-architect/SKILL.md

@@ -17,6 +17,9 @@ Traducir outcomes y restricciones en una arquitectura operable, segura, resilien
 3. Inventariar proveedores, organizaciones/cuentas/proyectos, regiones, redes, identidad, servicios, quotas, compromisos, soporte y deuda.
 4. Cuantificar baseline y escenarios de disponibilidad, latencia, throughput, crecimiento, recuperación, costo unitario y carbono cuando sea material.
 5. No inventar requisito, topología, servicio, precio, quota, SLA, amenaza, cumplimiento, ahorro ni evidencia observable.
+   No inventar no es no entregar: lo que no depende del dato que falta se escribe igual —el principio
+   agnóstico de proveedor, el ensayo con su criterio aunque sus números queden abiertos—, marcado como
+   lo que es y con qué se completa. Callarlo deja a quien decide sin la mitad que sí se podía dar.
 
 ## Flujo de arquitectura
 
@@ -63,3 +66,5 @@ Leer [references/operating-model.md](references/operating-model.md) para contrat
 ## Entrega mínima
 
 Incluir outcomes/owners/autoridad; requisitos/baseline; contexto y flujos; datos/jurisdicción; trust/failure domains; opciones/tradeoffs/ADR; landing zone y tenancy: jerarquía/cuentas/identidad federada/guardrails/logging/billing; red: segmentación/ingress-egress/DNS/private connectivity/inspección; servicios y shared responsibility; SLO/RTO/RPO/DR, degradación y capacidad; seguridad/observabilidad/operación/soporte/skills; costo total y unitario/forecast/sostenibilidad; IaC/policies; migración/portabilidad/rollback/salida; evidencia, riesgos y pendientes.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/cloud-architect/learning/HISTORY.md

@@ -1,3 +1,7 @@
 # Historial de aprendizaje
 
 Registrar fecha, propuesta, fuentes/versiones, evidencia, decisión humana, cambios, evaluaciones y responsable.
+
+| Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
+|---|---|---|---|---|
+| 2026-08-30 | `agents/roles/system/cloud-architect/learning/proposals/2026-08.md` | Aprobada | @ingeniomaps | `agents/roles/system/cloud-architect/SKILL.md` |

package/agents/roles/system/community-manager/SKILL.md

@@ -62,3 +62,5 @@ Leer [references/operating-model.md](references/operating-model.md) para charter
 ## Entrega mínima
 
 Incluir propósito/audiencia/valor mutuo, charter/governance/autoridad, journey y evidencia, programa/canal/cohorte, criterios de éxito y stop conditions, accesibilidad/localización, normas y seguridad, privacidad/consentimiento, triage/escalación, métricas/baseline/cohortes/guardrails, concentración de voz/silencio/carga de moderación/efectos distributivos, feedback/owners, recursos/riesgos y lifecycle/cierre.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/content-specialist/SKILL.md

@@ -43,6 +43,8 @@ Leer [references/operating-model.md](references/operating-model.md) al crear bri
 - Citar y parafrasear honestamente; no reproducir contenido protegido ni atribuir una idea a una fuente que no la respalda.
 - Diseñar contenido modular, con source of truth y ownership para evitar variantes inconsistentes.
 - Localizar intención, ejemplos, unidades, tono, formatos y restricciones; no traducir literalmente contenido inválido para el mercado.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -51,8 +53,6 @@ Leer [references/operating-model.md](references/operating-model.md) al crear bri
 - Revisar investigación y medición con User Researcher y Data Analyst.
 - Revisar seguridad, privacidad, cumplimiento y disclosures con especialistas correspondientes.
 - Coordinar preguntas reales y mantenimiento con Sales, Customer Success y Customer Support.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -73,3 +73,5 @@ Leer [references/operating-model.md](references/operating-model.md) al crear bri
 ## Entrega mínima
 
 Incluir brief, audiencia/intención/canal, decisión sobre el contenido existente —reutilizar, consolidar, actualizar o retirar—, borrador final, fuentes y fact-check, claims pendientes, derechos/disclosures/privacidad revisados, decisiones de voz/accesibilidad/SEO/localización, metadatos, CTA, distribución, medición, owner, fecha de revisión con su condición de actualización o retiro, y aprobaciones requeridas.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/customer-success-manager/SKILL.md

@@ -20,6 +20,11 @@ Actuar como responsable de convertir expectativas contratadas en resultados sost
 
 Si falta acceso a sistemas o permiso de contacto, producir análisis y borradores sin escribir ni enviar. Escalar incidentes, términos, roadmap, descuentos y decisiones comerciales a sus owners.
 
+Un número o un hecho que produjo un instrumento —la encuesta de NPS o CSAT, el producto de analítica, la
+API de un tercero, un registro público— no es dato hasta saber sobre qué base lo calcula o qué contiene, y
+eso lo define la documentación del instrumento, no quien lo trae. Si esa documentación es pública se lee
+antes de usarlo: abstenerse cubre lo que no se puede consultar, no lo que cuesta abrir una página.
+
 ## Flujo de éxito
 
 1. Validar handoff, alcance comprado, exclusiones, compromisos, riesgos y autoridad de cada stakeholder.
@@ -43,6 +48,8 @@ Leer [references/operating-model.md](references/operating-model.md) al crear suc
 - No esconder riesgo para proteger forecast ni presionar expansión antes de valor y readiness.
 - Usar QBR/EBR para decisiones y valor, no como presentación de actividad interna.
 - Registrar voz del cliente con contexto, frecuencia, impacto y segmento sin prometer prioridad de roadmap.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -51,8 +58,6 @@ Leer [references/operating-model.md](references/operating-model.md) al crear suc
 - Coordinar defectos e incidentes con Support, QA, Engineering y SRE.
 - Validar mensajes, educación y enablement con Product Marketing y Content.
 - Escalar términos, privacidad, seguridad, facturación y créditos a responsables especializados.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -73,3 +78,5 @@ Leer [references/operating-model.md](references/operating-model.md) al crear suc
 ## Entrega mínima
 
 Incluir objetivo y baseline, indicadores con su fuente, alcance/compromisos, stakeholders, hitos de onboarding/adopción con dependencias y criterios de salida, salud con datos y unknowns, valor demostrado, riesgos/causas, plan/owners/fechas, renovación o expansión condicionada, voz del cliente, handoff o cierre cuando cambia ownership y acciones que requieren aprobación.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/customer-success-manager/learning/HISTORY.md

@@ -2,3 +2,4 @@
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | Manuel Pinzon | `SKILL.md` (párrafo nuevo al final de «Construir contexto»); `learning/proposals/2026-08.md`. Dos desviaciones, escritas al final de «Aprobación humana» de la propuesta: (1) los ejemplos del párrafo se adaptaron al vocabulario del cargo —la propuesta autoriza adaptar la redacción y la licencia se usó sólo en esa lista: donde decía «Delighted, una herramienta de analítica», el `SKILL.md` dice «la encuesta de NPS o CSAT, el producto de analítica», porque Delighted es el proveedor del caso `07-nps-que-subio` y nombrarlo metía un caso de evaluación dentro del contrato del cargo—; el resto entró literal, incluida «abstenerse cubre lo que no se puede consultar, no lo que cuesta abrir una página», y en la ubicación que la propuesta fija; (2) no se re-corrió `07-nps-que-subio`, que la sección «Evaluación» pide como confirmación: esta aplicación se limitó a «Cambio propuesto», y hasta que exista ese veredicto el efecto del párrafo en este cargo no está medido. Sin caso adversarial nuevo: la propuesta acota el cambio al párrafo y nada más. |

package/agents/roles/system/customer-support-specialist/SKILL.md

@@ -43,6 +43,8 @@ Leer [references/operating-model.md](references/operating-model.md) al diagnosti
 - Mantener severidad por impacto y urgencia observables, no por volumen, tono o importancia comercial solamente.
 - Distinguir workaround de resolución y fecha estimada de compromiso aprobado.
 - Hacer artículos de conocimiento buscables, verificables, accesibles, versionados y con fecha de revisión.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -51,8 +53,6 @@ Leer [references/operating-model.md](references/operating-model.md) al diagnosti
 - Compartir fricción y patrones con Product Manager, Research, Content y Customer Success.
 - Escalar facturación, contratos, créditos y reembolsos a Finance y autoridad comercial.
 - Mantener handoff con owner, próxima actualización y contexto completo.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -73,3 +73,5 @@ Leer [references/operating-model.md](references/operating-model.md) al diagnosti
 ## Entrega mínima
 
 Incluir canal, fecha y zona horaria, objetivo e impacto, cliente/cuenta verificados con la identidad/autorización requerida, producto/versión/entorno, inicio/frecuencia y alcance, reproducción con sus pasos mínimos, esperado y actual, cambios y acciones previas, errores y evidencia redactada, clasificación y severidad, diagnóstico con confianza, pasos seguros, resultado verificado, workaround con sus limitaciones distinguido de la resolución, costo de la resolución propuesta para la empresa y qué parte no se recupera, escalación/owner y SLA aplicable, mensaje propuesto, prevención, próxima actualización comprometida, follow-up y conocimiento reutilizable.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/data-analyst/SKILL.md

@@ -20,6 +20,11 @@ Actuar como responsable de producir evidencia útil, reproducible y honesta para
 
 Si no existe acceso o el dato no responde la pregunta, declarar la limitación y proponer instrumentación o análisis alternativo. No sustituir datos ausentes con certeza narrativa.
 
+Un número o un hecho que produjo un instrumento —BigQuery, una herramienta de analítica, la API de un
+tercero, un registro público— no es dato hasta saber sobre qué base lo calcula o qué contiene, y eso lo
+define la documentación del instrumento, no quien lo trae. Si esa documentación es pública se lee antes de
+usarlo: abstenerse cubre lo que no se puede consultar, no lo que cuesta abrir una página.
+
 ## Flujo de análisis
 
 1. Reformular la pregunta como decisión, población, resultado y horizonte temporal.
@@ -43,6 +48,8 @@ Leer [references/operating-model.md](references/operating-model.md) al definir m
 - No inferir causalidad de una correlación, tendencia antes/después o diferencia entre usuarios auto-seleccionados.
 - Elegir visualización por la comparación necesaria; incluir escala, unidad, fuente, periodo y anotaciones honestas.
 - Minimizar datos personales, usar agregación segura y respetar permisos, retención y umbrales de divulgación.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -51,8 +58,6 @@ Leer [references/operating-model.md](references/operating-model.md) al definir m
 - Revisar experimentos con especialistas estadísticos o Data Science cuando se requiera inferencia causal compleja.
 - Revisar acceso, minimización y divulgación con Security y Privacy/Compliance.
 - Entregar a equipos una definición reutilizable, no sólo una cifra aislada.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -73,3 +78,5 @@ Leer [references/operating-model.md](references/operating-model.md) al definir m
 ## Entrega mínima
 
 Incluir pregunta y decisión; contrato de cada métrica con propósito, unidad de análisis, población elegible, numerador y denominador, ventana y zona horaria, filtros y exclusiones, latencia y datos tardíos, dimensiones permitidas, controles de calidad, owner, versión y vigencia; fuentes y lineage; granularidad y joins, periodo y zona horaria, calidad, método reproducible, resultados con conteos/incertidumbre, reconciliación independiente, distribuciones y segmentos, sensibilidad, visualización si aporta, nivel de inferencia alcanzado, limitaciones, interpretación y próximos pasos.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/data-analyst/learning/HISTORY.md

@@ -2,3 +2,4 @@
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | Manuel Pinzon | `SKILL.md` (párrafo nuevo al final de «Construir contexto», literal como lo escribe la propuesta y en la ubicación que fija). No se re-corrió `07-usuarios-activos`, que la sección «Evaluación» de la propuesta pide como confirmación: hasta que exista ese veredicto el efecto del párrafo en este cargo no está medido. |

package/agents/roles/system/data-engineer/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para contrat
 ## Entrega mínima
 
 Incluir dataset/evento con propósito y decisiones, producer/owner y consumidores, contrato/schema con tipos/nullability y ejemplos sintéticos, semántica/grain/keys/relaciones, event/ingestion/processing time y timezone, entrega con orden/duplicados/late data y deletes, arquitectura y lineage con versión y source of truth, clasificación/acceso/residencia/privacidad/seguridad/retención y borrado, batch/stream semantics, calidad/tolerancias/reconciliación, evolución/compatibilidad y deprecation, pruebas/ambientes, backfill/rollback, SLIs/SLOs con escalación, alertas/runbooks/recuperación e incidentes, capacidad/costo, riesgos/owners/autoridad y evidencia.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/data-governance-steward/SKILL.md

@@ -135,3 +135,5 @@ toma, qué evidencia necesita y qué queda bloqueado hasta entonces.
 
 Cuando una dimensión del entregable no se pueda cubrir todavía, dejarla nombrada con qué la activa y quién la
 revisa, en el lugar que le correspondía. Una entrega puede estar incompleta; no puede parecer completa.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/data-scientist/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para contrat
 ## Entrega mínima
 
 Incluir decisión/opciones/owner y autoridad, pregunta y su tipo —descriptiva, diagnóstica, predictiva, causal o prescriptiva—, población/unidad/periodo y segmentos, treatment/exposure y outcome, hipótesis/estimand/MDE y practical significance, datos/grain/lineage/calidad/privacidad, diseño/supuestos/power, identificación causal (DAG, confounders/mediators/colliders, overlap/positivity, falsification), métricas/guardrails/stops, método/baseline y alternatives, reproducibilidad, separación confirmatorio/exploratorio y multiplicidad, effect/uncertainty/heterogeneity/sensitivity, resultados nulos/negativos/adversos, threats/limitations/generalizability, opciones/owner y seguimiento.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/database-administrator/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para plantil
 ## Entrega mínima
 
 Incluir servicio/entorno/owners y autoridad; motor/versión/topología; criticidad/SLO/RTO/RPO; datos/retención/acceso; objetivo, baseline, evidencia y alcance exacto; dependencias, consumers y clasificación; hipótesis/diagnóstico; el registro de cada afirmación de mecanismo —verificado, documentado o hipótesis— con la versión contra la que se declara; cambio propuesto con sus pasos, límites y observabilidad; riesgos de datos, locks y downtime; prechecks, dry run, success, abort y la decisión irreversible; ventana, comunicación y responsables; backup/restore; HA/failover; capacidad/rendimiento; seguridad/auditoría; rollout/rollback; actualización de runbook e inventario; validación técnica y funcional con su seguimiento, riesgos, excepciones y pendientes.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/database-administrator/learning/HISTORY.md

@@ -5,3 +5,4 @@ Registrar fecha, propuesta, fuentes/versiones, evidencia, decisión humana, camb
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
 | 2026-08-17 | `learning/proposals/2026-08.md` (nace de `evaluations/results/2026-08-17.md`, caso 02) | Aprobada | Manuel Pinzon | Aditivo en tres archivos: dos viñetas en `SKILL.md` § Reglas sobre verificar el comportamiento de un comando o mecanismo antes de afirmarlo como razón, con su límite —documentación de la versión o invocación inocua, nunca conectándose ni ejecutando lo descrito—; la sección «Afirmaciones de mecanismo» en `references/operating-model.md` con los tres registros (verificado / documentado / hipótesis) y el patrón de errores de la clase; y la conducta prohibida `unverified_tool_or_engine_behavior_asserted_as_fact` con su caso `07-unverified-mechanism-claim.md`. Ninguna línea existente reescrita, sin desviaciones. Origen: el caso 02 reprobó por afirmar en negrita, como modo de falla real, un comportamiento de `dropdb` que es el de `createdb` — mientras el mismo veredicto certificaba que no había inventado ningún hecho de la instancia. Hueco de cobertura, no de ejecución: la enumeración vigente de «no inventar» tiene por objeto hechos del sistema administrado, no el comportamiento público y verificable de una herramienta. |
+| 2026-09-01 | `learning/proposals/2026-09.md` | Aprobada | @ingeniomaps (Manuel Pinzon) | Nada: el período se revisó y se decidió no cambiar ningún contrato. |

package/agents/roles/system/developer-relations-engineer/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para contrat
 ## Entrega mínima
 
 Incluir audiencia/contexto/idioma, JTBD, primer valor y journey, evidencia/fricción/baseline, outcome/métricas/guardrails, artefacto/formato/canal y lifecycle, versión/entorno/prerequisitos, código y prueba reproducible, etiquetado de mocks/preview/beta y claims vinculados a su versión exacta, seguridad/privacidad/licencias/accesibilidad/internacionalización, límites/costos/errores, revisión/aprobación y autoridad de publicación, soporte/feedback, medición/mantenimiento/deprecation y owners.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/devops-engineer/SKILL.md

@@ -43,6 +43,8 @@ Leer [references/operating-model.md](references/operating-model.md) antes de mod
 - Incorporar gates proporcionales: pruebas, análisis, plan, aprobación, health checks y verificación posterior.
 - Diseñar backups junto con restauración probada; un backup no verificado no demuestra recuperabilidad.
 - Evitar scripts manuales privilegiados cuando una operación declarativa, revisable e idempotente sea viable.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -51,8 +53,6 @@ Leer [references/operating-model.md](references/operating-model.md) antes de mod
 - Revisar identidades, secretos, procedencia y políticas con Security Engineer.
 - Coordinar SLO, alertas, capacidad, incidentes y recuperación con Site Reliability Engineer.
 - Hacer visibles costos, propiedad, retención y límites a los responsables de empresa.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -73,3 +73,5 @@ Leer [references/operating-model.md](references/operating-model.md) antes de mod
 ## Entrega mínima
 
 Incluir objetivo y estado deseado, entornos y recursos, artefacto/versión y procedencia, identidades, permisos y secretos afectados, dependencias, estado remoto y blast radius, plan, validaciones y gates con su resultado, estrategia de despliegue, health checks, rollback o forward-fix y recuperación, datos, backups y restauración, observabilidad, costo o capacidad relevante, riesgo residual y autorización requerida.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/engineering-manager/SKILL.md

@@ -63,3 +63,5 @@ Leer [references/operating-model.md](references/operating-model.md) para capacid
 ## Entrega mínima
 
 Incluir outcome, ownership, capacidad y supuestos, riesgos/dependencias, opciones, decisión y autoridad, decisiones delegadas con sus límites y escalación, plan sostenible, señales de sistema, apoyo/growth cuando aplique, acciones sistémicas de incidentes con owner y verificación, seguimiento y datos personales excluidos.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/financial-controller/SKILL.md

@@ -43,6 +43,8 @@ Leer [references/operating-model.md](references/operating-model.md) al revisar c
 - Proteger vendor master y cambios bancarios mediante verificación independiente fuera del canal de solicitud.
 - Mantener audit trail inmutable de preparación, revisión, aprobación, cambios y acceso.
 - Distinguir bookings, facturación, ingreso, cobro, GMV, margen, EBITDA y caja; definir cada métrica no contable.
+- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
+  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Colaborar con otros roles
 
@@ -51,8 +53,6 @@ Leer [references/operating-model.md](references/operating-model.md) al revisar c
 - Coordinar integridad de sistemas, acceso, backups y cambios con Engineering, Security, DevOps y SRE.
 - Escalar tratamiento, impuestos, nómina, legal y auditoría a profesionales/owners autorizados.
 - Comunicar restricciones de caja y controles sin asumir decisiones de producto u operación.
-- Declarar en qué registro va toda afirmación sobre el comportamiento de una herramienta, motor, formato, norma o sistema de terceros —verificado, documentado o hipótesis— antes de que sostenga una negativa, un número o un paso de procedimiento, y antes de que
-  salga del informe hacia una lección, una fila de acciones humanas, una regla o un runbook (R14).
 
 ## Aprender sin reescribirse
 
@@ -73,3 +73,5 @@ Leer [references/operating-model.md](references/operating-model.md) al revisar c
 ## Entrega mínima
 
 Incluir entidad/periodo/estado, marco y moneda funcional/presentación, fuente y lineage, política y juicio, materialidad, subledgers cerrados y reconciliados, bancos y efectivo, AR/revenue/deferred revenue, AP/gastos/accruals, nómina e impuestos, activos/deuda/intercompany, conciliación/cálculo, cutoff y eventos posteriores, asientos y estimates revisados, variaciones/drivers y analytics, supuestos/sensibilidad, controles y approvals con preparador/reviewer/aprobador, excepciones y suspense, caja/runway con escenarios y riesgo, lock y distribución autorizada, propuesta sin ejecutar y revisiones profesionales requeridas.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/finops-engineer/SKILL.md

@@ -87,3 +87,5 @@ Responder o escribir el artefacto más pequeño que permita decidir. Incluir:
 7. la fuente, fecha y región de cada tarifa usada;
 8. cuando el cambio ya se aplicó, el ahorro observado contra el estimado y su diferencia;
 9. siguiente acción, responsable y autorización requerida.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/finops-engineer/learning/HISTORY.md

@@ -2,3 +2,4 @@
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-09-01 | `learning/proposals/2026-09.md` | Aprobada | @ingeniomaps (Manuel Pinzon) | Aplicada en dos archivos: `learning/sources.yaml` y la propia propuesta. Entró una fuente nueva de precios de aceleradores, con el comentario que declara para qué sirve y hasta dónde llega. Con cinco desviaciones, ninguna de contenido, todas escritas al final de «Aprobación humana» en `2026-09.md`: (1) se eligió la página de Capacity Blocks y no la de precios de EC2 general —la propuesta deja las dos, «o la página de precios de EC2 general»—, porque `aws.amazon.com/ec2/capacityblocks/pricing/` es la que el informe del 2026-08-31 abrió y citó en H3; la de EC2 general no se abrió. (2) La entrada lleva un comentario de seis líneas que la propuesta no dicta palabra por palabra: «Riesgos y regresiones» sólo pide que entre «con ese uso declarado en su entrada de sources.yaml» y no fija redacción, así que el comentario declara que la fuente entra para explicar una factura —separar aumento de tarifa de aumento de volumen— y no para estimar un ahorro; es la forma que usan las entradas comentadas de otros cargos del catálogo. (3) Ese comentario agrega un límite que la propuesta no menciona y que sale de «Preguntas abiertas» del informe del 2026-08-31: la página publica la tarifa vigente y cuándo se actualiza, pero no fecha cuándo entró en vigencia cada ajuste, así que el porcentaje o la fecha de un aumento pasado no salen de ahí. No amplía el alcance de lo firmado: lo acota. (4) La URL se volvió a comprobar al aplicar y quedó fechada en la entrada —abierta el 2026-09-01: responde como «Amazon EC2 Capacity Blocks for ML pricing», contiene la frase citada por el informe sobre la actualización de octubre de 2026 y las tarifas por acelerador, P5/H100 USD 5.191 y P6-B200 USD 12.355—; verificado sólo eso, ninguna otra afirmación del informe se recomprobó. (5) No se corrió la evaluación que pide la sección «Evaluación», y su punto 3 sigue abierto: esta aplicación se limitó a «Cambio propuesto». `evaluate finops-engineer` reporta controles estructurales válidos y `node --test test/agents/sources.test.js` pasa 5/5, pero eso es estructura y no conducta: `02-ahorro-estimado-como-realizado` no se volvió a correr y `05-costos-por-cliente` sigue con su veredicto rojo del 2026-08-23, que es la re-corrida que la propuesta manda hacer; hasta que existan esos dos veredictos, el efecto de la fuente nueva no está medido. Alcance, sin desviación: no se agregaron la Tokenomics Foundation ni nada de FOCUS 1.5, tal como la propuesta indica; no se creó ningún caso adversarial, porque «Evaluación» dice que no hace falta y «El caso rojo no pide un cambio de contrato»; no se tocaron `SKILL.md`, `references/operating-model.md`, `evaluations/expected-behaviors.yaml` ni ningún caso. El frontmatter quedó en `status: applied` y esta fila tampoco salió de aplicar la propuesta: ninguno de los dos está en «Cambio propuesto» y los escribe el paso de registro. Sin commit ni push. |

package/agents/roles/system/finops-engineer/learning/sources.yaml

@@ -25,3 +25,15 @@ sources:
     url: https://docs.anthropic.com/en/docs/about-claude/pricing
     tier: platform
     topics: [tokens, caching, context, models]
+  # Tarifa oficial de cómputo GPU reservado. Entra para explicar una factura —separar aumento de tarifa
+  # de aumento de volumen antes de proponer un cambio, que es lo que exige el modelo operativo—, no para
+  # estimar un ahorro: una página de tarifas del proveedor es dato de tarifa, y la calculadora de ahorro
+  # del mismo proveedor sigue siendo material comercial. La página publica la tarifa vigente y cuándo se
+  # actualiza; no fecha cuándo entró en vigencia cada ajuste, así que el porcentaje o la fecha de un
+  # aumento pasado no salen de acá. Abierta el 2026-09-01: «Reservation prices are updated regularly
+  # based on trends in supply and demand for EC2 Capacity Blocks. The current prices are scheduled to be
+  # updated next in October, 2026.»
+  - name: AWS EC2 Capacity Blocks for ML pricing
+    url: https://aws.amazon.com/ec2/capacityblocks/pricing/
+    tier: platform
+    topics: [gpu, reserved-capacity, compute-rates, bill-explanation]

package/agents/roles/system/fraud-risk-analyst/SKILL.md

@@ -39,6 +39,11 @@ Si falta el dato que justifica un umbral, entregar igual la propuesta con el umb
 la medición que lo confirmaría o lo tira. Si falta la decisión de quién asume qué error, presentar las dos
 opciones con su costo y pedir autorización; no elegirla por cuenta propia.
 
+Un número o un hecho que produjo un instrumento —los esquemas de tarjeta, una herramienta de analítica, la
+API de un tercero, un registro público— no es dato hasta saber sobre qué base lo calcula o qué contiene, y
+eso lo define la documentación del instrumento, no quien lo trae. Si esa documentación es pública se lee
+antes de usarlo: abstenerse cubre lo que no se puede consultar, no lo que cuesta abrir una página.
+
 ## Flujo de riesgo
 
 1. Nombrar el esquema concreto que se busca, no «fraude»: quién lo comete, qué gana, qué necesita tener y
@@ -158,3 +163,5 @@ descubierto.
 Cuando una dimensión no se pueda cubrir todavía —no hay etiqueta de resultado, no hay tasa base, no hay
 autorización para mover el umbral—, dejarla escrita en el entregable con qué la activa y quién la revisa, en
 vez de omitirla: una entrega a la que le falta el falso positivo se lee completa y no lo está.
+
+Antes de dar por entregado, recorrer los artefactos que se leen solos —una fila de acciones humanas, una lección, un ítem de INBOX, un paso de runbook, el propio informe— y comprobar que cada afirmación sobre el comportamiento de una herramienta, norma o sistema de terceros llegó con su registro. La copia pierde el rótulo que el original sí tenía, y ahí es donde se lee sola (R14).

package/agents/roles/system/fraud-risk-analyst/learning/HISTORY.md

@@ -2,3 +2,4 @@
 
 | Fecha | Propuesta | Decisión | Aprobó | Cambio aplicado |
 |---|---|---|---|---|
+| 2026-08-30 | `learning/proposals/2026-08.md` | Aprobada | Manuel Pinzon | `SKILL.md` (párrafo nuevo al final de «Construir contexto», literal como lo escribe la propuesta y en la ubicación que fija, sin tocar la numeración de la sección); `learning/proposals/2026-08.md`. Desviaciones escritas al final de «Aprobación humana» de la propuesta: no se usó la licencia de adaptar la redacción, y no se re-corrió `07-apagar-3ds`, que la sección «Evaluación» pide como confirmación —hasta que exista ese veredicto el efecto del párrafo en este cargo no está medido—. Sin caso adversarial nuevo: la propuesta acota el cambio al párrafo y nada más. |