@saulwade/swl-ses 1.6.1 → 1.6.3

package/manifiestos/skills-lock.json

@@ -1,8 +1,8 @@
 {
   "lockfileVersion": 1,
-  "generatedAt": "2026-05-17T02:12:13.590Z",
-  "skillsCount": 162,
-  "lockHash": "sha256:3161595ab2e26eb867da552a1ecedec3a83f6ce07703f1d8dc7c4adea4625d24",
+  "generatedAt": "2026-05-18T14:10:18.550Z",
+  "skillsCount": 169,
+  "lockHash": "sha256:69b1de348f917c99653d4685bdbfc6c32dd81bdf3b2f0f366826c574ffaa5845",
   "skills": [
     {
       "nombre": "accesibilidad-a11y",
@@ -53,6 +53,13 @@
       "bytes": 10100,
       "version": "\"1.0.1\""
     },
+    {
+      "nombre": "aprender-de-git-diff",
+      "path": "habilidades/aprender-de-git-diff/SKILL.md",
+      "hash": "sha256:7d1a43e40be200aeccca6613ba6afcae6c00b047d219fbfbedd44e2a0f447d7d",
+      "bytes": 11551,
+      "version": "\"1.0.0\""
+    },
     {
       "nombre": "aprendizaje-continuo",
       "path": "habilidades/aprendizaje-continuo/SKILL.md",
@@ -350,9 +357,9 @@
     {
       "nombre": "diseno-herramientas-agente",
       "path": "habilidades/diseno-herramientas-agente/SKILL.md",
-      "hash": "sha256:7ba8423a04f9074df560b8adb7ad8efd5719931cbaef0f5897e434a611a22142",
-      "bytes": 10153,
-      "version": null
+      "hash": "sha256:42a8b0aa5d12368603eb1e677c849eb7ec92e9b8118ebb84489f5a54229e9534",
+      "bytes": 10171,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "diseno-responsivo",
@@ -378,9 +385,9 @@
     {
       "nombre": "doubt-driven-review",
       "path": "habilidades/doubt-driven-review/SKILL.md",
-      "hash": "sha256:5677f6c92a0fc183f9bbe06171cca14e3ad85695dba055acd1de56d81bff182b",
-      "bytes": 7620,
-      "version": null
+      "hash": "sha256:96410f86f24e7c5536e1bcf47c7f964ac126901afc38c8492deaba7eb0736752",
+      "bytes": 8363,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "drift-detection",
@@ -462,9 +469,9 @@
     {
       "nombre": "feynman-auditor-swl",
       "path": "habilidades/feynman-auditor-swl/SKILL.md",
-      "hash": "sha256:0bfc54a0e33a7c974ba4d644f46bf3d332eb8966de68a4dcbfa2de733b78ce68",
-      "bytes": 5080,
-      "version": null
+      "hash": "sha256:68c3c469470b4c351c6465edf1de37abd180eec910c1908cbdfb9ab8a43cb759",
+      "bytes": 5635,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "filament-admin",
@@ -553,9 +560,9 @@
     {
       "nombre": "infra-github-actions",
       "path": "habilidades/infra-github-actions/SKILL.md",
-      "hash": "sha256:50b85b21dd0e5f5fa8f211f6d0f31f4649bbe20c9480e0017184f1dd0b7fc8dc",
-      "bytes": 7189,
-      "version": null
+      "hash": "sha256:c41c5e2cba14e46814a5e31ae968714eb62d58cd9fad219bbe3078f86f96a9ee",
+      "bytes": 8039,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "instalar-sistema",
@@ -658,8 +665,8 @@
     {
       "nombre": "meta-skills-estandar",
       "path": "habilidades/meta-skills-estandar/SKILL.md",
-      "hash": "sha256:4908de280db0d143643fc96ae748519edc2142aa9ef35c415cd84074c274d613",
-      "bytes": 23181,
+      "hash": "sha256:5e5a4597e200766aa6465f4ecc194739b2d9d82f6ac219d6774f2a0bb4ca10dc",
+      "bytes": 23632,
       "version": "\"1.1.1\""
     },
     {
@@ -700,16 +707,16 @@
     {
       "nombre": "nemesis-evaluacion-json",
       "path": "habilidades/nemesis-evaluacion-json/SKILL.md",
-      "hash": "sha256:e8c84252b6d6080101486b5acc021af14c9eeab6d25b71a0fc0f450177d5782d",
-      "bytes": 10610,
-      "version": null
+      "hash": "sha256:4369065f21eca91a3ae437a2b811db81b0618f7237934eacef4223f3423c21d8",
+      "bytes": 11056,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "nemesis-redistribuir",
       "path": "habilidades/nemesis-redistribuir/SKILL.md",
-      "hash": "sha256:171919fe921f411b065644ab09a93bd32c68fa74f43669d83522ad237e4b0590",
-      "bytes": 13610,
-      "version": null
+      "hash": "sha256:6efae919dadbd27b1b37c51447f50e911fabf2bc8cb90a90eaff87fdb14c60d7",
+      "bytes": 13973,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "nestjs-experto",
@@ -833,9 +840,9 @@
     {
       "nombre": "prevencion-racionalizacion",
       "path": "habilidades/prevencion-racionalizacion/SKILL.md",
-      "hash": "sha256:1f9606074be0f376ad40f51a804c3ed5620a599c613ca10c4c94df2b347ee11e",
-      "bytes": 12297,
-      "version": null
+      "hash": "sha256:654f30eb9d973081838b315ea48df7c5749bd4fe3fb901c88f84d71086474c52",
+      "bytes": 12315,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "prevencion-sobreingenieria",
@@ -847,8 +854,43 @@
     {
       "nombre": "privacy-memoria",
       "path": "habilidades/privacy-memoria/SKILL.md",
-      "hash": "sha256:a0bd74e547064f9d4af60844fb1d3a0b93ded2a94e6875ba89a0a3fa1c54cd64",
-      "bytes": 9111,
+      "hash": "sha256:ada53794bc6336016a8a1410475f2928adec937052d5915ed1e0f35d0bba1b57",
+      "bytes": 9129,
+      "version": "\"1.0.0\""
+    },
+    {
+      "nombre": "proceso-autoverificacion-evidencias",
+      "path": "habilidades/proceso-autoverificacion-evidencias/SKILL.md",
+      "hash": "sha256:75d4675814864855c92c098a065a28a34c71c6f4e77e620cce94422d5d1638c6",
+      "bytes": 10455,
+      "version": "\"1.0.0\""
+    },
+    {
+      "nombre": "proceso-confianza-pre-implementacion",
+      "path": "habilidades/proceso-confianza-pre-implementacion/SKILL.md",
+      "hash": "sha256:c0766fc0df5a06d750db7a151c9794fd8f6decb521733ac42f8cfe9d176b9406",
+      "bytes": 11045,
+      "version": "\"1.0.0\""
+    },
+    {
+      "nombre": "proceso-ddia-fundamentos",
+      "path": "habilidades/proceso-ddia-fundamentos/SKILL.md",
+      "hash": "sha256:4ac1c8ee4c63e7bfd5e8f01997f6b59e2b0d5981d21947a42910db4f179a0710",
+      "bytes": 10302,
+      "version": null
+    },
+    {
+      "nombre": "proceso-ddia-streaming",
+      "path": "habilidades/proceso-ddia-streaming/SKILL.md",
+      "hash": "sha256:89602349bbdd2a41d46077b46c3450be1f467b04f9f2233c90f551e187bd59ed",
+      "bytes": 9497,
+      "version": null
+    },
+    {
+      "nombre": "proceso-intent-engineering",
+      "path": "habilidades/proceso-intent-engineering/SKILL.md",
+      "hash": "sha256:38cfc73217d54b61e93685dd7bf5f5cb6433e1fc6bccbc0f5a076764ada0418d",
+      "bytes": 11064,
       "version": null
     },
     {
@@ -900,6 +942,13 @@
       "bytes": 13493,
       "version": "\"1.0.0\""
     },
+    {
+      "nombre": "reducir-entropia",
+      "path": "habilidades/reducir-entropia/SKILL.md",
+      "hash": "sha256:b1608804e7b7a8cd6c8d10a8f6fe75720cb8f9c49e16c4d9ad0fb3ad4e35b48a",
+      "bytes": 9036,
+      "version": "\"1.0.0\""
+    },
     {
       "nombre": "release-semver",
       "path": "habilidades/release-semver/SKILL.md",
@@ -945,16 +994,16 @@
     {
       "nombre": "sre-patrones",
       "path": "habilidades/sre-patrones/SKILL.md",
-      "hash": "sha256:45a7f7c2329fdfacf19da0767f44cff0a4aab3fe21287aaf80a48b515cb43a24",
-      "bytes": 15651,
+      "hash": "sha256:9bc98452f5febcd0fd6eb8e2e6a413835fb0d6afe5e29d094d6894f29a6ab4e0",
+      "bytes": 15697,
       "version": "\"1.0.0\""
     },
     {
       "nombre": "state-inconsistency-auditor-swl",
       "path": "habilidades/state-inconsistency-auditor-swl/SKILL.md",
-      "hash": "sha256:fa1f2cbeba793f1d38c778b7ddca49f4c556dbf522de8edb10838dd54bd91c5f",
-      "bytes": 8013,
-      "version": null
+      "hash": "sha256:8c086ddc15dac503005edc57e9c7b403736bf81c51315f8ffd848a81c5d4a7da",
+      "bytes": 8628,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "stripe-pagos",
@@ -1099,9 +1148,9 @@
     {
       "nombre": "verificacion-evidencia",
       "path": "habilidades/verificacion-evidencia/SKILL.md",
-      "hash": "sha256:2a5521a7fe32dd7d2f33cabdb9c12b2dd4e6b7755514d5ab9661152a3327903c",
-      "bytes": 7765,
-      "version": null
+      "hash": "sha256:f0a1548653e009386fb119cbffe856a27d4cb612758e398af50d7dff49612651",
+      "bytes": 7783,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "verificar-trabajo",
@@ -1113,9 +1162,9 @@
     {
       "nombre": "web-fetcher-routing",
       "path": "habilidades/web-fetcher-routing/SKILL.md",
-      "hash": "sha256:14dc3cebbdc105c7c429f0456cc2e961ace63f9ea548f94b99da1b9e0b7c2074",
-      "bytes": 3611,
-      "version": null
+      "hash": "sha256:78f05abd2dcb5561deb95b30b91acea8b5ebfa7f2e10571efe926367747eab57",
+      "bytes": 4137,
+      "version": "\"1.0.0\""
     },
     {
       "nombre": "wiki-conocimiento",
@@ -1134,8 +1183,8 @@
     {
       "nombre": "workflow-claude-code",
       "path": "habilidades/workflow-claude-code/SKILL.md",
-      "hash": "sha256:7862ee8969de50693ad68cbf260c69dd85f87bd1b3ee563d36acfa68b75a4a11",
-      "bytes": 11745,
+      "hash": "sha256:21e4e3d8ce51e390f9312fe8331d62e4429d606e4a2b9522812240b37ff48ebb",
+      "bytes": 11832,
       "version": "\"1.1.0\""
     }
   ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@saulwade/swl-ses",
-  "version": "1.6.1",
-  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 60 agentes, 162 habilidades, 44 comandos, 67 reglas y 41 hooks. Soporta 11 lenguajes y 7 runtimes: Claude Code, OpenClaude, OpenCode, Gemini CLI, Cursor, Codex CLI (soporte completo); GitHub Copilot (soporte parcial). 100% en espanol (Mexico). Multi-target install (--target CSV / --all-runtimes), autoconfig MCP en Cursor/Codex con --with-mcp, agentes Codex en TOML, hooks Cursor (17 eventos) y Codex (6 eventos). Gateway bidireccional con relay Telegram y auditoria profunda Nemesis con loop evaluator-optimizer opt-in (ADR-0021) y 8 tools ejecutables. v1.6.1 endurece el verificador docs-vs-codigo con gates de profundidad (Check #2 + #6 + #7 + #8 nuevos) y formaliza el protocolo proactivo de propagacion (doc-sync v1.3.0) — ADR-0023.",
+  "version": "1.6.3",
+  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 60 agentes, 162 habilidades, 44 comandos, 67 reglas y 41 hooks. Soporta 11 lenguajes y 7 runtimes: Claude Code, OpenClaude, OpenCode, Gemini CLI, Cursor, Codex CLI (soporte completo); GitHub Copilot (soporte parcial). 100% en espanol (Mexico). Multi-target install (--target CSV / --all-runtimes), autoconfig MCP en Cursor/Codex con --with-mcp, agentes Codex en TOML, hooks Cursor (17 eventos) y Codex (6 eventos). Gateway bidireccional con relay Telegram y auditoria profunda Nemesis con loop evaluator-optimizer opt-in (ADR-0021) y 8 tools ejecutables. v1.6.2 integra 4 skills nuevos desde analisis de temp/ (proceso-confianza-pre-implementacion, proceso-autoverificacion-evidencias, aprender-de-git-diff, reducir-entropia) + helper task-budget.js — ADR-0025.",
   "bin": {
     "swl-ses": "bin/swl-ses.js",
     "swl-telegram-bot": "bin/swl-telegram-bot.js",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "swl-ses",
-  "version": "1.6.1",
-  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 162 habilidades, 44 comandos, 67 reglas y 41 hooks. 62 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.6.1 endurece verificador docs-vs-codigo (gates de profundidad) y formaliza protocolo proactivo doc-sync v1.3.0 (ADR-0023).",
+  "version": "1.6.3",
+  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 169 habilidades, 44 comandos, 68 reglas y 42 hooks. 62 librerias. 11 lenguajes. Soporta Claude Code, Copilot, OpenCode, Codex y Gemini CLI. Loop evaluator-optimizer en /swl:nemesis (ADR-0021). v1.6.2 integra 4 skills nuevos desde analisis de temp/ (PM Agent + lesson-learned + reducing-entropy) y helper task-budget.js — ADR-0025.",
   "author": "Saul Wade Leon",
   "license": "MIT",
   "repository": "https://github.com/saul-wade/swl-ses",
@@ -13,6 +13,7 @@
     "habilidades/angular-avanzado",
     "habilidades/angular-moderno",
     "habilidades/api-rest-diseno",
+    "habilidades/aprender-de-git-diff",
     "habilidades/aprendizaje-continuo",
     "habilidades/async-python",
     "habilidades/auth-patrones",
@@ -127,6 +128,11 @@
     "habilidades/prevencion-racionalizacion",
     "habilidades/prevencion-sobreingenieria",
     "habilidades/privacy-memoria",
+    "habilidades/proceso-autoverificacion-evidencias",
+    "habilidades/proceso-confianza-pre-implementacion",
+    "habilidades/proceso-ddia-fundamentos",
+    "habilidades/proceso-ddia-streaming",
+    "habilidades/proceso-intent-engineering",
     "habilidades/prompt-engineering",
     "habilidades/protocolo-revision-swl",
     "habilidades/rag-arquitectura",
@@ -134,6 +140,7 @@
     "habilidades/react-experto",
     "habilidades/react-optimizacion",
     "habilidades/redis-experto",
+    "habilidades/reducir-entropia",
     "habilidades/release-semver",
     "habilidades/rust-experto",
     "habilidades/rust-patrones",

package/reglas/fragmentos-compartidos.md

@@ -150,3 +150,29 @@ Para extraer un bloque duplicado a fragmento:
 - [ ] No es contenido invocable dinámicamente (eso es skill)
 - [ ] Cada agente que lo usa lo declara en `fragmentos: [...]`
 - [ ] `scripts/validar-manifest.js` no reporta errores
+
+## Implicaciones en scripts de auditoría/conteo de agentes
+
+Cualquier script o hook que recorre `agentes/*.md` para contar o validar
+agentes DEBE excluir fragmentos explícitamente con
+`filter(f => f.endsWith('.md') && !f.startsWith('_'))`. Si no lo hace,
+incluye fragmentos en el conteo y reporta cifras incorrectas o falla en la
+validación de frontmatter (los fragmentos NO tienen frontmatter de agente).
+
+Scripts y hooks SWL que aplican esta exclusión y deben mantenerla:
+
+- `scripts/validar.js` — verifica frontmatter de agentes.
+- `scripts/validar-manifest.js` — cruza `agentes/*.md` vs `modulos.json`.
+- `scripts/generar-inventario.js` — cuenta agentes para INVENTARIO/SALUD.
+- `hooks/validar-intent-spec.js` — regex `/\/agentes\/[^_][^/]*\.md$/`
+  con clase negada para fragmentos.
+- Cualquier script futuro de auditoría de agentes.
+
+**Caso de regresión histórico**: tras crear `agentes/_intent-spec.md`
+(fragmento) en sesión 2026-05-18, `scripts/generar-inventario.js` contó
+61 agentes cuando real eran 60 (gate `verificar-release.js` lo detectó).
+Fix: agregar el filtro al `readdirSync` del script.
+
+**Consideración futura**: centralizar la lógica en
+`scripts/lib/listar-agentes.js` con la exclusión por defecto evitaría que
+el filtro se omita en scripts nuevos.

package/reglas/intent-engineering.md

@@ -0,0 +1,214 @@
+# Regla: Intent Engineering para agentes ALTO riesgo
+
+Esta regla es **OBLIGATORIA** y aplica al crear, modificar o promover agentes
+del sistema SWL cuyo `nivelRiesgo` sea `ALTO`. Implementa el framework
+"Intent Engineering" de 8 partes de Pawel Huryn (*Lead Agents Like Humans*,
+Product Compass, 2026-05).
+
+---
+
+## Principio
+
+> Un agente con autonomía elevada que opera sin intent specification explícito
+> falla silenciosamente por instrucciones ambiguas, deriva de scope o pérdida
+> de health metrics. Los agentes ALTO riesgo del sistema SWL DEBEN declarar
+> las 8 partes del framework de forma verificable (frontmatter + fragmento),
+> no implícita.
+
+Huryn lo resume:
+
+> "Agents don't fail because the model is weak. They fail because intent is
+> incomplete. Objectives are vague. Outcomes are implicit. Trade-offs are
+> unstated. Constraints are treated as suggestions. Autonomy is granted
+> without understanding risk." (Lead Agents Like Humans, línea 56)
+
+SWL adopta el framework parcialmente: las partes 5 (Org Context) y 3
+(Desired Outcomes) viven en `CLAUDE.md` y `PLAN.md` respectivamente, no en
+cada agente. Las otras 6 son responsabilidad del autor del agente.
+
+---
+
+## Cuándo aplicar
+
+OBLIGATORIO al:
+
+- Crear un agente nuevo `nivelRiesgo: ALTO`.
+- Modificar el frontmatter de un agente `nivelRiesgo: ALTO` existente.
+- Promover un agente de `MEDIO` o `BAJO` a `ALTO`.
+- Auditar agentes con `/swl:revisar` cuando se detecta deriva de scope.
+
+NO aplicar al:
+
+- Agentes `BAJO` o `MEDIO` riesgo (los campos son opcionales para ellos).
+- Cambios cosméticos al cuerpo markdown del agente sin tocar frontmatter.
+- Skills, hooks, comandos (la regla aplica solo a agentes).
+
+---
+
+## Lo que DEBE declarar un agente ALTO
+
+### En el frontmatter YAML
+
+```yaml
+nivelRiesgo: ALTO            # Parte 7 — Autonomy Boundaries
+maxTurnos: <int>             # Parte 8 — Stop Rules (cap iteraciones)
+strategy: "<1-3 lineas>"     # Parte 1 — Strategy (max 500 chars)
+healthMetrics:               # Parte 4 — qué NO debe degradar
+  - "<invariante 1>"
+  - "<invariante 2>"
+steering:                    # Parte 6 — prompt-level constraints
+  - "<guía de comportamiento o @reglas/X.md>"
+hardGuardrails:              # Parte 6 — orchestration-level constraints
+  - "<restricción enforced por hook/schema o @reglas/X.md>"
+fragmentos:
+  - _intent-spec             # Importa el bloque compartido al system prompt
+```
+
+### En el cuerpo markdown
+
+NO requerido pero recomendado: agregar sección breve "Health Metrics" o
+"Constraints" si el rol del agente justifica explicación adicional.
+
+---
+
+## Criterios de calidad por campo
+
+### `strategy:`
+
+- 1-3 líneas, máximo 500 caracteres.
+- Nombra el tradeoff que el agente prioriza.
+- NO es boilerplate genérico ("código limpio", "buenas prácticas").
+- Hereda del proyecto cuando aplica; declara explícito cuando el rol impone
+  tradeoffs propios.
+
+**Ejemplo válido** (`migrador-swl`):
+```yaml
+strategy: >
+  Preservar integridad de datos por encima de velocidad de migración.
+  Expand-contract obligatorio sobre cambios destructivos. Rollback siempre
+  viable. Sin downtime es preferible a migración rápida.
+```
+
+**Ejemplo inválido**:
+```yaml
+strategy: "Migrar datos de forma segura."   # boilerplate genérico
+```
+
+### `healthMetrics:`
+
+- Lista de invariantes blandas que el agente protege mientras trabaja.
+- Distintas de `outcomes`: outcomes se persiguen, health metrics se
+  protegen.
+- Sin métrica = sin protección. Agentes ALTO sin health metrics violan
+  Goodhart's Law por construcción.
+- Pueden ser cualitativas si no hay telemetría que las mida live ("sin
+  warnings nuevos de ORM").
+
+### `steering:`
+
+- Soft constraints. El agente las lee como guía.
+- Acepta texto inline o referencia a regla global (`@reglas/X.md`).
+- NO duplicar contenido de `@reglas/X.md` — referenciar evita drift.
+
+### `hardGuardrails:`
+
+- Hard constraints aplicadas por arquitectura (hooks, schemas, sandbox).
+- Cada item DEBE referenciar el mecanismo que enforza:
+  - `@reglas/seguridad-agentes.md § Privilegio mínimo` (regla global)
+  - `@hooks/proteccion-rutas.js` (hook bloqueante)
+  - `@schemas/agent-frontmatter.schema.json#properties.tools` (validación)
+- Si la restricción no tiene mecanismo de enforcement, NO es hard
+  guardrail — es steering.
+
+---
+
+## Excepciones legítimas
+
+NO aplica la regla cuando:
+
+1. **El agente acaba de bajar de ALTO a MEDIO/BAJO**: si en una revisión se
+   determina que un agente puede operar con menos privilegio, primero baja
+   el `nivelRiesgo`, luego los campos se vuelven opcionales.
+
+2. **El agente está en proceso de deprecación**: agentes marcados
+   `evolvable: false` con plan de retiro documentado en ADR pueden quedar
+   sin las 8 partes hasta su retiro. Documentar excepción en commit.
+
+3. **Refactor cosmético reversible**: cambios al cuerpo markdown que no
+   modifican `nivelRiesgo:` ni los 4 campos nuevos no disparan la regla.
+
+---
+
+## Cómo verificar conformidad
+
+### Manualmente
+
+Para auditar un agente ALTO:
+
+```bash
+node -e "
+const a = require('js-yaml').load(require('fs').readFileSync(process.argv[1], 'utf-8').match(/^---\n([\s\S]+?)\n---/)[1]);
+if (a.nivelRiesgo !== 'ALTO') { console.log('NO-ALTO'); return; }
+const faltan = ['strategy','healthMetrics','steering','hardGuardrails'].filter(k => !a[k]);
+if (faltan.length) console.error('FALTAN:', faltan.join(','));
+else console.log('OK');
+" agentes/X-swl.md
+```
+
+### Automáticamente
+
+Hook `hooks/validar-intent-spec.js` (creado en F3) ejecuta esta validación
+en PostToolUse sobre `Write|Edit` de `agentes/*.md`. Modo inicial:
+`blocking: false` (warn-only). Promoción a `blocking: true` tras 2 semanas
+estables sin falsos positivos, documentada en ADR-0027.
+
+---
+
+## Anti-patrones
+
+- **Declarar `steering` algo que requiere enforcement**: "no eliminar
+  archivos" sin hook que lo prevenga. Si importa, va en `hardGuardrails`
+  con apoyo arquitectural.
+- **Copiar `@reglas/X.md` completa en `hardGuardrails`**: referenciar, no
+  duplicar. La regla evoluciona; la copia se queda atrás.
+- **Health metrics como outcomes negados**: "latencia < 200ms" es outcome;
+  "no degradar latencia mientras trabajas" es health metric.
+- **Strategy demasiado vaga**: si la strategy aplica a cualquier agente,
+  no es strategy de este agente. Borrar o especificar.
+- **Promover a ALTO sin declarar las 6 partes**: violación directa de
+  esta regla; el hook F3 (cuando blocking=true) lo previene.
+
+---
+
+## Relación con otras reglas
+
+- `reglas/seguridad-agentes.md § Privilegio mínimo` — los campos nuevos NO
+  escalan privilegios; son metadata declarativa.
+- `reglas/fragmentos-compartidos.md` — el `_intent-spec` importado es un
+  fragmento legítimo.
+- `reglas/skills-estandar.md` — los skills cargables (`proceso-intent-engineering`)
+  son la versión on-demand del fragmento.
+- `reglas/registro-componentes-nuevos.md` — al agregar agente nuevo ALTO,
+  registrar en manifiestos sigue siendo obligatorio.
+
+---
+
+## Cargar para aprender el framework
+
+```
+Skill("proceso-intent-engineering")
+```
+
+El skill explica cada parte con ejemplos, mapea Huryn (4 tiers) a SWL (3
+tiers), enumera anti-patrones y entrega tabla de referencia rápida.
+
+---
+
+## Origen
+
+Regla creada el 2026-05-18 como parte de Opción B (ver ADR-0025). Cubre el
+gap detectado en análisis del artículo Huryn: SWL cubría 5/8 partes pero
+no enforzaba sistemáticamente las 3 restantes (Strategy, Health Metrics,
+Constraints distinguidas). La regla aplica solo a agentes ALTO porque
+costos de declaración no compensan en agentes BAJO/MEDIO (los 6 agentes
+del CONTEXTO original que eran BAJO/MEDIO se dejan opcionales).

package/reglas/registro-componentes-nuevos.md

@@ -181,6 +181,43 @@ commit separado del fix actual.
 
 ---
 
+## Citas a módulos de manifest en ADRs y docs
+
+Cuando un ADR o documento del sistema cita un nombre de módulo de
+`manifiestos/modulos.json`, `manifiestos/hooks-config.json` o
+`manifiestos/perfiles.json`, **el nombre DEBE verificarse contra el
+archivo real antes de persistir el ADR/doc**. Citas redactadas "de
+memoria" tienden a inventar nombres plausibles que no existen.
+
+**Patrón verificador**:
+
+```bash
+# Verificar en qué módulo está registrado un componente específico
+node -e "
+const m = require('./manifiestos/modulos.json');
+for (const [k, v] of Object.entries(m.modulos || m)) {
+  if (v.archivos && v.archivos.includes('hooks/<NOMBRE>.js')) {
+    console.log('Módulo real:', k);
+  }
+}
+"
+
+# Listar todos los nombres de módulos disponibles
+node -e "console.log(Object.keys(require('./manifiestos/modulos.json').modulos))"
+```
+
+**Caso de regresión histórico**: ADR-0027 (2026-05-18) inicialmente decía
+"`manifiestos/modulos.json` en módulo `hooks-evolucion-instintos`" —
+módulo **inexistente**. El hook real quedó en `hooks-core`. Pasó la
+primera revisión porque el ADR se redactó de memoria. Fix retrospectivo
+en commit `6919b01`.
+
+**Aplicación**: la regla global `~/.claude/rules/verificar-citas-normativas.md
+§ Familia 2` cubre "citas archivo:línea" — esta regla extiende el patrón
+al dominio interno del proyecto: citas a nombres de módulos en manifiestos.
+
+---
+
 ## Checklist antes de commitear un componente nuevo
 
 - [ ] El archivo del componente está en el directorio correcto (`agentes/`, `habilidades/`, `comandos/swl/`, etc.).
@@ -190,3 +227,4 @@ commit separado del fix actual.
 - [ ] `npm run test:all` pasa sin errores.
 - [ ] Si es release: `node scripts/verificar-release.js` pasa sin discrepancias.
 - [ ] El commit message menciona qué componente se agrega y, si aplica, en qué módulo.
+- [ ] Si el ADR/doc cita un módulo de manifest, el nombre se verificó con `node -e` o `grep` contra el archivo real (no escrito "de memoria").