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.
- package/dist/templates/commands/en/engineer/plan.md +48 -10
- package/dist/templates/commands/en/engineer/pr.md +73 -12
- package/dist/templates/commands/en/engineer/pre-pr.md +69 -8
- package/dist/templates/commands/en/engineer/start.md +60 -23
- package/dist/templates/commands/en/engineer/work.md +45 -7
- package/dist/templates/commands/en/products/check.md +48 -11
- package/dist/templates/commands/en/products/collect.md +51 -14
- package/dist/templates/commands/es/engineer/plan.md +60 -22
- package/dist/templates/commands/es/engineer/pr.md +71 -10
- package/dist/templates/commands/es/engineer/pre-pr.md +90 -29
- package/dist/templates/commands/es/engineer/start.md +52 -15
- package/dist/templates/commands/es/engineer/work.md +91 -53
- package/dist/templates/commands/es/products/check.md +48 -10
- package/dist/templates/commands/es/products/collect.md +55 -18
- package/dist/templates/commands/pt-BR/engineer/plan.md +38 -0
- package/dist/templates/commands/pt-BR/engineer/pr.md +61 -0
- package/dist/templates/commands/pt-BR/engineer/pre-pr.md +61 -0
- package/dist/templates/commands/pt-BR/engineer/start.md +38 -0
- package/dist/templates/commands/pt-BR/engineer/work.md +38 -0
- package/dist/templates/commands/pt-BR/products/check.md +38 -0
- package/dist/templates/commands/pt-BR/products/collect.md +38 -0
- package/dist/templates/commands/pt-BR/products/refine.md +38 -0
- package/dist/templates/commands/pt-BR/products/spec.md +38 -0
- package/dist/templates/commands/pt-BR/quality/metrics.md +38 -0
- package/dist/templates/commands/pt-BR/quality/observe.md +38 -0
- package/dist/templates/commands/pt-BR/warm-up.md +38 -0
- package/package.json +1 -1
- package/templates/commands/en/engineer/plan.md +48 -10
- package/templates/commands/en/engineer/pr.md +73 -12
- package/templates/commands/en/engineer/pre-pr.md +69 -8
- package/templates/commands/en/engineer/start.md +60 -23
- package/templates/commands/en/engineer/work.md +45 -7
- package/templates/commands/en/products/check.md +48 -11
- package/templates/commands/en/products/collect.md +51 -14
- package/templates/commands/es/engineer/plan.md +60 -22
- package/templates/commands/es/engineer/pr.md +71 -10
- package/templates/commands/es/engineer/pre-pr.md +90 -29
- package/templates/commands/es/engineer/start.md +52 -15
- package/templates/commands/es/engineer/work.md +91 -53
- package/templates/commands/es/products/check.md +48 -10
- package/templates/commands/es/products/collect.md +55 -18
- package/templates/commands/pt-BR/engineer/plan.md +38 -0
- package/templates/commands/pt-BR/engineer/pr.md +61 -0
- package/templates/commands/pt-BR/engineer/pre-pr.md +61 -0
- package/templates/commands/pt-BR/engineer/start.md +38 -0
- package/templates/commands/pt-BR/engineer/work.md +38 -0
- package/templates/commands/pt-BR/products/check.md +38 -0
- package/templates/commands/pt-BR/products/collect.md +38 -0
- package/templates/commands/pt-BR/products/refine.md +38 -0
- package/templates/commands/pt-BR/products/spec.md +38 -0
- package/templates/commands/pt-BR/quality/metrics.md +38 -0
- package/templates/commands/pt-BR/quality/observe.md +38 -0
- 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
|
|
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ó
|
|
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.
|
|
143
|
+
### 3. Tests
|
|
83
144
|
|
|
84
145
|
Para cada repositorio:
|
|
85
146
|
|
|
86
147
|
```bash
|
|
87
148
|
cd <repositorio>
|
|
88
149
|
|
|
89
|
-
# Ejecutar
|
|
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
|
|
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
|
-
##
|
|
181
|
+
## Tests
|
|
121
182
|
|
|
122
183
|
### <repo-1>
|
|
123
|
-
- [ ]
|
|
124
|
-
- [ ]
|
|
125
|
-
- [ ] Cobertura de
|
|
126
|
-
- [ ]
|
|
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
|
-
- [ ]
|
|
130
|
-
- [ ]
|
|
131
|
-
- [ ] Cobertura de
|
|
132
|
-
- [ ]
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
-
## 🔗
|
|
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]
|
|
226
|
-
- [x]
|
|
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
|
|
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
|
-
## 📊
|
|
310
|
+
## 📊 Reporte de Validación
|
|
250
311
|
|
|
251
312
|
Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
|
|
252
313
|
|
|
253
314
|
```markdown
|
|
254
|
-
#
|
|
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
|
|
267
|
-
- **
|
|
268
|
-
- **
|
|
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
|
|
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 (
|
|
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
|
|
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
|
-
##
|
|
138
|
-
[E2E críticos,
|
|
174
|
+
## Pruebas
|
|
175
|
+
[E2E críticos, pruebas unitarias necesarias, cobertura esperada]
|
|
139
176
|
```
|
|
140
177
|
|
|
141
|
-
**Después de crear `context.md`,
|
|
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
|
|
200
|
+
3. **Validar cumplimiento con ADRs**:
|
|
164
201
|
- Para cada ADR relevante, verifique si la solución propuesta respeta las decisiones
|
|
165
|
-
- Documente
|
|
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
|
|
244
|
+
[Patrones que serán mantenidos o introducidos]
|
|
208
245
|
|
|
209
246
|
## Validación de ADRs
|
|
210
|
-
[Lista de ADRs consultados y
|
|
247
|
+
[Lista de ADRs consultados y cumplimiento]
|
|
211
248
|
|
|
212
|
-
- [x] ADR-001: [Nombre] -
|
|
213
|
-
- [x] ADR-002: [Nombre] -
|
|
249
|
+
- [x] ADR-001: [Nombre] - Cumple
|
|
250
|
+
- [x] ADR-002: [Nombre] - Cumple
|
|
214
251
|
|
|
215
252
|
## Dependencias Externas
|
|
216
|
-
[Bibliotecas que
|
|
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`,
|
|
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
|
-
## 📋
|
|
5
|
+
## 📋 Requisitos Previos
|
|
6
6
|
|
|
7
|
-
Antes de ejecutar,
|
|
8
|
-
-
|
|
9
|
-
-
|
|
10
|
-
-
|
|
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
|
-
##
|
|
15
|
+
## 📋 Configuración del Proyecto
|
|
16
16
|
|
|
17
|
-
|
|
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
|
-
- ✅
|
|
35
|
-
- ✅
|
|
36
|
-
- ❌ NUNCA
|
|
37
|
-
- ❌ NUNCA
|
|
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
|
|
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.
|
|
78
|
-
2.
|
|
79
|
-
3.
|
|
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.
|
|
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**.
|
|
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. 🛑 **
|
|
101
|
-
2. 📊 **
|
|
102
|
-
3. ❓ **
|
|
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
|
-
- ✅ **
|
|
109
|
-
- ❌ **NO
|
|
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
|
|
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`),
|
|
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**:
|
|
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
|
-
#
|
|
170
|
+
# Navegue al worktree dentro del workspace
|
|
133
171
|
cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
|
|
134
172
|
|
|
135
|
-
#
|
|
173
|
+
# Verifique que está en la rama correcta
|
|
136
174
|
git branch # debe mostrar * feature/<ISSUE-ID>
|
|
137
175
|
|
|
138
|
-
#
|
|
176
|
+
# Implemente el código aquí
|
|
139
177
|
```
|
|
140
178
|
|
|
141
|
-
|
|
142
|
-
- **Patrones del proyecto**:
|
|
143
|
-
- **Stack aprobada**:
|
|
144
|
-
- **Pruebas**:
|
|
145
|
-
- **Documentación**:
|
|
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
|
-
-
|
|
153
|
-
-
|
|
154
|
-
-
|
|
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
|
-
#
|
|
201
|
+
# Navegue al worktree dentro del workspace
|
|
164
202
|
cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
|
|
165
203
|
|
|
166
|
-
#
|
|
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**:
|
|
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
|
-
-
|
|
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**,
|
|
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
|
-
**
|
|
210
|
-
- `[No Iniciada ⏳]` - Tarea aún no
|
|
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
|
|
227
|
-
1. 🛑 **
|
|
228
|
-
2. 📝 **
|
|
229
|
-
3. 💬 **
|
|
230
|
-
4. 🔄 **
|
|
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**:
|
|
245
|
-
- **Finalizar feature**: Cuando todo esté implementado,
|
|
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
|
-
-
|
|
287
|
+
- Trabaje en unidades pequeñas e incrementales
|
|
250
288
|
- Commit frecuente (commits atómicos)
|
|
251
|
-
-
|
|
252
|
-
-
|
|
289
|
+
- Documente decisiones importantes en la sesión
|
|
290
|
+
- Mantenga los repositorios sincronizados entre sí
|