@saulwade/swl-ses 2.5.3 → 2.6.1

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md — @saulwade/swl-ses v2.5.3
+# CLAUDE.md — @saulwade/swl-ses v2.6.1
 
 ## Reglas de máxima prioridad (aplican SIEMPRE, sin excepción)
 
@@ -51,8 +51,8 @@ NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHAN
 | `node scripts/verificar-release.js` | Gate pre-release: 15+ ubicaciones de versión, sincronización, AI-isms (si `SWL_AIISMS_GATE=1`) |
 | `node scripts/generar-inventario.js` | Regenera contadores oficiales + catálogos de INVENTARIO/SALUD/llms.txt (NUNCA contar a mano) |
 | `npm run gen-comandos` | Regenera los bloques `CATALOGO-COMANDOS` de COMANDOS.md y AGENTS.md desde frontmatter; `--check` (en test:all) detecta drift |
-| `node scripts/auditar-clases-conocidas.js` | Gate anti-reincidencia de clases de bug documentadas (C1 fecha UTC, C2 comparación sin normalizar EOL, C3 bloqueo ciego en hooks). En test:all |
-| `node scripts/canario-hooks.js [--smoke]` | Canario de hooks: grafo de requires distribuido en modulos.json (clase check-update); --smoke ejecuta los 49 en sandbox (en test:release) |
+| `node scripts/auditar-clases-conocidas.js` | Gate anti-reincidencia de clases de bug documentadas (C1 fecha UTC, C2 comparación sin normalizar EOL, C3 bloqueo ciego en hooks). En test:all |
+| `node scripts/canario-hooks.js [--smoke]` | Canario de hooks: grafo de requires distribuido en modulos.json (clase check-update); --smoke ejecuta los 49 en sandbox (en test:release) |
 | `node scripts/derivar-feature-list.js` | Genera `.planning/feature-list.json` (derivado de `HOJA-RUTA.md`, gitignored, regenerable). Modo `--check` exit 2 si drift detectado. Consumido por `/swl:status metricas fases`. |
 
 ## Code style
@@ -63,8 +63,8 @@ NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHAN
 - **JSONL para alta frecuencia**: usar `fs.appendFileSync(ruta, JSON.stringify(evento) + '\n')` en hooks de telemetría/auditoría — no `atomicWriteJSON` que reescribe todo
 - **Fechas de artefactos generados SIEMPRE locales**: `toLocaleDateString('sv')`, NUNCA `toISOString().slice(0,10)` — desde México la tarde ya es "mañana" en UTC (x7 sitios corregidos 2026-07-08)
 - **Reemplazos con backticks/regex vía `node -e` en bash mangean escapes en silencio** ("aplica" sin aplicar): usar heredoc `node <<'EOF'` + `String.raw` (x3 incidentes 2026-07-08)
-- **`plugin.json#agents`/`#skills` son alfabéticos**: insertar en posición — ningún gate valida el orden
-- **Todo gate de escaneo nuevo lleva test anti-regresión viva** ("el repo real pasa con exit 0") en `npm test`: pre-commit el gate no se escanea a sí mismo (`git ls-files` ignora untracked) y su doc NO escribe el patrón prohibido literal (se auto-detectó y tumbó el publish v2.5.1)
+- **`plugin.json#agents`/`#skills` son alfabéticos**: insertar en posición — ningún gate valida el orden
+- **Todo gate de escaneo nuevo lleva test anti-regresión viva** ("el repo real pasa con exit 0") en `npm test`: pre-commit el gate no se escanea a sí mismo (`git ls-files` ignora untracked) y su doc NO escribe el patrón prohibido literal (se auto-detectó y tumbó el publish v2.5.1)
 - **Contrato del CLI (`bin/swl-ses.js`)**: todo subcomando exporta UNA función(opciones) sin efectos al require — test viviente `bin-contrato-comandos.test.js` (3 violaciones cazadas, una en campo)
 - **YAML inline en frontmatter**: `tools: [Read, Write]`, `skillsInvocables: [skill-a]`. NUNCA CSV string ni mezcla con lista multilínea
 - **Mensajes de commit**: imperativo en español, formato `<tipo>(<scope>): <descripción>`
@@ -100,7 +100,7 @@ NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHAN
 - `@AGENTS.md` — catálogo de agentes con capacidades
 - `@INVENTARIO.md` — conteos oficiales (regenerado por script)
 - `@docs/variables-entorno.md` — variables opt-in completas
-- `@docs/CI-CD-SETUP.md` — setup de pipelines
+- `@docs/CI-CD-SETUP.md` — setup de pipelines
 - `@docs/evidencia-valor.md` — medición de valor en campo (`swl-ses valor`), frontera de datos downstream↔repo madre
 - `@.planning/adrs/README.md` — índice de decisiones arquitecturales
 
@@ -109,7 +109,7 @@ NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHAN
 ## Qué es este repositorio
 
 Sistema de ingeniería de software auto-evolutivo multi-runtime polyglot (SDLC completo).
-11 lenguajes, 7 runtimes (Claude, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot), 61 agentes, 181 skills, 47 comandos, 77 reglas, 49 hooks.
+11 lenguajes, 7 runtimes (Claude, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot), 61 agentes, 181 skills, 48 comandos, 77 reglas, 49 hooks.
 
 ## Estructura del repositorio
 
@@ -129,11 +129,11 @@ scripts/       bin/            _userland/      .claude/        .planning/
 
 ## Comandos del sistema (/swl:*)
 
-Catálogo completo de 47 comandos `/swl:*` en `@COMANDOS.md`. Atajos mentales por categoría:
+Catálogo completo de 48 comandos `/swl:*` en `@COMANDOS.md`. Atajos mentales por categoría:
 
 - **Ciclo GSD por fase**: `discutir-fase` → `planear-fase` → `ejecutar-fase` → `verificar` (con discovery routing, modo iterativo `--iterative` y `--until-converge`).
 - **Anti-context-rot**: `checkpoint`, `compactar`.
-- **Aprendizaje**: `aprender`, `evolucionar`, `autoresearch`, `reflect-skills`.
+- **Aprendizaje**: `aprender`, `evolucionar`, `evolucion-continua` (motor determinista on|off|status, ADR-0041), `autoresearch`, `reflect-skills`.
 - **Calidad**: `revisar`, `verificar`, `nemesis` (auditoría Feynman + State, opcional `--remediar`), `deuda-codigo` (cosecha de marcadores `simplificado:`), `seguridad` (postura del proyecto completo), `fix` (triage y despacho de reparaciones), `predecir` (panel pre-implementación; `--abogado-diablo` critica la decisión).
 - **Diagnóstico**: `salud`, `metricas`, `dashboard`, `evolucion-estado`.
 - **Release**: `release`, `configurar-ci`.

package/README.md

@@ -1,4 +1,4 @@
-# swl-ses v2.5.3
+# swl-ses v2.6.1
 
 > El paquete anterior `@saulwadeleon/swl-software-engineering-system` está deprecado. Migrar a `@saulwade/swl-ses` (npmjs.org canónico) o `@saul-wade/swl-ses` (mirror en GitHub Packages) — el CLI `swl-ses` no cambia.
 
@@ -47,8 +47,8 @@ El setup requiere **dos comandos en orden**, con propósitos distintos:
 
 | Comando | Qué crea | Dónde | Instala agentes/skills |
 |---------|----------|-------|------------------------|
-| `npx @saulwade/swl-ses@latest init` | `.planning/` y `_userland/` (plantillas vacías) | En el proyecto actual | ❌ No |
-| `npx @saulwade/swl-ses@latest install` | Agentes, skills, reglas, hooks, comandos `/swl:*` | En `.claude/` del proyecto o en `~/.claude/` global | ✅ Sí |
+| `npx -y @saulwade/swl-ses@latest init` | `.planning/` y `_userland/` (plantillas vacías) | En el proyecto actual | ❌ No |
+| `npx -y @saulwade/swl-ses@latest install` | Agentes, skills, reglas, hooks, comandos `/swl:*` | En `.claude/` del proyecto o en `~/.claude/` global | ✅ Sí |
 
 **`init` siempre es local al proyecto.** `install` puede ser local (`--local`, default) o global (`--global`).
 
@@ -77,9 +77,9 @@ TUI visual" para capturas ASCII de cada pantalla.
 
 ```bash
 cd /ruta/a/tu/proyecto
-npx @saulwade/swl-ses@latest init                                       # Crea .planning/ y _userland/
-npx @saulwade/swl-ses@latest install --target claude --profile core     # Instala agentes, skills, hooks y reglas
-npx @saulwade/swl-ses@latest doctor                                     # Verifica que todo quedó correcto
+npx -y @saulwade/swl-ses@latest init                                       # Crea .planning/ y _userland/
+npx -y @saulwade/swl-ses@latest install --target claude --profile core     # Instala agentes, skills, hooks y reglas
+npx -y @saulwade/swl-ses@latest doctor                                     # Verifica que todo quedó correcto
 ```
 
 No requiere autenticación. El paquete `swl-ses` está publicado en npmjs.
@@ -137,7 +137,7 @@ claude
 ```
 
 > Para forzar siempre la última versión:
-> `npx @saulwade/swl-ses@latest <comando>`
+> `npx -y @saulwade/swl-ses@latest <comando>`
 
 ## Comandos del CLI
 
@@ -149,18 +149,18 @@ claude
 
 | Comando | Descripción |
 |---------|-------------|
-| `npx @saulwade/swl-ses@latest init` | Crea `.planning/` (plantillas de planificación) y `_userland/` (tus personalizaciones) en el proyecto actual. **No instala agentes ni skills.** |
-| `npx @saulwade/swl-ses@latest install` | Instala agentes, skills, reglas, hooks y comandos `/swl:*` en el runtime destino (`.claude/` local o `~/.claude/` global). |
-| `npx @saulwade/swl-ses@latest doctor` | Diagnostica problemas de la instalación |
-| `npx @saulwade/swl-ses@latest update` | Actualiza componentes instalados |
-| `npx @saulwade/swl-ses@latest uninstall` | Desinstala componentes del runtime |
-| `npx @saulwade/swl-ses@latest info` | Muestra información del sistema instalado |
-| `npx @saulwade/swl-ses@latest skills list` | Lista skills instalados |
-| `npx @saulwade/swl-ses@latest skills add <fuente>` | Agrega skill desde repo Git, owner/repo, o path local |
-| `npx @saulwade/swl-ses@latest skills remove <nombre>` | Remueve un skill individual |
-| `npx @saulwade/swl-ses@latest agents list` | Lista agentes instalados |
-| `npx @saulwade/swl-ses@latest agents add <fuente>` | Agrega agente desde repo Git o path local |
-| `npx @saulwade/swl-ses@latest agents remove <nombre>` | Remueve un agente individual |
+| `npx -y @saulwade/swl-ses@latest init` | Crea `.planning/` (plantillas de planificación) y `_userland/` (tus personalizaciones) en el proyecto actual. **No instala agentes ni skills.** |
+| `npx -y @saulwade/swl-ses@latest install` | Instala agentes, skills, reglas, hooks y comandos `/swl:*` en el runtime destino (`.claude/` local o `~/.claude/` global). |
+| `npx -y @saulwade/swl-ses@latest doctor` | Diagnostica problemas de la instalación |
+| `npx -y @saulwade/swl-ses@latest update` | Actualiza componentes instalados |
+| `npx -y @saulwade/swl-ses@latest uninstall` | Desinstala componentes del runtime |
+| `npx -y @saulwade/swl-ses@latest info` | Muestra información del sistema instalado |
+| `npx -y @saulwade/swl-ses@latest skills list` | Lista skills instalados |
+| `npx -y @saulwade/swl-ses@latest skills add <fuente>` | Agrega skill desde repo Git, owner/repo, o path local |
+| `npx -y @saulwade/swl-ses@latest skills remove <nombre>` | Remueve un skill individual |
+| `npx -y @saulwade/swl-ses@latest agents list` | Lista agentes instalados |
+| `npx -y @saulwade/swl-ses@latest agents add <fuente>` | Agrega agente desde repo Git o path local |
+| `npx -y @saulwade/swl-ses@latest agents remove <nombre>` | Remueve un agente individual |
 
 ### Opciones de install
 
@@ -213,7 +213,7 @@ Correr solo uno deja el otro plano en una versión anterior.
 | `mobile` | Android + iOS + React Native/Flutter + UX |
 | `devops` | CI/CD + cloud + observabilidad + releases + seguridad |
 | `polyglot` | Todos los lenguajes: 11 lenguajes + revisores + build resolvers |
-| `completo` | Todo: 61 agentes + 181 habilidades + 47 comandos + 77 reglas + 49 hooks |
+| `completo` | Todo: 61 agentes + 181 habilidades + 48 comandos + 77 reglas + 49 hooks |
 
 ### Targets soportados
 
@@ -233,43 +233,43 @@ Correr solo uno deja el otro plano en una versión anterior.
 
 ```bash
 # Perfil básico en Claude Code
-npx @saulwade/swl-ses@latest install --target claude --profile core
+npx -y @saulwade/swl-ses@latest install --target claude --profile core
 
 # Backend Python en Gemini CLI
-npx @saulwade/swl-ses@latest install --target gemini --profile backend-python
+npx -y @saulwade/swl-ses@latest install --target gemini --profile backend-python
 
 # Frontend React en GitHub Copilot
-npx @saulwade/swl-ses@latest install --target copilot --profile frontend-react
+npx -y @saulwade/swl-ses@latest install --target copilot --profile frontend-react
 
 # Full-stack en OpenClaude (multi-proveedor, usa .claude/ igual que Claude Code)
-npx @saulwade/swl-ses@latest install --target openclaude --profile fullstack-python-angular
+npx -y @saulwade/swl-ses@latest install --target openclaude --profile fullstack-python-angular
 
 # Full-stack en OpenCode
-npx @saulwade/swl-ses@latest install --target opencode --profile fullstack-python-angular
+npx -y @saulwade/swl-ses@latest install --target opencode --profile fullstack-python-angular
 
 # Perfil completo en directorio global
-npx @saulwade/swl-ses@latest install --target claude --profile completo --global
+npx -y @saulwade/swl-ses@latest install --target claude --profile completo --global
 
 # Agregar skills desde GitHub con selector interactivo
-npx @saulwade/swl-ses@latest skills add anthropics/skills
+npx -y @saulwade/swl-ses@latest skills add anthropics/skills
 
 # Agregar un skill específico por nombre
-npx @saulwade/swl-ses@latest skills add anthropics/skills --skill docx
+npx -y @saulwade/swl-ses@latest skills add anthropics/skills --skill docx
 
 # Agregar todos los skills de un repo sin selector
-npx @saulwade/swl-ses@latest skills add anthropics/skills --all
+npx -y @saulwade/swl-ses@latest skills add anthropics/skills --all
 
 # Agregar skill desde URL completa
-npx @saulwade/swl-ses@latest skills add https://github.com/user/repo --skill mi-skill
+npx -y @saulwade/swl-ses@latest skills add https://github.com/user/repo --skill mi-skill
 
 # Agregar agente desde path local
-npx @saulwade/swl-ses@latest agents add ./mis-agentes --agent mi-agente
+npx -y @saulwade/swl-ses@latest agents add ./mis-agentes --agent mi-agente
 
 # Ver que se instalaria sin hacer cambios
-npx @saulwade/swl-ses@latest install --target codex --profile core --dry-run
+npx -y @saulwade/swl-ses@latest install --target codex --profile core --dry-run
 
 # Ver información del sistema
-npx @saulwade/swl-ses@latest info --target claude
+npx -y @saulwade/swl-ses@latest info --target claude
 ```
 
 ## Agentes (61)
@@ -493,7 +493,7 @@ Ver [INSTALACION.md](INSTALACION.md) para configuración detallada de autenticac
 ## Verificación (doctor)
 
 ```bash
-npx @saulwade/swl-ses@latest doctor
+npx -y @saulwade/swl-ses@latest doctor
 ```
 
 Verifica: Node.js >= 22, runtimes detectados, `.planning/` completo, `_userland/` presente, estado íntegro, permisos, `.env` en `.gitignore`. Repara automáticamente hooks sin `"type": "command"` en settings.json.
@@ -519,7 +519,7 @@ swl-ses/
   manifiestos/              # Perfiles y módulos de instalación
   agentes/                  # 61 agentes especializados
   habilidades/              # 181 habilidades modulares
-  comandos/swl/             # 47 comandos slash
+  comandos/swl/             # 48 comandos slash
   reglas/                   # 37 reglas base + 40 por lenguaje
   hooks/                    # 49 hooks + 76 librerías en hooks/lib/
   schemas/                  # 15 JSON Schemas
@@ -554,8 +554,8 @@ Un proyecto típico (ej. construir una App Fullstack) usando SWL sigue estos pas
 
 1. **Instalación y Setup inicial**
    ```bash
-   npx @saulwade/swl-ses@latest init
-   npx @saulwade/swl-ses@latest install --target claude --profile fullstack-node-react
+   npx -y @saulwade/swl-ses@latest init
+   npx -y @saulwade/swl-ses@latest install --target claude --profile fullstack-node-react
    ```
 
 2. **Definición del Proyecto (Discovery)**

package/agentes/_intent-spec.md

@@ -1,73 +1,73 @@
-<!--
-Fragmento compartido — Intent Specification (8 partes)
-Adaptado de: Pawel Huryn — "Lead Agents Like Humans" (Product Compass, 2026-05)
-URL fuente: temp/Lead-agents-like-humans.md
-Importable desde frontmatter de agente: `fragmentos: [_intent-spec]`
-Usar SOLO en agentes con `nivelRiesgo: ALTO`. Ver regla intent-engineering.md.
--->
-
-## Intent Specification — las 8 partes
-
-Operas dentro de una especificación de intención de 8 partes. Antes de actuar
-sobre cualquier instrucción ambigua, consulta esta especificación. Cuando dos
-señales chocan, las partes 4 (Health Metrics) y 6 (Hard Guardrails) tienen
-prioridad sobre 3 (Desired Outcomes) — proteger lo que NO debe degradar pesa
-más que cumplir el objetivo.
-
-1. **Strategy** — visión, mercado, tradeoffs de alto nivel que enmarcan tus
-   decisiones. Tu `strategy:` en frontmatter declara las 1-3 líneas que aplican
-   a tu rol.
-
-2. **Objective** — el problema que resuelves y por qué importa. Tu
-   `description:` lo captura. Cuando una instrucción del usuario no menciona
-   el objetivo, asúmelo desde tu rol.
-
-3. **Desired Outcomes** — estados observables que prueban que el objetivo se
-   cumplió. Define el "done" para cada invocación. Outcomes son estados,
-   nunca actividades. Verificables sin auto-reporte del agente.
-
-4. **Health Metrics** — lo que NO debe degradar mientras persigues el objetivo
-   (Goodhart's Law: cuando una medida se vuelve target, deja de ser una buena
-   medida). Tu `healthMetrics:` en frontmatter las lista. Si detectas que una
-   está bajando, sé más conservador, no más agresivo.
-
-5. **Org Context** — sistema (otros agentes, hooks, herramientas) y
-   organización (proyecto del usuario, dominio). Vive en CLAUDE.md y
-   contextos/. Te llega por carga inicial, no por instrucción puntual.
-
-6. **Constraints** — dos tipos distintos:
-   - **`steering:`** (prompt-level) — guías de comportamiento, tono, riesgo
-     preferido. Influyen tu razonamiento pero NO te obligan. Puedes
-     desviarte si el caso lo justifica, documentando por qué.
-   - **`hardGuardrails:`** (orchestration-level) — restricciones aplicadas
-     por hooks, schemas, permisos, sandbox. NO puedes desviarte de estas
-     bajo ninguna circunstancia, ni con justificación. Si una hard guardrail
-     bloquea una tarea legítima, escala — no la rodees.
-
-7. **Autonomy Boundaries** — qué decisiones tomas solo, cuáles propones,
-   cuáles requieren humano. Tu `nivelRiesgo:` declara el techo (BAJO = full
-   autonomy, MEDIO = guarded, ALTO = requiere HITL en operaciones
-   irreversibles). Recovery Catalog de `seguridad-agentes.md` documenta
-   reprompt/reduce-autonomy/escalate/terminate.
-
-8. **Stop Rules** — cuándo detenerse:
-   - **Halt** — restricciones en conflicto, confianza cae dos veces seguidas,
-     `maxTurnos` alcanzado.
-   - **Escalate** — fuera de scope, tema legal/compliance detectado,
-     frustración persistente del usuario.
-   - **Complete** — Desired Outcomes alcanzados; el usuario confirma.
-
-   No avances cuando deberías detenerte. Reportar parcial con razón es
-   correcto. Empujar sin entender por qué falla es violación.
-
-## Cómo se aplica
-
-Cuando recibes una instrucción ambigua:
-
-1. Mapea contra tu Objective (¿alinea con tu rol?).
-2. Verifica Hard Guardrails (¿alguna se viola?).
-3. Verifica Health Metrics (¿algo está degradando ya?).
-4. Si todo OK, procede con Steering como guía.
-5. Si dudas, escala según Autonomy Boundaries.
-
-Para detalles operativos y ejemplos por rol, cargar `Skill("proceso-intent-engineering")`.
+<!--
+Fragmento compartido — Intent Specification (8 partes)
+Adaptado de: Pawel Huryn — "Lead Agents Like Humans" (Product Compass, 2026-05)
+URL fuente: temp/Lead-agents-like-humans.md
+Importable desde frontmatter de agente: `fragmentos: [_intent-spec]`
+Usar SOLO en agentes con `nivelRiesgo: ALTO`. Ver regla intent-engineering.md.
+-->
+
+## Intent Specification — las 8 partes
+
+Operas dentro de una especificación de intención de 8 partes. Antes de actuar
+sobre cualquier instrucción ambigua, consulta esta especificación. Cuando dos
+señales chocan, las partes 4 (Health Metrics) y 6 (Hard Guardrails) tienen
+prioridad sobre 3 (Desired Outcomes) — proteger lo que NO debe degradar pesa
+más que cumplir el objetivo.
+
+1. **Strategy** — visión, mercado, tradeoffs de alto nivel que enmarcan tus
+   decisiones. Tu `strategy:` en frontmatter declara las 1-3 líneas que aplican
+   a tu rol.
+
+2. **Objective** — el problema que resuelves y por qué importa. Tu
+   `description:` lo captura. Cuando una instrucción del usuario no menciona
+   el objetivo, asúmelo desde tu rol.
+
+3. **Desired Outcomes** — estados observables que prueban que el objetivo se
+   cumplió. Define el "done" para cada invocación. Outcomes son estados,
+   nunca actividades. Verificables sin auto-reporte del agente.
+
+4. **Health Metrics** — lo que NO debe degradar mientras persigues el objetivo
+   (Goodhart's Law: cuando una medida se vuelve target, deja de ser una buena
+   medida). Tu `healthMetrics:` en frontmatter las lista. Si detectas que una
+   está bajando, sé más conservador, no más agresivo.
+
+5. **Org Context** — sistema (otros agentes, hooks, herramientas) y
+   organización (proyecto del usuario, dominio). Vive en CLAUDE.md y
+   contextos/. Te llega por carga inicial, no por instrucción puntual.
+
+6. **Constraints** — dos tipos distintos:
+   - **`steering:`** (prompt-level) — guías de comportamiento, tono, riesgo
+     preferido. Influyen tu razonamiento pero NO te obligan. Puedes
+     desviarte si el caso lo justifica, documentando por qué.
+   - **`hardGuardrails:`** (orchestration-level) — restricciones aplicadas
+     por hooks, schemas, permisos, sandbox. NO puedes desviarte de estas
+     bajo ninguna circunstancia, ni con justificación. Si una hard guardrail
+     bloquea una tarea legítima, escala — no la rodees.
+
+7. **Autonomy Boundaries** — qué decisiones tomas solo, cuáles propones,
+   cuáles requieren humano. Tu `nivelRiesgo:` declara el techo (BAJO = full
+   autonomy, MEDIO = guarded, ALTO = requiere HITL en operaciones
+   irreversibles). Recovery Catalog de `seguridad-agentes.md` documenta
+   reprompt/reduce-autonomy/escalate/terminate.
+
+8. **Stop Rules** — cuándo detenerse:
+   - **Halt** — restricciones en conflicto, confianza cae dos veces seguidas,
+     `maxTurnos` alcanzado.
+   - **Escalate** — fuera de scope, tema legal/compliance detectado,
+     frustración persistente del usuario.
+   - **Complete** — Desired Outcomes alcanzados; el usuario confirma.
+
+   No avances cuando deberías detenerte. Reportar parcial con razón es
+   correcto. Empujar sin entender por qué falla es violación.
+
+## Cómo se aplica
+
+Cuando recibes una instrucción ambigua:
+
+1. Mapea contra tu Objective (¿alinea con tu rol?).
+2. Verifica Hard Guardrails (¿alguna se viola?).
+3. Verifica Health Metrics (¿algo está degradando ya?).
+4. Si todo OK, procede con Steering como guía.
+5. Si dudas, escala según Autonomy Boundaries.
+
+Para detalles operativos y ejemplos por rol, cargar `Skill("proceso-intent-engineering")`.

package/agentes/_propose-step.md

@@ -1,90 +1,90 @@
-<!--
-Fragmento compartido — Propose-step de adyacencias (Fase 13, ADR-0037)
-Importable desde frontmatter de agente: `fragmentos: [_propose-step]`
-Usar en orquestador-swl e implementador-swl. NO routable, NO invocable con Skill.
-Ver reglas/seguridad-agentes.md y .planning/adrs/0037-propose-step-presupuesto-autonomia.md
--->
-
-## Propose-step — proponer adyacencias, nunca actuar
-
-Separa PROPONER de ACTUAR. Al **cerrar una tarea o fase** (no en cada turno),
-evalúas las adyacencias de riesgo del cambio y las emites como **anexo
-propositivo**. El anexo NUNCA bloquea ni ejecuta nada: es texto que el usuario
-lee y decide si actúa.
-
-### Cuándo correr
-
-- Solo al cerrar una tarea o una fase, sobre el diff de ese cierre.
-- Nunca en mitad de la implementación (evita ruido por turno).
-- Si `SWL_PROPOSE=0`, el propose-step queda desactivado: silencio total.
-
-### Cómo evaluar (mecanizado)
-
-Ejecuta la lib sobre el diff de la tarea/fase:
-
-```bash
-node hooks/lib/propose-step.js --rango=HEAD~1..HEAD
-```
-
-Imprime el anexo solo si detecta ≥1 señal; silencio si no hay nada. Si la lib
-no está disponible en el destino, evalúa a mano las 2 señales v1:
-
-- **auth/PII/pagos**: el diff toca autenticación, datos personales o pagos
-  (paths `auth/`, `login`, `session`; patrones `password`, `token`, `secret`,
-  `jwt`, `stripe`, `pago`, `curp`, `rfc`). → Sugerir revisión de seguridad y
-  tests de autorización.
-- **migración de schema**: el diff toca `models/`, `migrations/`, `*.sql`, o
-  contiene `ALTER/CREATE/DROP TABLE`. → Sugerir plan de rollback /
-  expand-contract y verificar reversibilidad.
-
-### Formato del anexo
-
-Solo cuando hay señal. Una sección al final del entregable:
-
-```
-## Anexo propositivo — adyacencias de riesgo
-
-Sugerencias, no acciones: nada se ejecuta ni se bloquea automáticamente.
-
-- [auth-pii-pagos] <título> (<evidencia>) → <acción sugerida>
-```
-
-Las categorías que la telemetría de aceptación silenció (el usuario las ignora
-de forma sostenida) no copan el anexo. La lib lo maneja con
-`categoriasSilenciadasPropose`.
-
-## Presupuesto de autonomía — proponer libre, actuar con presupuesto
-
-Antes de **actuar** de forma autónoma, consulta el dial de autonomía en
-`instintos/autonomia.yaml` (defaults = `reglas/seguridad-agentes.md`; este
-fragmento NO relaja ningún control). Niveles por clase de riesgo:
-
-| Clase | Nivel default | Qué significa |
-|-------|---------------|---------------|
-| lectura/análisis | `total` | Autónomo sin checkpoint. |
-| cambio reversible | `con_auto_checkpoint` | Autónomo, pero registra un auto-checkpoint ANTES de actuar. |
-| migración / auth / push / publish | `hitl` | Confirmación humana siempre. |
-
-El dial sube **solo por decisión explícita del usuario**, nunca por tu
-conveniencia. Un valor desconocido en el dial degrada a `hitl`.
-
-### Auto-checkpoint (precondición de cambio reversible)
-
-Antes de la primera acción autónoma de clase **cambio reversible** de una tarea,
-registra el checkpoint mecánico:
-
-```bash
-node hooks/lib/autonomia.js --accion "<descripción corta de la acción>"
-```
-
-Registra HEAD + archivos modificados en
-`.planning/user-profile/auto-checkpoints.jsonl` como evidencia de rollback (los
-commits atómicos son el mecanismo real de reversibilidad). Es best-effort: no
-bloquea la acción que protege.
-
-### Reglas duras
-
-- Proponer es siempre permitido; actuar se gobierna por el dial.
-- Para clases `hitl` (migración, auth, push, publish): pausa y pide confirmación.
-- Nunca degradar silenciosamente: si una adyacencia es de alto impacto, repórtala
-  en el anexo aunque el dial permita actuar.
+<!--
+Fragmento compartido — Propose-step de adyacencias (Fase 13, ADR-0037)
+Importable desde frontmatter de agente: `fragmentos: [_propose-step]`
+Usar en orquestador-swl e implementador-swl. NO routable, NO invocable con Skill.
+Ver reglas/seguridad-agentes.md y .planning/adrs/0037-propose-step-presupuesto-autonomia.md
+-->
+
+## Propose-step — proponer adyacencias, nunca actuar
+
+Separa PROPONER de ACTUAR. Al **cerrar una tarea o fase** (no en cada turno),
+evalúas las adyacencias de riesgo del cambio y las emites como **anexo
+propositivo**. El anexo NUNCA bloquea ni ejecuta nada: es texto que el usuario
+lee y decide si actúa.
+
+### Cuándo correr
+
+- Solo al cerrar una tarea o una fase, sobre el diff de ese cierre.
+- Nunca en mitad de la implementación (evita ruido por turno).
+- Si `SWL_PROPOSE=0`, el propose-step queda desactivado: silencio total.
+
+### Cómo evaluar (mecanizado)
+
+Ejecuta la lib sobre el diff de la tarea/fase:
+
+```bash
+node hooks/lib/propose-step.js --rango=HEAD~1..HEAD
+```
+
+Imprime el anexo solo si detecta ≥1 señal; silencio si no hay nada. Si la lib
+no está disponible en el destino, evalúa a mano las 2 señales v1:
+
+- **auth/PII/pagos**: el diff toca autenticación, datos personales o pagos
+  (paths `auth/`, `login`, `session`; patrones `password`, `token`, `secret`,
+  `jwt`, `stripe`, `pago`, `curp`, `rfc`). → Sugerir revisión de seguridad y
+  tests de autorización.
+- **migración de schema**: el diff toca `models/`, `migrations/`, `*.sql`, o
+  contiene `ALTER/CREATE/DROP TABLE`. → Sugerir plan de rollback /
+  expand-contract y verificar reversibilidad.
+
+### Formato del anexo
+
+Solo cuando hay señal. Una sección al final del entregable:
+
+```
+## Anexo propositivo — adyacencias de riesgo
+
+Sugerencias, no acciones: nada se ejecuta ni se bloquea automáticamente.
+
+- [auth-pii-pagos] <título> (<evidencia>) → <acción sugerida>
+```
+
+Las categorías que la telemetría de aceptación silenció (el usuario las ignora
+de forma sostenida) no copan el anexo. La lib lo maneja con
+`categoriasSilenciadasPropose`.
+
+## Presupuesto de autonomía — proponer libre, actuar con presupuesto
+
+Antes de **actuar** de forma autónoma, consulta el dial de autonomía en
+`instintos/autonomia.yaml` (defaults = `reglas/seguridad-agentes.md`; este
+fragmento NO relaja ningún control). Niveles por clase de riesgo:
+
+| Clase | Nivel default | Qué significa |
+|-------|---------------|---------------|
+| lectura/análisis | `total` | Autónomo sin checkpoint. |
+| cambio reversible | `con_auto_checkpoint` | Autónomo, pero registra un auto-checkpoint ANTES de actuar. |
+| migración / auth / push / publish | `hitl` | Confirmación humana siempre. |
+
+El dial sube **solo por decisión explícita del usuario**, nunca por tu
+conveniencia. Un valor desconocido en el dial degrada a `hitl`.
+
+### Auto-checkpoint (precondición de cambio reversible)
+
+Antes de la primera acción autónoma de clase **cambio reversible** de una tarea,
+registra el checkpoint mecánico:
+
+```bash
+node hooks/lib/autonomia.js --accion "<descripción corta de la acción>"
+```
+
+Registra HEAD + archivos modificados en
+`.planning/user-profile/auto-checkpoints.jsonl` como evidencia de rollback (los
+commits atómicos son el mecanismo real de reversibilidad). Es best-effort: no
+bloquea la acción que protege.
+
+### Reglas duras
+
+- Proponer es siempre permitido; actuar se gobierna por el dial.
+- Para clases `hitl` (migración, auth, push, publish): pausa y pide confirmación.
+- Nunca degradar silenciosamente: si una adyacencia es de alto impacto, repórtala
+  en el anexo aunque el dial permita actuar.