@thatix.io/context-first-agents-cli 0.1.1 → 0.2.0

package/templates/commands/es/engineer/plan.md

@@ -0,0 +1,335 @@
+# Planificación Técnica
+
+Este comando crea el plan técnico detallado para la implementación de la funcionalidad.
+
+## 📋 Requisitos Previos
+
+- PRD creado vía `/spec`
+- Análisis inicial realizado vía `/start`
+- Archivos `context.md` y `architecture.md` creados y aprobados
+
+## 📋 Configuración del Proyecto
+
+**⚠️ IMPORTANTE: ¡Siempre lea los archivos de configuración del proyecto ANTES de ejecutar este comando!**
+
+### Archivos Obligatorios
+
+1. **`context-manifest.json`** (raíz del orquestador)
+   - Lista de repositorios del proyecto
+   - Roles de cada repositorio (metaspecs, application, etc.)
+   - URLs y dependencias entre repositorios
+
+2. **`ai.properties.md`** (raíz del orquestador)
+   - Configuraciones del proyecto (`project_name`, `base_path`)
+   - Sistema de gestión de tareas (`task_management_system`)
+   - Credenciales y configuraciones específicas
+
+### Cómo Leer
+
+```bash
+# 1. Leer context-manifest.json
+cat context-manifest.json
+
+# 2. Leer ai.properties.md
+cat ai.properties.md
+```
+
+### Información Esencial
+
+Después de leer los archivos, tendrás:
+- ✅ Lista completa de repositorios del proyecto
+- ✅ Ubicación del repositorio de metaspecs
+- ✅ Base path para localizar repositorios
+- ✅ Sistema de gestión de tareas configurado
+- ✅ Configuraciones específicas del proyecto
+
+**🛑 NO continúe sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
+
+
+## 📍 IMPORTANTE: Entienda la Estructura
+
+**Workspace**:
+```
+<orchestrator>/.sessions/<ISSUE-ID>/
+├── repo-1/          # worktree (se usará en /work)
+├── repo-2/          # worktree (se usará en /work)
+├── context.md       # contexto (inmutable - LEER)
+├── architecture.md  # arquitectura (inmutable - LEER)
+└── plan.md          # plan (mutable - CREAR)
+```
+
+**Repositorios principales** (solo lectura):
+```
+{base_path}/repo-1/  # repo principal (branch main/master)
+{base_path}/repo-2/  # repo principal (branch main/master)
+```
+
+**REGLA DE ORO**:
+- ✅ Lea `context.md` y `architecture.md` (inmutables)
+- ✅ Cree `plan.md` en `.sessions/<ISSUE-ID>/`
+- ✅ Lea código de los repositorios principales (solo lectura)
+- ❌ NUNCA haga checkout en los repositorios principales
+- ❌ NUNCA modifique `context.md` o `architecture.md`
+
+## ⚠️ IMPORTANTE: Archivos Inmutables
+
+**Este comando debe LEER pero NO MODIFICAR:**
+- ✅ **LEER** `.sessions/<ISSUE-ID>/context.md` (inmutable)
+- ✅ **LEER** `.sessions/<ISSUE-ID>/architecture.md` (inmutable)
+- ✅ **CREAR** `.sessions/<ISSUE-ID>/plan.md` (mutable - se actualizará durante `/work`)
+- ❌ **NO modificar `context.md` o `architecture.md`**
+
+## 📚 Cargar MetaSpecs
+
+**Localizar MetaSpecs automáticamente**:
+1. Lea `context-manifest.json` del orquestador
+2. Encuentre el repositorio con `"role": "metaspecs"`
+3. Lea `ai.properties.md` para obtener el `base_path`
+4. El metaspecs está en: `{base_path}/{metaspecs-repo-id}/`
+5. Lea los archivos `index.md` relevantes para asegurar conformidad con:
+   - Arquitectura del sistema
+   - Patrones de diseño y código
+   - Estructura de carpetas y archivos
+   - Convenciones de nomenclatura
+
+## 🎯 Objetivo
+
+Crear un plan técnico detallado que guiará la implementación, dividiendo el trabajo en unidades más pequeñas y secuenciales.
+
+## 📝 Estructura del Plan
+
+### 1. Visión General Técnica
+
+```markdown
+# Plan Técnico - [Título de la Funcionalidad]
+
+## Resumen
+[Breve descripción técnica de lo que se implementará]
+
+## Repositorios Involucrados
+- **<repo-1>**: [Rol en esta funcionalidad]
+- **<repo-2>**: [Rol en esta funcionalidad]
+
+## Enfoque Técnico
+[Estrategia general de implementación]
+```
+
+### 2. Arquitectura de la Solución
+
+```markdown
+## Arquitectura
+
+### Diagrama de Componentes
+[Descripción textual o arte ASCII de los componentes y sus relaciones]
+
+### Flujo de Datos
+1. [Paso 1 del flujo]
+2. [Paso 2 del flujo]
+3. [Paso 3 del flujo]
+
+### Integraciones
+- **<repo-1> → <repo-2>**: [Cómo se comunican]
+- **Sistema → API Externa**: [Si aplica]
+```
+
+### 3. Decisiones Técnicas
+
+```markdown
+## Decisiones Técnicas
+
+### Decisión 1: [Título]
+**Contexto**: [Por qué necesitamos decidir esto]
+**Opciones consideradas**:
+- Opción A: [Pros y contras]
+- Opción B: [Pros y contras]
+**Decisión**: [Opción elegida]
+**Justificación**: [Por qué elegimos esta opción]
+
+### Decisión 2: [Título]
+[Mismo formato anterior]
+```
+
+### 4. Plan de Implementación
+
+Divida el trabajo en unidades pequeñas y secuenciales:
+
+```markdown
+## Plan de Implementación
+
+### Fase 1: [Nombre de la Fase]
+**Objetivo**: [Qué se logrará en esta fase]
+**Repositorios**: [repos afectados]
+
+#### Tarea 1.1: [Descripción]
+- **Repo**: <repo-1>
+- **Archivos**: [archivos a crear/modificar]
+- **Descripción**: [Qué hacer]
+- **Pruebas**: [Pruebas a implementar]
+- **Estimación**: [tiempo estimado]
+
+#### Tarea 1.2: [Descripción]
+- **Repo**: <repo-2>
+- **Archivos**: [archivos a crear/modificar]
+- **Descripción**: [Qué hacer]
+- **Pruebas**: [Pruebas a implementar]
+- **Estimación**: [tiempo estimado]
+
+### Fase 2: [Nombre de la Fase]
+[Mismo formato anterior]
+
+### Fase 3: [Nombre de la Fase]
+[Mismo formato anterior]
+```
+
+### 5. Estructura de Archivos
+
+Para cada repositorio, defina la estructura:
+
+```markdown
+## Estructura de Archivos
+
+### <repo-1>
+```
+src/
+├── components/
+│   ├── NewComponent.tsx (CREAR)
+│   └── ExistingComponent.tsx (MODIFICAR)
+├── services/
+│   └── NewService.ts (CREAR)
+└── tests/
+    └── NewComponent.test.tsx (CREAR)
+```
+
+### <repo-2>
+```
+src/
+├── controllers/
+│   └── NewController.ts (CREAR)
+└── tests/
+    └── NewController.test.ts (CREAR)
+```
+```
+
+### 6. APIs y Contratos
+
+```markdown
+## APIs y Contratos
+
+### Endpoints Nuevos
+
+#### POST /api/resource
+**Request**:
+```json
+{
+  "field1": "string",
+  "field2": "number"
+}
+```
+
+**Response**:
+```json
+{
+  "id": "string",
+  "status": "string"
+}
+```
+
+### Endpoints Modificados
+
+#### GET /api/resource/:id
+**Cambios**: [Qué cambia]
+**Breaking Change**: Sí / No
+```
+
+### 7. Estrategia de Pruebas
+
+```markdown
+## Estrategia de Pruebas
+
+### Pruebas Unitarias
+- **<repo-1>**: [Componentes/funciones a probar]
+- **<repo-2>**: [Componentes/funciones a probar]
+
+### Pruebas de Integración
+- **Escenario 1**: [Descripción y repos involucrados]
+- **Escenario 2**: [Descripción y repos involucrados]
+
+### Pruebas E2E (si aplica)
+- **Flujo 1**: [Descripción]
+- **Flujo 2**: [Descripción]
+```
+
+### 8. Riesgos Técnicos
+
+```markdown
+## Riesgos Técnicos
+
+### Riesgo 1: [Descripción]
+- **Impacto**: Alto / Medio / Bajo
+- **Probabilidad**: Alta / Media / Baja
+- **Mitigación**: [Cómo mitigar]
+- **Plan B**: [Alternativa si ocurre]
+
+### Riesgo 2: [Descripción]
+[Mismo formato anterior]
+```
+
+### 9. Checklist de Implementación
+
+```markdown
+## Checklist de Implementación
+
+### Fase 1
+- [ ] Tarea 1.1
+- [ ] Tarea 1.2
+- [ ] Pruebas de la Fase 1
+
+### Fase 2
+- [ ] Tarea 2.1
+- [ ] Tarea 2.2
+- [ ] Pruebas de la Fase 2
+
+### Fase 3
+- [ ] Tarea 3.1
+- [ ] Tarea 3.2
+- [ ] Pruebas de la Fase 3
+
+### Finalización
+- [ ] Documentación actualizada
+- [ ] Code review
+- [ ] Pruebas de integración
+- [ ] PR creado
+```
+
+## 📄 Guardado del Plan
+
+Guarde en `./.sessions/<ISSUE-ID>/plan.md`
+
+## 🔍 Revisión
+
+Revise el plan verificando:
+- Todas las tareas están claras y ejecutables
+- Dependencias entre tareas están identificadas
+- Las estimaciones son realistas
+- Los riesgos fueron considerados
+- La estrategia de pruebas es adecuada
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Paso
+
+Después de la aprobación del plan:
+
+```bash
+/work
+```
+
+Este comando iniciará la ejecución de la primera unidad de trabajo del plan.

package/templates/commands/es/engineer/pr.md

@@ -0,0 +1,228 @@
+# Creación de Pull Request
+
+Este comando crea Pull Requests para todos los repositorios modificados en el workspace.
+
+## 📋 Requisitos Previos
+
+Antes de crear PRs, asegúrate de que:
+- Ejecutaste `/pre-pr` y todas las validaciones pasaron
+- Todos los commits fueron realizados
+- Todas las pruebas están pasando
+- La documentación está actualizada
+
+## 📋 Configuración del Proyecto
+
+**⚠️ IMPORTANTE: ¡Siempre lee los archivos de configuración del proyecto ANTES de ejecutar este comando!**
+
+### Archivos Obligatorios
+
+1. **`context-manifest.json`** (raíz del orchestrator)
+   - Lista de repositorios del proyecto
+   - Roles de cada repositorio (metaspecs, application, etc.)
+   - URLs y dependencias entre repositorios
+
+2. **`ai.properties.md`** (raíz del orchestrator)
+   - Configuraciones del proyecto (`project_name`, `base_path`)
+   - Sistema de gestión de tareas (`task_management_system`)
+   - Credenciales y configuraciones específicas
+
+### Cómo Leer
+
+```bash
+# 1. Leer context-manifest.json
+cat context-manifest.json
+
+# 2. Leer ai.properties.md
+cat ai.properties.md
+```
+
+### Información Esencial
+
+Después de leer los archivos, tendrás:
+- ✅ Lista completa de repositorios del proyecto
+- ✅ Ubicación del repositorio de metaspecs
+- ✅ Base path para localizar repositorios
+- ✅ Sistema de gestión de tareas configurado
+- ✅ Configuraciones específicas del proyecto
+
+**🛑 NO continúes sin leer estos archivos!** ¡Contienen información crítica para la correcta ejecución del comando!
+
+
+## 🛑 CRÍTICO: DÓNDE TRABAJAR
+
+**⚠️ ATENCIÓN: Si necesitas hacer ajustes de última hora, TODO EL CÓDIGO DEBE SER CREADO DENTRO DEL WORKTREE!**
+
+**✅ CORRECTO** - Trabajar dentro del worktree:
+```
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/README.md  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/CHANGELOG.md  ✅
+```
+
+**❌ INCORRECTO** - NUNCA crear código fuera del worktree:
+```
+<orchestrator>/.sessions/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+{base_path}/<repo-name>/file.ts  ❌ (¡repositorio principal!)
+```
+
+**REGLA ABSOLUTA**:
+- 🛑 **Cualquier ajuste de código** (docs, changelog, fixes) **DEBE estar en** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA modifiques** el repositorio principal en `{base_path}/<repo-name>/`
+- ✅ **Trabaja SÓLO** dentro del worktree del repositorio específico
+
+## 🎯 Proceso de Creación de PRs
+
+### 1. Identificar Repositorios Modificados
+
+Para cada repositorio en el workspace, verifica:
+```bash
+cd <repositorio>
+git status
+git log origin/main..HEAD  # Ver commits no pusheados
+```
+
+### 2. Push de las Branches
+
+Para cada repositorio modificado:
+```bash
+cd <repositorio>
+git push origin <branch-name>
+```
+
+### 3. Crear Pull Requests
+
+Para cada repositorio, crea un PR usando GitHub CLI o interfaz web:
+
+**Usando GitHub CLI**:
+```bash
+cd <repositorio>
+gh pr create --title "[ISSUE-ID] Título de la Feature" \
+  --body "$(cat ../.sessions/<ISSUE-ID>/pr-description.md)" \
+  --base main
+```
+
+**Plantilla de Descripción del PR**:
+
+```markdown
+## 🎯 Objetivo
+
+[Breve descripción de lo que hace este PR]
+
+## 📝 Cambios
+
+### Repositorio: <nombre-del-repo>
+
+- [Cambio 1]
+- [Cambio 2]
+- [Cambio 3]
+
+## 🔗 Relaciones
+
+- **Issue**: <ISSUE-ID>
+- **PRs Relacionados**: 
+  - <repo-1>#<PR-number>
+  - <repo-2>#<PR-number>
+
+## ✅ Checklist
+
+- [ ] Código implementado y probado
+- [ ] Pruebas unitarias añadidas/actualizadas
+- [ ] Pruebas de integración pasando
+- [ ] Documentación actualizada
+- [ ] Sin breaking changes (o documentados)
+- [ ] Revisado por pares (después de crear el PR)
+
+## 🧪 Cómo Probar
+
+1. [Paso 1]
+2. [Paso 2]
+3. [Resultado esperado]
+
+## 📸 Screenshots/Demos
+
+[Si aplica, añade capturas de pantalla o enlaces a demos]
+
+## 🔍 Notas para Revisores
+
+- [Punto de atención 1]
+- [Punto de atención 2]
+```
+
+### 4. Vincular PRs
+
+Si hay múltiples PRs (uno por repositorio):
+- Añade enlaces cruzados entre los PRs
+- Documenta el orden de merge recomendado
+- Indica dependencias entre PRs
+
+### 5. Actualizar Issue en el Task Manager
+
+Si el task manager está configurado:
+- Mueve la issue a "En Revisión" o "PR Abierto"
+- Añade enlaces de los PRs en la issue
+- Añade comentario con resumen de los cambios
+
+### 6. Documentación de la Sesión
+
+Actualiza `./.sessions/<ISSUE-ID>/pr.md`:
+
+```markdown
+# [Título de la Feature] - Pull Requests
+
+## PRs Creados
+
+### <repo-1>
+- **Link**: <URL del PR>
+- **Estado**: Abierto
+- **Commits**: X commits
+
+### <repo-2>
+- **Link**: <URL del PR>
+- **Estado**: Abierto
+- **Commits**: Y commits
+
+## Orden de Merge Recomendado
+
+1. <repo-1> - [Justificación]
+2. <repo-2> - [Justificación]
+
+## Notas para Merge
+
+- [Nota importante 1]
+- [Nota importante 2]
+```
+
+## 🔍 Checklist Final
+
+Antes de solicitar revisión:
+- [ ] Todos los PRs creados
+- [ ] Descripciones completas y claras
+- [ ] PRs vinculados entre sí
+- [ ] Issue actualizada en el task manager
+- [ ] Pruebas pasando en CI/CD
+- [ ] Documentación de la sesión completa
+
+## 📢 Comunicación
+
+Notifica al equipo sobre los PRs:
+- Menciona revisores relevantes
+- Destaca cambios críticos o breaking changes
+- Indica urgencia si aplica
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximos Pasos
+
+1. Esperar revisión de los PRs
+2. Responder comentarios y hacer ajustes
+3. Tras aprobación, hacer merge en el orden recomendado
+4. Ejecutar `context-cli feature:end <ISSUE-ID>` para limpiar el workspace