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

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

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

@@ -0,0 +1,359 @@
+# Preparación para Pull Request
+
+Este comando valida que todo está listo para crear Pull Requests.
+
+## 📋 Requisitos Previos
+
+- Implementación completa (todas las tareas del `/plan` ejecutadas)
+- Todos los commits realizados
+- Workspace limpio y organizado
+
+## 📋 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!
+
+
+## 🎯 Objetivo
+
+Garantizar que la implementación está completa, probada y lista para revisión antes de crear los PRs.
+
+## 🛑 CRÍTICO: DÓNDE TRABAJAR
+
+**⚠️ ATENCIÓN: TODO CÓDIGO (tests, fixes, ajustes) 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>/tests/test.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/.eslintrc.js  ✅
+```
+
+**❌ INCORRECTO** - NUNCA crear código fuera del worktree:
+```
+<orchestrator>/.sessions/test.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/test.ts  ❌
+{base_path}/<repo-name>/test.ts  ❌ (¡repositorio principal!)
+```
+
+**REGLA ABSOLUTA**:
+- 🛑 **TODO código** (tests, fixes, configuraciones) **DEBE estar en** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA modifique** el repositorio principal en `{base_path}/<repo-name>/`
+- ✅ **Trabaje SOLO** dentro del worktree del repositorio específico
+
+## ✅ Checklist de Validación
+
+### 1. Completitud de la Implementación
+
+```markdown
+## Verificación de Completitud
+
+- [ ] Todas las tareas del plan fueron ejecutadas
+- [ ] Todos los requisitos funcionales del PRD fueron implementados
+- [ ] Todos los criterios de aceptación fueron cumplidos
+- [ ] Ninguna funcionalidad quedó incompleta
+```
+
+### 2. Calidad del Código
+
+Para cada repositorio modificado:
+
+```bash
+cd <repositorio>
+
+# Verificar estado
+git status
+
+# Verificar linting (ejemplos por stack):
+# Node.js: npm run lint / yarn lint / pnpm lint
+# Python: flake8 . / pylint src/ / black --check .
+# Java: mvn checkstyle:check / gradle check
+# Go: golangci-lint run / go vet ./...
+# Ruby: rubocop
+# Rust: cargo clippy
+# PHP: ./vendor/bin/phpcs
+# C#: dotnet format --verify-no-changes
+
+# Verificar formateo (ejemplos por stack):
+# Node.js: npm run format:check / prettier --check .
+# Python: black --check . / autopep8 --diff .
+# Java: mvn formatter:validate
+# Go: gofmt -l . / go fmt ./...
+# Ruby: rubocop --format-only
+# Rust: cargo fmt --check
+
+# Verificar build (ejemplos por stack):
+# Node.js: npm run build / yarn build
+# Python: python setup.py build
+# Java: mvn compile / gradle build
+# Go: go build ./...
+# Ruby: rake build
+# Rust: cargo build
+```
+
+Checklist:
+```markdown
+## Calidad del Código
+
+### <repo-1>
+- [ ] Linting sin errores
+- [ ] Formateo correcto
+- [ ] Build sin errores
+- [ ] Sin warnings críticos
+
+### <repo-2>
+- [ ] Linting sin errores
+- [ ] Formateo correcto
+- [ ] Build sin errores
+- [ ] Sin warnings críticos
+```
+
+### 3. Tests
+
+Para cada repositorio:
+
+```bash
+cd <repositorio>
+
+# Ejecutar tests unitarios (ejemplos por stack):
+# Node.js: npm run test:unit / jest / vitest
+# Python: pytest tests/unit / python -m unittest
+# Java: mvn test / gradle test
+# Go: go test ./... -short
+# Ruby: rspec spec/unit / rake test:unit
+# Rust: cargo test --lib
+# PHP: ./vendor/bin/phpunit --testsuite=unit
+# C#: dotnet test --filter Category=Unit
+
+# Ejecutar tests de integración (ejemplos por stack):
+# Node.js: npm run test:integration
+# Python: pytest tests/integration
+# Java: mvn verify / gradle integrationTest
+# Go: go test ./... -run Integration
+# Ruby: rspec spec/integration
+# Rust: cargo test --test '*'
+# PHP: ./vendor/bin/phpunit --testsuite=integration
+
+# Verificar cobertura (ejemplos por stack):
+# Node.js: npm run test:coverage / jest --coverage
+# Python: pytest --cov=src tests/
+# Java: mvn jacoco:report / gradle jacocoTestReport
+# Go: go test -cover ./...
+# Ruby: rspec --coverage
+# Rust: cargo tarpaulin
+# PHP: ./vendor/bin/phpunit --coverage-html coverage/
+```
+
+Checklist:
+```markdown
+## Tests
+
+### <repo-1>
+- [ ] Todos los tests unitarios pasan
+- [ ] Todos los tests de integración pasan
+- [ ] Cobertura de tests adecuada (>= X%)
+- [ ] Nuevos tests añadidos para nuevas funcionalidades
+
+### <repo-2>
+- [ ] Todos los tests unitarios pasan
+- [ ] Todos los tests de integración pasan
+- [ ] Cobertura de tests adecuada (>= X%)
+- [ ] Nuevos tests añadidos para nuevas funcionalidades
+```
+
+### 4. Documentación
+
+```markdown
+## Documentación
+
+- [ ] README actualizado (si es necesario)
+- [ ] Comentarios de código adecuados
+- [ ] Documentación de APIs actualizada (si hubo cambios)
+- [ ] Changelog actualizado
+- [ ] Documentación técnica actualizada en las metaspecs (si aplica)
+```
+
+### 5. Commits
+
+```markdown
+## Commits
+
+- [ ] Todos los commits tienen mensajes claros y descriptivos
+- [ ] Los commits siguen el estándar del proyecto (conventional commits, etc.)
+- [ ] No hay commits con mensajes genéricos ("fix", "update", etc.)
+- [ ] Los commits están organizados lógicamente
+- [ ] No hay commits de debug o temporales
+```
+
+### 6. Sincronización
+
+```markdown
+## Sincronización
+
+- [ ] Las ramas están actualizadas con la rama base (main/develop)
+- [ ] No hay conflictos de merge
+- [ ] Cambios entre repositorios están sincronizados
+- [ ] Dependencias entre repos fueron probadas
+```
+
+### 7. Seguridad
+
+```markdown
+## Seguridad
+
+- [ ] No hay credenciales o secretos en el código
+- [ ] No hay datos sensibles en logs
+- [ ] Dependencias de seguridad fueron verificadas
+- [ ] No se introdujeron vulnerabilidades conocidas
+```
+
+### 8. Performance
+
+```markdown
+## Performance
+
+- [ ] No hay regresiones de performance evidentes
+- [ ] Queries/operaciones costosas fueron optimizadas
+- [ ] No se introdujeron memory leaks
+- [ ] Requisitos de performance del PRD fueron cumplidos
+```
+
+## 🔍 Validación Cruzada
+
+Si se modificaron múltiples repositorios:
+
+```markdown
+## Validación Cruzada
+
+- [ ] Probé la integración entre los repositorios localmente
+- [ ] APIs/contratos entre repos están consistentes
+- [ ] No hay breaking changes no documentados
+- [ ] El orden de deploy/merge está claro
+```
+
+## 📄 Preparación de la Descripción del PR
+
+Cree `./.sessions/<ISSUE-ID>/pr-description.md`:
+
+```markdown
+## 🎯 Objetivo
+[Breve descripción de lo que hace esta feature]
+
+## 📝 Cambios Principales
+- [Cambio 1]
+- [Cambio 2]
+- [Cambio 3]
+
+## 🔗 Links
+- **Issue**: [ISSUE-ID]
+- **PRD**: [link o ruta]
+- **Plan Técnico**: [link o ruta]
+
+## ✅ Checklist
+- [x] Código implementado y probado
+- [x] Tests unitarios añadidos/actualizados
+- [x] Tests de integración pasando
+- [x] Documentación actualizada
+- [x] Linting y formateo OK
+- [x] Build sin errores
+
+## 🧪 Cómo Probar
+1. [Paso 1]
+2. [Paso 2]
+3. [Resultado esperado]
+
+## 🔍 Notas para Revisores
+- [Punto de atención 1]
+- [Punto de atención 2]
+```
+
+## 🚨 Problemas Encontrados
+
+Si alguna validación falla:
+1. 🛑 **PARE** el proceso de creación de PR
+2. 📝 **DOCUMENTE** el problema
+3. 🔧 **CORRIJA** el problema
+4. 🔄 **EJECUTE** `/pre-pr` nuevamente
+
+## 📊 Reporte de Validación
+
+Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
+
+```markdown
+# Reporte de Validación Pre-PR
+
+**Fecha**: [fecha/hora]
+**Issue**: [ISSUE-ID]
+
+## Estado General
+✅ Listo para PR / ⚠️ Pendientes / ❌ Bloqueado
+
+## Repositorios Validados
+- **<repo-1>**: ✅ OK
+- **<repo-2>**: ✅ OK
+
+## Resumen de Tests
+- **Tests Unitarios**: X/X pasando
+- **Tests de Integración**: Y/Y pasando
+- **Cobertura**: Z%
+
+## Pendientes (si hay)
+- [Pendiente 1]
+- [Pendiente 2]
+
+## Próximos Pasos
+- [x] Todas las validaciones pasaron
+- [ ] Ejecutar `/pr` para crear Pull Requests
+```
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Paso
+
+Si todas las validaciones pasaron:
+
+```bash
+/pr
+```
+
+Este comando creará los Pull Requests para todos los repositorios modificados.