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.
- package/dist/templates/commands/en/engineer/plan.md +48 -10
- package/dist/templates/commands/en/engineer/pr.md +46 -8
- package/dist/templates/commands/en/engineer/pre-pr.md +49 -11
- 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 +47 -9
- package/dist/templates/commands/es/engineer/pre-pr.md +59 -21
- 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 +38 -0
- package/dist/templates/commands/pt-BR/engineer/pre-pr.md +38 -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 +46 -8
- package/templates/commands/en/engineer/pre-pr.md +49 -11
- 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 +47 -9
- package/templates/commands/es/engineer/pre-pr.md +59 -21
- 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 +38 -0
- package/templates/commands/pt-BR/engineer/pre-pr.md +38 -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,12 +2,50 @@
|
|
|
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.
|
|
@@ -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
|
|
36
|
-
- ✅ **
|
|
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ó
|
|
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
|
|
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
|
-
- [ ]
|
|
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
|
-
- [ ]
|
|
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
|
-
- [ ]
|
|
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
|
|
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
|
|
247
|
+
- [ ] No hay regresiones de performance evidentes
|
|
210
248
|
- [ ] Queries/operaciones costosas fueron optimizadas
|
|
211
|
-
- [ ] No
|
|
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
|
|
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
|
-
- [ ]
|
|
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
|
-
|
|
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
|
|
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. 🛑 **
|
|
268
|
-
2. 📝 **
|
|
269
|
-
3. 🔧 **
|
|
270
|
-
4. 🔄 **
|
|
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
|
-
|
|
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 (
|
|
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í
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Validación contra
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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/ (
|
|
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. 🛑 **
|
|
249
|
+
1. 🛑 **DETENGA** el proceso actual
|
|
212
250
|
2. 📝 **DOCUMENTE** todos los conflictos
|
|
213
251
|
3. 💬 **ALERTE** al usuario y stakeholders
|
|
214
|
-
4. **
|
|
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**
|
|
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 ✅:
|
|
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
|