@saulwade/swl-ses 2.3.0 → 2.4.1

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 (327) hide show
  1. package/CLAUDE.md +241 -199
  2. package/README.md +597 -597
  3. package/agentes/_intent-spec.md +73 -73
  4. package/agentes/_propose-step.md +90 -90
  5. package/agentes/accesibilidad-wcag-swl.md +2 -2
  6. package/agentes/arquitecto-swl.md +2 -2
  7. package/agentes/auto-evolucion-swl.md +2 -2
  8. package/agentes/backend-api-swl.md +2 -2
  9. package/agentes/backend-csharp-swl.md +2 -2
  10. package/agentes/backend-go-swl.md +2 -2
  11. package/agentes/backend-java-swl.md +2 -2
  12. package/agentes/backend-node-swl.md +2 -2
  13. package/agentes/backend-python-swl.md +2 -2
  14. package/agentes/backend-rust-swl.md +2 -2
  15. package/agentes/backend-workers-swl.md +2 -2
  16. package/agentes/cloud-infra-swl.md +2 -2
  17. package/agentes/consolidador-swl.md +2 -2
  18. package/agentes/datos-swl.md +2 -2
  19. package/agentes/depurador-swl.md +2 -2
  20. package/agentes/devops-ci-swl.md +2 -2
  21. package/agentes/disenador-ui-swl.md +2 -2
  22. package/agentes/documentador-swl.md +2 -2
  23. package/agentes/frontend-angular-swl.md +2 -2
  24. package/agentes/frontend-css-swl.md +2 -2
  25. package/agentes/frontend-react-swl.md +2 -2
  26. package/agentes/frontend-swl.md +2 -2
  27. package/agentes/frontend-tailwind-swl.md +2 -2
  28. package/agentes/gh-fix-ci-swl.md +275 -275
  29. package/agentes/implementador-swl.md +2 -2
  30. package/agentes/investigador-swl.md +2 -2
  31. package/agentes/investigador-ux-swl.md +2 -2
  32. package/agentes/llm-apps-swl.md +2 -2
  33. package/agentes/migrador-swl.md +2 -2
  34. package/agentes/mobile-android-swl.md +2 -2
  35. package/agentes/mobile-cross-swl.md +2 -2
  36. package/agentes/mobile-ios-swl.md +2 -2
  37. package/agentes/mobile-testing-swl.md +2 -2
  38. package/agentes/nemesis-auditor-swl.md +1 -1
  39. package/agentes/notificador-swl.md +2 -2
  40. package/agentes/observabilidad-swl.md +2 -2
  41. package/agentes/orquestador-swl.md +41 -14
  42. package/agentes/pagos-swl.md +2 -2
  43. package/agentes/perfilador-usuario-swl.md +2 -2
  44. package/agentes/planificador-swl.md +2 -2
  45. package/agentes/producto-prd-swl.md +2 -2
  46. package/agentes/red-team-swl.md +218 -218
  47. package/agentes/release-manager-swl.md +2 -2
  48. package/agentes/rendimiento-swl.md +2 -2
  49. package/agentes/resolutor-build-swl.md +2 -2
  50. package/agentes/revisor-angular-swl.md +2 -2
  51. package/agentes/revisor-codigo-swl.md +36 -3
  52. package/agentes/revisor-csharp-swl.md +2 -2
  53. package/agentes/revisor-go-swl.md +2 -2
  54. package/agentes/revisor-java-swl.md +2 -2
  55. package/agentes/revisor-kotlin-swl.md +2 -2
  56. package/agentes/revisor-nextjs-swl.md +2 -2
  57. package/agentes/revisor-php-swl.md +2 -2
  58. package/agentes/revisor-react-swl.md +2 -2
  59. package/agentes/revisor-rust-swl.md +2 -2
  60. package/agentes/revisor-seguridad-swl.md +2 -2
  61. package/agentes/revisor-swift-swl.md +2 -2
  62. package/agentes/revisor-typescript-swl.md +2 -2
  63. package/agentes/sre-swl.md +2 -2
  64. package/agentes/tdd-qa-swl.md +2 -2
  65. package/comandos/swl/briefing.md +119 -119
  66. package/comandos/swl/contexto.md +0 -2
  67. package/comandos/swl/contribuir.md +233 -233
  68. package/comandos/swl/deuda-codigo.md +97 -0
  69. package/comandos/swl/predecir.md +139 -139
  70. package/comandos/swl/sesiones.md +1 -1
  71. package/gateway/agent-executor.js +1 -1
  72. package/gateway/lib/event-channel.js +191 -191
  73. package/habilidades/agent-deep-links/SKILL.md +148 -148
  74. package/habilidades/agentes-como-servicio/SKILL.md +2 -2
  75. package/habilidades/angular-moderno/SKILL.md +24 -1
  76. package/habilidades/auto-evolucion-protocolo/SKILL.md +276 -276
  77. package/habilidades/backend-async-postgres-testing/SKILL.md +215 -215
  78. package/habilidades/backend-error-design/SKILL.md +221 -221
  79. package/habilidades/backend-production-resilience/SKILL.md +288 -288
  80. package/habilidades/benchmark-memoria/SKILL.md +186 -186
  81. package/habilidades/calidad-anti-patrones-universales/SKILL.md +368 -368
  82. package/habilidades/calidad-contract-testing/SKILL.md +165 -165
  83. package/habilidades/calidad-mutation-testing/SKILL.md +170 -170
  84. package/habilidades/changelog-generator/scripts/parse-commits.js +367 -367
  85. package/habilidades/checklist-seguridad/recursos/stride-cobertura.md +60 -60
  86. package/habilidades/contenedores-docker/SKILL.md +3 -1
  87. package/habilidades/diagrama-arquitectura/assets/template.html +276 -276
  88. package/habilidades/doubt-driven-review/recursos/EXAMPLES.md +130 -130
  89. package/habilidades/drift-detection/SKILL.md +179 -179
  90. package/habilidades/estructura-proyecto-claude/recursos/frontmatter-y-hooks-referencia.md +1 -1
  91. package/habilidades/estructura-proyecto-claude/recursos/mcp-json-template.json +57 -57
  92. package/habilidades/eval-framework/SKILL.md +212 -212
  93. package/habilidades/feynman-auditor-swl/recursos/preguntas-language-agnostic.md +108 -108
  94. package/habilidades/harness-claude-code/SKILL.md +4 -4
  95. package/habilidades/harness-claude-code/recursos/disciplina-harness-regla.md +253 -252
  96. package/habilidades/legacy-code-rescue/SKILL.md +268 -267
  97. package/habilidades/meta-skills-estandar/SKILL.md +1 -1
  98. package/habilidades/meta-skills-estandar/recursos/convencion-examples.md +93 -93
  99. package/habilidades/meta-skills-estandar/recursos/skills-as-agents.md +2 -2
  100. package/habilidades/patrones-python/recursos/patrones-avanzados.md +469 -469
  101. package/habilidades/perfil-usuario/SKILL.md +200 -200
  102. package/habilidades/postgresql-experto/SKILL.md +3 -1
  103. package/habilidades/prevencion-sobreingenieria/SKILL.md +70 -92
  104. package/habilidades/prevencion-sobreingenieria/recursos/EXAMPLES.md +580 -580
  105. package/habilidades/prevencion-sobreingenieria/recursos/soluciones-nativas.md +166 -0
  106. package/habilidades/prevencion-sobreingenieria/recursos/variables-residuales-post-refactor.md +85 -0
  107. package/habilidades/proceso-ddia-fundamentos/SKILL.md +255 -255
  108. package/habilidades/proceso-ddia-streaming/SKILL.md +231 -231
  109. package/habilidades/proceso-debate-adversarial/recursos/personas.md +105 -105
  110. package/habilidades/proceso-discovery-machote/SKILL.md +157 -157
  111. package/habilidades/proceso-dynamic-workflows/SKILL.md +138 -138
  112. package/habilidades/proceso-dynamic-workflows/recursos/template-adversarial-verify.js +65 -65
  113. package/habilidades/proceso-dynamic-workflows/recursos/template-triage.js +65 -65
  114. package/habilidades/proceso-intent-engineering/SKILL.md +269 -269
  115. package/habilidades/proceso-modular-split/SKILL.md +256 -256
  116. package/habilidades/prompt-engineering/recursos/patrones-avanzados.md +2 -2
  117. package/habilidades/state-inconsistency-auditor-swl/recursos/coupled-state-patterns.md +147 -147
  118. package/habilidades/structured-outputs/SKILL.md +2 -2
  119. package/habilidades/swl-claudemd/recursos/contrato-aprender.md +83 -83
  120. package/habilidades/swl-claudemd/recursos/duplicacion-reglas-globales.md +85 -85
  121. package/habilidades/swl-claudemd/recursos/plantillas-init.md +94 -94
  122. package/habilidades/swl-dashboard/SKILL.md +2 -2
  123. package/habilidades/tdd-workflow/recursos/gherkin-bdd.md +111 -111
  124. package/habilidades/validacion-ci-sistema/recursos/validadores-completos.md +1 -1
  125. package/habilidades/validacion-ci-sistema/scripts/validar-sistema.sh +1 -1
  126. package/hooks/audit-trail.js +4 -4
  127. package/hooks/calidad-pre-commit.js +15 -11
  128. package/hooks/captura-acciones-post.js +3 -2
  129. package/hooks/captura-acciones-session.js +3 -2
  130. package/hooks/ciclo-evolucion-subagente.js +26 -26
  131. package/hooks/ciclo-evolucion.js +26 -26
  132. package/hooks/claudemd-bloat-detector.js +161 -161
  133. package/hooks/claudemd-duplicacion-detector.js +170 -170
  134. package/hooks/contexto-iteracion.js +145 -144
  135. package/hooks/contexto-subagente.js +68 -0
  136. package/hooks/guardrail-modelo.js +14 -4
  137. package/hooks/inyeccion-contexto.js +12 -12
  138. package/hooks/lib/agent-routing.js +107 -107
  139. package/hooks/lib/auto-consolidator.js +335 -335
  140. package/hooks/lib/autonomia.js +208 -208
  141. package/hooks/lib/ciclo-evolucion.js +47 -47
  142. package/hooks/lib/deep-links.js +185 -185
  143. package/hooks/lib/error-classifier.js +308 -308
  144. package/hooks/lib/etapa-auto-evolucion.js +701 -701
  145. package/hooks/lib/etapa-metricas.js +388 -388
  146. package/hooks/lib/etapa-perfil-usuario.js +376 -376
  147. package/hooks/lib/loop-telemetry.js +321 -321
  148. package/hooks/lib/merkle-audit.js +96 -96
  149. package/hooks/lib/model-router.js +2 -2
  150. package/hooks/lib/propose-step.js +358 -358
  151. package/hooks/lib/provenance-tracker.js +191 -191
  152. package/hooks/lib/rate-limit-tracker.js +253 -253
  153. package/hooks/lib/resource-quota.js +122 -122
  154. package/hooks/lib/retry-jitter.js +165 -165
  155. package/hooks/lib/security-net.js +201 -201
  156. package/hooks/lib/skill-auditor.js +588 -588
  157. package/hooks/lib/sync-status.js +228 -228
  158. package/hooks/lib/taint-tracker.js +107 -107
  159. package/hooks/lib/text-similarity.js +241 -241
  160. package/hooks/lib/token-estimator.js +1 -0
  161. package/hooks/lib/toon-compressor.js +245 -245
  162. package/hooks/lib/usage-model.js +1 -1
  163. package/hooks/registro-turnos.js +210 -209
  164. package/hooks/session-briefing.js +98 -98
  165. package/hooks/spec-gate.js +212 -211
  166. package/hooks/sugerir-contribuir.js +2 -1
  167. package/hooks/sugerir-regenerar-inventario.js +171 -170
  168. package/hooks/tdd-gate.js +242 -241
  169. package/hooks/telemetria-skill-routing.js +100 -100
  170. package/hooks/validar-formato-post-subagente.js +140 -140
  171. package/hooks/validar-intent-spec.js +242 -242
  172. package/hooks/validar-memoria-hook.js +218 -218
  173. package/hooks/validar-planning-paths.js +134 -134
  174. package/instintos/autonomia.yaml +27 -27
  175. package/instintos/prompt-appendices.yaml +57 -57
  176. package/llms.txt +29 -29
  177. package/manifiestos/agent-output-schemas.json +57 -57
  178. package/manifiestos/canonical-hashes.json +2948 -1964
  179. package/manifiestos/hook-profiles.json +0 -2
  180. package/manifiestos/hooks-config.json +469 -477
  181. package/manifiestos/invariantes-criticos.json +30 -0
  182. package/manifiestos/modulos.json +1390 -1390
  183. package/manifiestos/planning-paths.json +44 -44
  184. package/manifiestos/skills-lock.json +1282 -1282
  185. package/package.json +93 -93
  186. package/plantillas/auditor-veto-template.md +105 -105
  187. package/plantillas/github-workflows/README.md +47 -47
  188. package/plantillas/github-workflows/release-please.yml +44 -44
  189. package/plantillas/github-workflows/swl-ci.yml +107 -107
  190. package/plantillas/github-workflows/swl-security.yml +51 -51
  191. package/plugin.json +369 -371
  192. package/reglas/accesibilidad.md +10 -10
  193. package/reglas/analisis-previo-tareas-grandes.md +172 -172
  194. package/reglas/api-diseno.md +9 -9
  195. package/reglas/arreglar-al-detectar.md +240 -240
  196. package/reglas/auditorias-documentales-estructurales.md +7 -7
  197. package/reglas/cloud-infra.md +8 -8
  198. package/reglas/consultar-vault-primero.md +195 -195
  199. package/reglas/debatir-antes-de-aceptar.md +158 -158
  200. package/reglas/fragmentos-compartidos.md +183 -183
  201. package/reglas/hooks.md +6 -6
  202. package/reglas/intent-engineering.md +218 -218
  203. package/reglas/markitdown.md +8 -8
  204. package/reglas/monitor-ci.md +309 -309
  205. package/reglas/patrones.md +6 -6
  206. package/reglas/sesiones-paralelas.md +180 -180
  207. package/reglas/sin-duplicacion-reglas-globales.md +182 -182
  208. package/reglas/skills-estandar.md +6 -6
  209. package/reglas/testing.md +7 -7
  210. package/reglas/tests-cleanup.md +224 -224
  211. package/reglas/usar-code-review-graph.md +155 -155
  212. package/reglas/usar-context7.md +226 -226
  213. package/reglas/verificar-citas-normativas.md +548 -548
  214. package/schemas/agent-frontmatter.schema.json +5 -3
  215. package/schemas/agent-message.schema.json +73 -73
  216. package/schemas/agent-output-implementacion.schema.json +114 -114
  217. package/schemas/agent-output-planificacion.schema.json +150 -150
  218. package/schemas/agent-output-review.schema.json +98 -98
  219. package/schemas/diary-entry.schema.json +112 -112
  220. package/schemas/hook-profiles.schema.json +54 -54
  221. package/schemas/hooks-config.schema.json +89 -89
  222. package/schemas/modulos.schema.json +38 -38
  223. package/schemas/perfiles.schema.json +36 -36
  224. package/schemas/plugin.schema.json +77 -77
  225. package/schemas/skill-evals.schema.json +119 -119
  226. package/schemas/skill-frontmatter.schema.json +245 -245
  227. package/scripts/audit-tools/audit-history.js +330 -330
  228. package/scripts/audit-tools/bundle-tracker.js +290 -290
  229. package/scripts/audit-tools/canary-monitor.js +352 -352
  230. package/scripts/audit-tools/code-profiler.js +605 -605
  231. package/scripts/audit-tools/dep-doctor.js +320 -320
  232. package/scripts/audit-tools/env-validator.js +206 -206
  233. package/scripts/audit-tools/lib/fs-walk.js +48 -48
  234. package/scripts/audit-tools/lib/output.js +23 -23
  235. package/scripts/audit-tools/migration-checker.js +392 -392
  236. package/scripts/audit-tools/pentest-scanner.js +1436 -1436
  237. package/scripts/benchmark-memoria.js +167 -167
  238. package/scripts/cli/aprobar-plan.js +73 -73
  239. package/scripts/cli/briefing.js +23 -23
  240. package/scripts/cli/ciclo-evolucion.js +26 -26
  241. package/scripts/cli/configurar-ci.js +40 -40
  242. package/scripts/cli/derivar-feature-list.js +25 -25
  243. package/scripts/cli/detectar-host.js +27 -27
  244. package/scripts/cli/diary-entry.js +69 -69
  245. package/scripts/cli/execution-state.js +18 -18
  246. package/scripts/cli/gateway-notify.js +41 -41
  247. package/scripts/cli/liberar-fase.js +42 -42
  248. package/scripts/cli/loop-telemetry.js +125 -125
  249. package/scripts/cli/mark-evolved.js +56 -56
  250. package/scripts/cli/metricas-dora.js +26 -26
  251. package/scripts/cli/near-duplicate.js +55 -55
  252. package/scripts/cli/notificaciones.js +123 -123
  253. package/scripts/cli/propose-step.js +29 -29
  254. package/scripts/cli/schedule-parse.js +19 -19
  255. package/scripts/cli/sugerir-modelo.js +20 -20
  256. package/scripts/cli/verificar-plan.js +36 -36
  257. package/scripts/cli/verificar-trazabilidad.js +35 -35
  258. package/scripts/configurar-branch-protection.js +418 -418
  259. package/scripts/detectar-aprendizajes-duplicados.js +151 -151
  260. package/scripts/field-report.js +199 -199
  261. package/scripts/generar-checklists-consolidados.js +273 -273
  262. package/scripts/generar-matriz-lenguajes.js +271 -271
  263. package/scripts/instalador.js +4 -1
  264. package/scripts/lib/artefactos-python.js +43 -43
  265. package/scripts/lib/auditar-invocaciones-comandos.js +104 -104
  266. package/scripts/lib/benchmark-metrics.js +160 -160
  267. package/scripts/lib/budget-enforcer.js +252 -252
  268. package/scripts/lib/ci-reader.js +193 -193
  269. package/scripts/lib/claude-sessions.js +1 -0
  270. package/scripts/lib/configurar-ci.js +380 -380
  271. package/scripts/lib/contadores-inventario.js +217 -217
  272. package/scripts/lib/detectar-host-swl.js +175 -175
  273. package/scripts/lib/detectar-stack-detallado.js +307 -307
  274. package/scripts/lib/detector-autoduplicacion-intra-archivo.js +234 -234
  275. package/scripts/lib/detector-reglas-duplicadas.js +220 -220
  276. package/scripts/lib/diary-entry.js +234 -234
  277. package/scripts/lib/eval-metrics-store.js +218 -218
  278. package/scripts/lib/eval-quality.js +171 -171
  279. package/scripts/lib/eval-schemas.js +144 -144
  280. package/scripts/lib/eval-self-correct.js +106 -106
  281. package/scripts/lib/eval-validator.js +185 -185
  282. package/scripts/lib/evidencia-release.js +322 -322
  283. package/scripts/lib/gate-hooks-requires.js +249 -249
  284. package/scripts/lib/gate-licencias.js +212 -212
  285. package/scripts/lib/git-metricas.js +257 -257
  286. package/scripts/lib/jaccard-similarity.js +98 -98
  287. package/scripts/lib/longmemeval-runner.js +125 -125
  288. package/scripts/lib/metricas-dora.js +204 -204
  289. package/scripts/lib/npm-version.js +261 -261
  290. package/scripts/lib/paquetes-conocidos.js +50 -50
  291. package/scripts/lib/plan-lock.js +275 -275
  292. package/scripts/lib/pr-analyzer.js +399 -399
  293. package/scripts/lib/preservar-usuario.js +39 -5
  294. package/scripts/lib/prompt-builder.js +264 -264
  295. package/scripts/lib/reglas-globales-conocidas.json +180 -180
  296. package/scripts/lib/resolver-plan-fase.js +37 -37
  297. package/scripts/lib/rrf-fusion.js +175 -175
  298. package/scripts/lib/schema-version.js +164 -164
  299. package/scripts/lib/scoring-instintos.js +277 -277
  300. package/scripts/lib/semantic-search.js +252 -252
  301. package/scripts/lib/tool-cost-analyzer.js +1 -0
  302. package/scripts/limpiar-artefactos-python.js +131 -131
  303. package/scripts/migrar-csv-a-array.js +168 -168
  304. package/scripts/migrar-fase-dominio.js +200 -200
  305. package/scripts/publicar.js +497 -497
  306. package/scripts/run-eval.js +141 -141
  307. package/scripts/tui/componentes/selector-multi.js +189 -189
  308. package/scripts/tui/componentes/selector-unico.js +158 -158
  309. package/scripts/tui/ejecutores.js +375 -375
  310. package/scripts/tui/index.js +162 -162
  311. package/scripts/tui/lib/colores.js +129 -129
  312. package/scripts/tui/lib/render.js +264 -264
  313. package/scripts/tui/lib/teclas.js +113 -113
  314. package/scripts/tui/pantallas/inspect.js +173 -173
  315. package/scripts/tui/pantallas/install-wizard.js +334 -334
  316. package/scripts/tui/pantallas/menu-principal.js +52 -52
  317. package/scripts/tui/pantallas/progreso.js +274 -274
  318. package/scripts/tui/pantallas/resumen.js +132 -132
  319. package/scripts/tui/pantallas/uninstall-wizard.js +208 -208
  320. package/scripts/tui/pantallas/update-wizard.js +232 -232
  321. package/scripts/tui/pantallas/welcome.js +187 -187
  322. package/scripts/validar-userland-vacio.js +110 -110
  323. package/scripts/validar.js +1 -1
  324. package/scripts/verificar-release.js +51 -0
  325. package/hooks/lib/context-compressor.js +0 -657
  326. package/hooks/linea-estado.js +0 -326
  327. package/hooks/monitor-contexto.js +0 -373
@@ -6,8 +6,8 @@ description: >
6
6
  OnPush, subscriptions sin unsubscribe, NgModules innecesarios y falta de lazy loading.
7
7
  Invocar para revisión de componentes Angular, servicios, o configuración de módulos.
8
8
  tools: [Read, Grep, Glob, Bash]
9
- model: claude-sonnet-4-6
10
- modeloAlterno: claude-haiku-4-5-20251001
9
+ model: sonnet
10
+ modeloAlterno: haiku
11
11
  ventanaContexto: 200k
12
12
  color: red
13
13
  version: 1.0.0
@@ -11,11 +11,11 @@ description: >
11
11
  feature, antes de pasar a revisión de seguridad. También invocar para
12
12
  auditar calidad de código heredado.
13
13
  tools: [Read, Grep, Glob, Bash]
14
- model: claude-sonnet-4-6
15
- modeloAlterno: claude-haiku-4-5-20251001
14
+ model: sonnet
15
+ modeloAlterno: haiku
16
16
  ventanaContexto: 200k
17
17
  color: orange
18
- version: 1.2.2
18
+ version: 1.3.0
19
19
  nivelRiesgo: BAJO
20
20
  skillsInvocables: [checklist-calidad, patrones-python, api-rest-diseno, tdd-workflow, verificar-trabajo, verificacion-evidencia, swl-revisar-impacto, prevencion-sobreingenieria]
21
21
  skillsRestringidos: []
@@ -365,6 +365,34 @@ se preservan sin cambios.
365
365
 
366
366
  Solo los problemas CRÍTICOS bloquean el avance. MAYOR debe documentarse como deuda.
367
367
 
368
+ ## Lente de sobre-ingeniería — qué borrar
369
+
370
+ Pasada dedicada a complejidad innecesaria (adaptada de ponytail, MIT; alineada
371
+ con la escalera de `Skill("prevencion-sobreingenieria")`). El mejor destino de
372
+ un diff es hacerse más corto. Una línea por hallazgo con etiqueta:
373
+
374
+ | Tag | Qué señala | El reemplazo |
375
+ |-----|-----------|--------------|
376
+ | `delete:` | Código muerto, flexibilidad sin uso, feature especulativa | Nada |
377
+ | `stdlib:` | Reimplementación de algo que la stdlib ya trae | Nombrar la función |
378
+ | `native:` | Dependencia o código que la plataforma ya cubre | Nombrar la feature nativa |
379
+ | `yagni:` | Abstracción con una sola implementación, config que nadie setea, capa con un solo caller | Inlinear hasta que exista el segundo caso |
380
+ | `shrink:` | Misma lógica, menos líneas | Mostrar la forma corta |
381
+
382
+ Formato: `archivo.py:L12-38: stdlib: clase validadora de 27 líneas. "@" en email, 1 línea; la validación real es el correo de confirmación.`
383
+
384
+ Reglas de la lente:
385
+
386
+ - Cerrar con la única métrica que importa: `net: −N líneas posibles.` Si no
387
+ hay nada que cortar: `Ya está magro.` — y se dice explícitamente.
388
+ - Un smoke test o self-check mínimo NUNCA se marca para borrar: es el piso
389
+ de la disciplina de código mínimo, no bloat.
390
+ - Los marcadores `simplificado:` con techo y trigger son simplificación
391
+ deliberada trazada — no son hallazgo; los que NO tienen trigger sí
392
+ (MAYOR: deuda silenciosa, remitir a `/swl:deuda-codigo`).
393
+ - Scope de la lente: solo complejidad. Bugs de correctness, seguridad y
394
+ performance van en sus ejes/handoffs — no aquí.
395
+
368
396
  ## Reglas estrictas
369
397
 
370
398
  - NUNCA apruebes código con un problema CRÍTICO sin resolución explícita
@@ -497,6 +525,11 @@ Si no se detecta ninguno: `### VETO ITEMS DETECTADOS\n- Ninguno`.
497
525
  - [descripción de la duplicación + archivos involucrados]
498
526
  - [o "Ninguna duplicación significativa"]
499
527
 
528
+ ### Sobre-ingeniería — qué borrar
529
+ - `archivo.py:L12-38: stdlib: [qué cortar]. [reemplazo].`
530
+ - [una línea por hallazgo con tag delete:/stdlib:/native:/yagni:/shrink:]
531
+ - net: −N líneas posibles. [o "Ya está magro."]
532
+
500
533
  ### Veredicto
501
534
  **APROBADO** / **APROBADO CON CORRECCIONES** / **RECHAZADO**
502
535
 
@@ -7,8 +7,8 @@ description: >
7
7
  por dimension y problemas clasificados por severidad. Invocar despues de
8
8
  implementar features C# o para auditar codigo C# existente antes de merge.
9
9
  tools: [Read, Grep, Glob, Bash]
10
- model: claude-sonnet-4-6
11
- modeloAlterno: claude-haiku-4-5-20251001
10
+ model: sonnet
11
+ modeloAlterno: haiku
12
12
  ventanaContexto: 200k
13
13
  color: purple
14
14
  version: 1.0.0
@@ -6,8 +6,8 @@ description: >
6
6
  con score por dimensión y problemas clasificados por severidad. Invocar después
7
7
  de implementar features Go o para auditar código Go existente antes de merge.
8
8
  tools: [Read, Grep, Glob, Bash]
9
- model: claude-sonnet-4-6
10
- modeloAlterno: claude-haiku-4-5-20251001
9
+ model: sonnet
10
+ modeloAlterno: haiku
11
11
  ventanaContexto: 200k
12
12
  color: cyan
13
13
  version: 1.0.0
@@ -6,8 +6,8 @@ description: >
6
6
  y problemas clasificados por severidad. Invocar después de implementar features
7
7
  Java o para auditar código Java existente antes de merge a main.
8
8
  tools: [Read, Grep, Glob, Bash]
9
- model: claude-sonnet-4-6
10
- modeloAlterno: claude-haiku-4-5-20251001
9
+ model: sonnet
10
+ modeloAlterno: haiku
11
11
  ventanaContexto: 200k
12
12
  color: blue
13
13
  version: 1.0.0
@@ -7,8 +7,8 @@ description: >
7
7
  Invocar despues de implementar features Kotlin/Android o para auditar codigo
8
8
  Kotlin existente antes de merge.
9
9
  tools: [Read, Grep, Glob, Bash]
10
- model: claude-sonnet-4-6
11
- modeloAlterno: claude-haiku-4-5-20251001
10
+ model: sonnet
11
+ modeloAlterno: haiku
12
12
  ventanaContexto: 200k
13
13
  color: green
14
14
  version: 1.0.0
@@ -7,8 +7,8 @@ description: >
7
7
  problemas clasificados por severidad. Invocar después de implementar features
8
8
  Next.js o para auditar código Next.js existente antes de merge.
9
9
  tools: [Read, Grep, Glob, Bash]
10
- model: claude-sonnet-4-6
11
- modeloAlterno: claude-haiku-4-5-20251001
10
+ model: sonnet
11
+ modeloAlterno: haiku
12
12
  ventanaContexto: 200k
13
13
  color: gray
14
14
  version: 1.0.0
@@ -7,8 +7,8 @@ description: >
7
7
  dimensión y problemas clasificados por severidad. Invocar después de implementar
8
8
  features PHP/Laravel o para auditar código PHP existente antes de merge.
9
9
  tools: [Read, Grep, Glob, Bash]
10
- model: claude-sonnet-4-6
11
- modeloAlterno: claude-haiku-4-5-20251001
10
+ model: sonnet
11
+ modeloAlterno: haiku
12
12
  ventanaContexto: 200k
13
13
  color: indigo
14
14
  version: 1.0.0
@@ -6,8 +6,8 @@ description: >
6
6
  state mal ubicado, prop drilling excesivo y falta de memoization. Invocar para revisión
7
7
  de componentes React, hooks custom, o integraciones con state managers.
8
8
  tools: [Read, Grep, Glob, Bash]
9
- model: claude-sonnet-4-6
10
- modeloAlterno: claude-haiku-4-5-20251001
9
+ model: sonnet
10
+ modeloAlterno: haiku
11
11
  ventanaContexto: 200k
12
12
  color: cyan
13
13
  version: 1.0.0
@@ -7,8 +7,8 @@ description: >
7
7
  problemas clasificados por severidad. Invocar despues de implementar features
8
8
  Rust o para auditar codigo Rust existente antes de merge.
9
9
  tools: [Read, Grep, Glob, Bash]
10
- model: claude-sonnet-4-6
11
- modeloAlterno: claude-haiku-4-5-20251001
10
+ model: sonnet
11
+ modeloAlterno: haiku
12
12
  ventanaContexto: 200k
13
13
  color: orange
14
14
  version: 1.0.0
@@ -7,8 +7,8 @@ description: >
7
7
  severidad CVSSv3 por hallazgo. Invocar antes de cualquier merge a main cuando
8
8
  el código toca endpoints, autenticación, manejo de archivos o datos de usuario.
9
9
  tools: [Read, Grep, Glob, Bash]
10
- model: claude-opus-4-8
11
- modeloAlterno: claude-sonnet-4-6
10
+ model: opus
11
+ modeloAlterno: sonnet
12
12
  ventanaContexto: 200k
13
13
  color: red
14
14
  version: 1.0.0
@@ -7,8 +7,8 @@ description: >
7
7
  problemas clasificados por severidad. Invocar despues de implementar features
8
8
  Swift/iOS o para auditar codigo Swift existente antes de merge.
9
9
  tools: [Read, Grep, Glob, Bash]
10
- model: claude-sonnet-4-6
11
- modeloAlterno: claude-haiku-4-5-20251001
10
+ model: sonnet
11
+ modeloAlterno: haiku
12
12
  ventanaContexto: 200k
13
13
  color: red
14
14
  version: 1.0.0
@@ -6,8 +6,8 @@ description: >
6
6
  inseguras, tipos duplicados y generics innecesarios. Invocar para revisión de
7
7
  código TypeScript puro, librerías, o backends Node.js.
8
8
  tools: [Read, Grep, Glob, Bash]
9
- model: claude-sonnet-4-6
10
- modeloAlterno: claude-haiku-4-5-20251001
9
+ model: sonnet
10
+ modeloAlterno: haiku
11
11
  ventanaContexto: 200k
12
12
  color: blue
13
13
  version: 1.0.0
@@ -8,8 +8,8 @@ description: >
8
8
  cuantificar la confiabilidad de un sistema. Complementa a observabilidad-swl
9
9
  (que implementa métricas) con el framework de confiabilidad.
10
10
  tools: [Read, Write, Edit, Bash, Grep, Glob, Skill]
11
- model: claude-opus-4-8
12
- modeloAlterno: claude-sonnet-4-6
11
+ model: opus
12
+ modeloAlterno: sonnet
13
13
  ventanaContexto: 200k
14
14
  permissionMode: acceptEdits
15
15
  color: red
@@ -7,8 +7,8 @@ description: >
7
7
  implementar (TDD) o después de implementar (auditoría de cobertura). NUNCA
8
8
  modifica código de producción — solo archivos de test y fixtures.
9
9
  tools: [Read, Write, Edit, Bash, Grep, Glob]
10
- model: claude-sonnet-4-6
11
- modeloAlterno: claude-haiku-4-5-20251001
10
+ model: sonnet
11
+ modeloAlterno: haiku
12
12
  ventanaContexto: 200k
13
13
  color: purple
14
14
  version: 1.1.0
@@ -1,119 +1,119 @@
1
- ---
2
- name: swl:briefing
3
- description: Briefing proactivo del proyecto bajo demanda. Re-presenta las señales baratas del hook SessionStart (ADRs Propuestos con reevaluación vencida, deuda con trigger por fecha cumplido, nudges sin accionar, gates en calibración, retoma pendiente) y agrega el análisis profundo opt-in que el hook no puede pagar: audit de dependencias del proyecto destino, cobertura vs umbral, hubs del grafo tocados sin revisión, drift de feature-list, y triggers de deuda en prosa libre. Cargar cuando el usuario pide "¿qué hay pendiente?", "¿qué riesgos hay?", "ponme al día", o cuando el digest de sesión sugiere el análisis completo por volumen de señales.
4
- allowed_tools: ["Read", "Bash", "Glob", "Grep"]
5
- ---
6
-
7
- # /swl:briefing — Briefing proactivo bajo demanda
8
-
9
- Análisis no solicitado del estado del proyecto destino (Fase 12, ADR-0036). El
10
- hook `session-briefing.js` da el digest barato al abrir sesión; este comando es
11
- el nivel profundo: re-presenta esas señales Y agrega las que cuestan (deps, grafo,
12
- cobertura) con degradación funcional si la herramienta no está instalada.
13
-
14
- Principio rector: **proponer es barato y siempre permitido; actuar requiere
15
- autorización del usuario**. Este comando solo propone y analiza — nunca aplica
16
- cambios sin que el usuario los pida.
17
-
18
- ## Uso
19
-
20
- ```
21
- /swl:briefing # señales baratas + análisis profundo completo
22
- /swl:briefing rapido # solo las 5 señales del hook (sin deps/grafo/cobertura)
23
- ```
24
-
25
- ## Paso 1 — Señales baratas (mismas del hook)
26
-
27
- Ejecuta los recolectores de filesystem y presenta el digest sin tope de 5 (aquí
28
- sí caben todas, no hay presupuesto de latencia de arranque):
29
-
30
- ```bash
31
- # Subcomando del CLI (resuelve cross-scope; ver docs/invocacion-cli-cross-scope.md)
32
- swl-ses briefing
33
- # fallback: npx -y @saulwade/swl-ses@latest briefing
34
- ```
35
-
36
- Las 5 categorías: `adr-vencido`, `deuda-trigger`, `nudges-pendientes`,
37
- `gate-calibracion`, `continue-here`. Si `rapido`, terminar aquí.
38
-
39
- ## Paso 2 — Análisis profundo (opt-in, con degradación)
40
-
41
- Para cada herramienta, **validar antes de invocar** (patrón "validar antes de
42
- invocar"): si no está disponible, reportar "no disponible, omitido" y continuar —
43
- nunca fallar el briefing por una herramienta ausente.
44
-
45
- ### 2.1 — Audit de dependencias del proyecto destino
46
-
47
- Detectar el ecosistema y correr el audit nativo:
48
-
49
- ```bash
50
- # Node
51
- [ -f package.json ] && npm audit --omit=dev 2>/dev/null | tail -5
52
- # Python
53
- [ -f requirements.txt -o -f pyproject.toml ] && (command -v pip-audit >/dev/null && pip-audit 2>/dev/null | tail -5 || echo "pip-audit no instalado — omitido")
54
- ```
55
-
56
- Reportar CVEs HIGH/CRITICAL con la acción concreta (`npm audit fix`, bump de
57
- versión). Sin lockfile o sin gestor → omitir.
58
-
59
- ### 2.2 — Cobertura vs umbral
60
-
61
- Si el proyecto define cobertura, comparar contra el umbral del proyecto (80% por
62
- defecto). Si no hay reporte reciente, indicar el comando para generarlo en vez de
63
- correrlo (puede ser caro):
64
-
65
- ```
66
- Para medir cobertura: <runner del proyecto> --coverage
67
- ```
68
-
69
- ### 2.3 — Hubs del grafo tocados sin revisión
70
-
71
- Si el MCP `code-review-graph` está disponible (tools `mcp__code-review-graph__*`
72
- registradas o deferred), consultar los nodos hub modificados en los últimos N
73
- commits sin revisión asociada. Si no está disponible → omitir con nota.
74
-
75
- ### 2.4 — Drift de feature-list
76
-
77
- ```bash
78
- swl-ses derivar-feature-list --check 2>/dev/null; echo "exit: $?"
79
- ```
80
-
81
- Exit 2 → reportar que `HOJA-RUTA.md` y `feature-list.json` divergieron, con la
82
- acción `swl-ses derivar-feature-list` para regenerar.
83
-
84
- ### 2.5 — Deuda con trigger en prosa libre
85
-
86
- El hook solo evalúa triggers verificables por fecha (D-16). Aquí, leer
87
- `.planning/DEUDA-TECNICA.md` y evaluar con criterio los triggers en prosa
88
- ("≥2 clientes reportan", "p95 > 60s documentado") contra el estado real del
89
- proyecto. Reportar los que parezcan cumplidos para revisión del usuario.
90
-
91
- ## Paso 3 — Presentación y telemetría
92
-
93
- Presenta el briefing agrupado por prioridad (continue-here → gates → deuda →
94
- ADRs → nudges → hallazgos profundos). Cada ítem con su acción ejecutable.
95
-
96
- Tras presentar, el usuario decide qué accionar. NO ejecutar acciones de mutación
97
- (cerrar deuda, promover gates, aplicar fixes) sin que el usuario lo pida — este
98
- comando es propositivo (separación PROPONER/ACTUAR, ADR-0037 pendiente).
99
-
100
- Si el usuario acciona una señal en esta sesión (ejecuta el comando sugerido), esa
101
- resolución la captura la telemetría de aceptación del hook en la siguiente sesión
102
- (la señal desaparece del recolector → cuenta como "actuada", D-18).
103
-
104
- ## Cuándo NO usar este comando
105
-
106
- - En cada turno de una sesión: el briefing es por sesión, no por mensaje. El hook
107
- ya cubre el inicio; este comando es para cuando el usuario pide el detalle.
108
- - Para aplicar las acciones propuestas: este comando propone, no ejecuta. Usar el
109
- comando concreto de cada señal (`/swl:evolucion-estado`, `/swl:verificar`, etc.).
110
- - En proyectos sin `.planning/`: no hay señales que recolectar.
111
-
112
- ## Gotchas
113
-
114
- - **Herramienta ausente ≠ error**: si `npm audit`, `pip-audit` o el grafo no están,
115
- el briefing los omite con nota y sigue. Nunca abortar por una dependencia opt-in.
116
- - **No re-listar lo que el hook ya mostró hoy**: el hook aplica dedupe diario; este
117
- comando ignora el dedupe a propósito (lo invoca el usuario, quiere ver todo).
118
- - **`code-review-graph` deferred ≠ ausente**: si las tools aparecen como deferred,
119
- cargar su schema con `ToolSearch` antes de concluir que no está disponible.
1
+ ---
2
+ name: swl:briefing
3
+ description: Briefing proactivo del proyecto bajo demanda. Re-presenta las señales baratas del hook SessionStart (ADRs Propuestos con reevaluación vencida, deuda con trigger por fecha cumplido, nudges sin accionar, gates en calibración, retoma pendiente) y agrega el análisis profundo opt-in que el hook no puede pagar: audit de dependencias del proyecto destino, cobertura vs umbral, hubs del grafo tocados sin revisión, drift de feature-list, y triggers de deuda en prosa libre. Cargar cuando el usuario pide "¿qué hay pendiente?", "¿qué riesgos hay?", "ponme al día", o cuando el digest de sesión sugiere el análisis completo por volumen de señales.
4
+ allowed_tools: ["Read", "Bash", "Glob", "Grep"]
5
+ ---
6
+
7
+ # /swl:briefing — Briefing proactivo bajo demanda
8
+
9
+ Análisis no solicitado del estado del proyecto destino (Fase 12, ADR-0036). El
10
+ hook `session-briefing.js` da el digest barato al abrir sesión; este comando es
11
+ el nivel profundo: re-presenta esas señales Y agrega las que cuestan (deps, grafo,
12
+ cobertura) con degradación funcional si la herramienta no está instalada.
13
+
14
+ Principio rector: **proponer es barato y siempre permitido; actuar requiere
15
+ autorización del usuario**. Este comando solo propone y analiza — nunca aplica
16
+ cambios sin que el usuario los pida.
17
+
18
+ ## Uso
19
+
20
+ ```
21
+ /swl:briefing # señales baratas + análisis profundo completo
22
+ /swl:briefing rapido # solo las 5 señales del hook (sin deps/grafo/cobertura)
23
+ ```
24
+
25
+ ## Paso 1 — Señales baratas (mismas del hook)
26
+
27
+ Ejecuta los recolectores de filesystem y presenta el digest sin tope de 5 (aquí
28
+ sí caben todas, no hay presupuesto de latencia de arranque):
29
+
30
+ ```bash
31
+ # Subcomando del CLI (resuelve cross-scope; ver docs/invocacion-cli-cross-scope.md)
32
+ swl-ses briefing
33
+ # fallback: npx -y @saulwade/swl-ses@latest briefing
34
+ ```
35
+
36
+ Las 5 categorías: `adr-vencido`, `deuda-trigger`, `nudges-pendientes`,
37
+ `gate-calibracion`, `continue-here`. Si `rapido`, terminar aquí.
38
+
39
+ ## Paso 2 — Análisis profundo (opt-in, con degradación)
40
+
41
+ Para cada herramienta, **validar antes de invocar** (patrón "validar antes de
42
+ invocar"): si no está disponible, reportar "no disponible, omitido" y continuar —
43
+ nunca fallar el briefing por una herramienta ausente.
44
+
45
+ ### 2.1 — Audit de dependencias del proyecto destino
46
+
47
+ Detectar el ecosistema y correr el audit nativo:
48
+
49
+ ```bash
50
+ # Node
51
+ [ -f package.json ] && npm audit --omit=dev 2>/dev/null | tail -5
52
+ # Python
53
+ [ -f requirements.txt -o -f pyproject.toml ] && (command -v pip-audit >/dev/null && pip-audit 2>/dev/null | tail -5 || echo "pip-audit no instalado — omitido")
54
+ ```
55
+
56
+ Reportar CVEs HIGH/CRITICAL con la acción concreta (`npm audit fix`, bump de
57
+ versión). Sin lockfile o sin gestor → omitir.
58
+
59
+ ### 2.2 — Cobertura vs umbral
60
+
61
+ Si el proyecto define cobertura, comparar contra el umbral del proyecto (80% por
62
+ defecto). Si no hay reporte reciente, indicar el comando para generarlo en vez de
63
+ correrlo (puede ser caro):
64
+
65
+ ```
66
+ Para medir cobertura: <runner del proyecto> --coverage
67
+ ```
68
+
69
+ ### 2.3 — Hubs del grafo tocados sin revisión
70
+
71
+ Si el MCP `code-review-graph` está disponible (tools `mcp__code-review-graph__*`
72
+ registradas o deferred), consultar los nodos hub modificados en los últimos N
73
+ commits sin revisión asociada. Si no está disponible → omitir con nota.
74
+
75
+ ### 2.4 — Drift de feature-list
76
+
77
+ ```bash
78
+ swl-ses derivar-feature-list --check 2>/dev/null; echo "exit: $?"
79
+ ```
80
+
81
+ Exit 2 → reportar que `HOJA-RUTA.md` y `feature-list.json` divergieron, con la
82
+ acción `swl-ses derivar-feature-list` para regenerar.
83
+
84
+ ### 2.5 — Deuda con trigger en prosa libre
85
+
86
+ El hook solo evalúa triggers verificables por fecha (D-16). Aquí, leer
87
+ `.planning/DEUDA-TECNICA.md` y evaluar con criterio los triggers en prosa
88
+ ("≥2 clientes reportan", "p95 > 60s documentado") contra el estado real del
89
+ proyecto. Reportar los que parezcan cumplidos para revisión del usuario.
90
+
91
+ ## Paso 3 — Presentación y telemetría
92
+
93
+ Presenta el briefing agrupado por prioridad (continue-here → gates → deuda →
94
+ ADRs → nudges → hallazgos profundos). Cada ítem con su acción ejecutable.
95
+
96
+ Tras presentar, el usuario decide qué accionar. NO ejecutar acciones de mutación
97
+ (cerrar deuda, promover gates, aplicar fixes) sin que el usuario lo pida — este
98
+ comando es propositivo (separación PROPONER/ACTUAR, ADR-0037 pendiente).
99
+
100
+ Si el usuario acciona una señal en esta sesión (ejecuta el comando sugerido), esa
101
+ resolución la captura la telemetría de aceptación del hook en la siguiente sesión
102
+ (la señal desaparece del recolector → cuenta como "actuada", D-18).
103
+
104
+ ## Cuándo NO usar este comando
105
+
106
+ - En cada turno de una sesión: el briefing es por sesión, no por mensaje. El hook
107
+ ya cubre el inicio; este comando es para cuando el usuario pide el detalle.
108
+ - Para aplicar las acciones propuestas: este comando propone, no ejecuta. Usar el
109
+ comando concreto de cada señal (`/swl:evolucion-estado`, `/swl:verificar`, etc.).
110
+ - En proyectos sin `.planning/`: no hay señales que recolectar.
111
+
112
+ ## Gotchas
113
+
114
+ - **Herramienta ausente ≠ error**: si `npm audit`, `pip-audit` o el grafo no están,
115
+ el briefing los omite con nota y sigue. Nunca abortar por una dependencia opt-in.
116
+ - **No re-listar lo que el hook ya mostró hoy**: el hook aplica dedupe diario; este
117
+ comando ignora el dedupe a propósito (lo invoca el usuario, quiere ver todo).
118
+ - **`code-review-graph` deferred ≠ ausente**: si las tools aparecen como deferred,
119
+ cargar su schema con `ToolSearch` antes de concluir que no está disponible.
@@ -100,8 +100,6 @@ Agentes desactivados: {lista resumida}
100
100
 
101
101
  - El **orquestador-swl** lee `.planning/CONTEXTO.md` al inicio de cada delegación
102
102
  para decidir qué agentes invocar.
103
- - El hook **`linea-estado.js`** lee el modo activo para mostrar `[DEV]`, `[REVIEW]`
104
- o `[RESEARCH]` en la barra de estado del terminal.
105
103
  - Los agentes marcados como desactivados en el contexto **no se invocan** aunque
106
104
  la tarea lo justifique — se registra en ESTADO.md que están inhibidos por el contexto.
107
105