@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-maintain/SKILL.md CHANGED
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  name: doc-maintain
3
3
  description: >
4
- Mantiene la documentación sincronizada con los cambios en el código.
5
- Se ejecuta DESPUÉS de cada tarea que modifica código, usando la tabla de
6
- triggers para determinar qué documentación actualizar. Sigue el protocolo
7
- post-tarea de AGENTS.md.
8
- TRIGGER: Cuando el usuario dice "sincronizar docs", "actualizar docs post-cambio",
9
- "post-feature", "post-release", "post-incident", o automáticamente después de
10
- cualquier tarea que cambie código.
4
+ Keeps documentation synchronized with code changes.
5
+ Runs AFTER each task that modifies code, using the trigger
6
+ table to determine which documentation to update. Follows the
7
+ post-task protocol from AGENTS.md.
8
+ TRIGGER: When the user says "sync docs", "update docs post-change",
9
+ "post-feature", "post-release", "post-incident", or automatically after
10
+ any task that changes code.
11
11
  license: Apache-2.0
12
12
  metadata:
13
13
  author: damenordev
@@ -16,120 +16,120 @@ metadata:
16
16
 
17
17
  # doc-maintain
18
18
 
19
- ## Cuándo Usar
19
+ ## When to Use
20
20
 
21
- - **Post-feature**: Después de implementar una feature nueva
22
- - **Post-release**: Después de hacer un release a producción
23
- - **Post-incident**: Después de resolver un incidente en producción
24
- - **Post-refactor**: Después de refactorizar código
25
- - **Post-hire**: Cuando un nuevo dev revisa la documentación
26
- - **Post-design-change**: Después de cambios en estilos/UI
27
- - **Post-API-change**: Después de agregar/modificar/eliminar endpoints
28
- - **Post-config-change**: Después de cambiar configuración
21
+ - **Post-feature**: After implementing a new feature
22
+ - **Post-release**: After making a release to production
23
+ - **Post-incident**: After resolving a production incident
24
+ - **Post-refactor**: After refactoring code
25
+ - **Post-hire**: When a new dev reviews the documentation
26
+ - **Post-design-change**: After changes to styles/UI
27
+ - **Post-API-change**: After adding/modifying/removing endpoints
28
+ - **Post-config-change**: After changing configuration
29
29
 
30
- ## Patrones Críticos
30
+ ## Critical Patterns
31
31
 
32
- ### REGLA #1: Esta skill se ejecuta DESPUÉS de cada tarea que cambia código
32
+ ### RULE #1: This skill runs AFTER every task that changes code
33
33
 
34
34
  ```
35
- Código cambió → doc-maintain se ejecuta
35
+ Code changed → doc-maintain runs
36
36
  ```
37
37
 
38
- No es opcional. No es "cuando haya tiempo". Es parte del Definition of Done.
38
+ It is not optional. It is not "when there's time". It is part of the Definition of Done.
39
39
 
40
- ### REGLA #2: Verificar qué cambió y actualizar docs correspondientes
40
+ ### RULE #2: Verify what changed and update corresponding docs
41
41
 
42
42
  ```
43
- 1. Identificar qué archivos cambiaron (git diff, lista de cambios)
44
- 2. Mapear cambios a documentación afectada (ver tabla de triggers)
45
- 3. Actualizar cada archivo de doc afectado
46
- 4. Verificar consistencia
43
+ 1. Identify which files changed (git diff, change list)
44
+ 2. Map changes to affected documentation (see trigger table)
45
+ 3. Update each affected doc file
46
+ 4. Verify consistency
47
47
  ```
48
48
 
49
- ### REGLA #3: NUNCA saltar actualización de docs
49
+ ### RULE #3: NEVER skip doc updates
50
50
 
51
51
  ```
52
- Código cambia = Documentación cambia
52
+ Code changes = Documentation changes
53
53
  ```
54
54
 
55
- Si no hay tiempo para actualizar docs, no hay tiempo para hacer el cambio de código.
55
+ If there's no time to update docs, there's no time to make the code change.
56
56
 
57
- ### REGLA #4: Seguir el protocolo post-tarea de AGENTS.md
57
+ ### RULE #4: Follow the post-task protocol from AGENTS.md
58
58
 
59
- Ejecutar el **árbol post-tarea** definido en `AGENTS.md` § DESPUÉS de cada tarea. Ese árbol es la fuente de verdad de qué documentación actualizar según qué cambió.
59
+ Execute the **post-task tree** defined in `AGENTS.md` § AFTER each task. That tree is the source of truth for which documentation to update based on what changed.
60
60
 
61
- ### REGLA #5: Si no se sabe qué actualizar, ejecutar doc-review primero
61
+ ### RULE #5: If unsure what to update, run doc-review first
62
62
 
63
63
  ```
64
- ¿No está claro qué docs se ven afectadas?
65
- → Ejecutar skill doc-review
66
- → Identificar gaps
67
- → Actualizar según el reporte
64
+ Not clear which docs are affected?
65
+ → Run doc-review skill
66
+ → Identify gaps
67
+ → Update based on the report
68
68
  ```
69
69
 
70
- ## Tabla de Triggers y Acciones
70
+ ## Trigger and Action Table
71
71
 
72
72
  ### Post-feature
73
73
 
74
- **Qué detectar**: Se agregó una feature nueva (nuevo módulo, nueva funcionalidad, nuevo endpoint)
74
+ **What to detect**: A new feature was added (new module, new functionality, new endpoint)
75
75
 
76
- **Docs a actualizar**:
76
+ **Docs to update**:
77
77
 
78
- | Documento | Cuándo | Prioridad | Skill |
79
- |-----------|--------|-----------|-------|
80
- | `docs/CONTEXT.md` | Si hay términos nuevos | Crítica | doc-write |
81
- | `docs/README.md` | Si se crearon/eliminaron archivos de doc | Crítica | doc-write |
82
- | `docs/adr/` | Si se tomó una decisión arquitectónica | Alta | doc-write |
83
- | `how-to/` | Si hay un problema repetible que la feature resuelve | Media | doc-write |
84
- | `reference/` | Si se agregaron endpoints/funciones/props | Alta | doc-write |
85
- | `tutorials/` | Si la feature cambia el onboarding | Baja | doc-write |
86
- | `CHANGELOG.md` | Si la feature va a salir en un release | Alta | doc-write |
78
+ | Document | When | Priority | Skill |
79
+ |----------|------|----------|-------|
80
+ | `docs/CONTEXT.md` | If there are new terms | Critical | doc-write |
81
+ | `docs/README.md` | If doc files were created/removed | Critical | doc-write |
82
+ | `docs/adr/` | If an architectural decision was made | High | doc-write |
83
+ | `how-to/` | If there is a repeatable problem the feature solves | Medium | doc-write |
84
+ | `reference/` | If endpoints/functions/props were added | High | doc-write |
85
+ | `tutorials/` | If the feature changes onboarding | Low | doc-write |
86
+ | `CHANGELOG.md` | If the feature will be in a release | High | doc-write |
87
87
 
88
88
  ### Post-release
89
89
 
90
- **Qué detectar**: Se hizo un deploy a producción, se creó un tag de versión
90
+ **What to detect**: A deploy to production was made, a version tag was created
91
91
 
92
- **Docs a actualizar**:
92
+ **Docs to update**:
93
93
 
94
- | Documento | Cuándo | Prioridad | Skill |
95
- |-----------|--------|-----------|-------|
96
- | `CHANGELOG.md` | Siempre | Crítica | doc-write |
97
- | `docs/guides/deployment.md` | Si cambió el proceso de deploy | Alta | doc-write |
98
- | `docs/README.md` | Si cambió la estructura de docs | Media | doc-write |
99
- | `README.md` | Si hay cambios visibles al usuario | Alta | doc-write |
94
+ | Document | When | Priority | Skill |
95
+ |----------|------|----------|-------|
96
+ | `CHANGELOG.md` | Always | Critical | doc-write |
97
+ | `docs/guides/deployment.md` | If the deploy process changed | High | doc-write |
98
+ | `docs/README.md` | If the doc structure changed | Medium | doc-write |
99
+ | `README.md` | If there are user-visible changes | High | doc-write |
100
100
 
101
- **Entrada de CHANGELOG**:
101
+ **CHANGELOG entry**:
102
102
  ```markdown
103
103
  ## [X.Y.Z] - YYYY-MM-DD
104
104
 
105
105
  ### Added
106
- - Descripción de feature nueva
106
+ - Description of new feature
107
107
 
108
108
  ### Changed
109
- - Descripción de cambio
109
+ - Description of change
110
110
 
111
111
  ### Fixed
112
- - Descripción de fix
112
+ - Description of fix
113
113
 
114
114
  ### Breaking
115
- - ⚠️ Descripción de breaking change
115
+ - ⚠️ Description of breaking change
116
116
  ```
117
117
 
118
118
  ### Post-incident
119
119
 
120
- **Qué detectar**: Se resolvió un incidente en producción (outage, bug crítico, data loss)
120
+ **What to detect**: A production incident was resolved (outage, critical bug, data loss)
121
121
 
122
- **Docs a actualizar**:
122
+ **Docs to update**:
123
123
 
124
- | Documento | Cuándo | Prioridad | Skill |
125
- |-----------|--------|-----------|-------|
126
- | `operations/post-mortems/YYYY-MM-DD-titulo.md` | Siempre | Crítica | doc-write |
127
- | `operations/runbooks/` | Si hay pasos de resolución que repetir | Alta | doc-write |
128
- | `docs/CONTEXT.md` | Si se descubrieron términos del dominio | Media | doc-write |
129
- | `reference/configuration.md` | Si se cambiaron configs durante el incidente | Alta | doc-write |
130
- | `how-to/troubleshooting.md` | Si el fix es aplicable a futuro | Alta | doc-write |
124
+ | Document | When | Priority | Skill |
125
+ |----------|------|----------|-------|
126
+ | `operations/post-mortems/YYYY-MM-DD-title.md` | Always | Critical | doc-write |
127
+ | `operations/runbooks/` | If there are resolution steps to repeat | High | doc-write |
128
+ | `docs/CONTEXT.md` | If domain terms were discovered | Medium | doc-write |
129
+ | `reference/configuration.md` | If configs were changed during the incident | High | doc-write |
130
+ | `how-to/troubleshooting.md` | If the fix is applicable in the future | High | doc-write |
131
131
 
132
- **Formato de post-mortem**:
132
+ **Post-mortem format**:
133
133
  ```markdown
134
134
  ---
135
135
  created: "YYYY-MM-DD"
@@ -138,208 +138,208 @@ type: explanation
138
138
  tags: [post-mortem, incident, sev-N]
139
139
  ---
140
140
 
141
- # Post-mortem: [Título del incidente]
141
+ # Post-mortem: [Incident title]
142
142
 
143
- **Fecha**: YYYY-MM-DD
144
- **Severidad**: SEV-N
145
- **Duración**: X horas/minutos
146
- **Impacto**: Descripción del impacto en usuarios
143
+ **Date**: YYYY-MM-DD
144
+ **Severity**: SEV-N
145
+ **Duration**: X hours/minutes
146
+ **Impact**: Description of user impact
147
147
 
148
- ## Línea de tiempo
149
- - HH:MM — Detección
150
- - HH:MM — Diagnóstico
151
- - HH:MM — Mitigación
152
- - HH:MM — Resolución
148
+ ## Timeline
149
+ - HH:MM — Detection
150
+ - HH:MM — Diagnosis
151
+ - HH:MM — Mitigation
152
+ - HH:MM — Resolution
153
153
 
154
- ## Causa raíz
155
- [Descripción]
154
+ ## Root cause
155
+ [Description]
156
156
 
157
- ## Acciones preventivas
158
- - [ ] [Acción 1] — Responsable — Fecha límite
159
- - [ ] [Acción 2] — Responsable — Fecha límite
157
+ ## Preventive actions
158
+ - [ ] [Action 1] — Responsible — Deadline
159
+ - [ ] [Action 2] — Responsible — Deadline
160
160
 
161
- ## Lecciones aprendidas
162
- [Qué aprendimos]
161
+ ## Lessons learned
162
+ [What we learned]
163
163
  ```
164
164
 
165
165
  ### Post-refactor
166
166
 
167
- **Qué detectar**: Se refactorizó código (renombrar, mover, cambiar patrones)
167
+ **What to detect**: Code was refactored (renamed, moved, changed patterns)
168
168
 
169
- **Docs a actualizar**:
169
+ **Docs to update**:
170
170
 
171
- | Documento | Cuándo | Prioridad | Skill |
172
- |-----------|--------|-----------|-------|
173
- | `docs/adr/` | Si el refactor implica un cambio de patrón | Alta | doc-write |
174
- | `docs/explanation/architecture.md` | Si cambió la arquitectura | Alta | doc-write |
175
- | `docs/CONTEXT.md` | Si cambiaron nombres/términos | Crítica | doc-write |
176
- | `docs/README.md` | Si se movieron archivos | Media | doc-write |
177
- | ADRs existentes | Verificar que sigan siendo válidos | Alta | doc-write |
171
+ | Document | When | Priority | Skill |
172
+ |----------|------|----------|-------|
173
+ | `docs/adr/` | If the refactor implies a pattern change | High | doc-write |
174
+ | `docs/explanation/architecture.md` | If the architecture changed | High | doc-write |
175
+ | `docs/CONTEXT.md` | If names/terms changed | Critical | doc-write |
176
+ | `docs/README.md` | If files were moved | Medium | doc-write |
177
+ | Existing ADRs | Verify they are still valid | High | doc-write |
178
178
 
179
179
  ### Post-hire
180
180
 
181
- **Qué detectar**: Un nuevo dev se unió al equipo y revisa la documentación
181
+ **What to detect**: A new dev joined the team and reviews the documentation
182
182
 
183
- **Docs a actualizar**:
183
+ **Docs to update**:
184
184
 
185
- | Documento | Cuándo | Prioridad | Skill |
186
- |-----------|--------|-----------|-------|
187
- | `tutorials/quick-start.md` | Si el nuevo dev no pudo seguir el tutorial | Crítica | doc-write |
188
- | `docs/CONTEXT.md` | Si el nuevo dev encontró términos confusos | Alta | doc-write |
189
- | Cualquier doc | Si el nuevo dev encontró info incorrecta | Alta | doc-write |
185
+ | Document | When | Priority | Skill |
186
+ |----------|------|----------|-------|
187
+ | `tutorials/quick-start.md` | If the new dev couldn't follow the tutorial | Critical | doc-write |
188
+ | `docs/CONTEXT.md` | If the new dev found confusing terms | High | doc-write |
189
+ | Any doc | If the new dev found incorrect info | High | doc-write |
190
190
 
191
191
  ### Post-design-change
192
192
 
193
- **Qué detectar**: Se cambiaron estilos, tokens de diseño, o componentes UI
193
+ **What to detect**: Styles, design tokens, or UI components were changed
194
194
 
195
- **Docs a actualizar**:
195
+ **Docs to update**:
196
196
 
197
- | Documento | Cuándo | Prioridad | Skill |
198
- |-----------|--------|-----------|-------|
199
- | `DESIGN.md` | Siempre | Crítica | doc-design |
200
- | `docs/CONTEXT.md` | Si hay términos de diseño nuevos | Media | doc-write |
197
+ | Document | When | Priority | Skill |
198
+ |----------|------|----------|-------|
199
+ | `DESIGN.md` | Always | Critical | doc-design |
200
+ | `docs/CONTEXT.md` | If there are new design terms | Medium | doc-write |
201
201
 
202
- **Usar skill `doc-design`** para re-extraer tokens y actualizar DESIGN.md.
202
+ **Use skill `doc-design`** to re-extract tokens and update DESIGN.md.
203
203
 
204
204
  ### Post-API-change
205
205
 
206
- **Qué detectar**: Se agregaron, modificaron o eliminaron endpoints
206
+ **What to detect**: Endpoints were added, modified, or removed
207
207
 
208
- **Docs a actualizar**:
208
+ **Docs to update**:
209
209
 
210
- | Documento | Cuándo | Prioridad | Skill |
211
- |-----------|--------|-----------|-------|
212
- | `reference/api.md` | Siempre | Crítica | doc-write |
213
- | `CHANGELOG.md` | Si hay breaking changes | Crítica | doc-write |
214
- | `docs/adr/` | Si se cambió la estructura de la API | Alta | doc-write |
215
- | `how-to/` | Si hay nuevos flujos de uso | Media | doc-write |
210
+ | Document | When | Priority | Skill |
211
+ |----------|------|----------|-------|
212
+ | `reference/api.md` | Always | Critical | doc-write |
213
+ | `CHANGELOG.md` | If there are breaking changes | Critical | doc-write |
214
+ | `docs/adr/` | If the API structure changed | High | doc-write |
215
+ | `how-to/` | If there are new usage flows | Medium | doc-write |
216
216
 
217
217
  ### Post-config-change
218
218
 
219
- **Qué detectar**: Se cambiaron variables de entorno, configuraciones, o infraestructura
219
+ **What to detect**: Environment variables, configurations, or infrastructure were changed
220
220
 
221
- **Docs a actualizar**:
221
+ **Docs to update**:
222
222
 
223
- | Documento | Cuándo | Prioridad | Skill |
224
- |-----------|--------|-----------|-------|
225
- | `reference/configuration.md` | Siempre | Crítica | doc-write |
226
- | `docs/guides/deployment.md` | Si afecta el deploy | Alta | doc-write |
227
- | `docs/adr/` | Si es un cambio de infraestructura significativo | Alta | doc-write |
228
- | `.env.example` | Si se agregaron variables | Alta | directo |
223
+ | Document | When | Priority | Skill |
224
+ |----------|------|----------|-------|
225
+ | `reference/configuration.md` | Always | Critical | doc-write |
226
+ | `docs/guides/deployment.md` | If it affects deploy | High | doc-write |
227
+ | `docs/adr/` | If it is a significant infrastructure change | High | doc-write |
228
+ | `.env.example` | If variables were added | High | direct |
229
229
 
230
- ## Flujo del Proceso
230
+ ## Process Flow
231
231
 
232
- ### Paso 1: Identificar qué cambió
232
+ ### Step 1: Identify what changed
233
233
 
234
234
  ```bash
235
- # Opción A: Git diff
235
+ # Option A: Git diff
236
236
  git diff --name-only HEAD~1 HEAD
237
237
  git diff --name-only --staged
238
238
 
239
- # Opción B: Lista manual de archivos cambiados
240
- [lista proporcionada por el agente/humano]
239
+ # Option B: Manual list of changed files
240
+ [list provided by agent/human]
241
241
  ```
242
242
 
243
- ### Paso 2: Mapear cambios a docs afectadas
243
+ ### Step 2: Map changes to affected docs
244
244
 
245
245
  ```
246
- Para cada archivo cambiado:
247
- ├── ¿Es código fuente? → Verificar reference/, CONTEXT.md
248
- ├── ¿Es estilo/CSS? → Verificar DESIGN.md
249
- ├── ¿Es configuración? → Verificar reference/configuration.md
250
- ├── ¿Es un módulo nuevo? → Verificar CONTEXT.md, docs/README.md
251
- ├── ¿Es un fix? → Verificar CHANGELOG.md, troubleshooting
252
- ├── ¿Es infraestructura? → Verificar deployment.md, ADRs
253
- └── ¿Es un test? → Generalmente no requiere doc update
246
+ For each changed file:
247
+ ├── Is it source code? → Check reference/, CONTEXT.md
248
+ ├── Is it styles/CSS? → Check DESIGN.md
249
+ ├── Is it configuration? → Check reference/configuration.md
250
+ ├── Is it a new module? → Check CONTEXT.md, docs/README.md
251
+ ├── Is it a fix? → Check CHANGELOG.md, troubleshooting
252
+ ├── Is it infrastructure? → Check deployment.md, ADRs
253
+ └── Is it a test? → Generally no doc update needed
254
254
  ```
255
255
 
256
- ### Paso 3: Actualizar cada doc afectada
256
+ ### Step 3: Update each affected doc
257
257
 
258
258
  ```
259
- 1. Abrir el archivo de doc afectado
260
- 2. Identificar la sección que necesita cambio
261
- 3. Hacer el cambio manteniendo el formato existente
262
- 4. Verificar que el cambio es consistente con el resto del archivo
259
+ 1. Open the affected doc file
260
+ 2. Identify the section that needs changing
261
+ 3. Make the change maintaining the existing format
262
+ 4. Verify the change is consistent with the rest of the file
263
263
  ```
264
264
 
265
- ### Paso 4: Verificar consistencia
265
+ ### Step 4: Verify consistency
266
266
 
267
267
  ```
268
- 1. CONTEXT.md: ¿Los términos nuevos están? ¿Los eliminados se marcaron?
269
- 2. docs/README.md: ¿El mapa refleja los archivos actuales?
270
- 3. ADRs: ¿Los cambios invalidan algún ADR existente?
271
- 4. DESIGN.md: ¿Los tokens siguen coincidiendo? (si cambiaron estilos)
272
- 5. reference/api.md: ¿Los endpoints documentados coinciden con el código?
268
+ 1. CONTEXT.md: Are the new terms there? Are removed ones marked?
269
+ 2. docs/README.md: Does the map reflect current files?
270
+ 3. ADRs: Do the changes invalidate any existing ADR?
271
+ 4. DESIGN.md: Do tokens still match? (if styles changed)
272
+ 5. reference/api.md: Do documented endpoints match the code?
273
273
  ```
274
274
 
275
- ### Paso 5: Reportar qué se actualizó
275
+ ### Step 5: Report what was updated
276
276
 
277
277
  ```
278
- ✅ Documentación actualizada:
279
- - docs/CONTEXT.md: Agregados 2 términos (UserService, RateLimit)
280
- - docs/README.md: Agregado how-to/rate-limiting.md al mapa
281
- - reference/api.md: Actualizado endpoint /api/users con nuevo campo
282
-
283
- ℹ️ Sin cambios necesarios:
284
- - CHANGELOG.md: Feature aún no es release
285
- - DESIGN.md: No hubo cambios de estilos
278
+ ✅ Documentation updated:
279
+ - docs/CONTEXT.md: Added 2 terms (UserService, RateLimit)
280
+ - docs/README.md: Added how-to/rate-limiting.md to map
281
+ - reference/api.md: Updated endpoint /api/users with new field
282
+
283
+ ℹ️ No changes needed:
284
+ - CHANGELOG.md: Feature not yet released
285
+ - DESIGN.md: No style changes
286
286
  ```
287
287
 
288
- ## Actualización por Lotes
288
+ ## Batch Updates
289
289
 
290
- Cuando múltiples cambios ocurren juntos (ej: fin de sprint):
290
+ When multiple changes occur together (e.g., end of sprint):
291
291
 
292
292
  ```
293
- 1. Listar TODOS los cambios desde la última actualización
294
- 2. Agrupar por tipo de trigger (feature, refactor, fix, etc.)
295
- 3. Actualizar cada doc UNA VEZ con todos los cambios acumulados
296
- 4. Ejecutar doc-review al final para verificar consistencia
293
+ 1. List ALL changes since the last update
294
+ 2. Group by trigger type (feature, refactor, fix, etc.)
295
+ 3. Update each doc ONCE with all accumulated changes
296
+ 4. Run doc-review at the end to verify consistency
297
297
  ```
298
298
 
299
- ### Ejemplo: Fin de sprint
299
+ ### Example: End of sprint
300
300
 
301
301
  ```
302
- Cambios del sprint:
303
- - 3 features nuevas
304
- - 1 refactor de auth
302
+ Sprint changes:
303
+ - 3 new features
304
+ - 1 auth refactor
305
305
  - 2 bug fixes
306
- - 1 cambio de configuración
307
-
308
- Docs a actualizar:
309
- 1. CHANGELOG.md → Entrada completa del sprint
310
- 2. CONTEXT.md → Términos de las 3 features + auth refactor
311
- 3. reference/api.md → Nuevos endpoints
312
- 4. docs/adr/ → ADR del refactor de auth (si aplica)
313
- 5. reference/configuration.md → Config cambiada
314
- 6. docs/README.md → Si se agregaron/eliminaron docs
306
+ - 1 configuration change
307
+
308
+ Docs to update:
309
+ 1. CHANGELOG.md → Complete sprint entry
310
+ 2. CONTEXT.md → Terms from 3 features + auth refactor
311
+ 3. reference/api.md → New endpoints
312
+ 4. docs/adr/ → Auth refactor ADR (if applicable)
313
+ 5. reference/configuration.md → Changed config
314
+ 6. docs/README.md → If docs were added/removed
315
315
  ```
316
316
 
317
- ## Comandos
317
+ ## Commands
318
318
 
319
- ### Identificar cambios
319
+ ### Identify changes
320
320
 
321
321
  ```bash
322
- # Archivos modificados en el último commit
322
+ # Files modified in the last commit
323
323
  git diff --name-only HEAD~1
324
324
 
325
- # Archivos modificados (staged + unstaged)
325
+ # Modified files (staged + unstaged)
326
326
  git diff --name-only; git diff --name-only --staged
327
327
 
328
- # Cambios en un rango de commits
328
+ # Changes in a range of commits
329
329
  git diff --name-only commit1..commit2
330
330
  ```
331
331
 
332
- ### Verificar consistencia post-actualización
332
+ ### Post-update consistency verification
333
333
 
334
334
  ```
335
- 1. ¿CONTEXT.md tiene todos los términos nuevos del código?
336
- 2. ¿docs/README.md lista todos los archivos de doc existentes?
337
- 3. ¿ADRs son consistentes con la implementación actual?
338
- 4. ¿DESIGN.md coincide con estilos actuales?
339
- 5. ¿reference/api.md refleja endpoints actuales?
335
+ 1. Does CONTEXT.md have all the new terms from code?
336
+ 2. Does docs/README.md list all existing doc files?
337
+ 3. Are ADRs consistent with the current implementation?
338
+ 4. Does DESIGN.md match current styles?
339
+ 5. Does reference/api.md reflect current endpoints?
340
340
  ```
341
341
 
342
- ## Recursos
342
+ ## Resources
343
343
 
344
- - [Triggers Reference](references/triggers.md) — Tabla completa de eventos → docs a actualizar con ejemplos
345
- - Skills relacionados: `doc-write` (escribir/actualizar docs), `doc-review` (auditar después de actualizar), `doc-design` (actualizar DESIGN.md), `doc-scaffold` (si falta estructura)
344
+ - [Triggers Reference](references/triggers.md) — Complete table of events → docs to update with examples
345
+ - Related skills: `doc-write` (write/update docs), `doc-review` (audit after updating), `doc-design` (update DESIGN.md), `doc-scaffold` (if structure is missing)