@saulwade/swl-ses 2.1.0 → 2.2.1

package/agentes/arquitecto-swl.md

@@ -13,11 +13,6 @@ modeloAlterno: claude-sonnet-4-6
 ventanaContexto: 200k
 color: blue
 version: 1.0.1
-evolved: true
-evolved-from: "1.0.0"
-evolved-at: "2026-05-16"
-evolved-by: "aprender"
-evolved-note: "v1.0.1: documentar contrato 'arquitecto NO tiene Write tool — produce contenido textual, el padre lo materializa'. Origen: sesión 2026-05-16 ADR-0021."
 nivelRiesgo: MEDIO
 skillsInvocables: [api-rest-diseno, microservicios, event-driven, cloud-aws, postgresql-experto, extraccion-documentos, diagrama-arquitectura]
 skillsRestringidos: []

package/agentes/backend-python-swl.md

@@ -23,11 +23,6 @@ skillsRestringidos: [angular-moderno, typescript-avanzado, react-native-best-pra
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
-evolved: true
-evolved-from: "5.2.0"
-evolved-at: "2026-04-02"
-evolved-by: "mutación SIGAF"
-evolved-note: "Evolución incorporada desde proyecto SIGAF"
 toolBudget:
   simple: 15
   standard: 30

package/agentes/implementador-swl.md

@@ -20,11 +20,6 @@ skillsRestringidos: [auto-evolucion-protocolo]
 permisosRed: false
 permisosEscritura: true
 permisosComandos: true
-evolved: true
-evolved-from: "5.2.0"
-evolved-at: "2026-04-02"
-evolved-by: "mutación SIGAF"
-evolved-note: "Evolución incorporada desde proyecto SIGAF"
 toolBudget:
   simple: 15
   standard: 30

package/agentes/nemesis-auditor-swl.md

@@ -12,11 +12,6 @@ tools: [Read, Grep, Glob, Bash, Write]
 model: claude-sonnet-4-6
 version: 1.1.1
 nivelRiesgo: MEDIO
-evolved: true
-evolved-from: "1.1.0"
-evolved-at: "2026-05-20"
-evolved-by: "aprender"
-evolved-note: "L-154 SIGM: reforzar exclusión ADR-0021 (no aplicar fixes) + agregar Gate defensivo post-fix (python -c import + compileall + tests) para detectar SyntaxErrors Python 2 que ruff no detecta cuando el agente excepcionalmente aplica fixes"
 skillsInvocables: [feynman-auditor-swl, state-inconsistency-auditor-swl, memoria-busqueda, checklist-seguridad, nemesis-evaluacion-json]
 permisosRed: false
 permisosEscritura: true

package/agentes/orquestador-swl.md

@@ -16,11 +16,6 @@ ventanaContexto: 200k
 permissionMode: plan
 color: white
 version: 1.3.0
-evolved: true
-evolved-from: "1.2.0"
-evolved-at: "2026-06-04"
-evolved-by: "evolucionar"
-evolved-note: "PE-005 sección 5 'Sub-agente background falla con API Error: Usage credits required for 1M context — verificar filesystem antes de re-intentar' + PE-006 sección 6 'Cuándo NO delegar a sub-agentes Opus 4.7 1M context'. Aprobación humana explícita pese a evolvable=false (función sistémica) — patrones de recovery operativos validados en OIC v1.5 2026-06-04 (2 sub-agentes background fallaron al cerrar pero dejaron ~700 LOC en disco)."
 nivelRiesgo: BAJO
 skillsInvocables: [compactacion-contexto, checkpoints-verificacion, aprendizaje-continuo, discutir-fase, ejecutar-fase, planear-fase, nuevo-proyecto, brainstorming, control-profundidad, prevencion-racionalizacion, estructura-proyecto-claude, workflow-claude-code, git-worktrees-paralelo, swl-dashboard, instalar-sistema, mapear-codebase, orquestacion-async, context-builder]
 skillsRestringidos: [fastapi-python, angular-component, angular-forms, postgresql-table-design]

package/agentes/planificador-swl.md

@@ -19,11 +19,6 @@ skillsRestringidos: []
 permisosRed: false
 permisosEscritura: true
 permisosComandos: false
-evolved: true
-evolved-from: "5.2.0"
-evolved-at: "2026-04-02"
-evolved-by: "mutación SIGAF"
-evolved-note: "Evolución incorporada desde proyecto SIGAF; v1.2.0 agrega secciones vivas del ExecPlan (Progreso, Sorpresas, Bitácora de decisiones, Retrospectiva) portadas desde openai-agents-python PLANS.md"
 toolBudget:
   simple: 10
   standard: 20

package/agentes/revisor-codigo-swl.md

@@ -16,11 +16,6 @@ modeloAlterno: claude-haiku-4-5-20251001
 ventanaContexto: 200k
 color: orange
 version: 1.2.2
-evolved: true
-evolved-from: "1.2.1"
-evolved-at: "2026-06-05"
-evolved-by: "evolucionar"
-evolved-note: "+gating por versión de lenguaje antes de marcar sintaxis como SyntaxError CRÍTICO: leer requires-python/target-version/tsconfig/edition y refutar con import+linter del stack (aplicación de verificar-citas Familia 2 a claims de sintaxis). Generalizable a cualquier lenguaje version-dependent. Origen: falso positivo PEP 758 (except A,B: en Python 3.14) en sistema-verificacion-oic."
 nivelRiesgo: BAJO
 skillsInvocables: [checklist-calidad, patrones-python, api-rest-diseno, tdd-workflow, verificar-trabajo, verificacion-evidencia, swl-revisar-impacto, prevencion-sobreingenieria]
 skillsRestringidos: []

package/bin/swl-ses.js

@@ -119,6 +119,26 @@ const COMANDOS = {
   'audit-coverage-frameworks': '../scripts/cli/audit-coverage-frameworks.js',
   'audit-agents-gaps': '../scripts/cli/audit-agents-gaps.js',
   'skill-discovery': '../scripts/cli/skill-discovery.js',
+  'aprobar-plan': '../scripts/cli/aprobar-plan.js',
+  'verificar-plan': '../scripts/cli/verificar-plan.js',
+  'verificar-trazabilidad': '../scripts/cli/verificar-trazabilidad.js',
+  'liberar-fase': '../scripts/cli/liberar-fase.js',
+  'propose-step': '../scripts/cli/propose-step.js',
+  'derivar-feature-list': '../scripts/cli/derivar-feature-list.js',
+  'detectar-host': '../scripts/cli/detectar-host.js',
+  'metricas-dora': '../scripts/cli/metricas-dora.js',
+  'mark-evolved': '../scripts/cli/mark-evolved.js',
+  'near-duplicate': '../scripts/cli/near-duplicate.js',
+  'sugerir-modelo': '../scripts/cli/sugerir-modelo.js',
+  briefing: '../scripts/cli/briefing.js',
+  'execution-state': '../scripts/cli/execution-state.js',
+  'schedule-parse': '../scripts/cli/schedule-parse.js',
+  'gateway-notify': '../scripts/cli/gateway-notify.js',
+  'diary-entry': '../scripts/cli/diary-entry.js',
+  'loop-telemetry': '../scripts/cli/loop-telemetry.js',
+  'configurar-ci': '../scripts/cli/configurar-ci.js',
+  'ciclo-evolucion': '../scripts/cli/ciclo-evolucion.js',
+  notificaciones: '../scripts/cli/notificaciones.js',
 };
 
 // Comandos con subcomandos (nivel 2)
@@ -177,6 +197,49 @@ COMANDOS PRINCIPALES:
                                 Usado por /swl:salud.
   skill-discovery [query]       Descubre y busca skills SWL. Sin query lista todos.
                                 Flag: --rebuild. Usado por /swl:skill-search.
+  aprobar-plan --fase=N         Gate G1: firma el PLAN (SHA256 → lock) y escribe
+                                fase-activa.json (gate G0). Flags: --plan=<ruta>,
+                                --aprobado-por="texto". Usado por /swl:aprobar-plan.
+  verificar-plan --fase=N       Verifica el lock de un PLAN (read-only). Exit 1 si
+                                mutado/sin-firmar. Usado por /swl:ejecutar-fase.
+  verificar-trazabilidad --fase=N  Valida matriz REQ×T→commit→test. Flags:
+                                --solo-plan, --json. Usado por /swl:aprobar-plan.
+  liberar-fase                  Cierra el gate G0 (borra fase-activa.json). Usado
+                                por /swl:ejecutar-fase al terminar.
+  propose-step --rango=A..B     Anexo propositivo del RESUMEN de fase (ADR-0037).
+                                Opt-out SWL_PROPOSE=0. Usado por /swl:ejecutar-fase.
+  derivar-feature-list          Genera .planning/feature-list.json desde HOJA-RUTA.md.
+                                Flag: --check (exit 2 si drift). Usado por /swl:status, briefing.
+  detectar-host                 Indica si el CWD es el repo host de SWL o consumidor.
+                                Flag: --json. Usado por /swl:status.
+  metricas-dora                 Calcula métricas DORA del repo. Flags: --json, --dias=N.
+                                Usado por /swl:status.
+  mark-evolved <ruta>           Marca un componente como evolucionado (frontmatter).
+                                Flags: --from, --by, --note, --rounds, --score.
+                                Usado por /swl:aprender, autoresearch, evolucionar.
+  near-duplicate --texto="..."  Detecta si un aprendizaje es duplicado cercano.
+                                Flags: --archivo, --threshold. Usado por /swl:aprender.
+  sugerir-modelo "<tarea>"      Sugiere modelo (opus/sonnet/haiku) por complejidad.
+                                Usado por /swl:modelo.
+  briefing                      Recolecta señales baratas del briefing. Usado por
+                                /swl:briefing.
+  execution-state               Imprime el resumen de .planning/execution-state.json.
+                                Usado por /swl:checkpoint.
+  schedule-parse "<frase>"      Parsea frase en inglés a expresión cron. Usado por
+                                /swl:cron.
+  gateway-notify --texto="..."  Encola notificación al canal origen del gateway.
+                                Flags: --tipo, --to, --reply-to. Usado por /swl:inbox.
+  diary-entry  (JSON stdin)     Construye y persiste una entrada de diario de sesión.
+                                Usado por /swl:aprender.
+  loop-telemetry <op>           Telemetría de loops: iniciar|registrar|handoff|listar.
+                                Usado por /swl:verificar, autoresearch, status.
+  configurar-ci <op>            Workflows CI/CD: init|status|uninstall (salida JSON).
+                                Usado por /swl:configurar-ci.
+  ciclo-evolucion               Regenera .planning/evolution/metricas.json.
+                                Usado por /swl:status.
+  notificaciones <op>           Telegram: init|status|disable|repair|bot-start|
+                                bot-stop|bot-status|bot-restart|bot-enable-autostart|
+                                bot-disable-autostart. Usado por /swl:notificaciones.
   info    [--target <runtime>]  Muestra información del sistema instalado
   help                          Muestra esta ayuda (alias de --help)
   list    [--target <runtime>]  Lista todos los agentes y skills instalados

package/comandos/swl/adoptar-proyecto.md

@@ -2,11 +2,6 @@
 name: swl:adoptar-proyecto
 description: Incorpora un proyecto existente al sistema SWL. Analiza automáticamente el codebase (stack, arquitectura, dependencias, estado git) y combina los hallazgos con una entrevista corta al usuario para generar los 9 archivos de .planning/ con información real del proyecto — no plantillas vacías.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep", "Agent"]
-evolved: true
-evolved-from: "1.6.8"
-evolved-at: "2026-05-22"
-evolved-by: "aprender"
-evolved-note: "Paso 8 — validación síncrona del auditor tras modificar CLAUDE.md (contrato cruzado con /swl:claudemd)"
 ---
 
 # /swl:adoptar-proyecto — Incorporar un proyecto existente al sistema SWL
@@ -182,15 +177,18 @@ Verificar el estado de `CLAUDE.md` en la raíz del proyecto:
   ```markdown
   ## Reglas obligatorias
 
-  @reglas/usar-sistema-swl.md
+  Aplica la regla global `usar-sistema-swl.md` (matriz operacional del sistema
+  SWL), auto-cargada desde `.claude/rules/`. NO duplicar su contenido aquí.
   ```
-- **Si existe pero NO incluye `@reglas/usar-sistema-swl.md`**: agregar la
-  referencia en una sección "Reglas obligatorias" cerca del inicio del
-  archivo, preservando el contenido existente.
-- **Si existe e incluye la referencia**: no tocar.
+- **Si existe pero NO menciona la regla global `usar-sistema-swl`**: agregar la
+  mención en una sección "Reglas obligatorias" cerca del inicio del archivo,
+  preservando el contenido existente. NUNCA usar `@reglas/usar-sistema-swl.md`
+  — esa ruta no existe en proyectos downstream (las reglas viven en
+  `.claude/rules/`).
+- **Si existe e incluye la mención**: no tocar.
 
-Esta referencia carga la matriz operacional del sistema SWL al inicio de cada
-sesión y es el contrato base de uso del sistema para el proyecto adoptado.
+Esta mención recuerda la matriz operacional del sistema SWL y es el contrato
+base de uso del sistema para el proyecto adoptado.
 
 ### Validación síncrona post-modificación (contrato cruzado con /swl:claudemd)
 
@@ -198,7 +196,7 @@ Tras generar o modificar `CLAUDE.md` en este paso, ejecutar el auditor
 síncrono para verificar que respeta el contrato canónico:
 
 ```bash
-node scripts/auditar-claudemd.js --json
+swl-ses audit-claudemd --json
 # Fallback si el script no está en el proyecto destino:
 npx -y @saulwade/swl-ses@latest audit-claudemd --json
 ```
@@ -230,7 +228,7 @@ Archivos generados:
   ✓ .planning/research/FUNCIONALIDADES.md — inventario de funcionalidades
   ✓ .planning/research/RESUMEN.md       — resumen ejecutivo consolidado
   ✓ .planning/research/TRAMPAS.md       — deuda técnica y anti-patrones
-  ✓ CLAUDE.md                          — creado o actualizado con @reglas/usar-sistema-swl.md
+  ✓ CLAUDE.md                          — creado o actualizado con mención de la regla global usar-sistema-swl
 
 Hallazgos clave:
   1. [hallazgo más importante]

package/comandos/swl/aprender.md

@@ -2,11 +2,6 @@
 name: swl:aprender
 description: Extrae aprendizajes de la sesión de trabajo actual. Analiza patrones de errores, decisiones y soluciones para generar nuevas reglas y habilidades que mejoran el sistema. Actualiza CLAUDE.md del proyecto y propone nuevas habilidades al sistema SWL.
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
-evolved: true
-evolved-from: "1.6.9"
-evolved-at: "2026-05-22"
-evolved-by: "aprender"
-evolved-note: "Paso 6.5 § Protocolo 4.5 — detección de duplicación de reglas globales tras Tipo A (regla sin-duplicacion-reglas-globales.md, v1.7.0)"
 ---
 
 # /swl:aprender — Extracción de aprendizajes y mejora del sistema
@@ -308,19 +303,18 @@ Marcar `evolved` y bumpear la versión interna del componente son **dos operacio
 
 ### Acción 1 — Marcar como evolved
 
+Usar el subcomando del CLI (resuelve cross-scope; ver
+`docs/invocacion-cli-cross-scope.md`):
+
 ```bash
-node -e "
-const { markAsEvolved } = require('./hooks/lib/evolution-tracker');
-const pkg = require('./package.json');
-const r = markAsEvolved('[RUTA_ARCHIVO_MODIFICADO]', {
-  from: pkg.version,
-  by: 'aprender',
-  note: '[tipo de aprendizaje: anti-patrón / mejora de metodología]'
-});
-console.log(r.marked ? 'Marcado como evolucionado' : 'Error: ' + r.error);
-"
+swl-ses mark-evolved "[RUTA_ARCHIVO_MODIFICADO]" \
+  --by=aprender \
+  --note="[tipo de aprendizaje: anti-patrón / mejora de metodología]"
+# fallback: npx -y @saulwade/swl-ses@latest mark-evolved "[RUTA]" --by=aprender --note="..."
 ```
 
+`--from` se infiere del `package.json` del CWD si se omite.
+
 `markAsEvolved` registra automáticamente `evolved-at` con la fecha del día en formato ISO (`YYYY-MM-DD`) — no hay que pasarla manualmente. Escribe en el frontmatter los 5 campos siguientes:
 
 ```yaml
@@ -421,7 +415,7 @@ Solo si en Paso 6 se aplicó al menos un Tipo A:
 1. **Ejecutar el auditor síncrono**:
 
    ```bash
-   node scripts/auditar-claudemd.js --json
+   swl-ses audit-claudemd --json
    ```
 
    Si el script no está disponible en el proyecto destino (instalación
@@ -573,29 +567,24 @@ búsquedas futuras y análisis cross-sesión.
 - Solo se respondieron preguntas técnicas sin tocar código.
 - Sesión < 30min sin commits.
 
-**Cómo generar**:
-
-```js
-const diary = require('./scripts/lib/diary-entry');
-
-let entry = diary.createDiary({
-  sessionId: '<id-de-sesión>',
-  agent: 'orquestador-swl',
-});
-entry = diary.addAccomplishment(entry, '<logro 1>');
-entry = diary.addDecision(entry, '<decisión 1 + razón>');
-entry = diary.addLearning(entry, '<aprendizaje clave 1>');
-entry = diary.addSourceAgent(entry, 'implementador-swl');
-entry = diary.closeDiary(entry);
-
-const fs = require('fs');
-const path = require('path');
-const dir = '.planning/sessions/diary';
-if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-fs.writeFileSync(path.join(dir, `${entry.id}.json`), diary.serializeDiary(entry));
+**Cómo generar** (subcomando del CLI, resuelve cross-scope; ver
+`docs/invocacion-cli-cross-scope.md`). Pasar el contenido como JSON por stdin:
+
+```bash
+echo '{
+  "sessionId": "<id-de-sesión>",
+  "agent": "orquestador-swl",
+  "accomplishments": ["<logro 1>"],
+  "decisions": ["<decisión 1 + razón>"],
+  "learnings": ["<aprendizaje clave 1>"],
+  "sourceAgents": ["implementador-swl"]
+}' | swl-ses diary-entry
+# fallback: ... | npx -y @saulwade/swl-ses@latest diary-entry
 ```
 
-Validar con `validateDiary()` antes de persistir. Reportar en el output:
+El subcomando construye la entrada, valida (`validateDiary`) y la persiste en
+`.planning/sessions/diary/<id>.json`, imprimiendo la ruta escrita. Reportar en
+el output:
 
 ```
 Diary generado: .planning/sessions/diary/diary-YYYYMMDD-HASH.json
@@ -714,16 +703,10 @@ Durante la consolidación (siguiente sección), usar estos niveles para decidir:
 Antes de persistir un aprendizaje nuevo, verificar que no sea duplicado de uno existente:
 
 ```bash
-# Usar fingerprint-id para detectar duplicados exactos o cercanos
-node -e "
-const { isNearDuplicate } = require('./hooks/lib/fingerprint-id');
-const fs = require('fs');
-const aprendizajes = fs.readFileSync('.planning/APRENDIZAJES.md', 'utf8');
-const existentes = aprendizajes.split(/^## /m).filter(Boolean);
-const nuevo = '[TEXTO_DEL_APRENDIZAJE_NUEVO]';
-const r = isNearDuplicate(nuevo, existentes, 0.6);
-console.log(r.nearDuplicate ? 'DUPLICADO (sim=' + r.similarity + ')' : 'ÚNICO');
-"
+# Subcomando del CLI (resuelve cross-scope; ver docs/invocacion-cli-cross-scope.md).
+# Lee APRENDIZAJES.md, divide por '## ' y compara con umbral 0.6 por defecto.
+swl-ses near-duplicate --texto="[TEXTO_DEL_APRENDIZAJE_NUEVO]"
+# fallback: npx -y @saulwade/swl-ses@latest near-duplicate --texto="[TEXTO]"
 ```
 
 Si es duplicado (similitud ≥0.6), fusionar con la entrada existente en vez de crear nueva.

package/comandos/swl/aprobar-plan.md

@@ -15,6 +15,14 @@ a mano (`estado: aprobado`) deja el plan en modo legacy (cláusula de gracia D-0
 se ejecuta con advertencia pero sin protección de integridad. Usar este comando
 es lo que activa el gate real.
 
+> **Invocación cross-scope** (ver `@docs/invocacion-cli-cross-scope.md`): las
+> partes deterministas del gate viven en subcomandos del CLI. Resuélvelos así:
+> si existe `./scripts/cli/<sub>.js` (repo madre) usa `node scripts/cli/<sub>.js`;
+> si `command -v swl-ses` responde usa `swl-ses <sub>`; si no,
+> `npx -y @saulwade/swl-ses@latest <sub>`. Abajo escribo la forma `swl-ses <sub>`
+> como canónica. NUNCA uses `node -e "require('./scripts/lib/...')"` — esa ruta no
+> existe en proyectos downstream.
+
 ## Uso
 
 ```
@@ -37,7 +45,7 @@ Lee el campo `estado:` del frontmatter:
 - Si `estado: borrador` → continúa al Paso 3 (caso normal).
 - Si `estado: aprobado` → ya está aprobado. Verifica si existe el lock:
   ```bash
-  node -e "const {verificarPlan}=require('./scripts/lib/plan-lock'); console.log(JSON.stringify(verificarPlan('.planning/fases/0N-PLAN.md')))"
+  swl-ses verificar-plan --fase=N
   ```
   - Si `modo: "firmado"` → informa "El plan ya está aprobado y firmado." y termina.
   - Si `modo: "legacy"` (aprobado sin lock) → pregunta al usuario: "El plan está
@@ -59,7 +67,7 @@ aceptación. `verificar-trazabilidad.js` reconoce ambos formatos.
   ("CONTEXTO sin REQ-IDs — trazabilidad no exigible, gracia legacy") y continúa.
 - **CONTEXTO con REQ-IDs**: verifica que el PLAN cubra TODOS:
   ```bash
-  node scripts/verificar-trazabilidad.js --fase=N --solo-plan
+  swl-ses verificar-trazabilidad --fase=N --solo-plan
   ```
   - Exit 0 → continúa al Paso 3.
   - Exit 1 (REQ huérfanos) → **RECHAZA la aprobación**. Lista los REQ sin tarea y
@@ -86,41 +94,21 @@ a `/swl:planear-fase N` para refinar.
    edita el frontmatter `estado: borrador` → `estado: aprobado` y agrega
    `aprobadoPor: usuario (<nombre>) — <fecha>, via /swl:aprobar-plan`.
 
-2. **Firmar** — escribe el lock SHA256:
-   ```bash
-   node -e "const {firmarPlan}=require('./scripts/lib/plan-lock'); const r=firmarPlan('.planning/fases/0N-PLAN.md'); console.log(JSON.stringify(r))"
-   ```
-   Verifica que el resultado sea `ok: true` y que exista
-   `.planning/locks/0N-PLAN.md.lock`.
-
-3. **Verificar** la firma de inmediato:
-   ```bash
-   node -e "const {verificarPlan}=require('./scripts/lib/plan-lock'); console.log(JSON.stringify(verificarPlan('.planning/fases/0N-PLAN.md')))"
-   ```
-   Debe retornar `modo: "firmado"`, `ok: true`.
-
-4. **Marcar la fase como activa** (gate G0 — `hooks/spec-gate.js` consume este
-   archivo): escribe `.planning/locks/fase-activa.json` con el sha256 devuelto
-   por `firmarPlan`:
+2. **Firmar y marcar la fase activa** — un solo subcomando hace las tres
+   operaciones deterministas: firma SHA256 → `.planning/locks/0N-PLAN.md.lock`,
+   verifica la firma, y escribe `.planning/locks/fase-activa.json` (gate G0 que
+   consume `hooks/spec-gate.js`):
    ```bash
-   node -e "
-   const {atomicWriteJSON} = require('./hooks/lib/atomic-write');
-   const {verificarPlan} = require('./scripts/lib/plan-lock');
-   const v = verificarPlan('.planning/fases/0N-PLAN.md');
-   atomicWriteJSON('.planning/locks/fase-activa.json', {
-     numero: N,
-     planPath: '.planning/fases/0N-PLAN.md',
-     sha256: v.hashEsperado,
-     aprobadoEn: new Date().toISOString(),
-     aprobadoPor: 'usuario via /swl:aprobar-plan'
-   });
-   console.log('fase activa: 0N');
-   "
+   swl-ses aprobar-plan --fase=N
    ```
-   Este archivo es runtime local (gitignored — a diferencia del `.lock`, que SÍ
-   se versiona como evidencia). `/swl:ejecutar-fase` lo elimina al cerrar la fase.
-   Si se re-firma un plan (re-aprobación tras mutación), re-escribir también
-   fase-activa.json para que el hash quede alineado.
+   Verifica en la salida JSON que `ok: true` y `modo: "firmado"`. Si reporta
+   error de firma, **NO continúes** — revisa el `motivo`.
+
+   El `.lock` SÍ se versiona en git (evidencia de aprobación, parte del audit
+   trail SDD). El `fase-activa.json` es runtime local (gitignored);
+   `/swl:ejecutar-fase` lo elimina al cerrar la fase. Re-ejecutar
+   `swl-ses aprobar-plan --fase=N` tras una re-aprobación (plan mutado) realinea
+   lock y fase-activa automáticamente.
 
 ## Paso 5 — Reporte
 

package/comandos/swl/autoresearch.md

@@ -135,20 +135,15 @@ Resultado: [ÉXITO | PLATEAU | ESTANCAMIENTO | DEGRADACIÓN]
 
 Si el score mejoró respecto al baseline:
 1. Actualizar versión del skill/agente (< 10 pts: PATCH, >= 10 pts: MINOR)
-2. **OBLIGATORIO — Marcar como evolucionado ejecutando este comando Bash**:
+2. **OBLIGATORIO — Marcar como evolucionado** con el subcomando del CLI
+   (resuelve cross-scope; ver `docs/invocacion-cli-cross-scope.md`):
    ```bash
-   node -e "
-   const { markAsEvolved } = require('./hooks/lib/evolution-tracker');
-   const pkg = require('./package.json');
-   const r = markAsEvolved('[RUTA_ARCHIVO_MODIFICADO]', {
-     from: pkg.version,
-     by: 'autoresearch',
-     rounds: [N_ROUNDS],
-     score: '[BASELINE]% → [FINAL]%',
-     note: '[descripción breve de las mutaciones]'
-   });
-   console.log(r.marked ? 'Marcado como evolucionado' : 'Error: ' + r.error);
-   "
+   swl-ses mark-evolved "[RUTA_ARCHIVO_MODIFICADO]" \
+     --by=autoresearch \
+     --rounds=[N_ROUNDS] \
+     --score="[BASELINE]% → [FINAL]%" \
+     --note="[descripción breve de las mutaciones]"
+   # fallback: npx -y @saulwade/swl-ses@latest mark-evolved "[RUTA]" --by=autoresearch ...
    ```
    Reemplazar los placeholders entre corchetes con los valores reales.
    Si el comando Bash no está disponible, agregar manualmente en el frontmatter:
@@ -220,8 +215,11 @@ Si `--dry-run`: terminar aquí mostrando la configuración derivada.
 
 ### Paso C1 — Baseline y telemetría
 
+Subcomando del CLI (resuelve cross-scope; ver `docs/invocacion-cli-cross-scope.md`).
+Imprime el `<dir>` de la corrida:
+
 ```bash
-node -e "const lt=require('./hooks/lib/loop-telemetry');const r=lt.iniciarCorrida({tipo:'autoresearch',direccion:'[direction]',config:{goal:'[goal]',scope:'[scope]',verify:'[verify]',guard:'[guard]'}});console.log(r.dir)"
+swl-ses loop-telemetry iniciar --tipo=autoresearch --direccion=[direction] --config='{"goal":"[goal]","scope":"[scope]","verify":"[verify]","guard":"[guard]"}'
 ```
 
 Correr Verify, extraer la métrica, registrar la iteración 0 (`estado:

package/comandos/swl/briefing.md

@@ -28,12 +28,9 @@ Ejecuta los recolectores de filesystem y presenta el digest sin tope de 5 (aquí
 sí caben todas, no hay presupuesto de latencia de arranque):
 
 ```bash
-node -e "
-const b = require('./hooks/lib/briefing.js');
-const items = b.recolectarTodo(process.cwd(), new Date());
-for (const it of items) console.log('— [' + it.categoria + '] ' + it.titulo + ' → ' + it.accion);
-if (items.length === 0) console.log('(sin señales baratas)');
-"
+# Subcomando del CLI (resuelve cross-scope; ver docs/invocacion-cli-cross-scope.md)
+swl-ses briefing
+# fallback: npx -y @saulwade/swl-ses@latest briefing
 ```
 
 Las 5 categorías: `adr-vencido`, `deuda-trigger`, `nudges-pendientes`,
@@ -78,11 +75,11 @@ commits sin revisión asociada. Si no está disponible → omitir con nota.
 ### 2.4 — Drift de feature-list
 
 ```bash
-node scripts/derivar-feature-list.js --check 2>/dev/null; echo "exit: $?"
+swl-ses derivar-feature-list --check 2>/dev/null; echo "exit: $?"
 ```
 
 Exit 2 → reportar que `HOJA-RUTA.md` y `feature-list.json` divergieron, con la
-acción `node scripts/derivar-feature-list.js` para regenerar.
+acción `swl-ses derivar-feature-list` para regenerar.
 
 ### 2.5 — Deuda con trigger en prosa libre
 

package/comandos/swl/checkpoint.md

@@ -221,24 +221,19 @@ cat .planning/execution-state.json 2>/dev/null || echo "(sin estado de ejecució
 ```
 
 Si existe, actualizar el campo `proximoAgente` con la siguiente tarea pendiente.
-Si no existe y hay un plan en progreso con agentes ejecutados en esta sesión, crear el estado:
+Si no existe y hay un plan en progreso con agentes ejecutados en esta sesión,
+imprimir el resumen estructurado con el subcomando del CLI (resuelve cross-scope;
+ver `docs/invocacion-cli-cross-scope.md`):
 
-```javascript
-// Ejemplo de actualización manual desde el orquestador o skill ejecutar-fase:
-const es = require('./hooks/lib/execution-state');
-
-// Registrar agentes completados en esta sesión
-// es.completarAgente(cwd, 'nombre-agente', 'slice', { resumen: '...' });
-
-// Registrar el próximo agente a ejecutar
-// es.establecerProximo(cwd, 'proximo-agente', 'proximo-slice');
-
-// Ver resumen del estado
-console.log(es.formatearResumen(process.cwd()));
+```bash
+swl-ses execution-state
+# fallback: npx -y @saulwade/swl-ses@latest execution-state
 ```
 
-Incluir el resumen de `formatearResumen()` en el `continue-here.md` generado en el Paso 4,
-bajo la sección "Qué se estaba haciendo".
+Incluir ese resumen en el `continue-here.md` generado en el Paso 4, bajo la
+sección "Qué se estaba haciendo". El registro de agentes
+(`completarAgente`/`establecerProximo`) lo gestiona el skill `ejecutar-fase`
+internamente; aquí solo se lee el resumen.
 
 ## Paso 4 — Creación del continue-here.md
 

package/comandos/swl/claudemd.md

@@ -2,11 +2,6 @@
 name: swl:claudemd
 description: Audita, refactoriza, valida o inicializa archivos CLAUDE.md según best practices Anthropic (ADR-0016). Subcomandos audit (analiza calidad), refactor (sugiere extracciones), check (verifica secciones canónicas), init-user (crea ~/.claude/CLAUDE.md template), init-project (genera CLAUDE.md raíz del proyecto).
 allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
-evolved: true
-evolved-from: "1.6.9"
-evolved-at: "2026-05-22"
-evolved-by: "aprender"
-evolved-note: "Audit dimensión 7 — duplicación de reglas globales (cataloga 6 reglas de ~/.claude/rules/ que NO deben duplicarse inline). Refactor propone reemplazo canónico. Aplica regla nueva sin-duplicacion-reglas-globales.md."
 ---
 
 # /swl:claudemd — Tratamiento profesional de CLAUDE.md
@@ -127,12 +122,15 @@ y genera `./CLAUDE.md` mínimo con:
   ```markdown
   ## Reglas obligatorias
 
-  @reglas/usar-sistema-swl.md
+  Aplica la regla global `usar-sistema-swl.md` (matriz operacional del sistema
+  SWL), auto-cargada desde `.claude/rules/`. NO duplicar su contenido aquí.
   ```
-  Esta referencia es obligatoria — fuerza que el agente cargue la matriz
-  operacional de uso del sistema SWL al inicio de cada sesión. Si el proyecto
-  tiene otras reglas locales (`@reglas/seguridad.md`, `@reglas/arquitectura.md`,
-  etc.), agregarlas debajo.
+  Esta mención es obligatoria — recuerda la matriz operacional de uso del
+  sistema SWL. NO usar `@reglas/usar-sistema-swl.md`: la regla se auto-carga
+  desde `.claude/rules/` y un `@reglas/...` se rompe en proyectos downstream
+  (ahí no existe `reglas/`). Las demás reglas globales (`seguridad.md`,
+  `arquitectura.md`, etc.) también se auto-cargan desde `.claude/rules/` — NO
+  referenciarlas con `@reglas/...`; mencionarlas por nombre si hace falta.
 - Sección **Reglas de máxima prioridad** con sub-sección obligatoria
   **Cuatro principios de implementación (Karpathy)**:
   ```markdown
@@ -150,7 +148,7 @@ y genera `./CLAUDE.md` mínimo con:
 
 Si CLAUDE.md ya existe, **NO lo sobreescribe**. Sugiere correr
 `/swl:claudemd refactor` para mejorar el actual. Si detecta que el CLAUDE.md
-existente NO incluye `@reglas/usar-sistema-swl.md` o NO menciona los cuatro
+existente NO menciona la regla global `usar-sistema-swl` o NO menciona los cuatro
 principios Karpathy (o `prevencion-sobreingenieria`), emitir hallazgo WARN
 recomendando agregarlo manualmente.
 
@@ -160,7 +158,9 @@ Tras `init-project` generar el archivo nuevo, ejecutar inmediatamente
 `audit` sobre el resultado:
 
 ```bash
-node scripts/auditar-claudemd.js --json
+swl-ses audit-claudemd --json
+# Fallback si el script no está en el proyecto destino (instalación global vía npm):
+npx -y @saulwade/swl-ses@latest audit-claudemd --json
 ```
 
 Veredicto esperado: `OK` (el template debe respetar el contrato por