@saulwade/swl-ses 1.6.0 → 1.6.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@saulwade/swl-ses",
-  "version": "1.6.0",
-  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot con 60 agentes, 162 habilidades, 44 comandos, 66 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.",
+  "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",
@@ -34,7 +34,7 @@
     "test:docs": "node scripts/verificar-docs-vs-codigo.js",
     "test:smoke": "node scripts/smoke-test.js",
     "test:aislamiento": "node scripts/validar-tests-aislamiento.js",
-    "test:all": "npm test && node scripts/validar.js && node scripts/validar-manifest.js && node scripts/verificar-docs-vs-codigo.js",
+    "test:all": "npm test && node scripts/validar.js && node scripts/validar-manifest.js && node scripts/verificar-docs-vs-codigo.js && node scripts/derivar-feature-list.js --check",
     "test:userland": "node scripts/validar-userland-vacio.js",
     "test:release": "npm run test:all && npm run test:userland && npm run test:smoke",
     "doctor": "node scripts/doctor.js",
@@ -47,6 +47,8 @@
     "generate:docs": "node scripts/generar-inventario.js",
     "gen-checklists": "node scripts/generar-checklists-consolidados.js",
     "gen-checklists:check": "node scripts/generar-checklists-consolidados.js --check",
+    "gen:feature-list": "node scripts/derivar-feature-list.js",
+    "gen:feature-list:check": "node scripts/derivar-feature-list.js --check",
     "field-report": "node scripts/field-report.js",
     "configure:branch-protection": "node scripts/configurar-branch-protection.js"
   },

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "swl-ses",
-  "version": "1.6.0",
-  "description": "Sistema de ingenieria de software auto-evolutivo multi-runtime polyglot. 60 agentes, 162 habilidades, 44 comandos, 66 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).",
+  "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/auditorias-documentales-estructurales.md

@@ -0,0 +1,205 @@
+# Regla: Auditorías documentales estructurales en SWL
+
+Esta regla es **OBLIGATORIA** y aplica a todo agente o agente humano que
+ejecute, reporte o consuma resultados de:
+
+- `node scripts/verificar-docs-vs-codigo.js` (verificador docs↔código)
+- `node scripts/verificar-release.js` (gate pre-publish)
+- `npm run test:manifest` (coherencia modulos/hooks)
+- `/swl:claudemd audit` (auditoría de CLAUDE.md)
+- Cualquier comando o script que reporte un veredicto agregado tipo
+  "N/N checks OK" como prueba de calidad documental.
+
+Es la **versión específica al sistema SWL** de la regla global
+`~/.claude/rules/arreglar-al-detectar.md § Aplicación a auditorías`.
+
+---
+
+## Principio
+
+> Una auditoría documental no se declara "limpia" hasta que se ha medido
+> **profundidad**, no solo **presencia**. El verificador automático puede
+> dar verde con docs vacías o infra-documentadas si su métrica es laxa.
+> El agente que reporta resultados al usuario es responsable de distinguir
+> entre **gate formal pasado** y **dominio realmente sano**.
+
+---
+
+## Por qué existe esta regla
+
+Sesión 2026-05-16, post-release v1.6.0: el agente ejecutó dos auditorías
+documentales consecutivas (Opción C release v1.6.0 + auditoría tras
+`/swl:exportar-vault`) y reportó "verde" en ambas. El usuario detectó que:
+
+- `agent-browser` estaba en el sistema desde ADR-0018 (skill + manifest +
+  integración con `investigador-swl` y `web-fetcher-routing`) pero **ausente
+  en `MANUAL_USO.md`**.
+- `ADR-0022` (TUI custom zero-deps, propio del release v1.6.0) **no estaba
+  referenciado** en `MANUAL_USO.md`.
+- 22 de 58 variables `SWL_*` que existen en `hooks/` y `scripts/` **no
+  estaban documentadas** ni en `docs/variables-entorno.md` ni en
+  `MANUAL_USO.md`.
+- El verificador `scripts/verificar-docs-vs-codigo.js` reportaba "9 checks
+  OK" porque sus checks de comandos contaban menciones (presencia), no
+  profundidad. WARN consolidado de comandos infra-documentados se reportaba
+  como "OK".
+
+Las dos auditorías fueron **cosméticas**, no estructurales. El gate verde
+ocultaba 22 variables huérfanas y 19 ADRs no referenciados.
+
+---
+
+## Gates de profundidad obligatorios
+
+### Para comandos `/swl:*`
+
+Un comando se considera **infra-documentado** si en `MANUAL_USO.md`:
+
+- Tiene **menos de 4 menciones** Y
+- Es un comando "no trivial" (excluir `ayuda`, `salud`, `modelo`,
+  `contexto`, `dashboard` que son operacionales simples).
+
+Un comando infra-documentado debe tener al menos:
+
+1. Una sección dedicada con encabezado `### \`/swl:<nombre>\``.
+2. Subsección "**Uso**" con el patrón completo de flags.
+3. Subsección "**¿Qué hace?**" con descripción funcional.
+4. Subsección "**Cuándo usarlo**" con casos de uso.
+5. Al menos un **ejemplo concreto** de invocación con output esperado.
+6. Subsección "**Gotchas**" o "**Troubleshooting**" si el comando tiene
+   dependencias externas (MCP, herramientas opt-in, paths críticos).
+
+### Para variables de entorno `SWL_*`
+
+Cobertura **completa, no muestral**:
+
+- Toda variable `SWL_*` que aparezca en `hooks/` o `scripts/` DEBE estar
+  documentada en `docs/variables-entorno.md` con: nombre, default, qué
+  activa, archivo que la consume.
+- La verificación es objetiva: `grep -rohE 'SWL_[A-Z_]+' hooks/ scripts/ |
+  sort -u` debe ser un **subconjunto** del set de variables documentadas.
+- **Sin excepciones**: variables internas de debug también se documentan
+  (ej. `SWL_DEBUG`, `SWL_SESSION_ID`).
+
+### Para ADRs
+
+- Todo ADR nuevo `.planning/adrs/NNNN-*.md` que cambia comportamiento
+  observable del sistema debe ser **referenciado** en al menos:
+  - `MANUAL_USO.md` en la sección del feature que materializa, Y
+  - `CHANGELOG.md` en la versión que lo introduce.
+- ADRs de proceso interno (deprecaciones, splits internos, refactors
+  ocultos) pueden documentarse solo en `.planning/adrs/README.md`.
+- El criterio de "cambia comportamiento observable" se evalúa: ¿un usuario
+  del sistema percibirá la diferencia? Si sí, debe ir a `MANUAL_USO.md`.
+
+### Para integraciones opt-in (dependencias externas)
+
+Toda dependencia externa opt-in (markitdown, code-review-graph,
+agent-browser, @dbml/core, likec4, etc.) debe documentarse en
+`MANUAL_USO.md § Dependencias externas` con la **estructura mínima**:
+
+1. Marcador obligatorio "**NO es dependencia técnica de swl-ses**"
+   (regla CLAUDE.md sobre dependencias educativas opt-in).
+2. **Qué es** y **por qué existe la integración** (no solo
+   instalación — eso es lo cosmético).
+3. **Beneficio cuantificado** vs alternativas (tokens, espacio,
+   tiempo, etc. — números, no adjetivos).
+4. **Cuándo vale la pena** vs **cuándo NO instalarlo**.
+5. **Cómo lo usa el sistema** internamente (qué agente, qué skill,
+   qué comando lo invoca).
+6. **Comportamiento si NO está instalado** (debe degradar
+   funcionalmente sin fallar — regla `arreglar-al-detectar`).
+7. **Limitaciones conocidas**.
+8. **Origen** (ADR, sesión, paper, repo).
+
+---
+
+## Procedimiento al ejecutar una auditoría documental
+
+### Antes de reportar "verde"
+
+1. **Listar qué mide cada check del verificador** y nombrar
+   explícitamente qué **NO** mide.
+2. **Hacer sondeo manual estructural** sobre 2-3 ítems aleatorios del
+   dominio auditado:
+   - Para comandos: tomar 2-3 al azar, contar menciones en MANUAL_USO,
+     verificar que tengan las 6 subsecciones obligatorias.
+   - Para variables: comparar lista de código (`grep -rohE`) contra
+     lista de docs.
+   - Para ADRs: cruzar `ls .planning/adrs/*.md` contra
+     `grep -oE "ADR-[0-9]+" MANUAL_USO.md`.
+3. **Reportar al usuario el desglose** entre:
+   - Gate formal pasado: "N/N checks OK" (cita textual del verificador).
+   - Drift estructural detectado en sondeo: "X gaps reales encontrados
+     fuera del scope del verificador".
+
+### Patrón de reporte correcto
+
+```
+Verificador docs-vs-código: 9/9 OK formal.
+Sondeo estructural manual:
+  - Comandos infra-documentados (<4 menciones): 3 detectados
+    → /swl:exportar-vault, /swl:nemesis (en COMANDOS.md), /swl:wiki
+  - Variables SWL_* huérfanas: 22 de 58
+  - ADRs nuevos no referenciados en MANUAL_USO: 19 de 22
+
+Conclusión: gate formal pasado, drift estructural REAL detectado.
+Recomendación: cerrar gaps antes de declarar docs sanas.
+```
+
+### Patrón de reporte INCORRECTO (a evitar)
+
+```
+Verificador docs-vs-código: 9/9 OK.
+Docs alineadas con código. ✓
+```
+
+Esta segunda forma es la que el usuario detectó y corrigió en
+sesión 2026-05-16. **No reincidir**.
+
+---
+
+## Anti-patrones específicos del sistema SWL
+
+- **Aceptar "WARN no falla el verificador"**: el check #2 actual
+  reporta WARN sin bloquear cuando comandos no están documentados.
+  Eso es deuda preexistente legítima, pero **NUNCA** se reporta como
+  "OK" al usuario sin enumerar los WARN.
+- **Confiar en el conteo agregado** (`44 comandos /swl:* documentados`)
+  sin verificar la profundidad de cada uno.
+- **No cruzar el universo real**: el verificador chequea `comandos/swl/*.md`
+  contra `MANUAL_USO.md`. Pero NO chequea `MANUAL_USO.md` contra ADRs
+  ni contra variables del código. Esos universos quedan invisibles.
+- **Whitelist hardcodeada en check #3**: solo 7 flags críticas. El
+  parser BOOLEANAS tiene más. Las flags no listadas en la whitelist
+  son drift invisible.
+- **Reportar "✓ skip" como "✓ pass"**: si el TUI no está instalado
+  (pre-v1.6.0), el check #5 reporta éxito. Eso es correcto técnicamente
+  pero el agente NO debe sumarlo al conteo "N/N OK" sin matizar.
+
+---
+
+## Relación con otras reglas
+
+- `~/.claude/rules/arreglar-al-detectar.md § Aplicación a auditorías` —
+  principio general; esta regla lo concreta para SWL.
+- `~/.claude/rules/registro-componentes-nuevos.md` — define el registro
+  obligatorio de componentes en manifiestos. Esta regla extiende:
+  no basta con registrar, hay que documentarlo con profundidad.
+- `~/.claude/rules/verificar-citas-normativas.md § Familia 2` —
+  verificar afirmaciones factuales del verificador antes de aceptar
+  el "verde" como hecho.
+- `habilidades/doc-sync/SKILL.md` — implementación operativa del
+  verificador. Esta regla define qué debe medir.
+
+---
+
+## Origen de esta regla
+
+Sesión 2026-05-16, post-release v1.6.0. Documentado en
+`.planning/adrs/0023-auditorias-documentales-estructurales.md`.
+Promovida tras feedback explícito del usuario:
+*"en esta misma sesión se pidieron dos auditorías que has minimizado o
+ignorado"*. Cierra el gap conceptual donde el agente aplicaba
+`arreglar-al-detectar.md` a bugs durante implementación pero NO a
+verificadores de docs que devuelven verde cosmético.

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").