@saulwade/swl-ses 1.5.2 → 1.6.1

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md — @saulwade/swl-ses v1.5.2
+# CLAUDE.md — @saulwade/swl-ses v1.6.1
 
 ## Reglas de máxima prioridad (aplican SIEMPRE, sin excepción)
 
@@ -19,19 +19,7 @@ python scripts/vendor/markitdown/cli.py <ruta-al-archivo>
 El Read tool sigue siendo correcto para `.pdf` (≤20 páginas), `.md`, `.txt` y código fuente. Para más opciones y casos de uso consultar `Skill("swl-markitdown")`.
 
 ### Versión SemVer del próximo release: decisión exclusiva del usuario
-NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHANGELOG el número del próximo release sin autorización explícita del usuario en la conversación actual. El agente puede **recomendar** el bump apropiado según SemVer estricto ("este cambio sugiere MINOR"), pero la **decisión final del número es del usuario**.
-
-Comportamiento correcto:
-- Recomendar: "feature opt-in nuevo sugiere bump MINOR (v1.5.1 → v1.6.0)."
-- Esperar autorización: "¿confirmas el bump?"
-- Aplicar solo lo autorizado: usuario dice "v1.5.2", aplicar v1.5.2.
-
-Comportamiento prohibido:
-- Escribir "v1.6.0" en ADR/CHANGELOG/manifiestos basado en juicio propio del agente.
-- Asumir que SemVer estricto sustituye la autorización del usuario.
-- Sincronizar las 15+ ubicaciones de versión sin que el usuario confirme el número.
-
-Origen: sesión 2026-05-16, ADR-0021. El agente asumió v1.6.0; el usuario eligió v1.5.2 al considerar que el cambio cerraba un bug observado con backward-compat estricta — decisión legítima del usuario que el agente no anticipó. Documentado como aprendizaje HIGH en APRENDIZAJES.md.
+NUNCA asumir, sugerir como hecho consumado, ni escribir en ADRs/manifiestos/CHANGELOG el número del próximo release sin autorización explícita del usuario en la conversación actual. El agente puede **recomendar** el bump apropiado según SemVer estricto, pero la **decisión final del número es del usuario**. Detalle y origen del aprendizaje en `.planning/APRENDIZAJES.md` sesión 2026-05-16 (ADR-0021).
 
 ---
 
@@ -98,7 +86,6 @@ Origen: sesión 2026-05-16, ADR-0021. El agente asumió v1.6.0; el usuario eligi
 - `@COMANDOS.md` — referencia detallada de cada `/swl:*`
 - `@AGENTS.md` — catálogo de agentes con capacidades
 - `@INVENTARIO.md` — conteos oficiales (regenerado por script)
-- `@CONTRIBUTING.md` — guía para colaboradores
 - `@docs/variables-entorno.md` — variables opt-in completas
 - `@docs/CI-CD-SETUP.md` — setup de pipelines
 - `@.planning/adrs/README.md` — índice de decisiones arquitecturales
@@ -108,7 +95,7 @@ Origen: sesión 2026-05-16, ADR-0021. El agente asumió v1.6.0; el usuario eligi
 ## 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), 60 agentes, 162 skills, 44 comandos, 66 reglas, 41 hooks.
+11 lenguajes, 7 runtimes (Claude, OpenClaude, OpenCode, Gemini, Cursor, Codex, Copilot), 60 agentes, 162 skills, 44 comandos, 67 reglas, 41 hooks.
 
 ## Estructura del repositorio
 
@@ -128,23 +115,17 @@ scripts/       bin/            _userland/      .claude/        .planning/
 
 ## Comandos del sistema (/swl:*)
 
-Para la lista completa con descripción ver `@COMANDOS.md`. Comandos más usados:
+Catálogo completo de 44 comandos `/swl:*` en `@COMANDOS.md`. Atajos mentales por categoría:
 
-| Comando | Propósito |
-|---------|-----------|
-| `/swl:nuevo-proyecto` | Iniciar proyecto nuevo desde cero con entrevista |
-| `/swl:adoptar-proyecto` | Incorporar proyecto existente: análisis automático + entrevista corta |
-| `/swl:discutir-fase` / `/swl:planear-fase` / `/swl:ejecutar-fase` / `/swl:verificar` | Ciclo GSD por fase. `discutir-fase` empieza con discovery routing (5 paths: extender / sin-fase / nueva / decomposición / mixto). `ejecutar-fase --iterative` activa modo per-task con review adversarial. `verificar` clasifica claims (TASK/FIX/TEST_OR_BUILD/FEATURE_GO) para evidencia proporcional. |
-| `/swl:checkpoint` / `/swl:compactar` | Anti-context-rot |
-| `/swl:claudemd` | Auditar/refactorizar/inicializar CLAUDE.md (audit, refactor, init-user, check) |
-| `/swl:aprender` / `/swl:evolucionar` / `/swl:autoresearch` | Aprendizaje y auto-evolución |
-| `/swl:salud` / `/swl:metricas` / `/swl:dashboard` | Diagnóstico y observabilidad |
-| `/swl:revisar` / `/swl:verificar` | Calidad de código (revisión por stack, verificación goal-backward). `/swl:verificar --full` activa parallel scorecard con 4 audits paralelos |
-| `/swl:nemesis` | Auditoría iterativa Feynman + State Inconsistency (loop hasta convergencia, ADR-0018). Flags: `--pass1`, `--pass2`, `--continue`, `--modulo <ruta>` |
-| `/swl:release` | Ciclo de release SemVer |
-| `/swl:configurar-ci` | Workflows CI/CD para proyectos del usuario |
-| `/swl:wiki` / `/swl:mapear-codebase` | Conocimiento de proyecto |
-| `/swl:ayuda` | Catálogo interactivo de comandos |
+- **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`.
+- **Calidad**: `revisar`, `verificar`, `nemesis` (auditoría Feynman + State, opcional `--remediar`).
+- **Diagnóstico**: `salud`, `metricas`, `dashboard`, `evolucion-estado`.
+- **Release**: `release`, `configurar-ci`.
+- **Conocimiento**: `wiki`, `mapear-codebase`, `skill-search`, `ayuda`.
+
+Para flags exactos y semántica de cada comando ver `@COMANDOS.md` y `@MANUAL_USO.md`.
 
 ## Reglas obligatorias (25 base + 40 por lenguaje)
 
@@ -164,6 +145,7 @@ proyecto. Reglas de mayor uso:
 | `git-workflow.md` | Siempre |
 | `skills-estandar.md` / `fragmentos-compartidos.md` | Crear/auditar skills o fragmentos |
 | `registro-componentes-nuevos.md` | Crear cualquier componente nuevo (agente/skill/comando/hook/regla) — registro obligatorio en manifiestos + plugin.json + INVENTARIO en mismo commit |
+| `auditorias-documentales-estructurales.md` | Ejecutar verificadores docs/release/manifest — gates de profundidad y cobertura completa (no muestra). Aplica reglas anti-cosméticas a auditorías |
 
 Catálogo completo y matchers en `@INVENTARIO.md` sección Reglas.
 
@@ -189,37 +171,26 @@ NUNCA usar Opus para tareas que Sonnet resuelve igual de bien.
 
 ## Convenciones operacionales
 
-- Score mínimo de calidad: **9.0/10** para aprobar trabajo
-- Modos de desarrollo: `dev`, `review`, `research` (vía `/swl:contexto`)
-- `respositorios-git/` y `temp/` son material de referencia — no modificar ni commitear
-- Inventario completo: ver `@INVENTARIO.md` o `@.planning/ESTADO.md`
-- **Limpieza de registros resueltos**: no dejar items completados en listas de pendientes
-- **Dependencias externas educativas son opt-in NO-dependencia**: cuando se documenta un recurso externo (MCPs opcionales, plantillas comunitarias, indexadores externos) marcarlo explícitamente como **"NO es dependencia técnica de swl-ses"**. El sistema debe seguir funcionando sin ese recurso
-- **Patrón "validar antes de invocar"**: cualquier invocación a herramienta externa opt-in (markitdown, MinerU, gh, etc.) DEBE verificar primero (`command -v <bin>` / `try/catch execSync('<bin> --version')`) y, si no está disponible, **continuar con el flujo nativo de SWL sin emitir error al usuario**
-- **`skillsInvocables` requiere `Skill` en `tools:`**: si un agente declara `skillsInvocables: [...]` Y su cuerpo usa `Skill("nombre")`, debe incluir `Skill` en `tools:`. Verificar con `grep -c 'Skill(' agentes/X.md` >0
-- **Criterio gitignore para JSONL — runtime vs baseline**: runtime telemetry (alta frecuencia, recreable) → gitignore. Baseline auditable (histórico crítico, decisiones, evidencia gobernanza) → trackear. Pregunta filtro: *si borro este archivo, ¿se pierde info que el sistema necesita reconstruir desde otra fuente?* Sí → trackear
-
-## Mapa de propagación de cambios
+Detalle completo en `@docs/convenciones-operacionales.md`. Resumen mínimo:
 
-Al modificar un componente del sistema, verificar TODOS los archivos afectados.
+- **Score mínimo de calidad**: **9.0/10** para aprobar trabajo.
+- **Modos de desarrollo**: `dev`, `review`, `research` (vía `/swl:contexto`).
+- **`respositorios-git/` y `temp/` son material de referencia** — no modificar ni commitear.
+- **Dependencias externas educativas son opt-in NO-dependencia** — el sistema funciona sin ellas.
+- **Patrón "validar antes de invocar"** para herramientas externas opt-in (markitdown, MinerU, gh).
+- **`skillsInvocables` requiere `Skill` en `tools:`** del agente.
 
-| Tipo de cambio | Archivos a verificar |
-|----------------|---------------------|
-| **Agente** | `plugin.json`, `manifiestos/modulos.json`, `INVENTARIO.md`, `AGENTS.md`, `SALUD.md`, `.planning/REPORTE-GRAFO.md` |
-| **Skill** | `plugin.json`, `manifiestos/modulos.json`, `INVENTARIO.md`, `CLAUDE.md` (si aplica al dominio) |
-| **Hook** | `plugin.json`, `.claude/settings.json`, `manifiestos/hooks-config.json` (event+matcher), `manifiestos/modulos.json` (ruta), `INVENTARIO.md`, `SALUD.md`. **AMBOS manifiestos son obligatorios** |
-| **Comando** | `COMANDOS.md`, `CLAUDE.md` (tabla de comandos), `INVENTARIO.md` |
-| **Regla** | `CLAUDE.md` (tabla de reglas), `INVENTARIO.md`, `SALUD.md` |
-| **Schema** | `INVENTARIO.md`, `SALUD.md` |
-| **Bump de versión** | 15+ ubicaciones — checklist en `/swl:release` paso 6 |
-| **CLAUDE.md (cualquier capa)** | Verificar con `/swl:claudemd audit` antes de commit |
-| **Cualquier `npm publish`** | Ejecutar `node scripts/verificar-release.js` ANTES, no solo en release formal. Detecta discrepancias de contadores y versiones invisibles al ojo humano (caso real v1.3.0: 18 discrepancias detectadas) |
+## Mapa de propagación de cambios
 
-Esta tabla es obligatoria. Omitir un archivo causa fallos en `/swl:salud`.
+Al modificar o agregar cualquier componente del sistema, **invocar
+`Skill("doc-sync")` antes del commit final** para cargar el protocolo
+proactivo completo. La tabla y checklist completos viven en
+`@docs/mapa-propagacion.md` para mantener este archivo bajo el umbral
+de 200 líneas (regla `auditar-claudemd.js`).
 
-### Reglas auxiliares
+Resumen mínimo para uso inmediato:
 
-- **Regenerar inventario, nunca contar a mano**: antes de modificar contadores en CLAUDE.md/README.md/SALUD.md/AGENTS.md/package.json/plugin.json, ejecutar `node scripts/generar-inventario.js`. El script es la fuente de verdad
-- **Checklists consolidados se regeneran**: archivos en `docs/checklists-consolidados/` son derivados. Editar la regla origen y `npm run gen-checklists`. NO editar manualmente los generados
-- **Modelo por defecto headless**: scripts/bots externos invocan `claude -p --model claude-haiku-4-5-20251001 --effort low --max-budget-usd 0.50 --dangerously-skip-permissions`. Haiku 4.5 cuesta 5× menos
-- **File-based queue sobre PTY injection**: control remoto via `gateway/command-relay.js` → `.planning/inbox/cmd-*.json` → `/swl:inbox`. Tmux solo opt-in avanzado (`scripts/inbox-tmux-inject.js` Linux/macOS)
+- Cualquier componente nuevo o modificado (agente / skill / comando / hook / regla / schema / variable `SWL_*` / ADR / dependencia opt-in): consultar tabla completa en `@docs/mapa-propagacion.md` para saber qué archivos tocar.
+- **Skill responsable**: `Skill("doc-sync") § Protocolo proactivo` (sub-secciones Tipo 1 a Tipo 8) tiene el detalle prescriptivo.
+- **Antes de commit estructural**: regenerar inventario, validar manifiestos, verificar evolución (si tocó skill/agente), correr verificador docs-vs-código, suite completa, gate de release. Checklist exacto en `@docs/mapa-propagacion.md § Checklist único`.
+- Si cualquier gate falla, **NO commitear** hasta corregir. Regla `arreglar-al-detectar.md` exige resolver en mismo turno.

package/README.md

@@ -1,4 +1,4 @@
-# swl-ses v1.5.2
+# swl-ses v1.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.
 
@@ -6,7 +6,7 @@ Sistema de ingeniería de software auto-evolutivo **multi-runtime** con agentes
 
 Soporta 7 runtimes de IA: Claude Code, OpenClaude, OpenCode y Gemini CLI (soporte completo); Cursor, Codex CLI y GitHub Copilot (soporte parcial — reglas + MCP server o consolidación en archivo de instrucciones según el runtime). Incluye sistema de transformadores que adapta el formato canónico SWL al formato nativo de cada runtime, **multi-target install** (`--target=claude,cursor,codex` en una sola invocación), y **`swl-mcp-server` v1.0.0** con auth opt-in para que Cursor, Codex y otros clientes MCP consulten la memoria SWL (aprendizajes, instintos, sesiones).
 
-Cubre el SDLC completo: discovery, requisitos, arquitectura, UX/UI, frontend, backend, mobile, datos, testing, seguridad, CI/CD, observabilidad, releases, documentación, notificaciones y auto-evolución. Incluye sistema de notificaciones Telegram opt-in (hook saliente, bot bidireccional con 15 comandos, autostart cross-platform) y **auditoría profunda Nemesis** (loop iterativo Feynman + State Inconsistency hasta convergencia) con 8 tools ejecutables JSON-output para code-profiler, pentest-scanner, dep-doctor, bundle-tracker y más (ADR-0018, v1.4.1).
+Cubre el SDLC completo: discovery, requisitos, arquitectura, UX/UI, frontend, backend, mobile, datos, testing, seguridad, CI/CD, observabilidad, releases, documentación, notificaciones y auto-evolución. Incluye sistema de notificaciones Telegram opt-in (hook saliente, bot bidireccional con 15 comandos, autostart cross-platform), **auditoría profunda Nemesis** (loop iterativo Feynman + State Inconsistency hasta convergencia, ahora con loop evaluator-optimizer opt-in vía `/swl:nemesis --remediar` desde v1.5.2 - ADR-0021) con 8 tools ejecutables JSON-output para code-profiler, pentest-scanner, dep-doctor, bundle-tracker y más (ADR-0018, v1.4.1), e **instalador/actualizador TUI custom** zero-deps con paneles, multi-select y barra de progreso por categoría (v1.6.0).
 
 ## Inventario
 
@@ -56,6 +56,23 @@ El setup requiere **dos comandos en orden**, con propósitos distintos:
 > y los hace disponibles en todos tus proyectos. Aun así, cada proyecto necesita su propio `init`
 > para obtener `.planning/` y `_userland/`.
 
+### Modo recomendado: TUI visual (v1.6.0+)
+
+Desde v1.6.0, al ejecutar `install` o `update` sin flags desde una terminal
+interactiva, swl-ses lanza un **TUI custom** con paneles, selectores con
+flechas, multi-select con espacio y barra de progreso por categoría.
+
+```bash
+# Lanza el TUI: Welcome → Menú → Wizard → Progreso → Resumen
+npx -y @saulwade/swl-ses@latest install
+npx -y @saulwade/swl-ses@latest update
+```
+
+Opt-out con `--no-tui` para usar el asistido lineal clásico, o pasa cualquier
+flag (`--target`, `--profile`, `--force`, etc.) y el CLI usa el flujo directo
+sin prompts. Ver [`MANUAL_USO.md`](./MANUAL_USO.md) sección "Opción C — Modo
+TUI visual" para capturas ASCII de cada pantalla.
+
 ### Opción 1: CLI vía npmjs (recomendada)
 
 ```bash
@@ -178,7 +195,7 @@ claude
 | `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: 60 agentes + 162 habilidades + 44 comandos + 66 reglas + 41 hooks |
+| `completo` | Todo: 60 agentes + 162 habilidades + 44 comandos + 67 reglas + 41 hooks |
 
 ### Targets soportados
 

package/agentes/datos-swl.md

@@ -62,7 +62,7 @@ Responsabilidades concretas:
 ANTES de diseñar cualquier pipeline o modelo de datos:
 
 1. Leer CLAUDE.md del proyecto para entender el stack de datos existente.
-2. Invocar `Skill("postgresql-schema-design")` y `Skill("sql-query-optimization")`.
+2. Invocar `Skill("postgresql-experto")` y `Skill("sql-optimizacion")`.
 3. Identificar las fuentes de datos: sistemas origen, formatos, frecuencia de actualización.
 4. Estimar el volumen: filas por tabla, tasa de crecimiento, tamaño en GB/TB.
 5. Verificar qué herramientas de orquestación están disponibles (Airflow, Prefect, dbt, etc.).

package/agentes/frontend-angular-swl.md

@@ -100,13 +100,13 @@ Grep("@if|@for")                        → confirmar uso de block syntax
 
 | Caso de uso | Skills a invocar |
 |-------------|-----------------|
-| Componentes Angular | `Skill("angular-component")` + `Skill("angular-signals")` |
-| Formularios Angular | + `Skill("angular-forms")` |
-| Build / CLI / configuración | + `Skill("angular-tooling")` |
-| Estilos con Tailwind | `Skill("tailwind-design-system")` + `Skill("responsive-design")` |
-| TypeScript complejo | `Skill("typescript-advanced-types")` |
-| Tests Angular | `Skill("javascript-testing-patterns")` |
-| Patrones de diseño UI | `Skill("frontend-design")` + `Skill("frontend-patterns")` |
+| Componentes Angular | `Skill("angular-moderno")` + `Skill("angular-moderno")` |
+| Formularios Angular | + `Skill("angular-moderno")` |
+| Build / CLI / configuración | + `Skill("angular-moderno")` |
+| Estilos con Tailwind | `Skill("tailwind-experto")` + `Skill("diseno-responsivo")` |
+| TypeScript complejo | `Skill("typescript-avanzado")` |
+| Tests Angular | (sin skill dedicado — usar `@angular/core/testing` directo) |
+| Patrones de diseño UI | `Skill("frontend-design")` + `Skill("frontend-avanzado")` |
 
 **REGLA**: Invoca AL MENOS 1 skill antes de implementar. Si la UI-SPEC.md lista
 skills requeridos, invoca TODOS los listados.

package/agentes/frontend-css-swl.md

@@ -90,10 +90,10 @@ Read("src/styles/tokens.css")           → sistema de tokens
 
 | Caso de uso | Skills a invocar |
 |-------------|-----------------|
-| Responsive design | `Skill("responsive-design")` |
-| Design system y tokens | `Skill("tailwind-design-system")` |
-| Patrones de UI/UX | `Skill("frontend-design")` + `Skill("frontend-patterns")` |
-| Accesibilidad visual | `Skill("web-design-guidelines")` |
+| Responsive design | `Skill("diseno-responsivo")` |
+| Design system y tokens | `Skill("tailwind-experto")` |
+| Patrones de UI/UX | `Skill("frontend-design")` + `Skill("frontend-avanzado")` |
+| Accesibilidad visual | `Skill("ux-diseno")` |
 
 ## Arquitectura de @layer — el estándar moderno
 

package/agentes/frontend-react-swl.md

@@ -103,13 +103,13 @@ Grep("useQuery|useSWR|fetch")          → patrones de data fetching en uso
 
 | Caso de uso | Skills a invocar |
 |-------------|-----------------|
-| Componentes React / Next.js | `Skill("vercel-react-best-practices")` |
-| Estilos con Tailwind | `Skill("tailwind-design-system")` + `Skill("responsive-design")` |
-| TypeScript complejo | `Skill("typescript-advanced-types")` |
-| Tests React | `Skill("javascript-testing-patterns")` |
-| React Native | `Skill("react-native-best-practices")` |
-| React Native + Expo | + `Skill("expo-tailwind-setup")` |
-| UX y patrones de diseño | `Skill("frontend-design")` + `Skill("frontend-patterns")` |
+| Componentes React / Next.js | `Skill("nextjs-experto")` |
+| Estilos con Tailwind | `Skill("tailwind-experto")` + `Skill("diseno-responsivo")` |
+| TypeScript complejo | `Skill("typescript-avanzado")` |
+| Tests React | (sin skill dedicado — usar Vitest/Jest + React Testing Library directo) |
+| React Native | `Skill("mobile-react-native")` |
+| React Native + Expo | + `Skill("mobile-react-native")` |
+| UX y patrones de diseño | `Skill("frontend-design")` + `Skill("frontend-avanzado")` |
 
 **REGLA**: Invoca AL MENOS 1 skill antes de implementar. Si la UI-SPEC.md lista
 skills requeridos, invoca TODOS los listados.

package/agentes/frontend-swl.md

@@ -75,15 +75,15 @@ Antes de escribir la primera línea de código, invoca los skills del framework
 
 | Framework | Skills a invocar |
 |-----------|-----------------|
-| Angular | `Skill("angular-component")` + `Skill("angular-signals")` |
-| Angular + formularios | + `Skill("angular-forms")` |
-| Angular + build/CLI | + `Skill("angular-tooling")` |
-| React (Next.js/Vercel) | `Skill("vercel-react-best-practices")` |
-| React Native | `Skill("react-native-best-practices")` |
-| React Native + Expo | + `Skill("expo-tailwind-setup")` |
-| Cualquier framework + estilos | `Skill("tailwind-design-system")` + `Skill("responsive-design")` |
-| TypeScript complejo | `Skill("typescript-advanced-types")` |
-| Tests JS/TS | `Skill("javascript-testing-patterns")` |
+| Angular | `Skill("angular-moderno")` + `Skill("angular-moderno")` |
+| Angular + formularios | + `Skill("angular-moderno")` |
+| Angular + build/CLI | + `Skill("angular-moderno")` |
+| React (Next.js/Vercel) | `Skill("nextjs-experto")` |
+| React Native | `Skill("mobile-react-native")` |
+| React Native + Expo | + `Skill("mobile-react-native")` |
+| Cualquier framework + estilos | `Skill("tailwind-experto")` + `Skill("diseno-responsivo")` |
+| TypeScript complejo | `Skill("typescript-avanzado")` |
+| Tests JS/TS | (sin skill dedicado — usar Vitest/Jest directo) |
 
 **REGLA**: Invoca AL MENOS 1 skill antes de escribir código.
 Si la UI-SPEC.md lista skills requeridos, invoca TODOS los listados.

package/agentes/frontend-tailwind-swl.md

@@ -94,10 +94,10 @@ Read("package.json")                    → versión exacta de Tailwind
 
 | Caso de uso | Skills a invocar |
 |-------------|-----------------|
-| Design system | `Skill("tailwind-design-system")` |
-| Responsive design | `Skill("responsive-design")` |
-| Patrones de UI | `Skill("frontend-design")` + `Skill("frontend-patterns")` |
-| Accesibilidad | `Skill("web-design-guidelines")` |
+| Design system | `Skill("tailwind-experto")` |
+| Responsive design | `Skill("diseno-responsivo")` |
+| Patrones de UI | `Skill("frontend-design")` + `Skill("frontend-avanzado")` |
+| Accesibilidad | `Skill("ux-diseno")` |
 
 **REGLA**: Invoca AL MENOS 1 skill antes de implementar.
 

package/agentes/rendimiento-swl.md

@@ -70,8 +70,8 @@ Responsabilidades concretas:
 ANTES de cualquier optimización:
 
 1. Leer CLAUDE.md del proyecto para entender el stack y las dependencias.
-2. Invocar `Skill("sql-query-optimization")` si hay optimización de queries.
-3. Invocar `Skill("async-python-patterns")` si hay optimización de código async.
+2. Invocar `Skill("sql-optimizacion")` si hay optimización de queries.
+3. Invocar `Skill("async-python")` si hay optimización de código async.
 4. Establecer el contexto del problema: ¿qué es lento?, ¿cuándo empezó?, ¿cuántos usuarios afecta?
 5. Obtener datos de rendimiento actuales (logs, APM, métricas de observabilidad).
 6. Establecer la línea base medible antes de cualquier cambio.

package/bin/swl-ses.js

@@ -190,7 +190,7 @@ GESTIÓN DE COMPONENTES:
   agents remove <nombre>        Remueve un agente individual
 
 OPCIONES DE INSTALL:
-  --target <runtime>     Runtime destino: claude|openclaude|copilot|opencode|codex|gemini (default: claude)
+  --target <runtime>     Runtime destino: claude|openclaude|copilot|opencode|codex|gemini|cursor (default: claude)
   --profile <perfil>     Perfil: core|backend-python|backend-node|frontend-react|frontend-angular|
                          fullstack-python-angular|fullstack-node-react|mobile|devops|completo (default: core)
   --with <componentes>   Incluir componentes adicionales (separados por coma)
@@ -200,10 +200,19 @@ OPCIONES DE INSTALL:
   --dry-run              Mostrar plan sin aplicar cambios
   --force                Sobreescribir archivos existentes sin confirmar
   --all-langs            Instalar reglas de todos los lenguajes (omite detección automática de stack)
+  --with-mcp             Configura el MCP server swl-memory automáticamente (v1.5.0+)
+  --tui                  Fuerza el modo TUI visual aunque pases otros flags (v1.6.0+)
+  --no-tui               Desactiva el TUI; usa el asistido lineal clásico (v1.6.0+)
+  --verbose              Expande el panel de log del Progreso del TUI de 8 a 24 líneas (v1.6.0+)
   --no-claudemd          No modificar el CLAUDE.md del proyecto (solo aplica con --target claude).
                          Por defecto el instalador crea o actualiza un bloque delimitado por
                          <!-- SWL-BEGIN vX.Y.Z --> / <!-- SWL-END --> preservando el resto del archivo.
 
+MODOS DE INVOCACIÓN (v1.6.0+):
+  TTY + sin flags        → TUI visual completo (recomendado)
+  TTY + --no-tui         → Asistido lineal clásico (preguntas en serie)
+  No-TTY o con flags     → Modo directo sin prompts (CI/scripts)
+
 OPCIONES DE SKILLS/AGENTS:
   --skill <nombre>       Nombre del skill a extraer del repo (con skills add)
   --agent <nombre>       Nombre del agente a extraer del repo (con agents add)
@@ -215,11 +224,14 @@ OPCIONES GENERALES:
 
 EJEMPLOS:
   ${NOMBRE} init
-  ${NOMBRE} install                                    (modo asistido — recomendado para primera vez)
+  ${NOMBRE} install                                    (TUI visual — recomendado para primera vez)
+  ${NOMBRE} install --no-tui                           (asistido lineal clásico)
   ${NOMBRE} install --target claude --profile backend-python
   ${NOMBRE} install --target openclaude --profile fullstack-python-angular
   ${NOMBRE} install --target gemini --profile core
   ${NOMBRE} install --target copilot --profile fullstack-node-react
+  ${NOMBRE} update                                     (TUI visual con multi-select de runtimes)
+  ${NOMBRE} update --no-tui                            (preguntas lineales clásicas)
   ${NOMBRE} skills list --target claude
   ${NOMBRE} skills add https://github.com/user/repo --skill mi-skill
   ${NOMBRE} agents add ./path/local --agent mi-agente
@@ -312,14 +324,44 @@ function main() {
 
   const opciones = parsearOpciones(args.slice(1));
 
-  // Modo asistido: `install` sin flags → flujo interactivo
-  // (Si el usuario pasa cualquier flag relevante, se asume que sabe lo que hace.)
-  if (comando === 'install') {
-    const flagsIrrelevantesParaAsistido = ['verbose'];
+  // Modo asistido / TUI: `install` o `update` sin flags relevantes → modo visual.
+  //
+  // Niveles de fallback:
+  //   1. TTY + sin flags (excepto --tui): lanzar TUI completo (scripts/tui/index.js)
+  //   2. TTY + --no-tui: lanzar install-asistido clásico (preguntarOpcion lineal)
+  //   3. No TTY (CI/pipe): flujo clásico con flags por defecto sin asistido
+  //
+  // El usuario puede forzar el TUI incluso con flags pasando --tui.
+  if (comando === 'install' || comando === 'update') {
+    const flagsIrrelevantesParaAsistido = ['verbose', 'tui'];
     const flagsEspecificados = Object.keys(opciones).filter(
       k => k !== '_args' && !flagsIrrelevantesParaAsistido.includes(k)
     );
-    if (flagsEspecificados.length === 0) {
+    const stdinTty = !!process.stdin.isTTY;
+    const optoutTui = opciones['no-tui'] || opciones.no_tui;
+    const forzarTui = opciones.tui;
+    const sinFlags = flagsEspecificados.length === 0;
+
+    if ((sinFlags || forzarTui) && stdinTty && !optoutTui) {
+      try {
+        const { iniciarTui } = require('../scripts/tui');
+        iniciarTui({ operacionInicial: comando }).then(() => {
+          process.exit(0);
+        }).catch(err => {
+          console.error(`Error en TUI: ${err.message}`);
+          if (opciones.verbose) console.error(err.stack);
+          process.exit(1);
+        });
+        return;
+      } catch (err) {
+        console.error(`Error cargando TUI: ${err.message}`);
+        if (opciones.verbose) console.error(err.stack);
+        // Caer al asistido clásico como fallback
+      }
+    }
+
+    if (comando === 'install' && sinFlags && !forzarTui) {
+      // Fallback al asistido lineal (sin TUI) — preserva la UX de versiones previas
       try {
         const asistido = require('../scripts/comandos/install-asistido');
         asistido.main().catch(err => {

package/comandos/swl/brainstorm.md

@@ -1,4 +1,5 @@
 ---
+name: swl:brainstorm
 description: Inicia una sesión de brainstorming estructurado para diseñar una feature o solución
 ---
 

package/comandos/swl/compactar.md

@@ -24,7 +24,7 @@ Este comando es diferente de `/swl:checkpoint`: mientras checkpoint guarda estad
 Skill("compactacion-contexto")
 ```
 
-Si no existe, busca alternativas: `Skill("systematic-debugging")` para razonamiento estructurado. Documenta lo que cargaste.
+Si no existe, busca alternativas en `~/.claude/skills/` (skills oficiales de Anthropic) o procede sin skill auxiliar — el algoritmo de 5 fases es zero-deps. Documenta lo que cargaste o que procediste sin skill.
 
 ## Paso 1 — Auditoría del contexto activo
 

package/comandos/swl/discutir-fase.md

@@ -17,13 +17,27 @@ Eres un analista funcional y técnico experto. Tu trabajo es convertir los objet
 
 El argumento `<n>` es el número de la fase a discutir.
 
+## Discovery routing (5 paths) — primer paso antes del cuestionario
+
+Antes del cuestionario adaptativo completo, el agente clasifica la petición en uno de **5 rutas posibles** y ejecuta solo lo relevante. Origen: ADR-0020 sub-fase 1.
+
+| Ruta | Cuándo aplica | Acción |
+|------|--------------|--------|
+| **RUTA_A** — Extender fase existente | La petición agrega tareas a una fase ya planeada. | Saltar cuestionario; cargar el CONTEXTO.md existente y agregar tareas. |
+| **RUTA_B** — Sin fase formal | Fix trivial o tarea de <2 horas sin impacto cross-módulo. | Saltar cuestionario; proceder con `/swl:ejecutar-fase` directamente. |
+| **RUTA_C** — Nueva fase single-scope | Petición nueva, no encaja en fases existentes, single-domain. | Ejecutar cuestionario completo (Bloques 1-4). |
+| **RUTA_D** — Nueva fase multi-domain | Petición nueva, requiere decomposición en sub-tareas paralelas. | Cuestionario completo + planificación de paralelización. |
+| **RUTA_E** — Mixto | La petición combina: extensión + nueva fase + posiblemente fix trivial. | Presentar decomposición propuesta y confirmar antes de proceder. |
+
+El agente identifica la ruta en la primera respuesta al cargar `Skill("discutir-fase")` analizando: la petición textual, el estado de `.planning/HOJA-RUTA.md` y el último `RESUMEN.md`. Solo si la ruta es C o D se ejecuta el cuestionario completo descrito a continuación.
+
 ## Paso 0 — Carga de habilidades
 
 ```
 Skill("discutir-fase")
 ```
 
-Si no existe, intenta `Skill("planificador")` o `Skill("api-design-principles")`. Documenta qué cargaste.
+Si no existe, intenta `Skill("planear-fase")` o `Skill("api-rest-diseno")`. Documenta qué cargaste.
 
 ## Paso 1 — Lectura de contexto previo
 

package/comandos/swl/mapear-codebase.md

@@ -16,7 +16,7 @@ Carga la habilidad de análisis antes de comenzar:
 Skill("mapear-codebase")
 ```
 
-Si no existe en el proyecto, busca alternativas como `Skill("codebase-mapper")` o `Skill("systematic-debugging")`. Documenta qué habilidad cargaste.
+Si no existe en el proyecto, procede sin skill auxiliar — la lógica de mapeo del comando es zero-deps. Documenta que procediste sin skill.
 
 ## Paso 1 — Verificación del entorno
 

package/comandos/swl/nemesis.md

@@ -247,6 +247,35 @@ Cada `evaluacion.json` sigue el schema `nemesis-evaluacion-json` v1.0.0.
 El costo del modo `--remediar` es 3-5× el del modo solo auditar. Es opt-in
 deliberado del usuario, no default.
 
+### Calibración para módulos pequeños con alta densidad de control de flujo
+
+Aunque la tabla estima 12-18 turnos para `--remediar` sobre módulo pequeño
+(< 500 LOC), el valor agregado es desproporcionadamente alto cuando el
+módulo concentra **lógica de control de flujo** (event handlers,
+callbacks, `setTimeout`/`setInterval`, readline, promises, race conditions).
+La densidad de bugs latentes en este tipo de código es alta, y nemesis los
+detecta donde la revisión one-shot no.
+
+**Patrón confirmado en swl-ses v1.6.0** (sesión 2026-05-16): `--remediar`
+sobre `scripts/lib/ui.js` (~300 LOC con spinner + readline + prompts)
+convergió en iter-2 con 15 turnos totales. Iter-1 detectó dos hallazgos
+adicionales que el fix manual no había detectado:
+
+- **F-1 (ALTO)**: listener leak de `process.once('exit')` acumulándose
+  en loops que crean N spinners secuenciales → MaxListenersExceededWarning.
+- **F-2 (MEDIO)**: `preguntarOpcion` llamaba `_pausarSpinnersActivos()`
+  DESPUÉS del primer `console.log` del menú, dejando una ventana donde
+  el tick del spinner sobrescribía la primera línea.
+
+Iter-2 confirmó PASS tras aplicar ambos fixes. Ninguno habría sido
+detectado por `/swl:revisar` o `revisor-codigo-swl` solos — ambos
+requirieron el reasoning iterativo Feynman+State.
+
+**Regla operativa**: tras commits de fix-only en módulos con alta densidad
+de control de flujo (no en módulos CRUD puros), correr `--remediar`
+acotado al módulo. La inversión de 15 turnos típicamente detecta 1-2
+bugs adyacentes que el fix original no cubrió.
+
 ## Ejemplos de invocación
 
 ```bash

package/comandos/swl/planear-fase.md

@@ -21,10 +21,10 @@ Eres el coordinador de planeación SWL. Tu trabajo es orquestar la generación d
 Skill("planear-fase")
 ```
 
-Si no existe, carga `Skill("python-patterns")` si el stack es Python, o `Skill("angular-component")` si el stack es Angular/TS. Siempre carga también:
+Si no existe, carga `Skill("patrones-python")` si el stack es Python, o `Skill("angular-moderno")` si el stack es Angular/TS. Siempre carga también:
 
 ```
-Skill("api-design-principles")
+Skill("api-rest-diseno")
 ```
 
 ## Paso 1 — Verificación de prerrequisitos

package/comandos/swl/verificar.md

@@ -51,12 +51,12 @@ Skill("verificar-trabajo")
 
 Carga también:
 ```
-Skill("error-handling-patterns")
-Skill("code-review-excellence")
+Skill("manejo-errores")
+Skill("checklist-calidad")
 ```
 
-Si el stack tiene Python: `Skill("python-testing-patterns")`
-Si el stack tiene Angular: `Skill("javascript-testing-patterns")`
+Si el stack tiene Python: `Skill("testing-python")`
+Si el stack tiene Angular: usar `@angular/core/testing` directo (sin skill dedicado)
 
 ## Paso 1 — Determinación del alcance de verificación
 

package/habilidades/aprendizaje-continuo/SKILL.md

@@ -6,7 +6,12 @@ description: >
   tres scopes (proyecto/dominio/global), degradacion automatica por contradiccion,
   promocion a skills/comandos/agentes, evolucion (merge, split, deprecate) y
   proteccion contra contaminacion cross-proyecto.
-version: "1.0.0"
+version: "1.0.1"
+evolved: true
+evolved-from: "1.0.0"
+evolved-at: "2026-05-16"
+evolved-by: "aprender"
+evolved-note: "v1.0.1 (PATCH): nuevo gotcha 'Filtro de exclusión de hooks debe cubrir tests/'. Origen: H3 sesión 2026-05-16 — el extractor de aprendizajes capturaba comentarios JSDoc de un test recién escrito (palabras 'bug', 'patrón', 'fix') y los promovía como entradas truncadas a APRENDIZAJES.md porque PATRONES_ARCHIVO_SWL_EXCLUIDO no incluía tests/."
 herramientasPermitidas: [Read]
 exclusiones:
   - "No cargar para consultar instintos ya cargados en la sesión actual — si el perfil fue leído, re-cargarlo es desperdicio de contexto."
@@ -141,6 +146,7 @@ ver [recursos/referencia-instintos.md](recursos/referencia-instintos.md).
 - **Hooks de observación con exit code != 0 interrumpen la sesión**: el hook `observe-pre.js` lanza una excepción y Claude Code detiene la tarea en curso. Causa: violación de la regla "los hooks de observación NUNCA deben producir exit code != 0". Solución: envolver toda la lógica del hook en `try/catch` y loggear el error al stderr sin propagarlo — la observabilidad nunca debe bloquear el trabajo productivo.
 - **Duplicación de instintos entre `proyecto.yaml` y `APRENDIZAJES.md`**: el mismo anti-patrón existe en ambos canales con información inconsistente. Causa: el instinto se creó manualmente sin verificar si ya había una entrada en APRENDIZAJES.md. Solución: antes de crear un instinto nuevo, ejecutar `memoria-busqueda` para verificar si ya existe en otro canal; si existe, actualizar el canal correcto según `reglas/memoria-consolidada.md`.
 - **Confianza llegando a 0.95 sin revisión humana**: el algoritmo suma 0.1 por evento y el instinto llega a 0.95 sin que nadie lo revise antes de la promoción. Causa: no se aplicó la restricción del último 5% (requiere revisión explícita). Solución: al llegar a 0.90, el sistema debe emitir un checkpoint `human-verify` antes de superar ese umbral — automatizar la vigilancia en `session-end.js`.
+- **Filtro de exclusión de hooks de extracción no cubre `tests/`** [CONFIRMADO 2026-05-16]: el hook `hooks/extraccion-aprendizajes.js` capturaba comentarios JSDoc/docstring de tests recién escritos por el agente y los promovía como entradas truncadas a `APRENDIZAJES.md`. Caso real: al escribir `tests/lib/ui-spinner-prompt.test.js` con un comentario `/** Bug original: cuando un comando arrancaba un spinner y luego (dentro de la lógica...) */`, el hook detectaba la palabra "bug" y promovía una entrada con título cortado a mitad de frase. Causa: `PATRONES_ARCHIVO_SWL_EXCLUIDO` tenía `agentes/`, `habilidades/`, `comandos/swl/`, `hooks/`, `scripts/`, etc., pero **no incluía `tests/`**. Solución: cualquier filtro de exclusión que protege contra ruido auto-referente del agente DEBE incluir explícitamente todos los patrones de tests: `tests/`, `__tests__/`, `spec/`, `*.test.{js,ts,jsx,tsx,mjs,cjs}`, `test_*.py`, `_test.{py,go}`. Los comentarios de un test describen el SUT (System Under Test) — contienen las mismas keywords que un descubrimiento real ("bug", "patrón", "fix") pero NO son descubrimientos. Patrón general: al diseñar un filtro de exclusión para hooks de observación, listar **todas las convenciones de naming de tests del ecosistema target**, no solo los directorios. Verificado en commit `cb4332e` swl-ses v1.6.0.
 
 ## Anti-patrones
 

package/habilidades/diseno-herramientas-agente/SKILL.md

@@ -6,6 +6,7 @@ description: >
   description como prompt engineering, naming MCP y diseno de mensajes de error.
   Cargar cuando se disenan tools para agentes, se configura MCP, se definen
   toolBudget en agentes SWL, o se evalua la coleccion de herramientas de un agente.
+version: "1.0.0"
 herramientasPermitidas: [Read, Grep]
 exclusiones:
   - "No cargar para implementar el hook que ejecuta los tools — este skill diseña la interfaz, no el handler; para implementar PreToolUse o PostToolUse cargar `hooks` o el agente correspondiente."