context-first-cli 1.8.2 → 2.0.0

package/templates/commands/es/products/refine.md

@@ -0,0 +1,222 @@
+# Refinamiento de Requisitos
+
+Este comando refina una issue recopilada, transformándola en requisitos claros y validados.
+
+## ⚠️ IMPORTANTE: Este Comando NO Implementa Código
+
+**Este comando es SOLO para refinamiento de requisitos:**
+- ✅ Refinar y validar requisitos
+- ✅ Actualizar issue en el task manager vía MCP
+- ✅ **LEER** archivos de los repositorios principales (solo lectura)
+- ❌ **NO implementar código**
+- ❌ **NO hacer ediciones en archivos de código**
+- ❌ **NO hacer checkout de branches en los repositorios principales**
+- ❌ **NO hacer commits**
+
+**Próximo paso**: `/spec [ISSUE-ID]` para crear la especificación completa (PRD).
+
+---
+
+## 📋 Prerrequisitos
+
+- Issue ya recopilada vía `/collect`
+- Contexto del proyecto se cargará automáticamente (ver sección "Cargar MetaSpecs" abajo)
+
+## 🎯 Objetivo
+
+Refinar la issue recopilada, aclarando:
+- Alcance exacto (qué entra y qué no entra)
+- Criterios de aceptación claros
+- Impacto en cada repositorio
+- Dependencias técnicas
+- Riesgos y restricciones
+
+## 📝 Proceso de Refinamiento
+
+### 1. Cargar Issue
+
+**PRIORIDAD 1: Usar MCP (Model Context Protocol)**
+
+- Lea `ai.properties.md` del orchestrator para identificar el `task_management_system`
+- Use el MCP apropiado para buscar la issue:
+  - `task_management_system=jira`: Use MCP de Jira
+  - `task_management_system=linear`: Use MCP de Linear
+  - `task_management_system=github`: Use MCP de GitHub
+- Cargue todos los datos de la issue (título, descripción, labels, etc.)
+
+**FALLBACK: Si MCP no está disponible o falla**
+
+- Lea `./.sessions/<ISSUE-ID>/collect.md`
+- Si el archivo no existe, informe el error al usuario
+
+### 2. 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 para entender:
+   - Arquitectura del sistema
+   - Patrones de diseño
+   - Restricciones técnicas
+   - Convenciones del proyecto
+
+### 3. Análisis de Alcance
+
+Defina claramente:
+
+**Qué ESTÁ en el alcance**:
+- Funcionalidades específicas a implementar
+- Repositorios que serán modificados
+- Integraciones necesarias
+
+**Qué NO ESTÁ en el alcance**:
+- Funcionalidades relacionadas pero que quedan para después
+- Optimizaciones futuras
+- Features "nice to have"
+
+### 4. Criterios de Aceptación
+
+Defina criterios medibles y comprobables:
+
+```markdown
+## Criterios de Aceptación
+
+### Funcional
+- [ ] [Criterio 1 - específico y comprobable]
+- [ ] [Criterio 2 - específico y comprobable]
+
+### Técnico
+- [ ] [Criterio técnico 1]
+- [ ] [Criterio técnico 2]
+
+### Calidad
+- [ ] Pruebas unitarias implementadas
+- [ ] Pruebas de integración implementadas
+- [ ] Documentación actualizada
+```
+
+### 5. Análisis de Impacto
+
+Para cada repositorio afectado:
+
+```markdown
+## Impacto por Repositorio
+
+### <repo-1>
+- **Componentes afectados**: [lista]
+- **Tipo de cambio**: Nueva feature / Modificación / Refactorización
+- **Complejidad estimada**: Baja / Media / Alta
+- **Riesgos**: [riesgos específicos]
+
+### <repo-2>
+- **Componentes afectados**: [lista]
+- **Tipo de cambio**: Nueva feature / Modificación / Refactorización
+- **Complejidad estimada**: Baja / Media / Alta
+- **Riesgos**: [riesgos específicos]
+```
+
+### 6. Dependencias y Restricciones
+
+Identifique:
+- Dependencias entre repositorios
+- Dependencias de otras features/issues
+- Restricciones técnicas
+- Restricciones de negocio
+- Bloqueadores conocidos
+
+### 7. Estimación Inicial
+
+Proporcione estimación de esfuerzo:
+- **Pequeño**: < 1 día
+- **Medio**: 1-3 días
+- **Grande**: 3-5 días
+- **Muy Grande**: > 5 días (considere dividir en issues más pequeñas)
+
+### 8. Preguntas Pendientes
+
+Liste preguntas que aún necesitan respuesta antes de iniciar la implementación.
+
+## 📄 Guardado del Refinamiento
+
+**PRIORIDAD 1: Actualizar vía MCP**
+
+- Use el MCP del task manager para actualizar la issue
+- Añada los criterios de aceptación como comentario o campo personalizado
+- Actualice labels/tags si es necesario (ej: "refined", "ready-for-spec")
+- Añada estimación si el task manager lo soporta
+- Informe al usuario: "✅ Issue [ID] actualizada con refinamiento"
+
+**FALLBACK: Crear archivo .md solo si MCP falla**
+
+Si el MCP no está disponible o falla, cree/actualice `./.sessions/<ISSUE-ID>/refine.md`:
+
+```markdown
+# [Título de la Issue] - Refinamiento
+
+## Alcance
+
+### Incluido
+- [Ítem 1]
+- [Ítem 2]
+
+### Excluido
+- [Ítem 1]
+- [Ítem 2]
+
+## Criterios de Aceptación
+[Según sección 3 arriba]
+
+## Impacto por Repositorio
+[Según sección 4 arriba]
+
+## Dependencias
+- [Dependencia 1]
+- [Dependencia 2]
+
+## Restricciones
+- [Restricción 1]
+- [Restricción 2]
+
+## Estimación
+[Pequeño/Medio/Grande/Muy Grande] - [Justificación]
+
+## Preguntas Pendientes
+1. [Pregunta 1]
+2. [Pregunta 2]
+
+## Riesgos Identificados
+- [Riesgo 1 y mitigación]
+- [Riesgo 2 y mitigación]
+```
+
+Informe al usuario: "⚠️ Refinamiento guardado localmente en .sessions/ (task manager no disponible)"
+
+## 🔍 Validación
+
+Valide el refinamiento contra:
+- Estrategia del producto (si está documentada)
+- Arquitectura técnica (si está documentada)
+- Capacidad del equipo
+- Prioridades del roadmap
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Paso
+
+Después de aprobar el refinamiento:
+
+```bash
+/spec [ISSUE-ID]
+```
+
+Este comando creará la especificación completa (PRD) de la feature.

package/templates/commands/es/products/spec.md

@@ -0,0 +1,267 @@
+# Creación de Especificación (PRD)
+
+Este comando crea la especificación completa (Product Requirements Document) de la feature.
+
+## ⚠️ IMPORTANTE: Este Comando NO Implementa Código
+
+**Este comando es SÓLO para documentación de requisitos:**
+- ✅ Crear PRD (Product Requirements Document)
+- ✅ Actualizar issue en el task manager vía MCP
+- ✅ **LEER** archivos de los repositorios principales (read-only)
+- ❌ **NO implementar código**
+- ❌ **NO hacer edits en archivos de código**
+- ❌ **NO hacer checkout de branches en los repositorios principales**
+- ❌ **NO hacer commits**
+
+**Próximo paso**: `/start` para iniciar el desarrollo.
+
+---
+
+## 📋 Requisitos Previos
+
+- Issue refinada vía `/refine`
+- Aprobación para continuar con la feature
+
+## 📚 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 para garantizar conformidad con:
+   - Arquitectura del sistema
+   - Patrones de diseño
+   - Restricciones técnicas
+   - Convenciones del proyecto
+
+## 🎯 Objetivo
+
+Crear un PRD completo que servirá como fuente única de verdad para la implementación.
+
+## 📝 Estructura del PRD
+
+### 1. Visión General
+
+```markdown
+# [Título de la Feature]
+
+## Contexto
+[¿Por qué estamos construyendo esto? ¿Qué problema resuelve?]
+
+## Objetivo
+[¿Qué queremos lograr con esta feature?]
+
+## Métricas de Éxito
+- [Métrica 1]: [Cómo medir]
+- [Métrica 2]: [Cómo medir]
+```
+
+### 2. Requisitos Funcionales
+
+```markdown
+## Requisitos Funcionales
+
+### RF-01: [Nombre del Requisito]
+**Descripción**: [Descripción detallada]
+**Prioridad**: Must Have / Should Have / Could Have
+**Repositorios**: [repos afectados]
+
+### RF-02: [Nombre del Requisito]
+**Descripción**: [Descripción detallada]
+**Prioridad**: Must Have / Should Have / Could Have
+**Repositorios**: [repos afectados]
+```
+
+### 3. Requisitos No Funcionales
+
+```markdown
+## Requisitos No Funcionales
+
+### Performance
+- [Requisito de performance]
+
+### Seguridad
+- [Requisito de seguridad]
+
+### Accesibilidad
+- [Requisito de accesibilidad]
+
+### Escalabilidad
+- [Requisito de escalabilidad]
+```
+
+### 4. Flujos de Usuario
+
+```markdown
+## Flujos de Usuario
+
+### Flujo Principal
+1. [Paso 1]
+2. [Paso 2]
+3. [Paso 3]
+
+### Flujos Alternativos
+**Escenario**: [Nombre del escenario]
+1. [Paso 1]
+2. [Paso 2]
+
+### Manejo de Errores
+**Error**: [Tipo de error]
+**Comportamiento**: [Cómo debe reaccionar el sistema]
+```
+
+### 5. Especificación Técnica
+
+```markdown
+## Especificación Técnica
+
+### Arquitectura
+
+#### <repo-1>
+- **Componentes nuevos**: [lista]
+- **Componentes modificados**: [lista]
+- **APIs**: [endpoints nuevos/modificados]
+
+#### <repo-2>
+- **Componentes nuevos**: [lista]
+- **Componentes modificados**: [lista]
+- **APIs**: [endpoints nuevos/modificados]
+
+### Integraciones
+- **Entre repos**: [cómo se comunican los repos]
+- **Externas**: [APIs externas, si las hay]
+
+### Modelo de Datos
+[Describa cambios en el modelo de datos, si los hay]
+```
+
+### 6. Criterios de Aceptación
+
+```markdown
+## Criterios de Aceptación
+
+### Funcional
+- [ ] [Criterio específico y testable]
+- [ ] [Criterio específico y testable]
+
+### Técnico
+- [ ] Tests unitarios con cobertura >= X%
+- [ ] Tests de integración implementados
+- [ ] Performance dentro de los requisitos
+- [ ] Documentación actualizada
+
+### Calidad
+- [ ] Code review aprobado
+- [ ] Sin regresiones
+- [ ] Accesibilidad validada
+```
+
+### 7. Fuera del Alcance
+
+```markdown
+## Fuera del Alcance
+
+Funcionalidades que NO serán implementadas en esta versión:
+- [Ítem 1]
+- [Ítem 2]
+
+Justificación: [Por qué quedan para después]
+```
+
+### 8. Riesgos y Mitigaciones
+
+```markdown
+## Riesgos y Mitigaciones
+
+### Riesgo 1: [Descripción]
+- **Probabilidad**: Alta / Media / Baja
+- **Impacto**: Alto / Medio / Bajo
+- **Mitigación**: [Cómo mitigar]
+
+### Riesgo 2: [Descripción]
+- **Probabilidad**: Alta / Media / Baja
+- **Impacto**: Alto / Medio / Bajo
+- **Mitigación**: [Cómo mitigar]
+```
+
+### 9. Dependencias
+
+```markdown
+## Dependencias
+
+### Técnicas
+- [Dependencia técnica 1]
+- [Dependencia técnica 2]
+
+### De Negocio
+- [Dependencia de negocio 1]
+- [Dependencia de negocio 2]
+
+### Bloqueadores
+- [Bloqueador 1 y plan para resolver]
+```
+
+### 10. Plan de Pruebas
+
+```markdown
+## Plan de Pruebas
+
+### Tests Unitarios
+- [Área 1 a testear]
+- [Área 2 a testear]
+
+### Tests de Integración
+- [Escenario 1]
+- [Escenario 2]
+
+### Tests Manuales
+- [Escenario 1]
+- [Escenario 2]
+```
+
+## 📄 Guardado del PRD
+
+**PRIORIDAD 1: Usar MCP (Model Context Protocol)**
+
+- Lea `ai.properties.md` del orchestrator para identificar el `task_management_system`
+- Use el MCP apropiado para actualizar la issue con el PRD:
+  - Añada el PRD completo como comentario en la issue
+  - O adjunte como archivo (si el task manager lo soporta)
+  - Actualice status/labels (ej: "spec-ready", "ready-for-dev")
+- Informe al usuario: "✅ PRD añadido a la issue [ID]"
+
+**FALLBACK: Crear archivo .md sólo si MCP falla**
+
+Si MCP no está disponible o falla:
+- Guarde en `./.sessions/<ISSUE-ID>/prd.md`
+- Informe al usuario: "⚠️ PRD guardado localmente en .sessions/ (task manager no disponible)"
+
+## 🔍 Revisión y Aprobación
+
+Antes de finalizar:
+1. Revise el PRD con stakeholders
+2. Valide contra metaspecs (si están disponibles)
+3. Obtenga aprobación para iniciar implementación
+4. **Vía MCP**: Actualice la issue en el task manager con status "Listo para Desarrollo"
+5. **Fallback**: Documente la aprobación en `./.sessions/<ISSUE-ID>/prd.md`
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Paso
+
+Tras la aprobación del PRD:
+
+```bash
+/start
+```
+
+Este comando iniciará el desarrollo de la feature.

package/templates/commands/es/quality/metrics.md

@@ -0,0 +1,240 @@
+# Métricas de Calidad
+
+Este comando recopila y analiza métricas de calidad del código y del proceso de desarrollo.
+
+## 🎯 Objetivo
+
+Medir y documentar la calidad de la implementación mediante métricas objetivas:
+- Cobertura de pruebas
+- Complejidad del código
+- Deuda técnica
+- Rendimiento
+- Cumplimiento con estándares
+
+## 📋 Requisitos previos
+
+- Implementación finalizada (después de `/work`)
+- Pruebas implementadas
+- Build funcionando
+
+## 📊 Métricas a Recopilar
+
+### 1. Cobertura de Pruebas
+
+Para cada repositorio modificado:
+
+```bash
+cd <repositório>
+
+# Ejecutar pruebas con cobertura
+npm run test:coverage  # ou comando equivalente
+
+# Capturar resultados
+```
+
+Documente:
+```markdown
+## Cobertura de Pruebas
+
+### <repo-1>
+- **Cobertura Total**: X%
+- **Statements**: X%
+- **Branches**: X%
+- **Functions**: X%
+- **Lines**: X%
+- **Archivos no cubiertos**: [lista]
+
+### <repo-2>
+[Mismo formato]
+```
+
+### 2. Complejidad del Código
+
+Analice la complejidad ciclomática de los archivos modificados:
+
+```markdown
+## Complejidad del Código
+
+### Archivos con Alta Complejidad
+- **archivo1.ts**: Complejidad 15 (recomendado: < 10)
+- **archivo2.ts**: Complejidad 12
+
+### Recomendaciones
+- [Sugerencia de refactorización 1]
+- [Sugerencia de refactorización 2]
+```
+
+### 3. Calidad del Código
+
+```bash
+# Ejecutar linting
+npm run lint
+
+# Verificar formato
+npm run format:check
+
+# Análisis estático (si está disponible)
+npm run analyze
+```
+
+Documente:
+```markdown
+## Calidad del Código
+
+### Linting
+- **Errores**: 0
+- **Warnings**: X
+- **Warnings Justificados**: [lista con justificaciones]
+
+### Formato
+- **Estado**: ✅ Conforme / ⚠️ Ajustes necesarios
+
+### Análisis Estático
+- **Problemas Críticos**: 0
+- **Problemas Medios**: X
+- **Problemas Bajos**: Y
+```
+
+### 4. Rendimiento
+
+Si aplica, mida rendimiento:
+
+```markdown
+## Rendimiento
+
+### Benchmarks
+- **Operación X**: Yms (baseline: Zms)
+- **Operación Y**: Yms (baseline: Zms)
+
+### Optimizaciones Aplicadas
+- [Optimización 1 e impacto]
+- [Optimización 2 e impacto]
+
+### Cuellos de Botella Identificados
+- [Cuello de botella 1 y plan de mitigación]
+```
+
+### 5. Tamaño e Impacto
+
+```markdown
+## Tamaño e Impacto
+
+### Líneas de Código
+- **Añadidas**: +X líneas
+- **Eliminadas**: -Y líneas
+- **Modificadas**: Z líneas
+
+### Archivos
+- **Nuevos**: X archivos
+- **Modificados**: Y archivos
+- **Eliminados**: Z archivos
+
+### Dependencias
+- **Nuevas dependencias**: [lista]
+- **Tamaño del bundle**: +X KB
+```
+
+### 6. Deuda Técnica
+
+Identifique deuda técnica introducida o resuelta:
+
+```markdown
+## Deuda Técnica
+
+### Deuda Introducida
+- **Ítem 1**: [Descripción y justificación]
+  - Severidad: Alta / Media / Baja
+  - Plan de resolución: [cuándo y cómo resolver]
+
+### Deuda Resuelta
+- **Ítem 1**: [Qué fue resuelto]
+  - Impacto: [mejora obtenida]
+```
+
+## 📄 Informe de Métricas
+
+Cree `./.sessions/<ISSUE-ID>/metrics.md`:
+
+```markdown
+# Informe de Métricas - [ISSUE-ID]
+
+**Fecha**: [fecha/hora]
+**Repositorios**: [lista]
+
+## Resumen Ejecutivo
+
+- **Cobertura de Pruebas**: X% (meta: Y%)
+- **Calidad del Código**: ✅ / ⚠️ / ❌
+- **Rendimiento**: ✅ / ⚠️ / ❌
+- **Deuda Técnica**: Baja / Media / Alta
+
+## Métricas Detalladas
+
+[Incluir todas las secciones anteriores]
+
+## Comparación con Baseline
+
+| Métrica | Antes | Después | Variación |
+|---------|-------|---------|-----------|
+| Cobertura | X% | Y% | +Z% |
+| Complejidad Media | X | Y | +Z |
+| Tamaño del Bundle | X KB | Y KB | +Z KB |
+
+## Acciones Recomendadas
+
+1. [Acción 1 - prioridad alta]
+2. [Acción 2 - prioridad media]
+3. [Acción 3 - prioridad baja]
+
+## Aprobación para Merge
+
+- [ ] Cobertura de pruebas >= meta
+- [ ] Sin problemas críticos de calidad
+- [ ] Rendimiento dentro de los requisitos
+- [ ] Deuda técnica documentada y aprobada
+```
+
+## 🎯 Metas de Calidad
+
+Si el proyecto tiene metas definidas en las metaspecs, valide:
+
+```markdown
+## Validación contra Metas
+
+### Metas del Proyecto
+- **Cobertura mínima**: 80%
+- **Complejidad máxima**: 10
+- **Rendimiento**: < 100ms
+
+### Estado
+- Cobertura: ✅ 85% (meta: 80%)
+- Complejidad: ⚠️ 12 (meta: 10) - Justificado
+- Rendimiento: ✅ 85ms (meta: 100ms)
+```
+
+## 🚨 Alertas
+
+Si alguna métrica está fuera de lo aceptable:
+1. 🛑 **DOCUMENTE** el problema
+2. 💬 **ALERTE** al usuario
+3. 🔧 **PROPONGA** acciones correctivas
+4. ⏸️ **CONSIDERE** bloquear el merge hasta resolución
+
+---
+
+**Argumentos proporcionados**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Resultado
+
+Tras ejecutar este comando, tendrá:
+- Informe completo de métricas
+- Comparación con baseline y metas
+- Identificación de problemas de calidad
+- Recomendaciones de acciones
+- Base objetiva para aprobación de merge