context-first-cli 1.8.2 → 2.0.0

package/dist/templates/commands/es/engineer/work.md

@@ -0,0 +1,197 @@
+# Ejecución del Trabajo
+
+Este comando ejecuta una unidad de trabajo en el workspace actual, implementando parte del plan técnico.
+
+## 📋 Prerrequisitos
+
+Antes de ejecutar, asegúrese de que:
+- Ha ejecutado `/start` y `/plan` para tener el plan técnico
+- Está en el workspace correcto: `<orchestrator>/.sessions/<ISSUE-ID>/`
+- Tiene los archivos `.sessions/<ISSUE-ID>/` disponibles:
+  - `context.md` (inmutable)
+  - `architecture.md` (inmutable)
+  - `plan.md` (mutable)
+
+## 📍 IMPORTANTE: Entienda la Estructura
+
+**Workspace** (donde trabaja):
+```
+<orchestrator>/.sessions/<ISSUE-ID>/
+├── repo-1/          # worktree con branch feature/<ISSUE-ID>
+├── repo-2/          # worktree con branch feature/<ISSUE-ID>
+├── context.md       # contexto (inmutable)
+├── architecture.md  # arquitectura (inmutable)
+└── plan.md          # plan (mutable)
+```
+
+**Repositorios principales** (NO tocar):
+```
+{base_path}/repo-1/  # repo principal (branch main/master)
+{base_path}/repo-2/  # repo principal (branch main/master)
+```
+
+**REGLA DE ORO**:
+- ✅ Trabaje SOLO dentro de `<orchestrator>/.sessions/<ISSUE-ID>/`
+- ✅ Haga commits en los worktrees dentro del workspace
+- ❌ NUNCA haga checkout en los repositorios principales
+- ❌ NUNCA navegue a `{base_path}/{repo-id}/`
+
+## ⚠️ IMPORTANTE: Archivos Inmutables
+
+**Este comando debe LEER pero NO MODIFICAR:**
+- ✅ **LEER** `.sessions/<ISSUE-ID>/context.md` (inmutable)
+- ✅ **LEER** `.sessions/<ISSUE-ID>/architecture.md` (inmutable)
+- ✅ **ACTUALIZAR** `.sessions/<ISSUE-ID>/plan.md` (marcar progreso)
+- ✅ **IMPLEMENTAR** código en los repositorios del workspace
+- ✅ **HACER COMMITS** en los repositorios del workspace
+- ❌ **NO modificar `context.md` o `architecture.md`**
+- ❌ **NO hacer checkout de branches en los repositorios principales (fuera del workspace)**
+
+## 📚 Cargar MetaSpecs
+
+**Localizar MetaSpecs automáticamente**:
+1. Lea `context-manifest.json` del orchestrator
+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 durante la implementación para:
+   - Seguir patrones de código
+   - Respetar la arquitectura definida
+   - Usar convenciones correctas
+
+## 🎯 Objetivo
+
+Implementar una unidad de trabajo específica del plan, que puede involucrar:
+- Crear nuevos archivos/componentes
+- Modificar archivos existentes
+- Añadir tests
+- Actualizar documentación
+
+## 📝 Proceso de Trabajo
+
+### 1. Identificar Unidad de Trabajo
+
+Basándose en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifique:
+- Qué tarea específica se implementará ahora
+- En cuál(es) repositorio(s) del workspace
+- Qué archivos serán creados/modificados
+- Dependencias con otras tareas
+
+### 2. Implementación
+
+**IMPORTANTE**: Trabaje SOLO dentro del workspace en `.sessions/<ISSUE-ID>/`
+
+Para cada repositorio en el workspace:
+
+```bash
+# Navegue al worktree dentro del workspace
+cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
+
+# Verifique que está en la branch correcta
+git branch  # debe mostrar * feature/<ISSUE-ID>
+
+# Implemente el código aquí
+```
+
+Ejecute la implementación siguiendo:
+- **Patrones del proyecto**: Consulte guías de estilo y arquitectura
+- **Stack aprobada**: Use solo tecnologías documentadas en las metaspecs
+- **Tests**: Implemente tests conforme a los patrones del proyecto
+- **Documentación**: Actualice comentarios y docs cuando sea necesario
+
+### 3. Validación Local
+
+Antes de commitear:
+- Ejecute tests unitarios/de integración
+- Verifique linting y formato
+- Confirme que no rompió funcionalidades existentes
+
+### 4. Commit
+
+Para cada repositorio modificado **dentro del workspace**:
+
+```bash
+# Navegue al worktree dentro del workspace
+cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
+
+# Añada los cambios
+git add .
+
+# Commit
+git commit -m "tipo: descripción concisa
+
+- Detalle 1
+- Detalle 2
+
+Refs: <ISSUE-ID>"
+```
+
+**Tipos de commit**: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
+
+### 5. Actualización del Plan.md
+
+**POR CADA tarea completada**, actualice `./.sessions/<ISSUE-ID>/plan.md`:
+
+```markdown
+#### 1.1 - [Nombre de la Tarea] [Completada ✅]
+- [Detalle 1]
+- [Detalle 2]
+- [Detalle 3]
+
+**Archivos**:
+- `path/to/file1.ts` ✅
+- `path/to/file2.vue` ✅
+
+**Tests**:
+- Unit test: [Descripción] ✅
+- Integration test: [Descripción] ✅
+
+**Comentarios**:
+- Decisión: [Explicación de decisión técnica importante]
+- Aprendizaje: [Algo aprendido durante implementación]
+```
+
+**Marque estado de las tareas**:
+- `[No Iniciada ⏳]` - Tarea aún no comenzó
+- `[En Progreso ⏰]` - Tarea en desarrollo ahora
+- `[Completada ✅]` - Tarea finalizada y validada
+
+## 🔍 Checklist de Calidad
+
+Antes de considerar la unidad completa:
+- [ ] Código implementado y testeado
+- [ ] Tests pasando
+- [ ] Linting/formato OK
+- [ ] Documentación actualizada (si es necesario)
+- [ ] Commit realizado en todos los repos afectados
+- [ ] `plan.md` actualizado con progreso y comentarios
+
+## ⚠️ Principio Jidoka
+
+Si encuentra problemas durante la implementación:
+1. 🛑 **PARE** la implementación
+2. 📝 **DOCUMENTE** el problema encontrado
+3. 💬 **ALERTE** al usuario y discuta soluciones
+4. 🔄 **AJUSTE** el plan si es necesario
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximos Pasos
+
+- **Continuar implementación**: Ejecute `/work` nuevamente para la próxima unidad
+- **Finalizar feature**: Cuando todo esté implementado, ejecute `/pre-pr`
+
+## 💡 Consejos
+
+- Trabaje en unidades pequeñas e incrementales
+- Commit frecuente (commits atómicos)
+- Documente decisiones importantes en la sesión
+- Mantenga los repos sincronizados entre sí

package/dist/templates/commands/es/products/check.md

@@ -0,0 +1,233 @@
+# Validación contra Metaspecs
+
+Este comando valida requisitos, decisiones o implementaciones contra las metaspecs del proyecto.
+
+## ⚠️ IMPORTANTE: Modo de Operación
+
+**Este comando es para VALIDACIÓN:**
+- ✅ Validar contra metaspecs
+- ✅ **LEER** archivos de los repositorios (solo lectura)
+- ✅ Generar informe de validación
+- ❌ **NO hacer checkout de branches en los repositorios principales**
+- ❌ **NO modificar código**
+- ❌ **NO modificar `context.md` o `architecture.md`**
+
+## 🎯 Objetivo
+
+Garantizar alineación con:
+- Estrategia de producto
+- Arquitectura técnica
+- Estándares y convenciones
+- ADRs (Architecture Decision Records)
+
+## 📋 Cuándo Usar
+
+Ejecute este comando:
+- Después de `/spec` - validar PRD
+- Después de `/plan` - validar plan técnico
+- Durante `/work` - validar decisiones de implementación
+- Antes de `/pr` - validación final
+
+## 📚 Cargar MetaSpecs
+
+**Localizar MetaSpecs automáticamente**:
+1. Lea `context-manifest.json` del orchestrator
+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}/`
+
+## 🔍 Proceso de Validación
+
+### 1. Identificar Metaspecs Disponibles
+
+Navegue hasta el directorio de metaspecs e identifique qué metaspecs existen:
+
+```bash
+ls -la {base_path}/{metaspecs-repo-id}/
+```
+
+### 2. Validación de Negocio
+
+Si existen metaspecs de negocio (`repositorio de MetaSpecs (sección de negocio)`):
+
+```markdown
+## Validación de Negocio
+
+### Estrategia de Producto
+- **Archivo**: `repositorio de MetaSpecs (sección de negocio)PRODUCT_STRATEGY.md`
+- **Validación**: [¿Esta funcionalidad está alineada con la estrategia?]
+- **Estado**: ✅ Alineado / ⚠️ Parcialmente / ❌ Desalineado
+- **Notas**: [Observaciones]
+
+### Personas
+- **Archivo**: `repositorio de MetaSpecs (sección de negocio)CUSTOMER_PERSONAS.md`
+- **Validación**: [¿Atiende a la persona correcta?]
+- **Estado**: ✅ Alineado / ⚠️ Parcialmente / ❌ Desalineado
+- **Notas**: [Observaciones]
+
+### Métricas
+- **Archivo**: `repositorio de MetaSpecs (sección de negocio)PRODUCT_METRICS.md`
+- **Validación**: [¿Métrica de éxito está documentada?]
+- **Estado**: ✅ Alineado / ⚠️ Parcialmente / ❌ Desalineado
+- **Notas**: [Observaciones]
+```
+
+### 3. Validación Técnica
+
+Si existen metaspecs técnicas (`repositorio de MetaSpecs (sección técnica)`):
+
+```markdown
+## Validación Técnica
+
+### Stack Tecnológica
+- **Archivo**: `repositorio de MetaSpecs (sección técnica)meta/stack.md`
+- **Validación**: [¿Usa solo tecnologías aprobadas?]
+- **Estado**: ✅ Conforme / ⚠️ Excepción justificada / ❌ No conforme
+- **Notas**: [Tecnologías usadas y justificaciones]
+
+### Arquitectura
+- **Archivo**: `repositorio de MetaSpecs (sección técnica)ARCHITECTURE.md`
+- **Validación**: [¿Sigue estándares arquitectónicos?]
+- **Estado**: ✅ Conforme / ⚠️ Parcialmente / ❌ No conforme
+- **Notas**: [Observaciones]
+
+### ADRs (Architecture Decision Records)
+- **Directorio**: `repositorio de MetaSpecs (sección técnica)adr/`
+- **Validación**: [¿Respeta decisiones arquitectónicas documentadas?]
+- **ADRs Relevantes**: [Lista de ADRs verificados]
+- **Estado**: ✅ Conforme / ⚠️ Conflicto menor / ❌ Conflicto crítico
+- **Notas**: [Observaciones]
+
+### Reglas de Negocio
+- **Archivo**: `repositorio de MetaSpecs (sección técnica)BUSINESS_LOGIC.md`
+- **Validación**: [¿Implementa reglas de negocio correctamente?]
+- **Estado**: ✅ Conforme / ⚠️ Parcialmente / ❌ No conforme
+- **Notas**: [Observaciones]
+```
+
+### 4. Validación de Estándares
+
+```markdown
+## Validación de Estándares
+
+### Código
+- **Archivo**: `repositorio de MetaSpecs (sección técnica)CODE_STANDARDS.md`
+- **Validación**: [¿Sigue estándares de código?]
+- **Estado**: ✅ Conforme / ⚠️ Pequeñas desviaciones / ❌ No conforme
+
+### Pruebas
+- **Archivo**: `repositorio de MetaSpecs (sección técnica)TEST_STANDARDS.md`
+- **Validación**: [¿Estrategia de pruebas adecuada?]
+- **Estado**: ✅ Conforme / ⚠️ Parcialmente / ❌ No conforme
+
+### Documentación
+- **Archivo**: `repositorio de MetaSpecs (sección técnica)DOC_STANDARDS.md`
+- **Validación**: [¿Documentación adecuada?]
+- **Estado**: ✅ Conforme / ⚠️ Parcialmente / ❌ No conforme
+```
+
+### 5. Identificación de Conflictos
+
+Si hay conflictos o desalineamientos:
+
+```markdown
+## Conflictos Identificados
+
+### Conflicto 1: [Descripción]
+- **Severidad**: Crítico / Alto / Medio / Bajo
+- **Metaspec**: [Archivo que está siendo violado]
+- **Descripción**: [Detalle del conflicto]
+- **Recomendación**: [Cómo resolver]
+
+### Conflicto 2: [Descripción]
+[Mismo formato anterior]
+```
+
+### 6. Excepciones Justificadas
+
+Si hay desviaciones justificadas:
+
+```markdown
+## Excepciones Justificadas
+
+### Excepción 1: [Descripción]
+- **Metaspec**: [Archivo que está siendo desviado]
+- **Desvío**: [Qué está diferente]
+- **Justificación**: [Por qué es necesario]
+- **Aprobación**: [Quién aprobó]
+- **Documentación**: [Dónde fue documentado]
+```
+
+## 📄 Guardado del Informe de Validación
+
+**PRIORIDAD 1: Usar MCP (Model Context Protocol)**
+
+- Lea `ai.properties.md` del orchestrator para identificar el `task_management_system`
+- Use el MCP apropiado para añadir el informe a la issue:
+  - Añada como comentario en la issue
+  - Actualice labels/tags según resultado (ej: "validated", "needs-adjustment", "blocked")
+  - Si hay conflictos críticos, actualice el estado de la issue
+- Informe al usuario: "✅ Informe de validación añadido a la issue [ID]"
+
+**FALLBACK: Crear archivo .md solo si MCP falla**
+
+Si el MCP no está disponible o falla, cree `./.sessions/<ISSUE-ID>/check-report.md`:
+
+```markdown
+# Informe de Validación - [ISSUE-ID]
+
+**Fecha**: [fecha/hora]
+**Fase**: [spec/plan/work/pre-pr]
+
+## Estado General
+✅ Validado / ⚠️ Validado con reservas / ❌ No validado
+
+## Validaciones Realizadas
+- Negocio: ✅ / ⚠️ / ❌
+- Técnica: ✅ / ⚠️ / ❌
+- Estándares: ✅ / ⚠️ / ❌
+
+## Conflictos
+[Lista de conflictos, si los hay]
+
+## Excepciones
+[Lista de excepciones justificadas, si las hay]
+
+## Recomendaciones
+1. [Recomendación 1]
+2. [Recomendación 2]
+
+## Aprobación
+- [ ] Aprobado para continuar
+- [ ] Requiere ajustes
+- [ ] Bloqueado
+```
+
+Informe al usuario: "⚠️ Informe guardado localmente en .sessions/ (task manager no disponible)"
+
+## 🚨 Acción en Caso de Conflictos
+
+Si se encuentran conflictos críticos:
+1. 🛑 **PARE** el proceso actual
+2. 📝 **DOCUMENTE** todos los conflictos
+3. 💬 **ALERTE** al usuario y stakeholders
+4. **Via MCP**: Actualice estado de la issue a "Bloqueado" o "Requiere Ajustes"
+5. 🔄 **AJUSTE** el plan/implementación según sea necesario
+6. ✅ **REVALIDE** después de los ajustes
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Resultado
+
+Después de la validación:
+- Si ✅: Proceda a la siguiente fase
+- Si ⚠️: Documente reservas y continúe con aprobación
+- Si ❌: Corrija conflictos antes de continuar

package/dist/templates/commands/es/products/collect.md

@@ -0,0 +1,156 @@
+# Recolección de Ideas y Requisitos
+
+Usted es un experto en producto responsable de recopilar y documentar nuevas ideas, features o bugs.
+
+## ⚠️ IMPORTANTE: Este Comando NO Implementa Código
+
+**Este comando es SOLO para planificación y documentación:**
+- ✅ Recopilar y entender requisitos
+- ✅ Crear issue en el task manager vía MCP
+- ✅ Hacer preguntas de aclaración
+- ✅ **LEER** archivos de los repositorios principales (solo lectura)
+- ❌ **NO implementar código**
+- ❌ **NO editar archivos de código**
+- ❌ **NO hacer checkout de branches en los repositorios principales**
+- ❌ **NO hacer commits**
+
+**Próximo paso**: `/refine [ISSUE-ID]` para refinar los requisitos recopilados.
+
+---
+
+## Contexto del Proyecto
+
+Antes de iniciar, cargue el contexto consultando:
+
+1. **Localizar MetaSpecs automáticamente**:
+   - Lea `context-manifest.json` del orchestrator
+   - Encuentre el repositorio con `"role": "metaspecs"`
+   - Lea `ai.properties.md` para obtener el `base_path`
+   - El metaspecs está en: `{base_path}/{metaspecs-repo-id}/`
+   - Lea los archivos `index.md` como referencia
+
+2. **Estructura del proyecto**:
+   - `context-manifest.json` - Lista de repositorios y sus funciones
+   - `README.md` de los repositorios involucrados
+
+## Su Objetivo
+
+Entender la solicitud del usuario y capturarla como issue en el task manager (vía MCP).
+
+**En esta fase, usted NO necesita:**
+- ❌ Escribir especificación completa
+- ❌ Validar contra metaspecs (esto se hace en `/refine` o `/spec`)
+- ❌ Detallar implementación técnica
+
+Solo asegúrese de que la idea esté **adecuadamente comprendida**.
+
+## Formato de la Issue
+
+```markdown
+# [Título Claro y Descriptivo]
+
+## Descripción
+[2-3 párrafos explicando qué es la feature/bug y por qué es importante]
+
+## Tipo
+- [ ] Nueva Feature
+- [ ] Mejora de Feature Existente
+- [ ] Bug
+- [ ] Tech Debt
+- [ ] Documentación
+
+## Contexto Adicional
+[Información relevante: dónde ocurre el bug, inspiración para la feature, etc.]
+
+## Repositorios Afectados
+[Liste qué repositorios del proyecto serán impactados]
+
+## Prioridad Sugerida
+- [ ] 🔴 Crítica
+- [ ] 🟡 Alta
+- [ ] 🟢 Media
+- [ ] ⚪ Baja (Backlog)
+```
+
+## Proceso de Recolección
+
+1. **Entendimiento Inicial**
+   - Haga preguntas de aclaración si es necesario
+   - Identifique: ¿Es feature nueva? ¿Mejora? ¿Bug?
+   - Identifique qué repositorios serán afectados
+
+2. **Borrador de la Issue**
+   - Título claro (máximo 10 palabras)
+   - Descripción objetiva (2-3 párrafos)
+   - Contexto adicional relevante
+   - Repositorios afectados
+   - Prioridad sugerida
+
+3. **Aprobación del Usuario**
+   - Presente el borrador
+   - Haga ajustes según feedback
+   - Obtenga aprobación final
+
+4. **Guardado de la Issue**
+
+   **PRIORIDAD 1: Usar MCP (Model Context Protocol)**
+   
+   Verifique si hay MCP configurado para task manager:
+   - Lea `ai.properties.md` del orchestrator para identificar el `task_management_system`
+   - Si `task_management_system=jira`: Use MCP de Jira para crear la issue
+   - Si `task_management_system=linear`: Use MCP de Linear para crear la issue
+   - Si `task_management_system=github`: Use MCP de GitHub para crear la issue
+   
+   **Al usar MCP:**
+   - Cree la issue directamente en el task manager
+   - Obtenga el ID de la issue creada (ej: FIN-123, LIN-456)
+   - Informe al usuario: "✅ Issue [ID] creada en [task manager]"
+   - **NO cree archivo .md**
+   
+   **FALLBACK: Crear archivo .md solo si MCP falla**
+   
+   Si el MCP no está disponible o falla:
+   - Cree archivo en `./.sessions/<ISSUE-ID>/collect.md`
+   - Use formato de ID manual: `LOCAL-001`, `LOCAL-002`, etc.
+   - Incluya fecha, tipo y contenido completo
+   - Informe al usuario: "⚠️ Issue guardada localmente en .sessions/ (task manager no disponible)"
+
+## Preguntas de Aclaración
+
+**Para Features**:
+- ¿Qué problema resuelve?
+- ¿Quién se beneficia?
+- ¿Es funcionalidad visible o infraestructura?
+- ¿Tiene relación con alguna feature existente?
+- ¿Qué repositorios necesitan ser modificados?
+
+**Para Bugs**:
+- ¿Dónde ocurre el bug? (repositorio, componente, flujo)
+- ¿Cómo reproducir?
+- ¿Cuál es el comportamiento esperado vs actual?
+- ¿Severidad del impacto?
+
+**Para Mejoras**:
+- ¿Qué está funcionando pero puede mejorar?
+- ¿Qué métrica queremos impactar?
+- ¿Es optimización técnica o de negocio?
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Paso
+
+Después de aprobación y guardado de la issue:
+
+```bash
+/refine [ISSUE-ID]
+```
+
+Este comando transformará la issue recopilada en requisitos refinados y validados.