context-first-cli 2.1.6 → 2.2.0

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 (53) hide show
  1. package/dist/templates/commands/en/engineer/plan.md +48 -10
  2. package/dist/templates/commands/en/engineer/pr.md +46 -8
  3. package/dist/templates/commands/en/engineer/pre-pr.md +49 -11
  4. package/dist/templates/commands/en/engineer/start.md +60 -23
  5. package/dist/templates/commands/en/engineer/work.md +45 -7
  6. package/dist/templates/commands/en/products/check.md +48 -11
  7. package/dist/templates/commands/en/products/collect.md +51 -14
  8. package/dist/templates/commands/es/engineer/plan.md +60 -22
  9. package/dist/templates/commands/es/engineer/pr.md +47 -9
  10. package/dist/templates/commands/es/engineer/pre-pr.md +59 -21
  11. package/dist/templates/commands/es/engineer/start.md +52 -15
  12. package/dist/templates/commands/es/engineer/work.md +91 -53
  13. package/dist/templates/commands/es/products/check.md +48 -10
  14. package/dist/templates/commands/es/products/collect.md +55 -18
  15. package/dist/templates/commands/pt-BR/engineer/plan.md +38 -0
  16. package/dist/templates/commands/pt-BR/engineer/pr.md +38 -0
  17. package/dist/templates/commands/pt-BR/engineer/pre-pr.md +38 -0
  18. package/dist/templates/commands/pt-BR/engineer/start.md +38 -0
  19. package/dist/templates/commands/pt-BR/engineer/work.md +38 -0
  20. package/dist/templates/commands/pt-BR/products/check.md +38 -0
  21. package/dist/templates/commands/pt-BR/products/collect.md +38 -0
  22. package/dist/templates/commands/pt-BR/products/refine.md +38 -0
  23. package/dist/templates/commands/pt-BR/products/spec.md +38 -0
  24. package/dist/templates/commands/pt-BR/quality/metrics.md +38 -0
  25. package/dist/templates/commands/pt-BR/quality/observe.md +38 -0
  26. package/dist/templates/commands/pt-BR/warm-up.md +38 -0
  27. package/package.json +1 -1
  28. package/templates/commands/en/engineer/plan.md +48 -10
  29. package/templates/commands/en/engineer/pr.md +46 -8
  30. package/templates/commands/en/engineer/pre-pr.md +49 -11
  31. package/templates/commands/en/engineer/start.md +60 -23
  32. package/templates/commands/en/engineer/work.md +45 -7
  33. package/templates/commands/en/products/check.md +48 -11
  34. package/templates/commands/en/products/collect.md +51 -14
  35. package/templates/commands/es/engineer/plan.md +60 -22
  36. package/templates/commands/es/engineer/pr.md +47 -9
  37. package/templates/commands/es/engineer/pre-pr.md +59 -21
  38. package/templates/commands/es/engineer/start.md +52 -15
  39. package/templates/commands/es/engineer/work.md +91 -53
  40. package/templates/commands/es/products/check.md +48 -10
  41. package/templates/commands/es/products/collect.md +55 -18
  42. package/templates/commands/pt-BR/engineer/plan.md +38 -0
  43. package/templates/commands/pt-BR/engineer/pr.md +38 -0
  44. package/templates/commands/pt-BR/engineer/pre-pr.md +38 -0
  45. package/templates/commands/pt-BR/engineer/start.md +38 -0
  46. package/templates/commands/pt-BR/engineer/work.md +38 -0
  47. package/templates/commands/pt-BR/products/check.md +38 -0
  48. package/templates/commands/pt-BR/products/collect.md +38 -0
  49. package/templates/commands/pt-BR/products/refine.md +38 -0
  50. package/templates/commands/pt-BR/products/spec.md +38 -0
  51. package/templates/commands/pt-BR/quality/metrics.md +38 -0
  52. package/templates/commands/pt-BR/quality/observe.md +38 -0
  53. package/templates/commands/pt-BR/warm-up.md +38 -0
@@ -2,12 +2,50 @@
2
2
 
3
3
  Este comando valida que todo está listo para crear Pull Requests.
4
4
 
5
- ## 📋 Requisitos previos
5
+ ## 📋 Requisitos Previos
6
6
 
7
7
  - Implementación completa (todas las tareas del `/plan` ejecutadas)
8
8
  - Todos los commits realizados
9
9
  - Workspace limpio y organizado
10
10
 
11
+ ## 📋 Configuración del Proyecto
12
+
13
+ **⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
14
+
15
+ ### Archivos Obligatorios
16
+
17
+ 1. **`context-manifest.json`** (raíz del orquestador)
18
+ - Lista de repositorios del proyecto
19
+ - Roles de cada repositorio (metaspecs, application, etc.)
20
+ - URLs y dependencias entre repositorios
21
+
22
+ 2. **`ai.properties.md`** (raíz del orquestador)
23
+ - Configuraciones del proyecto (`project_name`, `base_path`)
24
+ - Sistema de gestión de tareas (`task_management_system`)
25
+ - Credenciales y configuraciones específicas
26
+
27
+ ### Cómo Leer
28
+
29
+ ```bash
30
+ # 1. Leer context-manifest.json
31
+ cat context-manifest.json
32
+
33
+ # 2. Leer ai.properties.md
34
+ cat ai.properties.md
35
+ ```
36
+
37
+ ### Información Esencial
38
+
39
+ Después de leer los archivos, tendrás:
40
+ - ✅ Lista completa de repositorios del proyecto
41
+ - ✅ Ubicación del repositorio de metaspecs
42
+ - ✅ Base path para localizar repositorios
43
+ - ✅ Sistema de gestión de tareas configurado
44
+ - ✅ Configuraciones específicas del proyecto
45
+
46
+ **🛑 NO continúe sin leer estos archivos!** ¡Contienen información crítica para la correcta ejecución del comando!
47
+
48
+
11
49
  ## 🎯 Objetivo
12
50
 
13
51
  Garantizar que la implementación está completa, probada y lista para revisión antes de crear los PRs.
@@ -32,8 +70,8 @@ Garantizar que la implementación está completa, probada y lista para revisión
32
70
 
33
71
  **REGLA ABSOLUTA**:
34
72
  - 🛑 **TODO código** (tests, fixes, configuraciones) **DEBE estar en** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
35
- - 🛑 **NUNCA modifiques** el repositorio principal en `{base_path}/<repo-name>/`
36
- - ✅ **Trabaja SOLO** dentro del worktree del repositorio específico
73
+ - 🛑 **NUNCA modifique** el repositorio principal en `{base_path}/<repo-name>/`
74
+ - ✅ **Trabaje SOLO** dentro del worktree del repositorio específico
37
75
 
38
76
  ## ✅ Checklist de Validación
39
77
 
@@ -45,7 +83,7 @@ Garantizar que la implementación está completa, probada y lista para revisión
45
83
  - [ ] Todas las tareas del plan fueron ejecutadas
46
84
  - [ ] Todos los requisitos funcionales del PRD fueron implementados
47
85
  - [ ] Todos los criterios de aceptación fueron cumplidos
48
- - [ ] Ninguna funcionalidad quedó a medias
86
+ - [ ] Ninguna funcionalidad quedó incompleta
49
87
  ```
50
88
 
51
89
  ### 2. Calidad del Código
@@ -162,9 +200,9 @@ Checklist:
162
200
 
163
201
  - [ ] README actualizado (si es necesario)
164
202
  - [ ] Comentarios de código adecuados
165
- - [ ] Documentación de APIs actualizada (si hay cambios)
203
+ - [ ] Documentación de APIs actualizada (si hubo cambios)
166
204
  - [ ] Changelog actualizado
167
- - [ ] Documentación técnica actualizada en metaspecs (si aplica)
205
+ - [ ] Documentación técnica actualizada en las metaspecs (si aplica)
168
206
  ```
169
207
 
170
208
  ### 5. Commits
@@ -173,9 +211,9 @@ Checklist:
173
211
  ## Commits
174
212
 
175
213
  - [ ] Todos los commits tienen mensajes claros y descriptivos
176
- - [ ] Commits siguen el estándar del proyecto (conventional commits, etc.)
214
+ - [ ] Los commits siguen el estándar del proyecto (conventional commits, etc.)
177
215
  - [ ] No hay commits con mensajes genéricos ("fix", "update", etc.)
178
- - [ ] Commits están organizados lógicamente
216
+ - [ ] Los commits están organizados lógicamente
179
217
  - [ ] No hay commits de debug o temporales
180
218
  ```
181
219
 
@@ -184,7 +222,7 @@ Checklist:
184
222
  ```markdown
185
223
  ## Sincronización
186
224
 
187
- - [ ] Branches están actualizadas con la branch base (main/develop)
225
+ - [ ] Las ramas están actualizadas con la rama base (main/develop)
188
226
  - [ ] No hay conflictos de merge
189
227
  - [ ] Cambios entre repositorios están sincronizados
190
228
  - [ ] Dependencias entre repos fueron probadas
@@ -198,7 +236,7 @@ Checklist:
198
236
  - [ ] No hay credenciales o secretos en el código
199
237
  - [ ] No hay datos sensibles en logs
200
238
  - [ ] Dependencias de seguridad fueron verificadas
201
- - [ ] No hay vulnerabilidades conocidas introducidas
239
+ - [ ] No se introdujeron vulnerabilidades conocidas
202
240
  ```
203
241
 
204
242
  ### 8. Performance
@@ -206,15 +244,15 @@ Checklist:
206
244
  ```markdown
207
245
  ## Performance
208
246
 
209
- - [ ] No hay regresiones de performance obvias
247
+ - [ ] No hay regresiones de performance evidentes
210
248
  - [ ] Queries/operaciones costosas fueron optimizadas
211
- - [ ] No hay memory leaks introducidos
249
+ - [ ] No se introdujeron memory leaks
212
250
  - [ ] Requisitos de performance del PRD fueron cumplidos
213
251
  ```
214
252
 
215
253
  ## 🔍 Validación Cruzada
216
254
 
217
- Si múltiples repositorios fueron modificados:
255
+ Si se modificaron múltiples repositorios:
218
256
 
219
257
  ```markdown
220
258
  ## Validación Cruzada
@@ -222,12 +260,12 @@ Si múltiples repositorios fueron modificados:
222
260
  - [ ] Probé la integración entre los repositorios localmente
223
261
  - [ ] APIs/contratos entre repos están consistentes
224
262
  - [ ] No hay breaking changes no documentados
225
- - [ ] Orden de deploy/merge está claro
263
+ - [ ] El orden de deploy/merge está claro
226
264
  ```
227
265
 
228
266
  ## 📄 Preparación de la Descripción del PR
229
267
 
230
- Crea `./.sessions/<ISSUE-ID>/pr-description.md`:
268
+ Cree `./.sessions/<ISSUE-ID>/pr-description.md`:
231
269
 
232
270
  ```markdown
233
271
  ## 🎯 Objetivo
@@ -251,7 +289,7 @@ Crea `./.sessions/<ISSUE-ID>/pr-description.md`:
251
289
  - [x] Linting y formateo OK
252
290
  - [x] Build sin errores
253
291
 
254
- ## 🧪 Cómo Testear
292
+ ## 🧪 Cómo Probar
255
293
  1. [Paso 1]
256
294
  2. [Paso 2]
257
295
  3. [Resultado esperado]
@@ -264,14 +302,14 @@ Crea `./.sessions/<ISSUE-ID>/pr-description.md`:
264
302
  ## 🚨 Problemas Encontrados
265
303
 
266
304
  Si alguna validación falla:
267
- 1. 🛑 **DETÉN** el proceso de creación de PR
268
- 2. 📝 **DOCUMENTA** el problema
269
- 3. 🔧 **CORRIGE** el problema
270
- 4. 🔄 **EJECUTA** `/pre-pr` nuevamente
305
+ 1. 🛑 **PARE** el proceso de creación de PR
306
+ 2. 📝 **DOCUMENTE** el problema
307
+ 3. 🔧 **CORRIJA** el problema
308
+ 4. 🔄 **EJECUTE** `/pre-pr` nuevamente
271
309
 
272
310
  ## 📊 Reporte de Validación
273
311
 
274
- Crea `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
312
+ Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
275
313
 
276
314
  ```markdown
277
315
  # Reporte de Validación Pre-PR
@@ -26,6 +26,43 @@ Este comando inicia el desarrollo de una funcionalidad en el workspace actual.
26
26
  - ❌ NUNCA haga checkout en los repositorios principales
27
27
  - ❌ NUNCA modifique código en este comando (use `/work` después)
28
28
 
29
+ ## 📋 Configuración del Proyecto
30
+
31
+ **⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
32
+
33
+ ### Archivos Obligatorios
34
+
35
+ 1. **`context-manifest.json`** (raíz del orchestrator)
36
+ - Lista de repositorios del proyecto
37
+ - Roles de cada repositorio (metaspecs, application, etc.)
38
+ - URLs y dependencias entre repositorios
39
+
40
+ 2. **`ai.properties.md`** (raíz del orchestrator)
41
+ - Configuraciones del proyecto (`project_name`, `base_path`)
42
+ - Sistema de gestión de tareas (`task_management_system`)
43
+ - Credenciales y configuraciones específicas
44
+
45
+ ### Cómo Leer
46
+
47
+ ```bash
48
+ # 1. Leer context-manifest.json
49
+ cat context-manifest.json
50
+
51
+ # 2. Leer ai.properties.md
52
+ cat ai.properties.md
53
+ ```
54
+
55
+ ### Información Esencial
56
+
57
+ Después de leer los archivos, tendrá:
58
+ - ✅ Lista completa de repositorios del proyecto
59
+ - ✅ Ubicación del repositorio de metaspecs
60
+ - ✅ Base path para localizar repositorios
61
+ - ✅ Sistema de gestión de tareas configurado
62
+ - ✅ Configuraciones específicas del proyecto
63
+
64
+ **🛑 NO continúe sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
65
+
29
66
  ## 📚 Cargar MetaSpecs
30
67
 
31
68
  **Localizar MetaSpecs automáticamente**:
@@ -43,7 +80,7 @@ Este comando inicia el desarrollo de una funcionalidad en el workspace actual.
43
80
 
44
81
  Antes de iniciar, cargue el contexto consultando:
45
82
  - `context-manifest.json` - Estructura de repositorios
46
- - MetaSpecs (localizado arriba) - Arquitectura y patrones
83
+ - MetaSpecs (ubicado arriba) - Arquitectura y patrones
47
84
  - `directorio del workspace` - Información del workspace actual
48
85
 
49
86
  ## ⚙️ Configuración Inicial
@@ -57,10 +94,10 @@ Antes de iniciar, cargue el contexto consultando:
57
94
  - Confirme que todas las branches están sincronizadas
58
95
 
59
96
  3. **Cargar Especificación**:
60
- - **Si task manager configurado**: Lea la issue usando el MCP apropiado
97
+ - **Si el task manager está configurado**: Lea la issue usando el MCP apropiado
61
98
  - **Si no**: Pida al usuario el archivo de especificación o descripción de la feature
62
99
 
63
- 4. **Actualizar Estado** (si task manager configurado):
100
+ 4. **Actualizar Estado** (si el task manager está configurado):
64
101
  - Mueva la issue a "En Progreso"
65
102
 
66
103
  ## 📋 Análisis y Entendimiento
@@ -86,7 +123,7 @@ Analice la especificación y construya un entendimiento completo respondiendo:
86
123
  ### Validación contra MetaSpecs
87
124
 
88
125
  Si metaspecs están disponibles, validar:
89
- - ¿Está alineado con la estrategia y roadmap?
126
+ - ¿Está alineado con estrategia y roadmap?
90
127
  - ¿Usa stack tecnológica aprobada?
91
128
  - ¿Respeta Architecture Decision Records?
92
129
  - ¿Sigue reglas de negocio documentadas?
@@ -134,11 +171,11 @@ Cree el archivo `./.sessions/<ISSUE-ID>/context.md` con:
134
171
  ## Restricciones
135
172
  [Limitaciones técnicas, objetivos de performance, presupuesto]
136
173
 
137
- ## Tests
138
- [E2E críticos, unit tests necesarios, cobertura esperada]
174
+ ## Pruebas
175
+ [E2E críticos, pruebas unitarias necesarias, cobertura esperada]
139
176
  ```
140
177
 
141
- **Después de crear `context.md`, pida revisión y aprobación al usuario antes de continuar.**
178
+ **Después de crear `context.md`, solicite revisión y aprobación del usuario antes de continuar.**
142
179
 
143
180
  ---
144
181
 
@@ -160,9 +197,9 @@ Cree el archivo `./.sessions/<ISSUE-ID>/context.md` con:
160
197
  - Lea patrones de código en metaspecs
161
198
  - Identifique patrones existentes en el código (use Glob/Grep para encontrar ejemplos similares)
162
199
 
163
- 3. **Validar compliance con ADRs**:
200
+ 3. **Validar cumplimiento con ADRs**:
164
201
  - Para cada ADR relevante, verifique si la solución propuesta respeta las decisiones
165
- - Documente compliance en architecture.md
202
+ - Documente el cumplimiento en architecture.md
166
203
  - Si hay violación, justifique o proponga corrección
167
204
 
168
205
  4. **Analizar código existente**:
@@ -204,16 +241,16 @@ repo-1/
204
241
  ```
205
242
 
206
243
  ## Patrones y Mejores Prácticas
207
- [Patrones que se mantendrán o introducirán]
244
+ [Patrones que serán mantenidos o introducidos]
208
245
 
209
246
  ## Validación de ADRs
210
- [Lista de ADRs consultados y compliance]
247
+ [Lista de ADRs consultados y cumplimiento]
211
248
 
212
- - [x] ADR-001: [Nombre] - Compliant
213
- - [x] ADR-002: [Nombre] - Compliant
249
+ - [x] ADR-001: [Nombre] - Cumple
250
+ - [x] ADR-002: [Nombre] - Cumple
214
251
 
215
252
  ## Dependencias Externas
216
- [Bibliotecas que se usarán o añadirán]
253
+ [Bibliotecas que serán usadas o añadidas]
217
254
 
218
255
  ## Decisiones Técnicas
219
256
 
@@ -248,7 +285,7 @@ repo-1/
248
285
  - `repo-2/src/controllers/NewController.ts` (CREAR)
249
286
  ```
250
287
 
251
- **Después de crear `architecture.md`, pida revisión y aprobación al usuario antes de continuar.**
288
+ **Después de crear `architecture.md`, solicite revisión y aprobación del usuario antes de continuar.**
252
289
 
253
290
  ---
254
291
 
@@ -2,19 +2,57 @@
2
2
 
3
3
  Este comando ejecuta una unidad de trabajo en el workspace actual, implementando parte del plan técnico.
4
4
 
5
- ## 📋 Prerrequisitos
5
+ ## 📋 Requisitos Previos
6
6
 
7
- Antes de ejecutar, asegúrate de que:
8
- - Has ejecutado `/start` y `/plan` para tener el plan técnico
9
- - Estás en el workspace correcto: `<orchestrator>/.sessions/<ISSUE-ID>/`
10
- - Tienes disponibles los archivos `.sessions/<ISSUE-ID>/`:
7
+ Antes de ejecutar, asegúrese de que:
8
+ - Ha ejecutado `/start` y `/plan` para obtener el plan técnico
9
+ - Está en el workspace correcto: `<orchestrator>/.sessions/<ISSUE-ID>/`
10
+ - Tiene disponibles los archivos `.sessions/<ISSUE-ID>/`:
11
11
  - `context.md` (inmutable)
12
12
  - `architecture.md` (inmutable)
13
13
  - `plan.md` (mutable)
14
14
 
15
- ## 📍 IMPORTANTE: Entiende la Estructura
15
+ ## 📋 Configuración del Proyecto
16
16
 
17
- **Workspace** (donde trabajas):
17
+ **⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
18
+
19
+ ### Archivos Obligatorios
20
+
21
+ 1. **`context-manifest.json`** (raíz del orchestrator)
22
+ - Lista de repositorios del proyecto
23
+ - Roles de cada repositorio (metaspecs, application, etc.)
24
+ - URLs y dependencias entre repositorios
25
+
26
+ 2. **`ai.properties.md`** (raíz del orchestrator)
27
+ - Configuraciones del proyecto (`project_name`, `base_path`)
28
+ - Sistema de gestión de tareas (`task_management_system`)
29
+ - Credenciales y configuraciones específicas
30
+
31
+ ### Cómo Leer
32
+
33
+ ```bash
34
+ # 1. Leer context-manifest.json
35
+ cat context-manifest.json
36
+
37
+ # 2. Leer ai.properties.md
38
+ cat ai.properties.md
39
+ ```
40
+
41
+ ### Información Esencial
42
+
43
+ Después de leer los archivos, tendrá:
44
+ - ✅ Lista completa de repositorios del proyecto
45
+ - ✅ Ubicación del repositorio de metaspecs
46
+ - ✅ Base path para localizar repositorios
47
+ - ✅ Sistema de gestión de tareas configurado
48
+ - ✅ Configuraciones específicas del proyecto
49
+
50
+ **🛑 NO continúe sin leer estos archivos!** ¡Contienen información crítica para la correcta ejecución del comando!
51
+
52
+
53
+ ## 📍 IMPORTANTE: Entienda la Estructura
54
+
55
+ **Workspace** (donde trabaja):
18
56
  ```
19
57
  <orchestrator>/.sessions/<ISSUE-ID>/
20
58
  ├── repo-1/ # worktree con branch feature/<ISSUE-ID>
@@ -31,10 +69,10 @@ Antes de ejecutar, asegúrate de que:
31
69
  ```
32
70
 
33
71
  **REGLA DE ORO**:
34
- - ✅ Trabaja SÓLO dentro de `<orchestrator>/.sessions/<ISSUE-ID>/`
35
- - ✅ Haz commits en los worktrees dentro del workspace
36
- - ❌ NUNCA hagas checkout en los repositorios principales
37
- - ❌ NUNCA navegues a `{base_path}/{repo-id}/`
72
+ - ✅ Trabaje SOLO dentro de `<orchestrator>/.sessions/<ISSUE-ID>/`
73
+ - ✅ Haga commits en los worktrees dentro del workspace
74
+ - ❌ NUNCA haga checkout en los repositorios principales
75
+ - ❌ NUNCA navegue a `{base_path}/{repo-id}/`
38
76
 
39
77
  ## 🛑 CRÍTICO: DÓNDE CREAR CÓDIGO
40
78
 
@@ -56,7 +94,7 @@ Antes de ejecutar, asegúrate de que:
56
94
 
57
95
  **REGLA ABSOLUTA**:
58
96
  - 🛑 **TODO archivo de código** (`.ts`, `.js`, `.py`, `.java`, etc.) **DEBE estar dentro de** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
59
- - 🛑 **NUNCA crees código** directamente en `<orchestrator>/.sessions/` o `<orchestrator>/.sessions/<ISSUE-ID>/`
97
+ - 🛑 **NUNCA cree código** directamente en `<orchestrator>/.sessions/` o `<orchestrator>/.sessions/<ISSUE-ID>/`
60
98
  - ✅ **Único lugar válido**: Dentro del worktree del repositorio específico
61
99
 
62
100
  ## ⚠️ IMPORTANTE: Archivos Inmutables
@@ -74,11 +112,11 @@ Antes de ejecutar, asegúrate de que:
74
112
  ## 📚 Cargar MetaSpecs
75
113
 
76
114
  **Localizar MetaSpecs automáticamente**:
77
- 1. Lee `context-manifest.json` del orchestrator
78
- 2. Encuentra el repositorio con `"role": "metaspecs"`
79
- 3. Lee `ai.properties.md` para obtener el `base_path`
115
+ 1. Lea `context-manifest.json` del orchestrator
116
+ 2. Encuentre el repositorio con `"role": "metaspecs"`
117
+ 3. Lea `ai.properties.md` para obtener el `base_path`
80
118
  4. El metaspecs está en: `{base_path}/{metaspecs-repo-id}/`
81
- 5. Lee los archivos `index.md` relevantes durante la implementación para:
119
+ 5. Lea los archivos `index.md` relevantes durante la implementación para:
82
120
  - Seguir patrones de código
83
121
  - Respetar arquitectura definida
84
122
  - Usar convenciones correctas
@@ -95,26 +133,26 @@ Implementar una unidad de trabajo específica del plan, que puede involucrar:
95
133
 
96
134
  **⚠️ IMPORTANTE: CONTROL DE PROGRESO**
97
135
 
98
- Este comando ejecuta el trabajo en **fases incrementales**. Tras completar cada **FASE PRINCIPAL** (ej: Fase 1 → Fase 2):
136
+ Este comando ejecuta el trabajo en **fases incrementales**. Después de completar cada **FASE PRINCIPAL** (ej: Fase 1 → Fase 2):
99
137
 
100
- 1. 🛑 **DETÉN** la ejecución
101
- 2. 📊 **PRESENTA** un resumen de lo realizado
102
- 3. ❓ **PREGUNTA** al desarrollador si quiere:
138
+ 1. 🛑 **PARE** la ejecución
139
+ 2. 📊 **PRESENTE** un resumen de lo realizado
140
+ 3. ❓ **PREGUNTE** al desarrollador si desea:
103
141
  - Revisar el código implementado
104
142
  - Hacer ajustes antes de continuar
105
143
  - Continuar a la siguiente fase
106
144
 
107
145
  **IMPORTANTE**:
108
- - ✅ **PAUSA** entre fases principales (Fase 1 → Fase 2 → Fase 3)
109
- - ❌ **NO pauses** entre subfases (Fase 1.1 → Fase 1.2 → Fase 1.3)
146
+ - ✅ **PAUSE** entre fases principales (Fase 1 → Fase 2 → Fase 3)
147
+ - ❌ **NO pause** entre subfases (Fase 1.1 → Fase 1.2 → Fase 1.3)
110
148
 
111
- **NO implementes todo de una vez**. Trabaja fase principal por fase principal, esperando confirmación del desarrollador.
149
+ **NO implemente todo de una vez**. Trabaje fase principal por fase principal, esperando confirmación del desarrollador.
112
150
 
113
151
  ---
114
152
 
115
153
  ### 1. Identificar Unidad de Trabajo
116
154
 
117
- Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifica:
155
+ Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifique:
118
156
  - Qué tarea específica se implementará ahora
119
157
  - En cuál(es) repositorio(s) del workspace
120
158
  - Qué archivos serán creados/modificados
@@ -124,34 +162,34 @@ Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifica:
124
162
 
125
163
 
126
164
 
127
- **IMPORTANTE**: Trabaja SÓLO dentro del workspace en `.sessions/<ISSUE-ID>/`
165
+ **IMPORTANTE**: Trabaje SOLO dentro del workspace en `.sessions/<ISSUE-ID>/`
128
166
 
129
167
  Para cada repositorio en el workspace:
130
168
 
131
169
  ```bash
132
- # Navega al worktree dentro del workspace
170
+ # Navegue al worktree dentro del workspace
133
171
  cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
134
172
 
135
- # Verifica que estás en la branch correcta
173
+ # Verifique que está en la rama correcta
136
174
  git branch # debe mostrar * feature/<ISSUE-ID>
137
175
 
138
- # Implementa el código aquí
176
+ # Implemente el código aquí
139
177
  ```
140
178
 
141
- Ejecuta la implementación siguiendo:
142
- - **Patrones del proyecto**: Consulta guías de estilo y arquitectura
143
- - **Stack aprobada**: Usa sólo tecnologías documentadas en las metaspecs
144
- - **Pruebas**: Implementa pruebas conforme a los estándares del proyecto
145
- - **Documentación**: Actualiza comentarios y docs cuando sea necesario
179
+ Ejecute la implementación siguiendo:
180
+ - **Patrones del proyecto**: Consulte guías de estilo y arquitectura
181
+ - **Stack aprobada**: Use solo tecnologías documentadas en metaspecs
182
+ - **Pruebas**: Implemente pruebas conforme a los patrones del proyecto
183
+ - **Documentación**: Actualice comentarios y docs cuando sea necesario
146
184
 
147
185
 
148
186
 
149
187
  ### 3. Validación Local
150
188
 
151
189
  Antes de commitear:
152
- - Ejecuta pruebas unitarias/integración
153
- - Verifica linting y formato
154
- - Confirma que no rompiste funcionalidades existentes
190
+ - Ejecute pruebas unitarias/integración
191
+ - Verifique linting y formato
192
+ - Confirme que no rompió funcionalidades existentes
155
193
 
156
194
 
157
195
 
@@ -160,10 +198,10 @@ Antes de commitear:
160
198
  Para cada repositorio modificado **dentro del workspace**:
161
199
 
162
200
  ```bash
163
- # Navega al worktree dentro del workspace
201
+ # Navegue al worktree dentro del workspace
164
202
  cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
165
203
 
166
- # Añade los cambios
204
+ # Añada los cambios
167
205
  git add .
168
206
 
169
207
  # Commit
@@ -177,15 +215,15 @@ Refs: <ISSUE-ID>"
177
215
 
178
216
  **Tipos de commit**: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
179
217
 
180
- **⚠️ PAUSA OBLIGATORIA**: Tras completar TODA la fase principal (identificación + implementación + validación + commit + actualización del plan.md), **DETÉN** y muestra al desarrollador:
218
+ **⚠️ PAUSA OBLIGATORIA**: Después de completar TODA la fase principal (identificación + implementación + validación + commit + actualización del plan.md), **PARE** y muestre al desarrollador:
181
219
  - Resumen completo de la fase
182
220
  - Archivos creados/modificados
183
221
  - Commits realizados
184
- - Pregunta si quiere revisar o continuar a la siguiente fase
222
+ - Pregunte si desea revisar o continuar a la siguiente fase
185
223
 
186
224
  ### 5. Actualización del Plan.md
187
225
 
188
- **POR CADA tarea completada**, actualiza `./.sessions/<ISSUE-ID>/plan.md`:
226
+ **POR CADA tarea completada**, actualice `./.sessions/<ISSUE-ID>/plan.md`:
189
227
 
190
228
  ```markdown
191
229
  #### 1.1 - [Nombre de la Tarea] [Completada ✅]
@@ -206,8 +244,8 @@ Refs: <ISSUE-ID>"
206
244
  - Aprendizaje: [Algo aprendido durante implementación]
207
245
  ```
208
246
 
209
- **Marca el estado de las tareas**:
210
- - `[No Iniciada ⏳]` - Tarea aún no comenzó
247
+ **Marque estado de las tareas**:
248
+ - `[No Iniciada ⏳]` - Tarea aún no comenzada
211
249
  - `[En Progreso ⏰]` - Tarea en curso
212
250
  - `[Completada ✅]` - Tarea finalizada y validada
213
251
 
@@ -223,11 +261,11 @@ Antes de considerar la unidad completa:
223
261
 
224
262
  ## ⚠️ Principio Jidoka
225
263
 
226
- Si encuentras problemas durante la implementación:
227
- 1. 🛑 **DETÉN** la implementación
228
- 2. 📝 **DOCUMENTA** el problema encontrado
229
- 3. 💬 **ALERTA** al usuario y discute soluciones
230
- 4. 🔄 **AJUSTA** el plan si es necesario
264
+ Si encuentra problemas durante la implementación:
265
+ 1. 🛑 **PARE** la implementación
266
+ 2. 📝 **DOCUMENTE** el problema encontrado
267
+ 3. 💬 **ALERTE** al usuario y discuta soluciones
268
+ 4. 🔄 **AJUSTE** el plan si es necesario
231
269
 
232
270
  ---
233
271
 
@@ -241,12 +279,12 @@ Si encuentras problemas durante la implementación:
241
279
 
242
280
  ## 🎯 Próximos Pasos
243
281
 
244
- - **Continuar implementación**: Ejecuta `/work` nuevamente para la siguiente unidad
245
- - **Finalizar feature**: Cuando todo esté implementado, ejecuta `/pre-pr`
282
+ - **Continuar implementación**: Ejecute `/work` nuevamente para la próxima unidad
283
+ - **Finalizar feature**: Cuando todo esté implementado, ejecute `/pre-pr`
246
284
 
247
285
  ## 💡 Consejos
248
286
 
249
- - Trabaja en unidades pequeñas e incrementales
287
+ - Trabaje en unidades pequeñas e incrementales
250
288
  - Commit frecuente (commits atómicos)
251
- - Documenta decisiones importantes en la sesión
252
- - Mantén los repositorios sincronizados entre sí
289
+ - Documente decisiones importantes en la sesión
290
+ - Mantenga los repositorios sincronizados entre sí
@@ -1,4 +1,4 @@
1
- # Validación contra Metaspecs
1
+ # Validación contra MetaSpecs
2
2
 
3
3
  Este comando valida requisitos, decisiones o implementaciones contra las metaspecs del proyecto.
4
4
 
@@ -12,6 +12,44 @@ Este comando valida requisitos, decisiones o implementaciones contra las metaspe
12
12
  - ❌ **NO modificar código**
13
13
  - ❌ **NO modificar `context.md` o `architecture.md`**
14
14
 
15
+ ## 📋 Configuración del Proyecto
16
+
17
+ **⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
18
+
19
+ ### Archivos Obligatorios
20
+
21
+ 1. **`context-manifest.json`** (raíz del orchestrator)
22
+ - Lista de repositorios del proyecto
23
+ - Roles de cada repositorio (metaspecs, application, etc.)
24
+ - URLs y dependencias entre repositorios
25
+
26
+ 2. **`ai.properties.md`** (raíz del orchestrator)
27
+ - Configuraciones del proyecto (`project_name`, `base_path`)
28
+ - Sistema de gestión de tareas (`task_management_system`)
29
+ - Credenciales y configuraciones específicas
30
+
31
+ ### Cómo Leer
32
+
33
+ ```bash
34
+ # 1. Leer context-manifest.json
35
+ cat context-manifest.json
36
+
37
+ # 2. Leer ai.properties.md
38
+ cat ai.properties.md
39
+ ```
40
+
41
+ ### Información Esencial
42
+
43
+ Después de leer los archivos, tendrá:
44
+ - ✅ Lista completa de repositorios del proyecto
45
+ - ✅ Ubicación del repositorio de metaspecs
46
+ - ✅ Base path para localizar repositorios
47
+ - ✅ Sistema de gestión de tareas configurado
48
+ - ✅ Configuraciones específicas del proyecto
49
+
50
+ **🛑 NO continúe sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
51
+
52
+
15
53
  ## 🎯 Objetivo
16
54
 
17
55
  Garantizar alineación con:
@@ -38,7 +76,7 @@ Ejecute este comando:
38
76
 
39
77
  ## 🔍 Proceso de Validación
40
78
 
41
- ### 1. Identificar Metaspecs Disponibles
79
+ ### 1. Identificar MetaSpecs Disponibles
42
80
 
43
81
  Navegue hasta el directorio de metaspecs e identifique qué metaspecs existen:
44
82
 
@@ -55,7 +93,7 @@ Si existen metaspecs de negocio (`repositorio de MetaSpecs (sección de negocio)
55
93
 
56
94
  ### Estrategia de Producto
57
95
  - **Archivo**: `repositorio de MetaSpecs (sección de negocio)PRODUCT_STRATEGY.md`
58
- - **Validación**: [¿Esta funcionalidad está alineada con la estrategia?]
96
+ - **Validación**: [¿Esta feature está alineada con la estrategia?]
59
97
  - **Estado**: ✅ Alineado / ⚠️ Parcialmente / ❌ Desalineado
60
98
  - **Notas**: [Observaciones]
61
99
 
@@ -87,7 +125,7 @@ Si existen metaspecs técnicas (`repositorio de MetaSpecs (sección técnica)`):
87
125
 
88
126
  ### Arquitectura
89
127
  - **Archivo**: `repositorio de MetaSpecs (sección técnica)ARCHITECTURE.md`
90
- - **Validación**: [¿Sigue estándares arquitectónicos?]
128
+ - **Validación**: [¿Sigue patrones arquitectónicos?]
91
129
  - **Estado**: ✅ Conforme / ⚠️ Parcialmente / ❌ No conforme
92
130
  - **Notas**: [Observaciones]
93
131
 
@@ -140,7 +178,7 @@ Si hay conflictos o desalineamientos:
140
178
  - **Recomendación**: [Cómo resolver]
141
179
 
142
180
  ### Conflicto 2: [Descripción]
143
- [Mismo formato anterior]
181
+ [Mismo formato arriba]
144
182
  ```
145
183
 
146
184
  ### 6. Excepciones Justificadas
@@ -203,17 +241,17 @@ Si el MCP no está disponible o falla, cree `./.sessions/<ISSUE-ID>/check-report
203
241
  - [ ] Bloqueado
204
242
  ```
205
243
 
206
- Informe al usuario: "⚠️ Informe guardado localmente en .sessions/ (task manager no disponible)"
244
+ Informe al usuario: "⚠️ Informe guardado localmente en .sessions/ (gestor de tareas no disponible)"
207
245
 
208
246
  ## 🚨 Acción en Caso de Conflictos
209
247
 
210
248
  Si se encuentran conflictos críticos:
211
- 1. 🛑 **PARE** el proceso actual
249
+ 1. 🛑 **DETENGA** el proceso actual
212
250
  2. 📝 **DOCUMENTE** todos los conflictos
213
251
  3. 💬 **ALERTE** al usuario y stakeholders
214
- 4. **Via MCP**: Actualice estado de la issue a "Bloqueado" o "Requiere Ajustes"
252
+ 4. **Vía MCP**: Actualice el estado de la issue a "Bloqueado" o "Requiere Ajustes"
215
253
  5. 🔄 **AJUSTE** el plan/implementación según sea necesario
216
- 6. ✅ **REVALIDE** después de los ajustes
254
+ 6. ✅ **REVALIDE** tras los ajustes
217
255
 
218
256
  ---
219
257
 
@@ -228,6 +266,6 @@ Si se encuentran conflictos críticos:
228
266
  ## 🎯 Resultado
229
267
 
230
268
  Después de la validación:
231
- - Si ✅: Proceda a la siguiente fase
269
+ - Si ✅: Continúe a la siguiente fase
232
270
  - Si ⚠️: Documente reservas y continúe con aprobación
233
271
  - Si ❌: Corrija conflictos antes de continuar