context-first-cli 2.1.5 → 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 +73 -12
  3. package/dist/templates/commands/en/engineer/pre-pr.md +69 -8
  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 +71 -10
  10. package/dist/templates/commands/es/engineer/pre-pr.md +90 -29
  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 +61 -0
  17. package/dist/templates/commands/pt-BR/engineer/pre-pr.md +61 -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 +73 -12
  30. package/templates/commands/en/engineer/pre-pr.md +69 -8
  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 +71 -10
  37. package/templates/commands/es/engineer/pre-pr.md +90 -29
  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 +61 -0
  44. package/templates/commands/pt-BR/engineer/pre-pr.md +61 -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,16 +2,77 @@
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.
14
52
 
53
+ ## 🛑 CRÍTICO: DÓNDE TRABAJAR
54
+
55
+ **⚠️ ATENCIÓN: TODO CÓDIGO (tests, fixes, ajustes) DEBE SER CREADO DENTRO DEL WORKTREE!**
56
+
57
+ **✅ CORRECTO** - Trabajar dentro del worktree:
58
+ ```
59
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts ✅
60
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/tests/test.ts ✅
61
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/.eslintrc.js ✅
62
+ ```
63
+
64
+ **❌ INCORRECTO** - NUNCA crear código fuera del worktree:
65
+ ```
66
+ <orchestrator>/.sessions/test.ts ❌
67
+ <orchestrator>/.sessions/<ISSUE-ID>/test.ts ❌
68
+ {base_path}/<repo-name>/test.ts ❌ (¡repositorio principal!)
69
+ ```
70
+
71
+ **REGLA ABSOLUTA**:
72
+ - 🛑 **TODO código** (tests, fixes, configuraciones) **DEBE estar en** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
73
+ - 🛑 **NUNCA modifique** el repositorio principal en `{base_path}/<repo-name>/`
74
+ - ✅ **Trabaje SOLO** dentro del worktree del repositorio específico
75
+
15
76
  ## ✅ Checklist de Validación
16
77
 
17
78
  ### 1. Completitud de la Implementación
@@ -22,7 +83,7 @@ Garantizar que la implementación está completa, probada y lista para revisión
22
83
  - [ ] Todas las tareas del plan fueron ejecutadas
23
84
  - [ ] Todos los requisitos funcionales del PRD fueron implementados
24
85
  - [ ] Todos los criterios de aceptación fueron cumplidos
25
- - [ ] Ninguna funcionalidad quedó a medias
86
+ - [ ] Ninguna funcionalidad quedó incompleta
26
87
  ```
27
88
 
28
89
  ### 2. Calidad del Código
@@ -79,14 +140,14 @@ Checklist:
79
140
  - [ ] Sin warnings críticos
80
141
  ```
81
142
 
82
- ### 3. Pruebas
143
+ ### 3. Tests
83
144
 
84
145
  Para cada repositorio:
85
146
 
86
147
  ```bash
87
148
  cd <repositorio>
88
149
 
89
- # Ejecutar pruebas unitarias (ejemplos por stack):
150
+ # Ejecutar tests unitarios (ejemplos por stack):
90
151
  # Node.js: npm run test:unit / jest / vitest
91
152
  # Python: pytest tests/unit / python -m unittest
92
153
  # Java: mvn test / gradle test
@@ -96,7 +157,7 @@ cd <repositorio>
96
157
  # PHP: ./vendor/bin/phpunit --testsuite=unit
97
158
  # C#: dotnet test --filter Category=Unit
98
159
 
99
- # Ejecutar pruebas de integración (ejemplos por stack):
160
+ # Ejecutar tests de integración (ejemplos por stack):
100
161
  # Node.js: npm run test:integration
101
162
  # Python: pytest tests/integration
102
163
  # Java: mvn verify / gradle integrationTest
@@ -117,19 +178,19 @@ cd <repositorio>
117
178
 
118
179
  Checklist:
119
180
  ```markdown
120
- ## Pruebas
181
+ ## Tests
121
182
 
122
183
  ### <repo-1>
123
- - [ ] Todas las pruebas unitarias pasando
124
- - [ ] Todas las pruebas de integración pasando
125
- - [ ] Cobertura de pruebas adecuada (>= X%)
126
- - [ ] Nuevas pruebas añadidas para nuevas funcionalidades
184
+ - [ ] Todos los tests unitarios pasan
185
+ - [ ] Todos los tests de integración pasan
186
+ - [ ] Cobertura de tests adecuada (>= X%)
187
+ - [ ] Nuevos tests añadidos para nuevas funcionalidades
127
188
 
128
189
  ### <repo-2>
129
- - [ ] Todas las pruebas unitarias pasando
130
- - [ ] Todas las pruebas de integración pasando
131
- - [ ] Cobertura de pruebas adecuada (>= X%)
132
- - [ ] Nuevas pruebas añadidas para nuevas funcionalidades
190
+ - [ ] Todos los tests unitarios pasan
191
+ - [ ] Todos los tests de integración pasan
192
+ - [ ] Cobertura de tests adecuada (>= X%)
193
+ - [ ] Nuevos tests añadidos para nuevas funcionalidades
133
194
  ```
134
195
 
135
196
  ### 4. Documentación
@@ -139,7 +200,7 @@ Checklist:
139
200
 
140
201
  - [ ] README actualizado (si es necesario)
141
202
  - [ ] Comentarios de código adecuados
142
- - [ ] Documentación de APIs actualizada (si hay cambios)
203
+ - [ ] Documentación de APIs actualizada (si hubo cambios)
143
204
  - [ ] Changelog actualizado
144
205
  - [ ] Documentación técnica actualizada en las metaspecs (si aplica)
145
206
  ```
@@ -161,7 +222,7 @@ Checklist:
161
222
  ```markdown
162
223
  ## Sincronización
163
224
 
164
- - [ ] Las branches están actualizadas con la branch base (main/develop)
225
+ - [ ] Las ramas están actualizadas con la rama base (main/develop)
165
226
  - [ ] No hay conflictos de merge
166
227
  - [ ] Cambios entre repositorios están sincronizados
167
228
  - [ ] Dependencias entre repos fueron probadas
@@ -172,10 +233,10 @@ Checklist:
172
233
  ```markdown
173
234
  ## Seguridad
174
235
 
175
- - [ ] No hay credenciales ni secrets en el código
236
+ - [ ] No hay credenciales o secretos en el código
176
237
  - [ ] No hay datos sensibles en logs
177
238
  - [ ] Dependencias de seguridad fueron verificadas
178
- - [ ] No hay vulnerabilidades conocidas introducidas
239
+ - [ ] No se introdujeron vulnerabilidades conocidas
179
240
  ```
180
241
 
181
242
  ### 8. Performance
@@ -185,7 +246,7 @@ Checklist:
185
246
 
186
247
  - [ ] No hay regresiones de performance evidentes
187
248
  - [ ] Queries/operaciones costosas fueron optimizadas
188
- - [ ] No hay memory leaks introducidos
249
+ - [ ] No se introdujeron memory leaks
189
250
  - [ ] Requisitos de performance del PRD fueron cumplidos
190
251
  ```
191
252
 
@@ -215,20 +276,20 @@ Cree `./.sessions/<ISSUE-ID>/pr-description.md`:
215
276
  - [Cambio 2]
216
277
  - [Cambio 3]
217
278
 
218
- ## 🔗 Enlaces
279
+ ## 🔗 Links
219
280
  - **Issue**: [ISSUE-ID]
220
281
  - **PRD**: [link o ruta]
221
282
  - **Plan Técnico**: [link o ruta]
222
283
 
223
284
  ## ✅ Checklist
224
285
  - [x] Código implementado y probado
225
- - [x] Pruebas unitarias añadidas/actualizadas
226
- - [x] Pruebas de integración pasando
286
+ - [x] Tests unitarios añadidos/actualizados
287
+ - [x] Tests de integración pasando
227
288
  - [x] Documentación actualizada
228
289
  - [x] Linting y formateo OK
229
290
  - [x] Build sin errores
230
291
 
231
- ## 🧪 Cómo Testear
292
+ ## 🧪 Cómo Probar
232
293
  1. [Paso 1]
233
294
  2. [Paso 2]
234
295
  3. [Resultado esperado]
@@ -246,12 +307,12 @@ Si alguna validación falla:
246
307
  3. 🔧 **CORRIJA** el problema
247
308
  4. 🔄 **EJECUTE** `/pre-pr` nuevamente
248
309
 
249
- ## 📊 Informe de Validación
310
+ ## 📊 Reporte de Validación
250
311
 
251
312
  Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
252
313
 
253
314
  ```markdown
254
- # Informe de Validación Pre-PR
315
+ # Reporte de Validación Pre-PR
255
316
 
256
317
  **Fecha**: [fecha/hora]
257
318
  **Issue**: [ISSUE-ID]
@@ -263,12 +324,12 @@ Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
263
324
  - **<repo-1>**: ✅ OK
264
325
  - **<repo-2>**: ✅ OK
265
326
 
266
- ## Resumen de Pruebas
267
- - **Pruebas Unitarias**: X/X pasando
268
- - **Pruebas de Integración**: Y/Y pasando
327
+ ## Resumen de Tests
328
+ - **Tests Unitarios**: X/X pasando
329
+ - **Tests de Integración**: Y/Y pasando
269
330
  - **Cobertura**: Z%
270
331
 
271
- ## Pendientes (si las hay)
332
+ ## Pendientes (si hay)
272
333
  - [Pendiente 1]
273
334
  - [Pendiente 2]
274
335
 
@@ -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í