@saulwade/swl-ses 1.9.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/CLAUDE.md +8 -8
  2. package/README.md +12 -12
  3. package/agentes/accesibilidad-wcag-swl.md +3 -3
  4. package/agentes/auto-evolucion-swl.md +908 -908
  5. package/agentes/disenador-ui-swl.md +6 -5
  6. package/agentes/frontend-angular-swl.md +2 -2
  7. package/agentes/frontend-css-swl.md +2 -2
  8. package/agentes/frontend-react-swl.md +4 -4
  9. package/agentes/frontend-swl.md +6 -6
  10. package/agentes/investigador-ux-swl.md +5 -5
  11. package/agentes/orquestador-swl.md +7 -7
  12. package/agentes/perfilador-usuario-swl.md +308 -308
  13. package/agentes/producto-prd-swl.md +1 -1
  14. package/agentes/red-team-swl.md +218 -218
  15. package/agentes/tdd-qa-swl.md +17 -1
  16. package/comandos/swl/actualizar.md +1 -1
  17. package/comandos/swl/aprender.md +2 -2
  18. package/comandos/swl/aprobar-plan.md +152 -0
  19. package/comandos/swl/ayuda.md +3 -3
  20. package/comandos/swl/discutir-fase.md +20 -2
  21. package/comandos/swl/ejecutar-fase.md +53 -6
  22. package/comandos/swl/evolucionar.md +1 -1
  23. package/comandos/swl/inbox.md +1 -1
  24. package/comandos/swl/instalar.md +1 -1
  25. package/comandos/swl/nemesis.md +1 -1
  26. package/comandos/swl/planear-fase.md +17 -1
  27. package/comandos/swl/plugins.md +1 -1
  28. package/comandos/swl/release.md +1 -1
  29. package/comandos/swl/status.md +279 -0
  30. package/comandos/swl/verificar.md +26 -1
  31. package/habilidades/ai-runtime-security/SKILL.md +1 -1
  32. package/habilidades/auto-evolucion-protocolo/SKILL.md +276 -276
  33. package/habilidades/benchmark-memoria/SKILL.md +1 -1
  34. package/habilidades/calidad-contract-testing/SKILL.md +165 -0
  35. package/habilidades/changelog-generator/SKILL.md +9 -2
  36. package/habilidades/changelog-generator/scripts/parse-commits.js +11 -1
  37. package/habilidades/diagrama-arquitectura/SKILL.md +1 -1
  38. package/habilidades/drift-detection/SKILL.md +179 -179
  39. package/habilidades/ejecutar-fase/SKILL.md +64 -14
  40. package/habilidades/estructura-proyecto-claude/SKILL.md +17 -14
  41. package/habilidades/estructura-proyecto-claude/recursos/configuracion-y-extensiones.md +34 -23
  42. package/habilidades/estructura-proyecto-claude/recursos/frontmatter-y-hooks-referencia.md +70 -53
  43. package/habilidades/estructura-proyecto-claude/recursos/mcp-json-template.json +57 -77
  44. package/habilidades/extractor-de-aprendizajes/SKILL.md +9 -5
  45. package/habilidades/harness-claude-code/SKILL.md +10 -7
  46. package/{reglas/harness-claude-code.md → habilidades/harness-claude-code/recursos/disciplina-harness-regla.md} +2 -2
  47. package/habilidades/instalar-sistema/SKILL.md +3 -3
  48. package/habilidades/meta-skills-estandar/recursos/frameworks-seguridad.md +1 -1
  49. package/habilidades/perfil-usuario/SKILL.md +200 -200
  50. package/habilidades/planear-fase/SKILL.md +25 -4
  51. package/habilidades/proceso-ddia-fundamentos/SKILL.md +1 -1
  52. package/habilidades/proceso-ddia-streaming/SKILL.md +4 -4
  53. package/habilidades/proceso-debate-adversarial/SKILL.md +2 -2
  54. package/habilidades/protocolo-revision-swl/SKILL.md +1 -1
  55. package/habilidades/seguridad-skills-ia/SKILL.md +1 -1
  56. package/habilidades/swl-claudemd/SKILL.md +50 -210
  57. package/habilidades/swl-claudemd/recursos/contrato-aprender.md +83 -0
  58. package/habilidades/swl-claudemd/recursos/duplicacion-reglas-globales.md +85 -0
  59. package/habilidades/swl-claudemd/recursos/plantillas-init.md +94 -0
  60. package/habilidades/swl-dashboard/SKILL.md +9 -9
  61. package/habilidades/swl-revisar-impacto/SKILL.md +1 -1
  62. package/habilidades/tdd-workflow/SKILL.md +45 -5
  63. package/habilidades/validacion-ci-sistema/SKILL.md +3 -3
  64. package/hooks/calidad-pre-commit.js +340 -3
  65. package/hooks/ciclo-evolucion-subagente.js +26 -0
  66. package/hooks/ciclo-evolucion.js +26 -0
  67. package/hooks/extraccion-aprendizajes.js +13 -0
  68. package/hooks/lib/ciclo-evolucion.js +47 -0
  69. package/hooks/{auto-evolucion.js → lib/etapa-auto-evolucion.js} +701 -700
  70. package/hooks/{metricas-evolucion.js → lib/etapa-metricas.js} +388 -376
  71. package/hooks/{actualizar-perfil-usuario.js → lib/etapa-perfil-usuario.js} +376 -364
  72. package/hooks/lib/evolution-tracker.js +24 -3
  73. package/hooks/spec-gate.js +211 -0
  74. package/hooks/tdd-gate.js +241 -0
  75. package/hooks/validar-intent-spec.js +30 -10
  76. package/llms.txt +6 -6
  77. package/manifiestos/hooks-config.json +26 -17
  78. package/manifiestos/modulos.json +17 -14
  79. package/manifiestos/skills-lock.json +63 -56
  80. package/package.json +2 -2
  81. package/plugin.json +6 -10
  82. package/reglas/accesibilidad.md +10 -0
  83. package/reglas/api-diseno.md +9 -0
  84. package/reglas/auditorias-documentales-estructurales.md +7 -0
  85. package/reglas/cloud-infra.md +8 -0
  86. package/reglas/fragmentos-compartidos.md +5 -0
  87. package/reglas/gobernanza.md +4 -4
  88. package/reglas/hooks.md +6 -0
  89. package/reglas/intent-engineering.md +4 -0
  90. package/reglas/markitdown.md +8 -0
  91. package/reglas/memoria-consolidada.md +1 -1
  92. package/reglas/patrones.md +6 -0
  93. package/reglas/registro-componentes-nuevos.md +10 -1
  94. package/reglas/seguridad-agentes.md +1 -1
  95. package/reglas/skills-estandar.md +6 -0
  96. package/reglas/testing.md +7 -0
  97. package/reglas/tests-cleanup.md +4 -0
  98. package/reglas/usar-sistema-swl.md +1 -1
  99. package/scripts/lib/gitignore-manifest.js +29 -1
  100. package/scripts/lib/plan-lock.js +275 -0
  101. package/scripts/migrar-fase-dominio.js +0 -1
  102. package/scripts/verificar-trazabilidad.js +292 -0
  103. package/agentes/ux-disenador-swl.md +0 -503
  104. package/comandos/swl/dashboard.md +0 -146
  105. package/comandos/swl/evolucion-estado.md +0 -191
  106. package/comandos/swl/metricas.md +0 -376
  107. package/comandos/swl/salud.md +0 -481
  108. package/reglas/verificar-citas-temporales.md +0 -139
@@ -1,77 +1,57 @@
1
- {
2
- "_comentario": "Template de .mcp.json para proyectos Claude-ready. Eliminar los servidores que no se usen. Las variables de entorno con valor vacío deben completarse en .env o exportarse antes de correr claude.",
3
- "_instrucciones": [
4
- "1. Copiar este archivo a la raíz del proyecto como .mcp.json",
5
- "2. Eliminar el bloque _comentario y _instrucciones (no son JSON válido en producción)",
6
- "3. Configurar las variables de entorno requeridas por cada servidor activo",
7
- "4. Agregar .mcp.json al repositorio (no contiene secretos — los secretos van en env vars)",
8
- "5. Agregar a .gitignore cualquier archivo .mcp.local.json con credenciales"
9
- ],
10
- "mcpServers": {
11
- "context7": {
12
- "_descripcion": "Documentación actualizada de librerías. Uso: 'use context7' en el prompt.",
13
- "command": "npx",
14
- "args": ["-y", "@upstash/context7-mcp@latest"]
15
- },
16
- "github": {
17
- "_descripcion": "Acceso a GitHub: issues, PRs, repos, commits. Requiere token con permisos repo.",
18
- "command": "npx",
19
- "args": ["-y", "@modelcontextprotocol/server-github"],
20
- "env": {
21
- "GITHUB_PERSONAL_ACCESS_TOKEN": ""
22
- }
23
- },
24
- "filesystem": {
25
- "_descripcion": "Acceso a sistema de archivos fuera del directorio de trabajo. Usar con cuidado.",
26
- "_activar": "Descomentar solo si se necesita acceso a paths fuera del proyecto",
27
- "command": "npx",
28
- "args": [
29
- "-y",
30
- "@modelcontextprotocol/server-filesystem",
31
- "/ruta/al/directorio/permitido"
32
- ]
33
- },
34
- "postgres": {
35
- "_descripcion": "Acceso de solo lectura a PostgreSQL. Útil para explorar esquemas y datos.",
36
- "_activar": "Descomentar si el proyecto usa PostgreSQL y se requiere introspección de BD",
37
- "command": "npx",
38
- "args": ["-y", "@modelcontextprotocol/server-postgres"],
39
- "env": {
40
- "POSTGRES_CONNECTION_STRING": "postgresql://usuario:password@localhost:5432/nombre_bd"
41
- }
42
- },
43
- "sqlite": {
44
- "_descripcion": "Acceso a base de datos SQLite. Alternativa ligera a postgres para proyectos pequeños.",
45
- "_activar": "Descomentar si el proyecto usa SQLite",
46
- "command": "npx",
47
- "args": ["-y", "@modelcontextprotocol/server-sqlite", "--db-path", "./data.db"]
48
- },
49
- "brave-search": {
50
- "_descripcion": "Búsqueda web con Brave Search API. Útil para investigación técnica durante desarrollo.",
51
- "_activar": "Requiere API key de Brave Search (plan gratuito disponible)",
52
- "command": "npx",
53
- "args": ["-y", "@modelcontextprotocol/server-brave-search"],
54
- "env": {
55
- "BRAVE_API_KEY": ""
56
- }
57
- },
58
- "memory": {
59
- "_descripcion": "Memoria persistente entre sesiones. Almacena entidades y relaciones en grafo.",
60
- "_activar": "Útil para proyectos largos donde se quiere persistir contexto entre sesiones",
61
- "command": "npx",
62
- "args": ["-y", "@modelcontextprotocol/server-memory"]
63
- },
64
- "puppeteer": {
65
- "_descripcion": "Control de navegador. Útil para testing E2E, scraping o automatización web.",
66
- "_activar": "Requiere Chrome/Chromium instalado",
67
- "command": "npx",
68
- "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
69
- },
70
- "sequential-thinking": {
71
- "_descripcion": "Herramienta de razonamiento estructurado para problemas complejos.",
72
- "_activar": "Útil para arquitectura, debugging complejo, decisiones de diseño",
73
- "command": "npx",
74
- "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
75
- }
76
- }
77
- }
1
+ {
2
+ "_comentario": "Template de .mcp.json para proyectos Claude-ready. Eliminar los servidores que no se usen. Las variables de entorno con valor vacío deben completarse en .env o exportarse antes de correr claude.",
3
+ "_instrucciones": [
4
+ "1. Copiar este archivo a la raíz del proyecto como .mcp.json",
5
+ "2. Eliminar el bloque _comentario y _instrucciones (no son JSON válido en producción)",
6
+ "3. Configurar las variables de entorno requeridas por cada servidor activo",
7
+ "4. Agregar .mcp.json al repositorio (no contiene secretos — los secretos van en env vars)",
8
+ "5. Agregar a .gitignore cualquier archivo .mcp.local.json con credenciales"
9
+ ],
10
+ "_nota_archivados": "Los reference servers @modelcontextprotocol/server-github, server-postgres, server-sqlite, server-brave-search y server-puppeteer fueron ARCHIVADOS por el proyecto MCP. No usarlos en proyectos nuevos — los reemplazos vigentes están abajo (GitHub remoto oficial, Playwright oficial de Microsoft).",
11
+ "mcpServers": {
12
+ "context7": {
13
+ "_descripcion": "Documentación actualizada de librerías. Uso: 'use context7' en el prompt.",
14
+ "command": "npx",
15
+ "args": ["-y", "@upstash/context7-mcp@latest"]
16
+ },
17
+ "github": {
18
+ "_descripcion": "GitHub MCP server oficial (remoto): issues, PRs, repos, commits. Reemplaza al archivado @modelcontextprotocol/server-github. Autenticación OAuth al conectar, o PAT vía header.",
19
+ "type": "http",
20
+ "url": "https://api.githubcopilot.com/mcp/"
21
+ },
22
+ "playwright": {
23
+ "_descripcion": "Control de navegador con Playwright (oficial de Microsoft). Testing E2E, scraping, automatización web. Reemplaza al archivado server-puppeteer.",
24
+ "_activar": "Requiere Node 18+ — descarga browsers en el primer uso",
25
+ "command": "npx",
26
+ "args": ["-y", "@playwright/mcp@latest"]
27
+ },
28
+ "filesystem": {
29
+ "_descripcion": "Acceso a sistema de archivos fuera del directorio de trabajo. Usar con cuidado.",
30
+ "_activar": "Descomentar solo si se necesita acceso a paths fuera del proyecto",
31
+ "command": "npx",
32
+ "args": [
33
+ "-y",
34
+ "@modelcontextprotocol/server-filesystem",
35
+ "/ruta/al/directorio/permitido"
36
+ ]
37
+ },
38
+ "fetch": {
39
+ "_descripcion": "Extracción y conversión de contenido web a markdown.",
40
+ "_activar": "Útil cuando WebFetch nativo no basta (contenido que requiere conversión estructurada)",
41
+ "command": "npx",
42
+ "args": ["-y", "@modelcontextprotocol/server-fetch"]
43
+ },
44
+ "memory": {
45
+ "_descripcion": "Memoria persistente entre sesiones. Almacena entidades y relaciones en grafo.",
46
+ "_activar": "Útil para proyectos largos donde se quiere persistir contexto entre sesiones",
47
+ "command": "npx",
48
+ "args": ["-y", "@modelcontextprotocol/server-memory"]
49
+ },
50
+ "sequential-thinking": {
51
+ "_descripcion": "Herramienta de razonamiento estructurado para problemas complejos.",
52
+ "_activar": "Útil para arquitectura, debugging complejo, decisiones de diseño",
53
+ "command": "npx",
54
+ "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
55
+ }
56
+ }
57
+ }
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: extractor-de-aprendizajes
3
3
  description: Convertir errores y patrones descubiertos durante la implementación en nuevas habilidades o reglas. Ciclo de mejora continua del sistema SWL.
4
- version: "1.0.5"
4
+ version: "1.0.6"
5
5
  herramientasPermitidas: [Read]
6
6
  exclusiones:
7
7
  - "No cargar para actualizar el perfil del usuario — las correcciones explícitas del usuario van a `instintos/perfil-usuario.yaml` vía `perfilador-usuario-swl`, no a APRENDIZAJES.md."
@@ -10,10 +10,10 @@ exclusiones:
10
10
  - "No cargar si el aprendizaje no tiene causa raíz identificada — documentar síntoma sin causa produce reglas que no previenen el error real."
11
11
  evolvable: true # default para skill estandar
12
12
  evolved: true
13
- evolved-from: "1.0.4"
14
- evolved-at: "2026-05-12"
13
+ evolved-from: "1.0.5"
14
+ evolved-at: "2026-06-11"
15
15
  evolved-by: "aprender"
16
- evolved-note: "Backport L-140 SIGM: extender gotcha sub-agentes a Modo C (revisor-codigo-swl reporta ubicaciones incorrectas y severidades subestimadas); CONFIRMADO x4 x5"
16
+ evolved-note: "Modo D del gotcha sub-agentes (CONFIRMADO x5 x6): agentes de documentación (claude-code-guide) emiten veredictos NO-SOPORTADO por inferencia del contexto local sin consultar la doc oficial; exigir cita a doc consultada en el turno. Precedente 2026-05-15 (runtimes Cursor/Codex)"
17
17
  ---
18
18
  # Extractor de Aprendizajes
19
19
 
@@ -296,7 +296,7 @@ Durante `/swl:aprender`, aplicar estas reglas:
296
296
  - **`rating: HIGH` asignado sin verificar criterio de irreversibilidad**: el agente promueve a CLAUDE.md un aprendizaje "MEDIUM" por el entusiasmo del momento. Causa: no se aplicó el criterio de "decisión irreversible o bug crítico". Solución: antes de asignar HIGH, verificar: ¿cambiar esto en el futuro requeriría refactorizar múltiples archivos o migrar datos? Si no, mantener MEDIUM.
297
297
  - **Regla incompleta sobre registro de hooks**: una entrada en memoria dice "registrar en modulos.json" pero omite `hooks-config.json`, y en la siguiente iteración se repite el fallo en CI porque ambos manifiestos son obligatorios. Causa: la regla de la lección anterior no cubrió todos los manifiestos afectados. Solución: al documentar una regla sobre registro en manifiestos, listar EXPLÍCITAMENTE cada manifiesto con su responsabilidad distinta (`modulos.json` = qué copiar; `hooks-config.json` = cómo registrar evento). Evidencia: tres incidentes históricos del mismo patrón incompleto (v5.7.1, v5.7.2/3, v5.11.0).
298
298
  - **Inventario estimado a mano en vez de regenerar**: el agente cuenta "28 hooks" visualmente y propaga la cifra a 5 archivos (CLAUDE/README/package/plugin/SALUD); al regenerar con `scripts/generar-inventario.js` el número real es 30. Causa: confiar en la observación directa en vez de la fuente de verdad determinista. Solución: antes de modificar cualquier contador en documentación oficial, ejecutar el script de inventario y usar su salida como ground truth.
299
- - **Sub-agentes (Explore + revisores) reportan afirmaciones factuales no verificadas sobre el código** [CONFIRMADO x5]: aplica a `Explore`, `revisor-codigo-swl`, `revisor-seguridad-swl`, `investigador-swl`, `planificador-swl`, y en general a cualquier sub-agente que reporte hallazgos sobre código del proyecto destino. **Tres modos de falla observados**:
299
+ - **Sub-agentes (Explore + revisores + agentes de documentación) reportan afirmaciones factuales no verificadas** [CONFIRMADO x6]: aplica a `Explore`, `revisor-codigo-swl`, `revisor-seguridad-swl`, `investigador-swl`, `planificador-swl`, `claude-code-guide`, y en general a cualquier sub-agente que reporte hallazgos sobre código o capacidades de herramientas. **Cuatro modos de falla observados**:
300
300
 
301
301
  **Modo A — papers académicos** (sesión 2026-04-25): sub-agente Explore propuso 50h+ para implementar SPRT + Lyapunov + compositionality theorem del paper Bhardwaj 2026; costo real validado fue ~5h (solo Drift Score + Recovery Catalog). Causa: el Explore evalúa portabilidad técnica sin aplicar filtro de "datos disponibles" ni "infraestructura zero-deps". Evidencia: 3 papers analizados (evolver, Bhardwaj 2026, Zhang et al. 2026) con descarte sistemático ~70-90% del contenido propuesto.
302
302
 
@@ -304,6 +304,8 @@ Durante `/swl:aprender`, aplicar estas reglas:
304
304
 
305
305
  **Modo C — revisores reportan ubicaciones y severidades incorrectas en código del proyecto** (sesión 2026-05-12 SIGM): `revisor-codigo-swl` ejecutado en `/swl:verificar --until-converge` reportó dos errores factuales: (1) **ubicación incorrecta**: "deferred import en `caja/router.py:545`" cuando la línea real estaba en `caja/service.py:545` — el archivo `caja/router.py` solo tiene 157 líneas (`wc -l caja/router.py = 157`); (2) **severidad subestimada**: reportó "mismatch `CobroConsolidadoResponse` en pantalla de éxito" como MAYOR, mi auditoría manual descubrió que `CobroConsolidadoRequest` también estaba completamente desalineado (más grave, debería ser CRÍTICO bloqueante) — el revisor solo miró el Response. Causa: el revisor analiza código sin re-verificar el path/línea/extensión reportada cuando produce el reporte; sub-agentes basados en LLM hallucinan números de línea con frecuencia ≥15% en archivos grandes.
306
306
 
307
+ **Modo D — agentes de documentación responden por inferencia del contexto local sin consultar la fuente oficial** (sesión 2026-06-11 swl-ses Fase 09; precedente 2026-05-15 con runtimes Cursor/Codex): `claude-code-guide` emitió veredicto categórico "Claude Code NO soporta carga condicional por `paths:` en rules; el frontmatter sería inerte" basándose en que la config local del usuario no usaba ese campo (declinó el WebFetch a docs). Un WebFetch directo a `code.claude.com/docs/en/memory` demostró lo contrario: `paths:` es feature nativa documentada con sintaxis exacta, brace expansion y soporte user-level. Aceptar el veredicto habría descartado un slice completo de la fase. Causa: "ausencia de evidencia en el contexto local" tratada como "evidencia de ausencia en el producto" — mismo patrón del precedente 2026-05-15 ("Cursor no soporta hooks" — falso). Las features recientes nunca aparecen en configs existentes precisamente por ser recientes.
308
+
307
309
  **Solución unificada — protocolo de verificación de afirmaciones factuales antes de aceptar propuesta de CUALQUIER sub-agente**:
308
310
 
309
311
  *Patrón obligatorio aplicable a TODOS los modos*: extraer 2-3 afirmaciones factuales del reporte del sub-agente y verificar cada una con primitivas baratas (`Grep`/`Read`/`wc -l`/`ls`/`git log`) ANTES de aceptar el plan o acción. Tipos de afirmaciones a verificar:
@@ -317,6 +319,8 @@ Durante `/swl:aprender`, aplicar estas reglas:
317
319
  *Para repos externos (Modo B)*: 4 filtros adicionales: (1) ¿qué % es teoría/código no-portable vs portable? — si >70% no-portable, recortar; (2) **¿la propuesta reescribe mecanismos existentes en el proyecto destino?** — VERIFICAR con `Grep`/`Read` 2-3 afirmaciones concretas del agente contra el código real ANTES de aceptar; (3) ¿LOC nuevas estimadas vs reutilizar lo existente? — si la propuesta supera 500 LOC para un solo patrón, hay sobre-ingeniería; (4) ¿el alcance reducido cubre 80% del valor? — Pareto.
318
320
 
319
321
  *Para revisores de código (Modo C)*: además del patrón obligatorio, **re-clasificar severidad cuando el revisor solo miró parte del flujo**. Si el revisor marca MAYOR un bug del Response, verificar si el Request también está afectado — los happy paths típicamente involucran ambos lados.
322
+
323
+ *Para agentes de documentación (Modo D)*: todo veredicto **NO-EXISTE / NO-SOPORTADO** sobre una feature de un producto externo exige cita a la doc oficial consultada EN ese turno (URL + extracto). Si el agente "verifica" solo contra el contexto local (configs del usuario, código del repo), su veredicto es inferencia, no verificación — re-verificar con 1 WebFetch a la doc oficial antes de tomar decisiones de diseño sobre él. Regla mnemónica: *ausencia en mi config ≠ ausencia en el producto*.
320
324
  - **Hooks de calidad pre-commit bloquean fixtures de tests como falsos positivos**: el hook `calidad-pre-commit.js` aplica regex `\b(api_key|password|token|secret)\s*[=:]\s*["'][^"'\s]{4,}["']` que matchea fixtures legítimos en archivos de test. Caso real: test que valida que la función `sanitizar()` redacta `api_key="abc12345xyz"` se bloquea. Causa: el hook no distingue contexto de test vs producción. Solución: en archivos de test, construir fixtures con concatenación de strings (`'api' + '_key'`, `'pass' + 'word'`) o agregar marcador placeholder reconocido por el hook (`fake_`, `dummy_`, `placeholder`, `example`, `os.environ`). NUNCA bypassear el hook con `--no-verify` — el detector cumple su función; ajustar el fixture es lo correcto.
321
325
  - **Regex de path-matching `/[\\/]<dir>[\\/]/` falla con paths relativos sin slash inicial** [CONFIRMADO x4]: hooks que filtran archivos por directorio (ej: `hooks/extraccion-aprendizajes.js` con `PATRONES_ARCHIVO_SWL_EXCLUIDO`) usan patrones que requieren un separator ANTES del nombre. Caso real: path `scripts/lib/foo.js` (sin slash inicial) eludía el filtro de exclusión y generaba placeholders espurios en APRENDIZAJES.md cada vez que se hacía `Edit` o `Write` sobre archivos del sistema SWL. Causa: el regex `[\\/]` requiere un caracter slash/backslash previo; cuando el path empieza con el nombre del directorio directamente, no matchea. Solución: usar `/(?:^|[\\/])<dir>[\\/]/` para aceptar tanto el inicio del string como un separator previo. Evidencia: 4 placeholders eliminados manualmente entre v1.3.3-v1.3.5 antes de identificar la causa raíz; fix endurecido aplicado en v1.3.5 (Fix I).
322
326
  - **`git ls-files` es preferible a `fs.readdir` recursivo para tests anti-regresión que escanean el repo**: usar `execSync('git ls-files')` limita el escaneo a archivos versionados — evita `node_modules/`, `.git/`, `_userland/`, archivos temporales y backups sin enumerar exclusiones. Caso real: `tests/scripts/no-legacy-npx-pattern.test.js` v1.3.6 escanea 1000+ archivos versionados en <200ms; el equivalente con `fs.readdir` recursivo más exclusiones manuales sería más lento y propenso a olvidar paths. Cuando el test es de "calidad del repo" (no de comportamiento), `git ls-files` es la primitiva correcta.
@@ -17,7 +17,7 @@ exclusiones:
17
17
  - "No cargar para teoría general de context-rot y compactación — usar `compactacion-contexto`. Este skill cubre operación day-to-day del harness Claude Code; aquel cubre principios de gestión de contexto independientes de la herramienta."
18
18
  - "No cargar para diseño/escritura de skills SWL — usar `meta-skills-estandar` y `reglas/skills-estandar.md`. Este skill cubre uso eficiente de skills, no su construcción."
19
19
  - "No cargar para resolución de errores específicos del runtime (CLI no arranca, MCP no conecta) — esos son problemas técnicos del CLI, no del harness operacional."
20
- - "No cargar para análisis de costo histórico o dashboards — usar `swl-dashboard` o `/swl:metricas`. Este skill cubre PREVENCIÓN del gasto excesivo, no el reporte post-hoc."
20
+ - "No cargar para análisis de costo histórico o dashboards — usar `swl-dashboard` o `/swl:status metricas`. Este skill cubre PREVENCIÓN del gasto excesivo, no el reporte post-hoc."
21
21
  evolvable: true
22
22
  ---
23
23
 
@@ -47,7 +47,7 @@ del lado del usuario.
47
47
  - Se va a escribir un skill SWL nuevo — usar `meta-skills-estandar`.
48
48
  - El problema es un error del runtime (CLI no inicia, MCP no responde) —
49
49
  ese es problema técnico, no operacional.
50
- - Se quiere ver costo histórico — usar `swl-dashboard` o `/swl:metricas`.
50
+ - Se quiere ver costo histórico — usar `swl-dashboard` o `/swl:status metricas`.
51
51
 
52
52
  ---
53
53
 
@@ -67,7 +67,10 @@ El prompt cache es la palanca económica más grande:
67
67
  Cada hit resetea el TTL sin costo. El prefijo se mantiene caliente mientras
68
68
  no cambie. **Hit rate sano: ~90% en 5-min default.**
69
69
 
70
- **Reglas operacionales** (ver también `reglas/harness-claude-code.md`):
70
+ **Reglas operacionales** (detalle completo en
71
+ [disciplina-harness-regla](recursos/disciplina-harness-regla.md) — ex-regla
72
+ `reglas/harness-claude-code.md`, absorbida aquí porque su propio texto decía
73
+ "no es de carga obligatoria global" y este skill es su canal bajo demanda):
71
74
 
72
75
  - NO agregar/quitar MCP servers mid-session
73
76
  - NO usar `/model` mid-session
@@ -224,8 +227,8 @@ sí pierdes el cache cuando vuelves a Anthropic.
224
227
 
225
228
  | Necesidad | Herramienta |
226
229
  |-----------|-------------|
227
- | Histórico Pro/Max/Team | `/swl:dashboard` (basado en `phuryn/claude-usage`) |
228
- | Tokens/costo de la sesión actual | `/swl:metricas` |
230
+ | Histórico Pro/Max/Team | `/swl:status dashboard` (basado en `phuryn/claude-usage`) |
231
+ | Tokens/costo de la sesión actual | `/swl:status metricas` |
229
232
  | Porcentaje de contexto usado en vivo | `hooks/linea-estado.js` (status bar) |
230
233
  | Alertas cuando contexto se llena | `hooks/monitor-contexto.js` (WARNING ≥65%, CRITICAL ≥75%) |
231
234
  | Hit rate de cache (API users) | `platform.claude.com/usage/cache` |
@@ -277,7 +280,7 @@ Sin observar la métrica, no puedes optimizarla.
277
280
  ## Integración con SWL
278
281
 
279
282
  Componentes SWL que cubren necesidades de harness: `/swl:compactar`,
280
- `/swl:checkpoint`, `/swl:dashboard`, `/swl:metricas`, `/swl:modelo`,
283
+ `/swl:checkpoint`, `/swl:status dashboard`, `/swl:status metricas`, `/swl:modelo`,
281
284
  `/swl:contexto`, hooks `linea-estado.js` + `monitor-contexto.js`,
282
285
  `/swl:revisar-impacto` (meta-grafo del sistema SWL) y `code-review-graph`
283
286
  pip (opt-in para codebase del usuario, ver `MANUAL_USO.md`).
@@ -299,4 +302,4 @@ el modelo mental completo del harness.
299
302
  - [ ] PDFs/Office docs pre-procesados con `markitdown`
300
303
  - [ ] Para repos grandes: `code-review-graph` instalado y `build` ejecutado
301
304
  - [ ] CLAUDE.md del proyecto con bloque de Task Delegation
302
- - [ ] Saber dónde ver métricas durante la sesión (`/swl:metricas`)
305
+ - [ ] Saber dónde ver métricas durante la sesión (`/swl:status metricas`)
@@ -204,9 +204,9 @@ Algunos formatos consumen muchos más tokens de los necesarios:
204
204
 
205
205
  SWL incluye:
206
206
 
207
- - **`/swl:dashboard`** — dashboard histórico de uso (basado en
207
+ - **`/swl:status dashboard`** — dashboard histórico de uso (basado en
208
208
  `phuryn/claude-usage`).
209
- - **`/swl:metricas`** — métricas de la sesión actual (tokens, costo
209
+ - **`/swl:status metricas`** — métricas de la sesión actual (tokens, costo
210
210
  estimado, modelos usados).
211
211
  - **`hooks/linea-estado.js`** — barra de estado con porcentaje de
212
212
  contexto consumido (con detección dinámica del techo según modelo —
@@ -7,7 +7,7 @@ herramientasPermitidas: [Read, Write, Edit, Bash, Glob, Grep]
7
7
  exclusiones:
8
8
  - "No cargar si SWL ya está instalado y funcionando (`doctor` pasa sin errores); no reinstalar para resolver problemas de uso del sistema."
9
9
  - "No cargar para actualizar un skill o agente individual; editar el SKILL.md o agente directamente en `habilidades/` o `agentes/`."
10
- - "No cargar para diagnosticar integridad del sistema instalado; usar `/swl:salud`."
10
+ - "No cargar para diagnosticar integridad del sistema instalado; usar `/swl:status salud`."
11
11
  - "No cargar para añadir skills de `_userland/` al core; usar `/swl:contribuir`."
12
12
  evolvable: true # default para skill estandar
13
13
  ---
@@ -32,7 +32,7 @@ NO se activa cuando:
32
32
 
33
33
  - SWL está instalado y `npx swl-ses doctor` pasa sin errores; reinstalar no resuelve problemas de uso.
34
34
  - El usuario quiere modificar un skill o agente específico; editar los archivos en `habilidades/` o `agentes/` directamente.
35
- - Se quiere diagnosticar por qué algo del sistema no funciona; usar `/swl:salud` que ejecuta validaciones sin reinstalar.
35
+ - Se quiere diagnosticar por qué algo del sistema no funciona; usar `/swl:status salud` que ejecuta validaciones sin reinstalar.
36
36
  - Se quiere incorporar skills de `_userland/` al core del sistema; ese flujo es `/swl:contribuir`, no una reinstalación.
37
37
 
38
38
  ## Paquete npm
@@ -218,4 +218,4 @@ markitdown --version
218
218
  - `/swl:mapear-codebase` — analizar código existente
219
219
  - `/swl:planear-fase` — planificar una fase de trabajo
220
220
  - `/swl:ejecutar-fase` — ejecutar plan con commits atómicos
221
- - `/swl:salud` — diagnóstico profundo del sistema
221
+ - `/swl:status salud` — diagnóstico profundo del sistema
@@ -7,7 +7,7 @@ del dominio seguridad.
7
7
 
8
8
  Skills del dominio de seguridad pueden declarar mapeos opcionales a cinco
9
9
  frameworks estándar en el frontmatter. El propósito es enriquecer reportes
10
- (`/swl:salud`, `/swl:dashboard`) con cobertura de control y alinear el sistema
10
+ (`/swl:status salud`, `/swl:status dashboard`) con cobertura de control y alinear el sistema
11
11
  con vocabulario de la industria. **No es evolución — es metadata aditiva que
12
12
  no cambia comportamiento.**
13
13