@saulwade/swl-ses 2.6.0 → 2.6.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 (207) hide show
  1. package/CLAUDE.md +197 -197
  2. package/README.md +600 -600
  3. package/agentes/_intent-spec.md +73 -73
  4. package/agentes/_propose-step.md +90 -90
  5. package/agentes/accesibilidad-wcag-swl.md +690 -690
  6. package/agentes/arquitecto-swl.md +267 -267
  7. package/agentes/auto-evolucion-swl.md +932 -932
  8. package/agentes/backend-csharp-swl.md +420 -420
  9. package/agentes/backend-go-swl.md +390 -390
  10. package/agentes/backend-java-swl.md +281 -281
  11. package/agentes/backend-rust-swl.md +364 -364
  12. package/agentes/backend-workers-swl.md +482 -482
  13. package/agentes/cloud-infra-swl.md +509 -509
  14. package/agentes/consolidador-swl.md +541 -541
  15. package/agentes/depurador-swl.md +352 -352
  16. package/agentes/devops-ci-swl.md +400 -400
  17. package/agentes/disenador-ui-swl.md +569 -569
  18. package/agentes/documentador-swl.md +345 -345
  19. package/agentes/frontend-angular-swl.md +621 -621
  20. package/agentes/frontend-css-swl.md +716 -716
  21. package/agentes/frontend-react-swl.md +692 -692
  22. package/agentes/frontend-swl.md +496 -496
  23. package/agentes/frontend-tailwind-swl.md +826 -826
  24. package/agentes/investigador-swl.md +432 -432
  25. package/agentes/investigador-ux-swl.md +505 -505
  26. package/agentes/migrador-swl.md +442 -442
  27. package/agentes/mobile-android-swl.md +511 -511
  28. package/agentes/mobile-cross-swl.md +541 -541
  29. package/agentes/mobile-ios-swl.md +502 -502
  30. package/agentes/mobile-testing-swl.md +302 -302
  31. package/agentes/nemesis-auditor-swl.md +285 -285
  32. package/agentes/observabilidad-swl.md +438 -438
  33. package/agentes/pagos-swl.md +310 -310
  34. package/agentes/perfilador-usuario-swl.md +321 -321
  35. package/agentes/planificador-swl.md +399 -399
  36. package/agentes/producto-prd-swl.md +589 -589
  37. package/agentes/red-team-swl.md +218 -218
  38. package/agentes/release-manager-swl.md +590 -590
  39. package/agentes/rendimiento-swl.md +713 -713
  40. package/agentes/revisor-angular-swl.md +278 -278
  41. package/agentes/revisor-csharp-swl.md +264 -264
  42. package/agentes/revisor-go-swl.md +259 -259
  43. package/agentes/revisor-java-swl.md +257 -257
  44. package/agentes/revisor-kotlin-swl.md +273 -273
  45. package/agentes/revisor-nextjs-swl.md +281 -281
  46. package/agentes/revisor-php-swl.md +271 -271
  47. package/agentes/revisor-react-swl.md +278 -278
  48. package/agentes/revisor-rust-swl.md +346 -346
  49. package/agentes/revisor-seguridad-swl.md +399 -399
  50. package/agentes/revisor-swift-swl.md +268 -268
  51. package/agentes/revisor-typescript-swl.md +346 -346
  52. package/agentes/tdd-qa-swl.md +393 -393
  53. package/comandos/swl/actualizar.md +174 -174
  54. package/comandos/swl/adoptar-proyecto.md +265 -265
  55. package/comandos/swl/aprender.md +836 -836
  56. package/comandos/swl/aprobar-plan.md +146 -146
  57. package/comandos/swl/auditar-deps.md +134 -134
  58. package/comandos/swl/autoresearch.md +264 -264
  59. package/comandos/swl/ayuda.md +224 -224
  60. package/comandos/swl/brainstorm.md +51 -51
  61. package/comandos/swl/briefing.md +119 -119
  62. package/comandos/swl/checkpoint.md +325 -325
  63. package/comandos/swl/claudemd.md +234 -234
  64. package/comandos/swl/compactar.md +310 -310
  65. package/comandos/swl/configurar-ci.md +235 -235
  66. package/comandos/swl/contexto.md +110 -110
  67. package/comandos/swl/contribuir.md +233 -233
  68. package/comandos/swl/crear-skill.md +292 -292
  69. package/comandos/swl/cron.md +194 -194
  70. package/comandos/swl/discutir-fase.md +169 -169
  71. package/comandos/swl/ejecutar-fase.md +233 -233
  72. package/comandos/swl/evaluar-skill.md +520 -520
  73. package/comandos/swl/evolucion-continua.md +73 -73
  74. package/comandos/swl/evolucionar.md +267 -267
  75. package/comandos/swl/exportar-vault.md +583 -583
  76. package/comandos/swl/fix.md +118 -118
  77. package/comandos/swl/gateway.md +158 -158
  78. package/comandos/swl/inbox.md +116 -116
  79. package/comandos/swl/instalar.md +220 -220
  80. package/comandos/swl/instintos.md +86 -86
  81. package/comandos/swl/mapear-codebase.md +312 -312
  82. package/comandos/swl/mcp-status.md +175 -175
  83. package/comandos/swl/modelo.md +100 -100
  84. package/comandos/swl/nemesis.md +433 -433
  85. package/comandos/swl/notificaciones.md +299 -299
  86. package/comandos/swl/nuevo-proyecto.md +251 -251
  87. package/comandos/swl/planear-fase.md +263 -263
  88. package/comandos/swl/plugins.md +256 -256
  89. package/comandos/swl/predecir.md +169 -169
  90. package/comandos/swl/reflect-skills.md +125 -125
  91. package/comandos/swl/release.md +450 -450
  92. package/comandos/swl/revisar-impacto.md +201 -201
  93. package/comandos/swl/revisar.md +330 -330
  94. package/comandos/swl/seguridad.md +189 -189
  95. package/comandos/swl/sesiones.md +200 -200
  96. package/comandos/swl/skill-search.md +113 -113
  97. package/comandos/swl/status.md +345 -345
  98. package/comandos/swl/verificar.md +817 -817
  99. package/comandos/swl/wiki.md +620 -620
  100. package/gateway/cron/jobs.example.json +12 -12
  101. package/habilidades/auto-evolucion-protocolo/SKILL.md +294 -294
  102. package/habilidades/backend-async-postgres-testing/SKILL.md +2 -1
  103. package/habilidades/changelog-generator/SKILL.md +174 -174
  104. package/habilidades/compactacion-contexto/SKILL.md +2 -1
  105. package/habilidades/contenedores-docker/SKILL.md +4 -2
  106. package/habilidades/doubt-driven-review/SKILL.md +207 -207
  107. package/habilidades/drift-detection/SKILL.md +1 -1
  108. package/habilidades/ejecutar-task-iterativo/SKILL.md +278 -278
  109. package/habilidades/extractor-de-aprendizajes/SKILL.md +8 -2
  110. package/habilidades/git-worktrees-paralelo/SKILL.md +19 -1
  111. package/habilidades/harness-claude-code/SKILL.md +314 -314
  112. package/habilidades/instalar-sistema/SKILL.md +227 -227
  113. package/habilidades/planear-fase/SKILL.md +358 -358
  114. package/habilidades/prevencion-sobreingenieria/recursos/soluciones-nativas.md +166 -166
  115. package/habilidades/prevencion-sobreingenieria/recursos/variables-residuales-post-refactor.md +85 -85
  116. package/habilidades/proceso-ingenieria-requerimientos/SKILL.md +147 -147
  117. package/habilidades/release-semver/SKILL.md +2 -2
  118. package/habilidades/tdd-workflow/SKILL.md +749 -749
  119. package/hooks/agente-lifecycle.js +1 -1
  120. package/hooks/audit-trail.js +1 -1
  121. package/hooks/auto-consolidacion.js +1 -1
  122. package/hooks/captura-acciones-post.js +1 -1
  123. package/hooks/captura-acciones-session.js +1 -1
  124. package/hooks/captura-feedback-usuario.js +1 -1
  125. package/hooks/contexto-iteracion.js +1 -1
  126. package/hooks/contexto-subagente.js +68 -68
  127. package/hooks/degradacion-instintos.js +1 -1
  128. package/hooks/grafo-contexto.js +1 -1
  129. package/hooks/guardrail-modelo.js +1 -1
  130. package/hooks/inbox-aviso.js +1 -1
  131. package/hooks/inyeccion-contexto.js +1 -1
  132. package/hooks/lib/agent-matcher.js +1 -1
  133. package/hooks/lib/agent-routing.js +1 -1
  134. package/hooks/lib/captura-acciones.js +1 -1
  135. package/hooks/lib/etapa-metricas.js +1 -1
  136. package/hooks/lib/evolution-tracker.js +1 -1
  137. package/hooks/lib/gateway-notify.js +193 -193
  138. package/hooks/lib/mcp-health.js +1 -1
  139. package/hooks/lib/notificacion-formato.js +58 -0
  140. package/hooks/lib/nudge-tracker.js +1 -1
  141. package/hooks/lib/otlp-exporter.js +1 -1
  142. package/hooks/lib/propose-step.js +1 -1
  143. package/hooks/lib/raiz-proyecto.js +127 -102
  144. package/hooks/lib/run-log.js +1 -1
  145. package/hooks/lib/singleton-guard.js +20 -13
  146. package/hooks/lib/telegram-cliente.js +11 -3
  147. package/hooks/notificacion-telegram.js +13 -3
  148. package/hooks/preservar-estado-pre-compact.js +1 -1
  149. package/hooks/registro-turnos.js +1 -1
  150. package/hooks/resumen-sesion.js +1 -1
  151. package/hooks/risk-scoring.js +1 -1
  152. package/hooks/session-briefing.js +1 -1
  153. package/hooks/spec-gate.js +1 -1
  154. package/hooks/sugerir-regenerar-inventario.js +1 -1
  155. package/hooks/tdd-gate.js +1 -1
  156. package/hooks/telemetria-agentes.js +1 -1
  157. package/hooks/telemetria-skill-routing.js +1 -1
  158. package/hooks/tracking-costos.js +1 -1
  159. package/hooks/validar-formato-post-subagente.js +1 -1
  160. package/hooks/validar-intent-spec.js +1 -1
  161. package/hooks/validar-planning-paths.js +1 -1
  162. package/llms.txt +29 -29
  163. package/manifiestos/canonical-hashes.json +5588 -5257
  164. package/manifiestos/hooks-config.json +469 -469
  165. package/manifiestos/invariantes-criticos.json +30 -30
  166. package/manifiestos/modulos.json +1429 -1428
  167. package/manifiestos/skills-lock.json +1275 -1275
  168. package/package.json +94 -94
  169. package/plugin.json +369 -369
  170. package/scripts/auditar-clases-conocidas.js +134 -134
  171. package/scripts/bootstrap-instintos.js +85 -14
  172. package/scripts/canario-hooks.js +166 -166
  173. package/scripts/cli/autonomia.js +23 -23
  174. package/scripts/cli/benchmark-memoria.js +37 -37
  175. package/scripts/cli/ciclo-autonomo.js +73 -73
  176. package/scripts/cli/ciclo-fase-b.js +102 -102
  177. package/scripts/cli/guardrail-metrics.js +39 -39
  178. package/scripts/cli/memoria-search.js +69 -69
  179. package/scripts/cli/nudge-accionar.js +39 -39
  180. package/scripts/cli/run-eval.js +38 -38
  181. package/scripts/doctor.js +26 -3
  182. package/scripts/evidencia-valor.js +101 -101
  183. package/scripts/field-report.js +16 -16
  184. package/scripts/instalador.js +13 -0
  185. package/scripts/lib/activar-hooks-proyecto.js +116 -116
  186. package/scripts/lib/ciclo-autonomo/candidatos.js +174 -174
  187. package/scripts/lib/ciclo-autonomo/config.js +165 -165
  188. package/scripts/lib/ciclo-autonomo/drenador-feedback.js +174 -174
  189. package/scripts/lib/ciclo-autonomo/fallback.js +77 -77
  190. package/scripts/lib/ciclo-autonomo/guard-convivencia.js +139 -139
  191. package/scripts/lib/ciclo-autonomo/higiene-nudges.js +112 -112
  192. package/scripts/lib/ciclo-autonomo/index.js +301 -301
  193. package/scripts/lib/ciclo-autonomo/lock.js +124 -124
  194. package/scripts/lib/ciclo-autonomo/presupuesto.js +122 -122
  195. package/scripts/lib/ciclo-autonomo/puente-degradacion.js +240 -240
  196. package/scripts/lib/ciclo-autonomo/runner-fase-b.js +248 -248
  197. package/scripts/lib/ciclo-autonomo/writer-instintos.js +190 -190
  198. package/scripts/lib/ciclo-autonomo/yaml-instintos.js +535 -535
  199. package/scripts/lib/evidencia-valor.js +228 -228
  200. package/scripts/lib/expandir-targets.js +71 -71
  201. package/scripts/lib/limpiar-basura-global.js +161 -0
  202. package/scripts/lib/toml-merge.js +204 -204
  203. package/scripts/mcp-server/auth.js +105 -105
  204. package/scripts/mcp-server/cache.js +106 -106
  205. package/scripts/tui/pantallas/install-wizard.js +403 -403
  206. package/instintos/.backups/perfil-usuario.yaml.2026-07-10-165128.bak +0 -53
  207. package/instintos/.backups/proyecto.yaml.2026-07-10-165128.bak +0 -372
@@ -1,53 +0,0 @@
1
- # Perfil de Usuario — Modelo persistente entre sesiones
2
- # Generado y mantenido por agentes/perfilador-usuario-swl.md
3
- # Alimentado por hooks/actualizar-perfil-usuario.js (acumula señales en .planning/perfil-usuario/dirty.json)
4
- # NUNCA editar a mano datos con confidence >= 0.9 sin contraevidencia documentada
5
- # Formato estandarizado v1.0
6
-
7
- version: "1.0"
8
- generado: "2026-04-18"
9
- actualizado: "2026-04-18"
10
- total_senales_consolidadas: 0
11
-
12
- identidad:
13
- rol: null
14
- rol_confidence: 0.0
15
- rol_fuentes: []
16
- anos_experiencia: null
17
- zonas_horarias_activas: []
18
-
19
- stack_preferido: []
20
- # Estructura de entrada:
21
- # - tecnologia: "Python"
22
- # confidence: 0.9
23
- # evidencia: "87% de archivos modificados en último mes"
24
-
25
- patrones_trabajo: []
26
- # - patron: "pide 'investigar antes de editar'"
27
- # confidence: 0.95
28
- # evidencia_count: 5
29
- # fuente: "CLAUDE.md + feedback recurrente"
30
-
31
- correcciones_repetidas: []
32
- # - correccion: "no usar emojis"
33
- # confidence: 0.9
34
- # ocurrencias: 4
35
- # primera: "YYYY-MM-DD"
36
- # ultima: "YYYY-MM-DD"
37
-
38
- decisiones_validadas: []
39
- # - decision: "Node.js zero-deps en hooks/lib/"
40
- # confidence: 1.0
41
- # fuente: "CLAUDE.md regla explícita"
42
- # confirmado_en: ["YYYY-MM-DD"]
43
-
44
- preferencias_comunicacion:
45
- idioma: "es-MX"
46
- formalidad: null # tuteo-tecnico | ustedeo-formal | null (no observado)
47
- longitud_respuestas: null # breve | media | extensa | null
48
- detalle_explicaciones: null
49
- confirmacion_acciones: null # siempre | riesgo-alto | nunca
50
-
51
- limites_explicitos:
52
- no_guardar: [] # Categorías que el usuario pidió no memorizar
53
- no_sugerir: [] # Stacks/frameworks/enfoques a evitar en sugerencias
@@ -1,372 +0,0 @@
1
- # Instintos del Proyecto — SWL-SES
2
- # Generado automáticamente por scripts/bootstrap-instintos.js desde .planning/APRENDIZAJES.md
3
- # Formato estandarizado v1.0
4
-
5
- version: "1.0"
6
- generado: "2026-04-19"
7
- total_instintos: 26
8
-
9
- instintos:
10
- - id: inst-001
11
- pattern: "Heurística de paralelización del orquestador"
12
- description: "Paralelizar (múltiples Agent() en un solo mensaje) cuando las tareas son independientes y no comparten archivos. Ir secuencial cuando hay dependencias de datos entre agentes."
13
- confidence: 0.8
14
- scope: project
15
- source: "APRENDIZAJES.md"
16
- evidence_count: 1
17
- last_validated: "2026-03-29"
18
- contradictions: 0
19
- status: active
20
- tags: ["decision", "arquitectura"]
21
- created_at: "2026-04-19"
22
- seccion_origen: "Decisiones de arquitectura"
23
-
24
- - id: inst-002
25
- pattern: "Pipeline mobile"
26
- description: "producto-prd-swl → mobile-cross-swl (decisión) → mobile-android/ios-swl → tdd-qa-swl. La decisión de framework (React Native vs Flutter vs nativo) se toma en mobile-cross-swl, no en el orquestador."
27
- confidence: 0.8
28
- scope: project
29
- source: "APRENDIZAJES.md"
30
- evidence_count: 1
31
- last_validated: "2026-03-29"
32
- contradictions: 0
33
- status: active
34
- tags: ["decision", "arquitectura"]
35
- created_at: "2026-04-19"
36
- seccion_origen: "Decisiones de arquitectura"
37
-
38
- - id: inst-003
39
- pattern: "Fragmentación de criterio en CLAUDE.md"
40
- description: "Con 53 agentes compartiendo el mismo CLAUDE.md, las reglas deben ser genéricas o explícitamente marcadas con su alcance. Una regla de Angular escrita genéricamente confunde al agente de backend."
41
- confidence: 0.8
42
- scope: project
43
- source: "APRENDIZAJES.md"
44
- evidence_count: 1
45
- last_validated: "2026-03-29"
46
- contradictions: 0
47
- status: active
48
- tags: ["decision", "arquitectura"]
49
- created_at: "2026-04-19"
50
- seccion_origen: "Decisiones de arquitectura"
51
-
52
- - id: inst-004
53
- pattern: "Preservación de evoluciones en actualización"
54
- description: "`decideUpdateStrategy()` debe usar `evolvedFrom <= versionNueva` (no igualdad exacta) para preservar evoluciones de versiones anteriores. Tres bugs en cadena descubiertos y corregidos."
55
- confidence: 0.8
56
- scope: project
57
- source: "APRENDIZAJES.md"
58
- evidence_count: 1
59
- last_validated: "2026-04-02"
60
- contradictions: 0
61
- status: active
62
- tags: ["decision", "arquitectura"]
63
- created_at: "2026-04-19"
64
- seccion_origen: "Decisiones de arquitectura"
65
-
66
- - id: inst-005
67
- pattern: "CLAUDE.md lean reduce 77% de tokens por turno"
68
- description: "Mover tablas de inventario detalladas a INVENTARIO.md y mantener CLAUDE.md como índice compacto ahorra ~4,585 tokens/turno sin perder funcionalidad."
69
- confidence: 0.8
70
- scope: project
71
- source: "APRENDIZAJES.md"
72
- evidence_count: 1
73
- last_validated: "2026-04-03"
74
- contradictions: 0
75
- status: active
76
- tags: ["decision", "arquitectura"]
77
- created_at: "2026-04-19"
78
- seccion_origen: "Decisiones de arquitectura"
79
-
80
- - id: inst-006
81
- pattern: "Detección automática de stack tecnológico"
82
- description: "`detectarTecnologias()` con 40+ patrones (packages, configFiles, configContent) alimenta agent-matcher y model-router para asignación automática de agentes y skills."
83
- confidence: 0.8
84
- scope: project
85
- source: "APRENDIZAJES.md"
86
- evidence_count: 1
87
- last_validated: "2026-04-06"
88
- contradictions: 0
89
- status: active
90
- tags: ["decision", "arquitectura"]
91
- created_at: "2026-04-19"
92
- seccion_origen: "Decisiones de arquitectura"
93
-
94
- - id: inst-007
95
- pattern: "stderr en hooks causa error en Claude Code"
96
- description: "Nunca escribir a stderr en hooks — Claude Code lo interpreta como error del hook. Usar stdout para mensajes y exit code 0 para advertencias, exit code 2 para bloqueos."
97
- confidence: 0.7
98
- scope: project
99
- source: "APRENDIZAJES.md"
100
- evidence_count: 1
101
- last_validated: "2026-04-01"
102
- contradictions: 0
103
- status: active
104
- tags: ["anti-patron"]
105
- created_at: "2026-04-19"
106
- seccion_origen: "Anti-patrones detectados"
107
-
108
- - id: inst-008
109
- pattern: "Hook que bloquea por error interno"
110
- description: "Todo hook debe envolver su lógica en try/catch y nunca bloquear por errores propios. Solo bloquear por violaciones reales de seguridad o calidad."
111
- confidence: 0.7
112
- scope: project
113
- source: "APRENDIZAJES.md"
114
- evidence_count: 1
115
- last_validated: "2026-04-01"
116
- contradictions: 0
117
- status: active
118
- tags: ["anti-patron"]
119
- created_at: "2026-04-19"
120
- seccion_origen: "Anti-patrones detectados"
121
-
122
- - id: inst-009
123
- pattern: "Archivos evolucionados sin marcar"
124
- description: "Si un agente, skill o comando es modificado por `/swl:aprender` o `/swl:evolucionar` sin `markAsEvolved()`, la próxima actualización lo sobreescribe. El marcado en frontmatter es obligatorio."
125
- confidence: 0.7
126
- scope: project
127
- source: "APRENDIZAJES.md"
128
- evidence_count: 1
129
- last_validated: "2026-04-02"
130
- contradictions: 0
131
- status: active
132
- tags: ["anti-patron"]
133
- created_at: "2026-04-19"
134
- seccion_origen: "Anti-patrones detectados"
135
-
136
- - id: inst-010
137
- pattern: "Agente debilita config de linter en vez de corregir código"
138
- description: "Proteger archivos de configuración (.eslintrc, tsconfig.json, .prettierrc, etc.) con advertencia que redirige a corregir el código fuente."
139
- confidence: 0.7
140
- scope: project
141
- source: "APRENDIZAJES.md"
142
- evidence_count: 1
143
- last_validated: "2026-04-06"
144
- contradictions: 0
145
- status: active
146
- tags: ["anti-patron"]
147
- created_at: "2026-04-19"
148
- seccion_origen: "Anti-patrones detectados"
149
-
150
- - id: inst-011
151
- pattern: "`.claude/settings.json` no se commitea — hooks deben auto-documentarse"
152
- description: "`.claude/` está en `.gitignore`. Al agregar hooks nuevos (PreCompact, SubagentStop, PostToolUseFailure), documentar los eventos y matchers esperados en los comentarios de cabecera del archivo `.js` del hook, para que otro desarrollador pueda reconstruir `settings.json` desde los fuentes."
153
- confidence: 0.7
154
- scope: project
155
- source: "APRENDIZAJES.md"
156
- evidence_count: 1
157
- last_validated: "2026-04-10"
158
- contradictions: 0
159
- status: active
160
- tags: ["anti-patron"]
161
- created_at: "2026-04-19"
162
- seccion_origen: "Anti-patrones detectados"
163
-
164
- - id: inst-012
165
- pattern: "Verificar existencia de skills antes de crear nuevos"
166
- description: "Antes de implementar un skill \"nuevo\", buscar con `glob` en `habilidades/` si ya existe. En la sesión v5.4.0, 4 de 5 componentes propuestos como nuevos ya existían con contenido completo (redis-experto, mongodb-experto, kubernetes-orquestacion, graphql-experto)."
167
- confidence: 0.7
168
- scope: project
169
- source: "APRENDIZAJES.md"
170
- evidence_count: 1
171
- last_validated: "2026-04-10"
172
- contradictions: 0
173
- status: active
174
- tags: ["anti-patron"]
175
- created_at: "2026-04-19"
176
- seccion_origen: "Anti-patrones detectados"
177
-
178
- - id: inst-013
179
- pattern: "Patrones SQLAlchemy async"
180
- description: "`selectinload()` obligatorio en toda relación accedida en serialización Pydantic. `lazy=\"selectin\"` para relaciones frecuentes. Services no hacen `db.commit()`."
181
- confidence: 0.6
182
- scope: project
183
- source: "APRENDIZAJES.md"
184
- evidence_count: 1
185
- last_validated: "2026-03-29"
186
- contradictions: 0
187
- status: active
188
- tags: ["patron"]
189
- created_at: "2026-04-19"
190
- seccion_origen: "Patrones exitosos"
191
-
192
- - id: inst-014
193
- pattern: "Circuit breaker en hooks"
194
- description: "Degradar hook automáticamente tras 3 fallos consecutivos, half-open recovery a los 5 minutos. Previene cascadas de fallos en sesiones largas."
195
- confidence: 0.6
196
- scope: project
197
- source: "APRENDIZAJES.md"
198
- evidence_count: 1
199
- last_validated: "2026-04-01"
200
- contradictions: 0
201
- status: active
202
- tags: ["patron"]
203
- created_at: "2026-04-19"
204
- seccion_origen: "Patrones exitosos"
205
-
206
- - id: inst-015
207
- pattern: "Auto-consolidación patrón autoDream"
208
- description: "Sugerir `/swl:aprender` cuando pasan >= 24h y >= 5 sesiones nuevas. Lock basado en mtime con staleness de 1h."
209
- confidence: 0.6
210
- scope: project
211
- source: "APRENDIZAJES.md"
212
- evidence_count: 1
213
- last_validated: "2026-04-02"
214
- contradictions: 0
215
- status: active
216
- tags: ["patron"]
217
- created_at: "2026-04-19"
218
- seccion_origen: "Patrones exitosos"
219
-
220
- - id: inst-016
221
- pattern: "toolBudget por agente"
222
- description: "Presupuesto de tool calls (simple/standard/complex) en el frontmatter. Los revisores con budget 10/20/35, los implementadores con 15/30/60. Evita desperdicio de tool calls en tareas simples."
223
- confidence: 0.6
224
- scope: project
225
- source: "APRENDIZAJES.md"
226
- evidence_count: 1
227
- last_validated: "2026-04-06"
228
- contradictions: 0
229
- status: active
230
- tags: ["patron"]
231
- created_at: "2026-04-19"
232
- seccion_origen: "Patrones exitosos"
233
-
234
- - id: inst-017
235
- pattern: "Write-complete-test-once para slices simples"
236
- description: "Para slices ≤3 archivos y ≤100 líneas: escribir solución completa y testear una sola vez al final. Solo iterar si el test falla. Reduce 40-60% de tool calls."
237
- confidence: 0.6
238
- scope: project
239
- source: "APRENDIZAJES.md"
240
- evidence_count: 1
241
- last_validated: "2026-04-06"
242
- contradictions: 0
243
- status: active
244
- tags: ["patron"]
245
- created_at: "2026-04-19"
246
- seccion_origen: "Patrones exitosos"
247
-
248
- - id: inst-018
249
- pattern: "Clasificación automática de mensajes del usuario"
250
- description: "Hook UserPromptSubmit con 9 categorías por regex español+inglés. Inyecta hints de routing sin bloquear ni modificar el mensaje. Costo ~0 en tokens de input."
251
- confidence: 0.6
252
- scope: project
253
- source: "APRENDIZAJES.md"
254
- evidence_count: 1
255
- last_validated: "2026-04-06"
256
- contradictions: 0
257
- status: active
258
- tags: ["patron"]
259
- created_at: "2026-04-19"
260
- seccion_origen: "Patrones exitosos"
261
-
262
- - id: inst-019
263
- pattern: "Filtro de dominio ANTES de analizar repos externos"
264
- description: "Aplicar el filtro de CLAUDE.md (\"¿le sirve a un ingeniero de software en cualquier proyecto?\") como primer paso al evaluar repos en `temp/`. Ahorra 100% del tiempo de análisis en repos incompatibles. Ejemplo: `awesome-design-systems-master` (lista curada de enlaces, sin código) se descartó en <30 segundos."
265
- confidence: 0.6
266
- scope: project
267
- source: "APRENDIZAJES.md"
268
- evidence_count: 1
269
- last_validated: "2026-04-10"
270
- contradictions: 0
271
- status: active
272
- tags: ["patron"]
273
- created_at: "2026-04-19"
274
- seccion_origen: "Patrones exitosos"
275
-
276
- - id: inst-020
277
- pattern: "`package-lock.json` retiene versión anterior tras bump [CONFIRMADO x2]"
278
- description: "La versión aparece en 2 ubicaciones (líneas 3 y 9). Se actualiza con `npm install`, no con sed. Si se edita manualmente, verificar AMBAS ubicaciones. Confirmado el 2026-04-10 durante bump v5.3.4→v5.4.0."
279
- confidence: 0.6
280
- scope: project
281
- source: "APRENDIZAJES.md"
282
- evidence_count: 1
283
- last_validated: "2026-04-02"
284
- contradictions: 0
285
- status: active
286
- tags: ["gotcha"]
287
- created_at: "2026-04-19"
288
- seccion_origen: "Gotchas del sistema"
289
-
290
- - id: inst-021
291
- pattern: "APRENDIZAJES.md se infla con contenido no-accionable [CONFIRMADO x2]"
292
- description: "El hook `extraccion-aprendizajes.js` captura fragmentos de código y documentación como \"aprendizajes\". Requiere consolidación periódica para mantener calidad. Confirmado 2026-04-10: las entradas automáticas de línea 88+ siguen siendo fragmentos sin valor accionable."
293
- confidence: 0.6
294
- scope: project
295
- source: "APRENDIZAJES.md"
296
- evidence_count: 1
297
- last_validated: "2026-04-06"
298
- contradictions: 0
299
- status: active
300
- tags: ["gotcha"]
301
- created_at: "2026-04-19"
302
- seccion_origen: "Gotchas del sistema"
303
-
304
- - id: inst-022
305
- pattern: "Versión debe actualizarse en 15+ archivos — integrar checklist en `/swl:release` [CONFIRMADO x3]"
306
- description: "package.json, package-lock.json (2 ubicaciones), plugin.json, CLAUDE.md, INVENTARIO.md, HEALTH.md (3 ubicaciones), README.md, SETUP.md, AGENTS.md, COMMANDS.md, CHANGELOG.md, COMPACT.md, STATE.md. Confirmado el 2026-04-12 durante bump v5.4.10→v5.4.11: la lista completa son 15+ ubicaciones en 14 archivos distintos."
307
- confidence: 0.6
308
- scope: project
309
- source: "APRENDIZAJES.md"
310
- evidence_count: 1
311
- last_validated: "2026-04-06"
312
- contradictions: 0
313
- status: active
314
- tags: ["gotcha"]
315
- created_at: "2026-04-19"
316
- seccion_origen: "Gotchas del sistema"
317
-
318
- - id: inst-023
319
- pattern: "Skills fantasma en `skillsInvocables` rompen el grafo de dependencias"
320
- description: "Nunca referenciar nombres de skills inexistentes ni nombres de agentes en `skillsInvocables`. Ejemplo: `pagos-swl` referenciaba `\"seguridad\"` (skill inexistente, el real es `\"checklist-seguridad\"`) y `\"backend-node-swl\"` (nombre de agente, no de skill). Verificar existencia con `ls habilidades/ | grep nombre` antes de agregar."
321
- confidence: 0.6
322
- scope: project
323
- source: "APRENDIZAJES.md"
324
- evidence_count: 1
325
- last_validated: "2026-04-12"
326
- contradictions: 0
327
- status: active
328
- tags: ["gotcha"]
329
- created_at: "2026-04-19"
330
- seccion_origen: "Gotchas del sistema"
331
-
332
- - id: inst-024
333
- pattern: "Truncación de reportes de diagnóstico oculta problemas reales"
334
- description: "El `graph-builder.py` truncaba la lista de nodos huérfanos a 20, ocultando 81 de 101 problemas. Los reportes de diagnóstico NUNCA deben truncarse — mostrar el cuadro completo para tomar decisiones informadas."
335
- confidence: 0.6
336
- scope: project
337
- source: "APRENDIZAJES.md"
338
- evidence_count: 1
339
- last_validated: "2026-04-12"
340
- contradictions: 0
341
- status: active
342
- tags: ["gotcha"]
343
- created_at: "2026-04-19"
344
- seccion_origen: "Gotchas del sistema"
345
-
346
- - id: inst-025
347
- pattern: "`skillsInvocables: todos` debe expandirse a aristas reales en el grafo"
348
- description: "Los agentes con `skillsInvocables: todos` (planificador-swl, investigador-swl) no generaban aristas en el grafo. Sin expansión, su grado era 2 cuando el real es 126. El graph-builder.py ahora expande `todos` al set completo de skill_ids."
349
- confidence: 0.6
350
- scope: project
351
- source: "APRENDIZAJES.md"
352
- evidence_count: 1
353
- last_validated: "2026-04-12"
354
- contradictions: 0
355
- status: active
356
- tags: ["gotcha"]
357
- created_at: "2026-04-19"
358
- seccion_origen: "Gotchas del sistema"
359
-
360
- - id: inst-026
361
- pattern: "Formato mixto YAML-lista + CSV en `skillsInvocables` causa parsing roto"
362
- description: "`frontend-react-swl` y `disenador-ui-swl` tenían líneas `- item` debajo de una línea CSV en `skillsInvocables`. El parser YAML interpreta esto como estructura inválida. El formato DEBE ser CSV puro en una sola línea. `disenador-ui-swl` queda pendiente de corrección."
363
- confidence: 0.6
364
- scope: project
365
- source: "APRENDIZAJES.md"
366
- evidence_count: 1
367
- last_validated: "2026-04-12"
368
- contradictions: 0
369
- status: active
370
- tags: ["gotcha"]
371
- created_at: "2026-04-19"
372
- seccion_origen: "Gotchas del sistema"