@damenor/agent-docs 0.1.0 → 0.1.2

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 (9) hide show
  1. package/README.md +141 -71
  2. package/dist/index.js +259 -13
  3. package/package.json +11 -11
  4. package/templates/base/README.md +64 -69
  5. package/templates/base/docs/CONTEXT.md +111 -111
  6. package/templates/modules/agents/.agents/skills/doc-maintain/SKILL.md +193 -193
  7. package/templates/modules/agents/.agents/skills/doc-review/SKILL.md +223 -223
  8. package/templates/modules/agents/.agents/skills/doc-scaffold/SKILL.md +155 -155
  9. package/templates/modules/agents/.agents/skills/doc-write/SKILL.md +197 -197
package/templates/modules/agents/.agents/skills/doc-review/SKILL.md CHANGED
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  name: doc-review
3
3
  description: >
4
- Audita la salud de la documentación del proyecto. Verifica completitud,
5
- actualización, consistencia y cobertura. Genera un reporte de salud con
6
- puntuación 0-100 y prioridades de acción.
7
- TRIGGER: Cuando el usuario dice "auditar docs", "revisar documentación",
8
- "estado de docs", "docs saludables", "health check docs", o periódicamente
9
- como parte del mantenimiento del proyecto.
4
+ Audits the health of the project documentation. Verifies completeness,
5
+ currency, consistency, and coverage. Generates a health report with
6
+ a 0-100 score and action priorities.
7
+ TRIGGER: When the user says "audit docs", "review documentation",
8
+ "docs status", "healthy docs", "health check docs", or periodically
9
+ as part of project maintenance.
10
10
  license: Apache-2.0
11
11
  metadata:
12
12
  author: damenordev
@@ -15,310 +15,310 @@ metadata:
15
15
 
16
16
  # doc-review
17
17
 
18
- ## Cuándo Usar
18
+ ## When to Use
19
19
 
20
- - **Revisión periódica**: Mensual o al final de cada sprint
21
- - **Antes de releases**: Verificar que la doc está actualizada
22
- - **Integración CI**: Como paso automático en el pipeline
23
- - **Onboarding de nuevo dev**: Verificar que la doc permite arrancar
24
- - **Cuando la doc se siente desactualizada**: Sensación de que la doc no refleja el código
20
+ - **Periodic review**: Monthly or at the end of each sprint
21
+ - **Before releases**: Verify that docs are up to date
22
+ - **CI integration**: As an automatic step in the pipeline
23
+ - **New dev onboarding**: Verify that docs allow getting started
24
+ - **When docs feel outdated**: Sensation that docs don't reflect the code
25
25
 
26
- ## Patrones Críticos
26
+ ## Critical Patterns
27
27
 
28
- ### REGLA #1: Verificar problemas específicos, no solo existencia
28
+ ### RULE #1: Check for specific issues, not just existence
29
29
 
30
- No basta con "¿el archivo existe?". Verificar:
30
+ It's not enough to ask "does the file exist?". Check:
31
31
 
32
- | Problema | Qué buscar |
33
- |----------|------------|
34
- | Docs vacíos | Archivos con solo frontmatter y título |
35
- | Docs stale | Archivos sin `last-reviewed` en >3 meses |
36
- | TODO/TBD | Buscar `TODO`, `TBD`, `FIXME`, `PENDIENTE` en contenido |
37
- | Placeholder | Buscar "contenido pendiente", "agregar aquí", secciones vacías |
38
- | Wikilinks rotos | `[[enlace]]` que no resuelve a un archivo existente |
32
+ | Issue | What to look for |
33
+ |-------|------------------|
34
+ | Empty docs | Files with only frontmatter and title |
35
+ | Stale docs | Files without `last-reviewed` in >3 months |
36
+ | TODO/TBD | Search for `TODO`, `TBD`, `FIXME`, `PENDING` in content |
37
+ | Placeholder | Search for "pending content", "add here", empty sections |
38
+ | Broken wikilinks | `[[link]]` that doesn't resolve to an existing file |
39
39
 
40
- ### REGLA #2: Validar cobertura Diátaxis
40
+ ### RULE #2: Validate Diátaxis coverage
41
41
 
42
- Los 4 cuadrantes deben estar cubiertos:
42
+ All 4 quadrants must be covered:
43
43
 
44
44
  ```
45
- ¿Hay al menos un tutorial? → tutorials/
46
- ¿Hay al menos un how-to? → how-to/
47
- ¿Hay al menos un archivo de referencia? → reference/
48
- ¿Hay al menos una explicación? → explanation/
45
+ Is there at least one tutorial? → tutorials/
46
+ Is there at least one how-to? → how-to/
47
+ Is there at least one reference file? → reference/
48
+ Is there at least one explanation? → explanation/
49
49
  ```
50
50
 
51
- Si falta un cuadrante completo, es un gap CRÍTICO.
51
+ If an entire quadrant is missing, it is a CRITICAL gap.
52
52
 
53
- ### REGLA #3: Verificar consistencia de CONTEXT.md con el código
53
+ ### RULE #3: Verify CONTEXT.md consistency with code
54
54
 
55
55
  ```
56
- 1. Leer CONTEXT.md → lista de términos definidos
57
- 2. Buscar en código términos usados pero no en CONTEXT.md
58
- 3. Buscar en CONTEXT.md términos que ya no existen en código
59
- 4. Reportar discrepancias
56
+ 1. Read CONTEXT.md → list of defined terms
57
+ 2. Search code for terms used but not in CONTEXT.md
58
+ 3. Search CONTEXT.md for terms that no longer exist in code
59
+ 4. Report discrepancies
60
60
  ```
61
61
 
62
- ### REGLA #4: Validar completitud de ADRs
62
+ ### RULE #4: Validate ADR completeness
63
63
 
64
64
  ```
65
- 1. ¿Todo ADR tiene status válido? (proposed, accepted, deprecated, superseded)
66
- 2. ¿La numeración es secuencial sin gaps?
67
- 3. ¿Los ADRs deprecated tienen reemplazo documentado?
68
- 4. ¿Cada ADR cumple los 3 criterios (difícil de revertir, sorprendente, trade-off)?
65
+ 1. Does every ADR have a valid status? (proposed, accepted, deprecated, superseded)
66
+ 2. Is the numbering sequential without gaps?
67
+ 3. Do deprecated ADRs have a documented replacement?
68
+ 4. Does each ADR meet the 3 criteria (hard to reverse, surprising, trade-off)?
69
69
  ```
70
70
 
71
- ### REGLA #5: Verificar sincronía de DESIGN.md con el código
71
+ ### RULE #5: Verify DESIGN.md sync with code
72
72
 
73
73
  ```
74
- 1. Leer DESIGN.md → extraer tokens documentados
75
- 2. Leer archivos de estilos (CSS vars, Tailwind config)
76
- 3. Comparar valores documentados vs valores reales
77
- 4. Reportar diferencias
74
+ 1. Read DESIGN.md → extract documented tokens
75
+ 2. Read style files (CSS vars, Tailwind config)
76
+ 3. Compare documented values vs actual values
77
+ 4. Report differences
78
78
  ```
79
79
 
80
- ### REGLA #6: Verificar que se sigue el protocolo de AGENTS.md
80
+ ### RULE #6: Verify AGENTS.md protocol is followed
81
81
 
82
82
  ```
83
- 1. ¿AGENTS.md existe y tiene el protocolo?
84
- 2. ¿Los agentes siguen el protocolo? (evidencia en commits recientes)
85
- 3. ¿La estructura de carpetas coincide con lo documentado en AGENTS.md?
83
+ 1. Does AGENTS.md exist and have the protocol?
84
+ 2. Do agents follow the protocol? (evidence in recent commits)
85
+ 3. Does the folder structure match what's documented in AGENTS.md?
86
86
  ```
87
87
 
88
- ## Dimensiones de Revisión
89
-
90
- ### 1. Completitud
91
-
92
- **Qué verificar**:
93
- - Archivos de documentación que deberían existir y no existen
94
- - Secciones vacías dentro de archivos existentes
95
- - Features del código sin documentación correspondiente
96
- - Endpoints/funciones/componentes sin documentar
97
-
98
- **Puntuación**:
99
- | Criterio | Puntos |
100
- |----------|--------|
101
- | Todos los archivos esenciales existen | 0-10 |
102
- | Todas las secciones tienen contenido real | 0-10 |
103
- | Todas las features públicas están documentadas | 0-10 |
104
-
105
- ### 2. Actualidad
106
-
107
- **Qué verificar**:
108
- - Archivos sin actualización en >3 meses (verificar si el código relevante cambió)
109
- - Referencias a versiones/librerías obsoletas
110
- - CHANGELOG.md desactualizado vs tags de git
111
- - Screenshots o diagramas que no reflejan la UI actual
112
-
113
- **Puntuación**:
114
- | Criterio | Puntos |
115
- |----------|--------|
116
- | Docs reflejan el estado actual del código | 0-10 |
117
- | CHANGELOG está al día | 0-5 |
118
- | No hay referencias a versiones viejas | 0-5 |
119
-
120
- ### 3. Consistencia
121
-
122
- **Qué verificar**:
123
- - CONTEXT.md vs código: términos coinciden
124
- - DESIGN.md vs estilos: tokens coinciden
125
- - ADRs vs implementación: lo que dice el ADR es lo que está en código
126
- - docs/README.md mapa refleja archivos reales
127
- - Formato consistente: frontmatter, nomenclatura, idioma
128
-
129
- **Puntuación**:
130
- | Criterio | Puntos |
131
- |----------|--------|
132
- | CONTEXT.md coincide con código | 0-5 |
133
- | DESIGN.md coincide con estilos | 0-5 |
134
- | docs/README.md refleja archivos reales | 0-5 |
135
- | Formato consistente entre archivos | 0-5 |
136
-
137
- ### 4. Cobertura
138
-
139
- **Qué verificar**:
140
- - Diátaxis: los 4 cuadrantes están cubiertos
141
- - Features: cada feature pública tiene al menos un doc asociado
142
- - API: todos los endpoints están documentados
143
- - Componentes: todos los componentes UI están en DESIGN.md
144
- - Errores: errores comunes tienen troubleshooting
145
-
146
- **Puntuación**:
147
- | Criterio | Puntos |
148
- |----------|--------|
149
- | Diátaxis: 4 cuadrantes cubiertos | 0-10 |
150
- | API/endpoints documentados | 0-5 |
151
- | Componentes UI en DESIGN.md | 0-5 |
152
-
153
- ### 5. Calidad
154
-
155
- **Qué verificar**:
156
- - Contenido real vs placeholder (no TODO, no "pendiente")
157
- - Escritura clara y correcta
158
- - Ejemplos ejecutables en tutoriales/how-tos
159
- - Tablas completas en referencia
160
- - Sin duplicación entre archivos
161
-
162
- **Puntuación**:
163
- | Criterio | Puntos |
164
- |----------|--------|
165
- | Sin placeholders ni TODOs | 0-10 |
166
- | Ejemplos ejecutables | 0-5 |
167
- | Sin duplicación de contenido | 0-5 |
168
-
169
- ## Puntuación de Salud
170
-
171
- ### Cálculo
88
+ ## Review Dimensions
89
+
90
+ ### 1. Completeness
91
+
92
+ **What to check**:
93
+ - Documentation files that should exist but don't
94
+ - Empty sections within existing files
95
+ - Code features without corresponding documentation
96
+ - Undocumented endpoints/functions/components
97
+
98
+ **Score**:
99
+ | Criterion | Points |
100
+ |-----------|--------|
101
+ | All essential files exist | 0-10 |
102
+ | All sections have real content | 0-10 |
103
+ | All public features are documented | 0-10 |
104
+
105
+ ### 2. Currency
106
+
107
+ **What to check**:
108
+ - Files not updated in >3 months (check if relevant code changed)
109
+ - References to obsolete versions/libraries
110
+ - CHANGELOG.md outdated vs git tags
111
+ - Screenshots or diagrams that don't reflect current UI
112
+
113
+ **Score**:
114
+ | Criterion | Points |
115
+ |-----------|--------|
116
+ | Docs reflect current state of code | 0-10 |
117
+ | CHANGELOG is up to date | 0-5 |
118
+ | No references to old versions | 0-5 |
119
+
120
+ ### 3. Consistency
121
+
122
+ **What to check**:
123
+ - CONTEXT.md vs code: terms match
124
+ - DESIGN.md vs styles: tokens match
125
+ - ADRs vs implementation: what the ADR says is what's in code
126
+ - docs/README.md map reflects real files
127
+ - Consistent format: frontmatter, naming, language
128
+
129
+ **Score**:
130
+ | Criterion | Points |
131
+ |-----------|--------|
132
+ | CONTEXT.md matches code | 0-5 |
133
+ | DESIGN.md matches styles | 0-5 |
134
+ | docs/README.md reflects real files | 0-5 |
135
+ | Consistent format across files | 0-5 |
136
+
137
+ ### 4. Coverage
138
+
139
+ **What to check**:
140
+ - Diátaxis: all 4 quadrants are covered
141
+ - Features: each public feature has at least one associated doc
142
+ - API: all endpoints are documented
143
+ - Components: all UI components are in DESIGN.md
144
+ - Errors: common errors have troubleshooting
145
+
146
+ **Score**:
147
+ | Criterion | Points |
148
+ |-----------|--------|
149
+ | Diátaxis: 4 quadrants covered | 0-10 |
150
+ | API/endpoints documented | 0-5 |
151
+ | UI components in DESIGN.md | 0-5 |
152
+
153
+ ### 5. Quality
154
+
155
+ **What to check**:
156
+ - Real content vs placeholder (no TODO, no "pending")
157
+ - Clear and correct writing
158
+ - Runnable examples in tutorials/how-tos
159
+ - Complete tables in reference
160
+ - No duplication between files
161
+
162
+ **Score**:
163
+ | Criterion | Points |
164
+ |-----------|--------|
165
+ | No placeholders or TODOs | 0-10 |
166
+ | Runnable examples | 0-5 |
167
+ | No content duplication | 0-5 |
168
+
169
+ ## Health Score
170
+
171
+ ### Calculation
172
172
 
173
173
  ```
174
- Puntuación total = Completitud (30) + Actualidad (20) + Consistencia (20) + Cobertura (20) + Calidad (20) = 100
174
+ Total score = Completeness (30) + Currency (20) + Consistency (20) + Coverage (20) + Quality (20) = 100
175
175
  ```
176
176
 
177
- ### Escala
177
+ ### Scale
178
178
 
179
- | Puntuación | Estado | Acción |
180
- |------------|--------|--------|
181
- | 90-100 | 🟢 Saludable | Mantener, revisión periódica |
182
- | 70-89 | 🟡 Aceptable | Mejoras prioritarias identificadas |
183
- | 50-69 | 🟠 Deficiente | Requiere trabajo significativo |
184
- | 0-49 | 🔴 Crítico | Documentación fundamental faltante |
179
+ | Score | Status | Action |
180
+ |-------|--------|--------|
181
+ | 90-100 | 🟢 Healthy | Maintain, periodic review |
182
+ | 70-89 | 🟡 Acceptable | Prioritized improvements identified |
183
+ | 50-69 | 🟠 Deficient | Requires significant work |
184
+ | 0-49 | 🔴 Critical | Fundamental documentation missing |
185
185
 
186
- ## Formato del Reporte
186
+ ## Report Format
187
187
 
188
188
  ```markdown
189
- # Reporte de Salud de Documentación
189
+ # Documentation Health Report
190
190
 
191
- **Fecha**: 2024-03-15
192
- **Proyecto**: [nombre]
193
- **Puntuación**: 72/100 🟡
191
+ **Date**: 2024-03-15
192
+ **Project**: [name]
193
+ **Score**: 72/100 🟡
194
194
 
195
- ## Resumen por Dimensión
195
+ ## Summary by Dimension
196
196
 
197
- | Dimensión | Puntuación | Máximo |
198
- |-----------|------------|--------|
199
- | Completitud | 22 | 30 |
200
- | Actualidad | 15 | 20 |
201
- | Consistencia | 14 | 20 |
202
- | Cobertura | 12 | 20 |
203
- | Calidad | 9 | 10 |
197
+ | Dimension | Score | Maximum |
198
+ |-----------|-------|---------|
199
+ | Completeness | 22 | 30 |
200
+ | Currency | 15 | 20 |
201
+ | Consistency | 14 | 20 |
202
+ | Coverage | 12 | 20 |
203
+ | Quality | 9 | 10 |
204
204
  | **Total** | **72** | **100** |
205
205
 
206
- ## Problemas Críticos 🔴
206
+ ## Critical Issues 🔴
207
207
 
208
- - [ ] No existe documentation de API (reference/api.md)
209
- - [ ] DESIGN.md tiene valores de colores que no coinciden con CSS variables
208
+ - [ ] No API documentation exists (reference/api.md)
209
+ - [ ] DESIGN.md has color values that don't match CSS variables
210
210
 
211
- ## Problemas Importantes 🟡
211
+ ## Important Issues 🟡
212
212
 
213
- - [ ] Falta cobertura de how-tos (carpeta vacía)
214
- - [ ] 3 ADRs sin status definido
215
- - [ ] CONTEXT.md no incluye 5 términos usados en código
213
+ - [ ] Missing how-to coverage (empty folder)
214
+ - [ ] 3 ADRs without defined status
215
+ - [ ] CONTEXT.md doesn't include 5 terms used in code
216
216
 
217
- ## Mejoras Sugeridas 🟢
217
+ ## Suggested Improvements 🟢
218
218
 
219
- - [ ] Agregar last-reviewed a archivos sin fecha de revisión
220
- - [ ] Actualizar CHANGELOG con últimos 3 releases
221
- - [ ] Agregar ejemplos ejecutables a tutorials/quick-start.md
219
+ - [ ] Add last-reviewed to files without review date
220
+ - [ ] Update CHANGELOG with last 3 releases
221
+ - [ ] Add runnable examples to tutorials/quick-start.md
222
222
 
223
- ## Detalle por Archivo
223
+ ## Detail by File
224
224
 
225
- | Archivo | Estado | Issues |
226
- |---------|--------|--------|
225
+ | File | Status | Issues |
226
+ |------|--------|--------|
227
227
  | README.md | ✅ OK | — |
228
- | CHANGELOG.md | ⚠️ Desactualizado | Falta release 2.1.0 |
229
- | docs/CONTEXT.md | ⚠️ Incompleto | 5 términos faltantes |
230
- | docs/DESIGN.md | 🔴 Desincronizado | 3 tokens no coinciden |
228
+ | CHANGELOG.md | ⚠️ Outdated | Missing release 2.1.0 |
229
+ | docs/CONTEXT.md | ⚠️ Incomplete | 5 terms missing |
230
+ | docs/DESIGN.md | 🔴 Out of sync | 3 tokens don't match |
231
231
  | docs/README.md | ✅ OK | — |
232
- | reference/api.md | 🔴 Faltante | No existe |
232
+ | reference/api.md | 🔴 Missing | Does not exist |
233
233
  | tutorials/ | ✅ OK | — |
234
- | how-to/ | ⚠️ Vacío | Sin contenido |
234
+ | how-to/ | ⚠️ Empty | No content |
235
235
  | explanation/ | ✅ OK | — |
236
- | docs/adr/ | ⚠️ Incompleto | 3 ADRs sin status |
236
+ | docs/adr/ | ⚠️ Incomplete | 3 ADRs without status |
237
237
  ```
238
238
 
239
- ## Proceso de Revisión
239
+ ## Review Process
240
240
 
241
- ### Paso 1: Inventario
241
+ ### Step 1: Inventory
242
242
 
243
243
  ```
244
- 1. Listar todos los archivos de documentación existentes
245
- 2. Verificar docs/README.md vs archivos reales
246
- 3. Identificar archivos faltantes según el stack
244
+ 1. List all existing documentation files
245
+ 2. Verify docs/README.md vs real files
246
+ 3. Identify missing files based on the stack
247
247
  ```
248
248
 
249
- ### Paso 2: Verificación por dimensión
249
+ ### Step 2: Verification by dimension
250
250
 
251
251
  ```
252
- 1. Completitud: archivos, secciones, features
253
- 2. Actualidad: fechas, versiones, cambios recientes
254
- 3. Consistencia: CONTEXT, DESIGN, ADRs, README
255
- 4. Cobertura: Diátaxis, API, componentes
256
- 5. Calidad: placeholders, ejemplos, duplicados
252
+ 1. Completeness: files, sections, features
253
+ 2. Currency: dates, versions, recent changes
254
+ 3. Consistency: CONTEXT, DESIGN, ADRs, README
255
+ 4. Coverage: Diátaxis, API, components
256
+ 5. Quality: placeholders, examples, duplicates
257
257
  ```
258
258
 
259
- ### Paso 3: Puntuación
259
+ ### Step 3: Scoring
260
260
 
261
261
  ```
262
- Calcular puntuación por dimensión y total
263
- Determinar estado general (🟢🟡🟠🔴)
262
+ Calculate score by dimension and total
263
+ Determine overall status (🟢🟡🟠🔴)
264
264
  ```
265
265
 
266
- ### Paso 4: Generar reporte
266
+ ### Step 4: Generate report
267
267
 
268
268
  ```
269
- 1. Listar problemas críticos primero
270
- 2. Problemas importantes después
271
- 3. Mejoras sugeridas al final
272
- 4. Detalle por archivo
269
+ 1. List critical issues first
270
+ 2. Important issues next
271
+ 3. Suggested improvements at the end
272
+ 4. Detail by file
273
273
  ```
274
274
 
275
- ### Paso 5: Recomendar acciones
275
+ ### Step 5: Recommend actions
276
276
 
277
277
  ```
278
- Para cada problema crítico:
279
- - Qué archivo crear/actualizar
280
- - Qué skill usar (doc-write, doc-design, etc.)
281
- - Prioridad (inmediata, esta semana, este sprint)
278
+ For each critical issue:
279
+ - Which file to create/update
280
+ - Which skill to use (doc-write, doc-design, etc.)
281
+ - Priority (immediate, this week, this sprint)
282
282
  ```
283
283
 
284
- ## Comandos
284
+ ## Commands
285
285
 
286
- ### Verificación rápida
286
+ ### Quick verification
287
287
 
288
288
  ```
289
- 1. Listar archivos de doc: docs/, tutorials/, how-to/, reference/, explanation/
290
- 2. Buscar TODOs: rg "TODO|TBD|FIXME|PENDIENTE" --type md
291
- 3. Verificar fechas: revisar last-reviewed en frontmatter
292
- 4. Verificar wikilinks: buscar [[...]] y verificar que existen
289
+ 1. List doc files: docs/, tutorials/, how-to/, reference/, explanation/
290
+ 2. Search TODOs: rg "TODO|TBD|FIXME|PENDING" --type md
291
+ 3. Verify dates: check last-reviewed in frontmatter
292
+ 4. Verify wikilinks: search [[...]] and verify they exist
293
293
  ```
294
294
 
295
- ### Verificación profunda
295
+ ### Deep verification
296
296
 
297
297
  ```
298
- 1. CONTEXT.md vs código: comparar términos definidos vs usados
299
- 2. DESIGN.md vs estilos: comparar tokens documentados vs reales
300
- 3. ADRs vs implementación: verificar que el código sigue lo decidido
301
- 4. Diátaxis: verificar cobertura de los 4 cuadrantes
298
+ 1. CONTEXT.md vs code: compare defined terms vs used terms
299
+ 2. DESIGN.md vs styles: compare documented tokens vs actual ones
300
+ 3. ADRs vs implementation: verify that code follows what was decided
301
+ 4. Diátaxis: verify coverage of all 4 quadrants
302
302
  ```
303
303
 
304
- ## Escaladas
304
+ ## Escalations
305
305
 
306
- ### Cuándo escalar (gap crítico)
306
+ ### When to escalate (critical gap)
307
307
 
308
- - Sin tutorial de quick-start → onboarding bloqueado
309
- - Sin referencia de API → integradores bloqueados
310
- - CHANGELOG vacío → no se sabe qué cambió entre versiones
311
- - Sin CONTEXT.md → términos ambiguos causan confusión
312
- - DESIGN.md desincronizado → inconsistencias visuales
308
+ - No quick-start tutorial → onboarding blocked
309
+ - No API reference → integrators blocked
310
+ - Empty CHANGELOG → can't tell what changed between versions
311
+ - No CONTEXT.md → ambiguous terms cause confusion
312
+ - DESIGN.md out of sync → visual inconsistencies
313
313
 
314
- ### Acción al escalar
314
+ ### Action on escalation
315
315
 
316
- 1. Crear el issue/tarea con prioridad alta
317
- 2. Asignar al skill correspondiente: `doc-write`, `doc-design`, `doc-scaffold`
318
- 3. Estimar esfuerzo
319
- 4. Incluir en el siguiente sprint
316
+ 1. Create the issue/task with high priority
317
+ 2. Assign to the corresponding skill: `doc-write`, `doc-design`, `doc-scaffold`
318
+ 3. Estimate effort
319
+ 4. Include in the next sprint
320
320
 
321
- ## Recursos
321
+ ## Resources
322
322
 
323
- - [Health Checklist](references/health-checklist.md) — Checklist completo de auditoría con rúbrica de puntuación
324
- - Skills relacionados: `doc-write` (escribir docs faltantes), `doc-design` (arreglar DESIGN.md), `doc-scaffold` (crear estructura faltante), `doc-maintain` (sincronizar cambios)
323
+ - [Health Checklist](references/health-checklist.md) — Complete audit checklist with scoring rubric
324
+ - Related skills: `doc-write` (write missing docs), `doc-design` (fix DESIGN.md), `doc-scaffold` (create missing structure), `doc-maintain` (sync changes)