@saulwade/swl-ses 2.2.0 → 2.2.3
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.
- package/CLAUDE.md +199 -196
- package/README.md +597 -579
- package/agentes/arquitecto-swl.md +0 -5
- package/agentes/backend-python-swl.md +0 -5
- package/agentes/implementador-swl.md +0 -5
- package/agentes/nemesis-auditor-swl.md +0 -5
- package/agentes/orquestador-swl.md +0 -5
- package/agentes/planificador-swl.md +0 -5
- package/agentes/revisor-codigo-swl.md +0 -5
- package/bin/swl-mcp-server.js +1 -1
- package/comandos/swl/adoptar-proyecto.md +253 -258
- package/comandos/swl/aprender.md +823 -828
- package/comandos/swl/claudemd.md +234 -239
- package/comandos/swl/ejecutar-fase.md +0 -5
- package/comandos/swl/nuevo-proyecto.md +200 -205
- package/comandos/swl/release.md +19 -5
- package/comandos/swl/revisar-impacto.md +0 -5
- package/habilidades/agent-browser/SKILL.md +0 -5
- package/habilidades/angular-moderno/SKILL.md +0 -5
- package/habilidades/api-rest-diseno/SKILL.md +0 -5
- package/habilidades/aprendizaje-continuo/SKILL.md +0 -5
- package/habilidades/auth-patrones/SKILL.md +0 -5
- package/habilidades/build-errors-nextjs/SKILL.md +0 -5
- package/habilidades/changelog-generator/SKILL.md +174 -179
- package/habilidades/checklist-seguridad/SKILL.md +0 -5
- package/habilidades/contenedores-docker/SKILL.md +0 -5
- package/habilidades/datos-etl/SKILL.md +0 -5
- package/habilidades/doc-sync/SKILL.md +0 -5
- package/habilidades/extractor-de-aprendizajes/SKILL.md +0 -5
- package/habilidades/fastapi-experto/SKILL.md +0 -5
- package/habilidades/frontend-avanzado/SKILL.md +0 -5
- package/habilidades/iam-secretos/SKILL.md +0 -5
- package/habilidades/manejo-errores/SKILL.md +0 -5
- package/habilidades/mapear-codebase/SKILL.md +0 -5
- package/habilidades/meta-skills-estandar/SKILL.md +0 -5
- package/habilidades/monitoring-alertas/SKILL.md +0 -5
- package/habilidades/nextjs-experto/SKILL.md +0 -5
- package/habilidades/nextjs-testing/SKILL.md +0 -5
- package/habilidades/node-experto/SKILL.md +0 -5
- package/habilidades/orquestacion-async/SKILL.md +0 -5
- package/habilidades/patrones-python/SKILL.md +227 -232
- package/habilidades/planear-fase/SKILL.md +336 -341
- package/habilidades/postgresql-experto/SKILL.md +0 -5
- package/habilidades/prevencion-sobreingenieria/SKILL.md +0 -5
- package/habilidades/protocolo-revision-swl/SKILL.md +0 -5
- package/habilidades/react-experto/SKILL.md +0 -5
- package/habilidades/release-semver/SKILL.md +0 -5
- package/habilidades/swl-claudemd/SKILL.md +0 -5
- package/habilidades/tdd-workflow/SKILL.md +710 -715
- package/habilidades/testing-python/SKILL.md +335 -340
- package/habilidades/verificar-trabajo/SKILL.md +0 -5
- package/hooks/lib/etapa-perfil-usuario.js +1 -1
- package/hooks/lib/evolution-tracker.js +191 -35
- package/hooks/resumen-sesion.js +4 -4
- package/llms.txt +1 -1
- package/manifiestos/canonical-hashes.json +1310 -0
- package/manifiestos/modulos.json +3 -0
- package/manifiestos/skills-lock.json +70 -70
- package/package.json +1 -1
- package/plugin.json +1 -1
- package/scripts/doctor.js +13 -0
- package/scripts/generar-canonical-hashes.js +147 -0
- package/scripts/instalador.js +140 -54
- package/scripts/lib/audit-evolved.js +76 -0
- package/scripts/lib/canonical-hash.js +94 -0
- package/scripts/lib/evolved-fuente.js +138 -0
- package/scripts/lib/manifiestos.js +1 -1
- package/scripts/publicar.js +42 -5
- package/scripts/remediar-evolved-instaladas.js +242 -0
- package/scripts/validar.js +14 -0
- package/scripts/vendor/claude-usage/__pycache__/scanner.cpython-314.pyc +0 -0
- package/scripts/verificar-evolucion.js +36 -0
- package/scripts/verificar-release.js +33 -0
- package/agentes/.evolved.json +0 -9
- package/comandos/swl/.evolved.json +0 -23
- package/habilidades/auth-patrones/.evolved.json +0 -9
- package/habilidades/extractor-de-aprendizajes/.evolved.json +0 -9
- package/habilidades/instalar-sistema/.evolved.json +0 -9
- package/habilidades/manejo-errores/.evolved.json +0 -9
- package/habilidades/node-experto/.evolved.json +0 -9
- package/habilidades/release-semver/.evolved.json +0 -9
package/comandos/swl/claudemd.md
CHANGED
|
@@ -1,239 +1,234 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: swl:claudemd
|
|
3
|
-
description: Audita, refactoriza, valida o inicializa archivos CLAUDE.md según best practices Anthropic (ADR-0016). Subcomandos audit (analiza calidad), refactor (sugiere extracciones), check (verifica secciones canónicas), init-user (crea ~/.claude/CLAUDE.md template), init-project (genera CLAUDE.md raíz del proyecto).
|
|
4
|
-
allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
El
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
```
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
`
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
- `
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
- `
|
|
234
|
-
- `
|
|
235
|
-
|
|
236
|
-
## Exit codes
|
|
237
|
-
|
|
238
|
-
- `0` — OK o WARN (consultivo)
|
|
239
|
-
- `1` — ERROR o `--strict` + WARN
|
|
1
|
+
---
|
|
2
|
+
name: swl:claudemd
|
|
3
|
+
description: Audita, refactoriza, valida o inicializa archivos CLAUDE.md según best practices Anthropic (ADR-0016). Subcomandos audit (analiza calidad), refactor (sugiere extracciones), check (verifica secciones canónicas), init-user (crea ~/.claude/CLAUDE.md template), init-project (genera CLAUDE.md raíz del proyecto).
|
|
4
|
+
allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# /swl:claudemd — Tratamiento profesional de CLAUDE.md
|
|
8
|
+
|
|
9
|
+
Comando para auditar, refactorizar y mantener `CLAUDE.md` siguiendo las
|
|
10
|
+
cinco recomendaciones del video oficial Anthropic *"The CLAUDE.md file"*:
|
|
11
|
+
|
|
12
|
+
1. **Compacto** — empieza sin uno, agrega solo lo que tengas que corregir
|
|
13
|
+
2. **Stack arriba** — lenguaje, framework, ORM, BD
|
|
14
|
+
3. **Commands** — cómo correr dev, tests, lint, build
|
|
15
|
+
4. **Code style** — convenciones de indentación, exports, nombrado
|
|
16
|
+
5. **Conventions** — dónde van las cosas, qué patrones preferir
|
|
17
|
+
|
|
18
|
+
**Carga**: `Skill("swl-claudemd")` — contiene la lógica de auditoría, las
|
|
19
|
+
secciones canónicas, los umbrales de inflación y los templates de
|
|
20
|
+
generación. Delega análisis y criterios al skill.
|
|
21
|
+
|
|
22
|
+
## Subcomandos
|
|
23
|
+
|
|
24
|
+
| Subcomando | Propósito |
|
|
25
|
+
|---|---|
|
|
26
|
+
| `/swl:claudemd audit` | Audita el CLAUDE.md actual (líneas, bullets gigantes, secciones canónicas, @references, placeholders) |
|
|
27
|
+
| `/swl:claudemd check` | Como audit pero exit 1 si hay WARN — útil en pre-commit/CI |
|
|
28
|
+
| `/swl:claudemd refactor` | Sugiere extracciones a archivos `@`-referenciados (no modifica, solo propone diff) |
|
|
29
|
+
| `/swl:claudemd init-user` | Crea `~/.claude/CLAUDE.md` con template de preferencias personales si no existe |
|
|
30
|
+
| `/swl:claudemd init-project` | Genera CLAUDE.md raíz del proyecto detectando el stack actual |
|
|
31
|
+
|
|
32
|
+
Sin subcomando: equivale a `audit`.
|
|
33
|
+
|
|
34
|
+
## Cuándo usar
|
|
35
|
+
|
|
36
|
+
- Después de modificar manualmente CLAUDE.md (verifica calidad)
|
|
37
|
+
- Al inicio de un proyecto que no tenía CLAUDE.md (init-project)
|
|
38
|
+
- Al cambiar de máquina y querer transportar preferencias (init-user)
|
|
39
|
+
- En pre-commit hook si el proyecto trackea CLAUDE.md (check)
|
|
40
|
+
- Cuando el hook `claudemd-bloat-detector` emite nudge
|
|
41
|
+
|
|
42
|
+
## Ejecución de cada subcomando
|
|
43
|
+
|
|
44
|
+
### audit / check
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
npx -y @saulwade/swl-ses@latest audit-claudemd # output legible
|
|
48
|
+
npx -y @saulwade/swl-ses@latest audit-claudemd --json # output JSON estructurado
|
|
49
|
+
npx -y @saulwade/swl-ses@latest audit-claudemd --strict # exit 1 si WARN (modo check)
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
El subcomando `audit-claudemd` del CLI funciona con cualquier modo de instalación
|
|
53
|
+
(global vía `npm i -g`, npx puntual o local dev) porque resuelve el script via
|
|
54
|
+
el paquete npm, no via path relativo al CWD. Es independiente del proyecto desde
|
|
55
|
+
donde se invoque.
|
|
56
|
+
|
|
57
|
+
El veredicto puede ser:
|
|
58
|
+
|
|
59
|
+
- **OK** — cumple best practices, sin hallazgos
|
|
60
|
+
- **WARN** — tiene oportunidades de mejora (líneas excesivas, bullets
|
|
61
|
+
gigantes, secciones ausentes, sin @references)
|
|
62
|
+
- **ERROR** — no existe, tiene placeholders sin reemplazar, faltan
|
|
63
|
+
secciones críticas
|
|
64
|
+
|
|
65
|
+
### refactor
|
|
66
|
+
|
|
67
|
+
Lee el CLAUDE.md actual, identifica candidatos a extracción (bullets
|
|
68
|
+
monolíticos, secciones largas, contenido duplicable a `@references`) y
|
|
69
|
+
imprime el diff propuesto. **NO modifica el archivo** — el usuario
|
|
70
|
+
revisa y aplica manualmente o con `git apply`.
|
|
71
|
+
|
|
72
|
+
Patrones de extracción típicos:
|
|
73
|
+
|
|
74
|
+
| Si el bullet/sección contiene… | Mover a… |
|
|
75
|
+
|---|---|
|
|
76
|
+
| Variables de entorno opt-in | `docs/variables-entorno.md` |
|
|
77
|
+
| Reglas de gobernanza extensas | `docs/gobernanza.md` |
|
|
78
|
+
| Catálogo de comandos completo | `COMANDOS.md` (referenciar) |
|
|
79
|
+
| Mapa de propagación detallado | `docs/mapa-propagacion.md` |
|
|
80
|
+
| Convenciones de cada capa | `docs/convenciones-{capa}.md` |
|
|
81
|
+
|
|
82
|
+
### init-user
|
|
83
|
+
|
|
84
|
+
Verifica si existe `~/.claude/CLAUDE.md` (en Windows:
|
|
85
|
+
`%USERPROFILE%\.claude\CLAUDE.md`). Si no existe, genera template
|
|
86
|
+
mínimo:
|
|
87
|
+
|
|
88
|
+
```markdown
|
|
89
|
+
# CLAUDE.md (preferencias personales transversales)
|
|
90
|
+
|
|
91
|
+
> Este archivo aplica a TODOS mis proyectos. Las reglas específicas de
|
|
92
|
+
> proyecto van en el CLAUDE.md de la raíz del proyecto, no aquí.
|
|
93
|
+
|
|
94
|
+
## Mi rol y stack preferido
|
|
95
|
+
|
|
96
|
+
- Rol: [ej. ingeniero senior backend]
|
|
97
|
+
- Stack preferido: [ej. Python + FastAPI, TypeScript + Next.js]
|
|
98
|
+
- Herramientas habituales: [ej. Neovim, ripgrep, fd, gh CLI]
|
|
99
|
+
|
|
100
|
+
## Estilo de comunicación
|
|
101
|
+
|
|
102
|
+
- Idioma: español
|
|
103
|
+
- Formato preferido para respuestas: [breve / detallado / con tablas]
|
|
104
|
+
- Cuándo prefiero ver alternativas vs. una sola recomendación
|
|
105
|
+
|
|
106
|
+
## Patrones que aplico siempre
|
|
107
|
+
|
|
108
|
+
- [ej. "Antes de implementar, mostrar el plan"]
|
|
109
|
+
- [ej. "Tests para todo código nuevo, sin excepción"]
|
|
110
|
+
- [ej. "Commits atómicos en español, formato conventional"]
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Si ya existe, NO lo sobreescribe — sugiere añadir secciones faltantes.
|
|
114
|
+
|
|
115
|
+
### init-project
|
|
116
|
+
|
|
117
|
+
Detecta el stack del proyecto actual con `scripts/lib/detectar-stack-detallado.js`
|
|
118
|
+
y genera `./CLAUDE.md` mínimo con:
|
|
119
|
+
|
|
120
|
+
- Sección **Reglas obligatorias** que **DEBE** incluir como primera línea
|
|
121
|
+
bajo el encabezado:
|
|
122
|
+
```markdown
|
|
123
|
+
## Reglas obligatorias
|
|
124
|
+
|
|
125
|
+
Aplica la regla global `usar-sistema-swl.md` (matriz operacional del sistema
|
|
126
|
+
SWL), auto-cargada desde `.claude/rules/`. NO duplicar su contenido aquí.
|
|
127
|
+
```
|
|
128
|
+
Esta mención es obligatoria — recuerda la matriz operacional de uso del
|
|
129
|
+
sistema SWL. NO usar `@reglas/usar-sistema-swl.md`: la regla se auto-carga
|
|
130
|
+
desde `.claude/rules/` y un `@reglas/...` se rompe en proyectos downstream
|
|
131
|
+
(ahí no existe `reglas/`). Las demás reglas globales (`seguridad.md`,
|
|
132
|
+
`arquitectura.md`, etc.) también se auto-cargan desde `.claude/rules/` — NO
|
|
133
|
+
referenciarlas con `@reglas/...`; mencionarlas por nombre si hace falta.
|
|
134
|
+
- Sección **Reglas de máxima prioridad** con sub-sección obligatoria
|
|
135
|
+
**Cuatro principios de implementación (Karpathy)**:
|
|
136
|
+
```markdown
|
|
137
|
+
### Cuatro principios de implementación (Karpathy)
|
|
138
|
+
Antes de implementar, refactorizar o corregir bugs: (1) **pensar antes de codificar** (no asumir en silencio), (2) **simplicidad primero** (sin abstracciones especulativas), (3) **cambios quirúrgicos** (leer archivo completo antes de editar, no refactor de oportunidad), (4) **ejecución orientada a metas** (criterios verificables, test que reproduce bugs antes del fix). Detalle + 9 ejemplos MAL→BIEN: `Skill("prevencion-sobreingenieria")` + `recursos/EXAMPLES.md`.
|
|
139
|
+
```
|
|
140
|
+
Esta sub-sección es estándar SWL y cubre los gaps cognitivos más
|
|
141
|
+
frecuentes del agente sin agregar reglas específicas del proyecto.
|
|
142
|
+
- Sección **Stack** poblada (lenguaje, framework, ORM, package manager)
|
|
143
|
+
- Sección **Comandos** poblada (npm scripts detectados o comandos típicos)
|
|
144
|
+
- Sección **Code style** vacía con placeholders
|
|
145
|
+
- Sección **Conventions** vacía con placeholders
|
|
146
|
+
- Sección **@references** apuntando a `.planning/PROYECTO.md`,
|
|
147
|
+
`README.md`, etc. si existen
|
|
148
|
+
|
|
149
|
+
Si CLAUDE.md ya existe, **NO lo sobreescribe**. Sugiere correr
|
|
150
|
+
`/swl:claudemd refactor` para mejorar el actual. Si detecta que el CLAUDE.md
|
|
151
|
+
existente NO menciona la regla global `usar-sistema-swl` o NO menciona los cuatro
|
|
152
|
+
principios Karpathy (o `prevencion-sobreingenieria`), emitir hallazgo WARN
|
|
153
|
+
recomendando agregarlo manualmente.
|
|
154
|
+
|
|
155
|
+
### Validación síncrona post-generación
|
|
156
|
+
|
|
157
|
+
Tras `init-project` generar el archivo nuevo, ejecutar inmediatamente
|
|
158
|
+
`audit` sobre el resultado:
|
|
159
|
+
|
|
160
|
+
```bash
|
|
161
|
+
swl-ses audit-claudemd --json
|
|
162
|
+
# Fallback si el script no está en el proyecto destino (instalación global vía npm):
|
|
163
|
+
npx -y @saulwade/swl-ses@latest audit-claudemd --json
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
Veredicto esperado: `OK` (el template debe respetar el contrato por
|
|
167
|
+
construcción). Cualquier WARN/ERROR es bug del template — reportar al
|
|
168
|
+
usuario y abrir issue para corrección. Este check es parte del contrato
|
|
169
|
+
cruzado con `/swl:aprender` documentado en `@docs/contrato-aprender-claudemd.md`.
|
|
170
|
+
|
|
171
|
+
### audit — checks específicos sobre Karpathy
|
|
172
|
+
|
|
173
|
+
El subcomando `audit` verifica además de las dimensiones estándar:
|
|
174
|
+
|
|
175
|
+
- ¿El CLAUDE.md menciona los cuatro principios Karpathy (texto literal
|
|
176
|
+
"Karpathy" o nombres de los 4 principios) o referencia
|
|
177
|
+
`prevencion-sobreingenieria` con `Skill(...)` o `@reglas/`?
|
|
178
|
+
|
|
179
|
+
Si NO los menciona y el archivo tiene >50 líneas: emitir hallazgo WARN
|
|
180
|
+
recomendando agregar la sub-sección compacta (4 líneas) como guía de
|
|
181
|
+
implementación. NO emite WARN para CLAUDE.md mínimos (<50 LOC) ni para
|
|
182
|
+
archivos `~/.claude/CLAUDE.md` user-level (esos siguen otro contrato).
|
|
183
|
+
|
|
184
|
+
### audit — checks específicos sobre duplicación de reglas globales
|
|
185
|
+
|
|
186
|
+
El subcomando `audit` también detecta (dimensión 7) si CLAUDE.md duplica
|
|
187
|
+
reglas que ya viven en `~/.claude/rules/` y se cargan globalmente.
|
|
188
|
+
Consume el catálogo declarativo
|
|
189
|
+
`scripts/lib/reglas-globales-conocidas.json` que cataloga 6 reglas
|
|
190
|
+
conocidas:
|
|
191
|
+
|
|
192
|
+
- `brevedad-output.md` § Idioma obligatorio: español de México
|
|
193
|
+
- `brevedad-output.md` § Brevedad y eficiencia de output
|
|
194
|
+
- `git-coauthor.md` § Sin co-autores en commits
|
|
195
|
+
- `arreglar-al-detectar.md` § Detectar → Informar → Arreglar
|
|
196
|
+
- `debatir-antes-de-aceptar.md`
|
|
197
|
+
- `usar-context7.md`
|
|
198
|
+
|
|
199
|
+
Si detecta duplicación: emite hallazgo `duplicacion-reglas-globales`
|
|
200
|
+
severidad WARN con línea aproximada y remediación específica. NO bloquea
|
|
201
|
+
el comando — sirve como nudge para limpiar el CLAUDE.md.
|
|
202
|
+
|
|
203
|
+
NO aplica a `~/.claude/CLAUDE.md` user-level (ahí sí pueden declararse
|
|
204
|
+
preferencias personales que parafrasean reglas globales).
|
|
205
|
+
|
|
206
|
+
Aplica regla `reglas/sin-duplicacion-reglas-globales.md`.
|
|
207
|
+
|
|
208
|
+
### refactor — propuestas para duplicaciones de reglas globales
|
|
209
|
+
|
|
210
|
+
Cuando `audit` detecta duplicaciones, el subcomando `refactor` propone
|
|
211
|
+
el reemplazo concreto usando `construirSugerenciaRefactor()` del
|
|
212
|
+
detector. Cada propuesta incluye:
|
|
213
|
+
|
|
214
|
+
- **Bloque a eliminar** (línea aproximada en CLAUDE.md)
|
|
215
|
+
- **Regla global afectada** (archivo + sección canónica)
|
|
216
|
+
- **Reemplazo sugerido** (3 opciones):
|
|
217
|
+
1. Eliminar el bloque — la regla global YA aplica automáticamente
|
|
218
|
+
2. Reescribir como matiz local en ≤3 líneas referenciando la regla
|
|
219
|
+
3. Documentar override explícito con justificación
|
|
220
|
+
|
|
221
|
+
El refactor SOLO imprime el diff propuesto. El usuario decide aplicar.
|
|
222
|
+
|
|
223
|
+
## Variables de entorno
|
|
224
|
+
|
|
225
|
+
Ver `@docs/variables-entorno.md` sección "Calidad de CLAUDE.md":
|
|
226
|
+
|
|
227
|
+
- `SWL_CLAUDEMD_BLOAT` (on/off) — activa hook `claudemd-bloat-detector`
|
|
228
|
+
- `SWL_CLAUDEMD_MAX_LINES` (default 200) — umbral de líneas totales
|
|
229
|
+
- `SWL_CLAUDEMD_MAX_BULLET_CHARS` (default 1000) — umbral de bullet/párrafo
|
|
230
|
+
|
|
231
|
+
## Exit codes
|
|
232
|
+
|
|
233
|
+
- `0` — OK o WARN (consultivo)
|
|
234
|
+
- `1` — ERROR o `--strict` + WARN
|
|
@@ -2,11 +2,6 @@
|
|
|
2
2
|
name: swl:ejecutar-fase
|
|
3
3
|
description: Recibe el número de una fase y la implementa siguiendo el PLAN.md. Delega al agente implementador-swl, hace commits atómicos por slice, produce RESUMEN.md y actualiza ESTADO.md y HOJA-RUTA.md al terminar.
|
|
4
4
|
allowed_tools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
|
|
5
|
-
evolved: true
|
|
6
|
-
evolved-from: "1.6.8"
|
|
7
|
-
evolved-at: "2026-05-22"
|
|
8
|
-
evolved-by: "aprender"
|
|
9
|
-
evolved-note: "Paso 4.2 — cota dura 30k tokens al prompt del sub-agente para prevenir autocompact thrashing (origen SIGAF 2026-05-22)"
|
|
10
5
|
---
|
|
11
6
|
|
|
12
7
|
# /swl:ejecutar-fase <n> [--iterative] — Ejecutar implementación de una fase
|