context-first-cli 2.2.0 → 2.2.1

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

@@ -1,15 +1,15 @@
 # Creación de Especificación (PRD)
 
-Este comando crea la especificación completa (Product Requirements Document) de la feature.
+Este comando crea la especificación completa (Product Requirements Document) de la funcionalidad.
 
 ## ⚠️ 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)
+- ✅ Actualizar issue en el gestor de tareas vía MCP
+- ✅ **LEER** archivos de los repositorios principales (solo lectura)
 - ❌ **NO implementar código**
-- ❌ **NO hacer edits en archivos de código**
+- ❌ **NO hacer ediciones en archivos de código**
 - ❌ **NO hacer checkout de branches en los repositorios principales**
 - ❌ **NO hacer commits**
 
@@ -17,19 +17,56 @@ Este comando crea la especificación completa (Product Requirements Document) de
 
 ---
 
-## 📋 Requisitos Previos
+## 📋 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.
+
+## 📋 Pre-requisitos
 
 - Issue refinada vía `/refine`
-- Aprobación para continuar con la feature
+- Aprobación para continuar con la funcionalidad
 
 ## 📚 Cargar MetaSpecs
 
 **Localizar MetaSpecs automáticamente**:
-1. Lea `context-manifest.json` del orchestrator
+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 garantizar conformidad con:
+5. Lea los archivos `index.md` relevantes para asegurar conformidad con:
    - Arquitectura del sistema
    - Patrones de diseño
    - Restricciones técnicas
@@ -44,13 +81,13 @@ Crear un PRD completo que servirá como fuente única de verdad para la implemen
 ### 1. Visión General
 
 ```markdown
-# [Título de la Feature]
+# [Título de la Funcionalidad]
 
 ## Contexto
 [¿Por qué estamos construyendo esto? ¿Qué problema resuelve?]
 
 ## Objetivo
-[¿Qué queremos lograr con esta feature?]
+[¿Qué queremos lograr con esta funcionalidad?]
 
 ## Métricas de Éxito
 - [Métrica 1]: [Cómo medir]
@@ -142,12 +179,12 @@ Crear un PRD completo que servirá como fuente única de verdad para la implemen
 ## Criterios de Aceptación
 
 ### Funcional
-- [ ] [Criterio específico y testable]
-- [ ] [Criterio específico y testable]
+- [ ] [Criterio específico y comprobable]
+- [ ] [Criterio específico y comprobable]
 
 ### Técnico
-- [ ] Tests unitarios con cobertura >= X%
-- [ ] Tests de integración implementados
+- [ ] Pruebas unitarias con cobertura >= X%
+- [ ] Pruebas de integración implementadas
 - [ ] Performance dentro de los requisitos
 - [ ] Documentación actualizada
 
@@ -207,15 +244,15 @@ Justificación: [Por qué quedan para después]
 ```markdown
 ## Plan de Pruebas
 
-### Tests Unitarios
-- [Área 1 a testear]
-- [Área 2 a testear]
+### Pruebas Unitarias
+- [Área 1 a probar]
+- [Área 2 a probar]
 
-### Tests de Integración
+### Pruebas de Integración
 - [Escenario 1]
 - [Escenario 2]
 
-### Tests Manuales
+### Pruebas Manuales
 - [Escenario 1]
 - [Escenario 2]
 ```
@@ -224,18 +261,18 @@ Justificación: [Por qué quedan para después]
 
 **PRIORIDAD 1: Usar MCP (Model Context Protocol)**
 
-- Lea `ai.properties.md` del orchestrator para identificar el `task_management_system`
+- Lea `ai.properties.md` del orquestador 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")
+  - O adjunte como archivo (si el gestor de tareas lo soporta)
+  - Actualice estado/etiquetas (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)"
+- Informe al usuario: "⚠️ PRD guardado localmente en .sessions/ (gestor de tareas no disponible)"
 
 ## 🔍 Revisión y Aprobación
 
@@ -243,7 +280,7 @@ 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"
+4. **Vía MCP**: Actualice la issue en el gestor de tareas con estado "Listo para Desarrollo"
 5. **Fallback**: Documente la aprobación en `./.sessions/<ISSUE-ID>/prd.md`
 
 ---
@@ -258,10 +295,10 @@ Antes de finalizar:
 
 ## 🎯 Próximo Paso
 
-Tras la aprobación del PRD:
+Después de la aprobación del PRD:
 
 ```bash
 /start
 ```
 
-Este comando iniciará el desarrollo de la feature.
+Este comando iniciará el desarrollo de la funcionalidad.

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

@@ -9,11 +9,49 @@ Medir y documentar la calidad de la implementación mediante métricas objetivas
 - Complejidad del código
 - Deuda técnica
 - Rendimiento
-- Cumplimiento con estándares
+- Conformidad con estándares
 
-## 📋 Requisitos previos
+## 📋 Configuración del Proyecto
 
-- Implementación finalizada (después de `/work`)
+**⚠️ 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.
+
+
+## 📋 Requisitos Previos
+
+- Implementación completada (después de `/work`)
 - Pruebas implementadas
 - Build funcionando
 
@@ -142,7 +180,7 @@ Si aplica, mida rendimiento:
 ## Tamaño e Impacto
 
 ### Líneas de Código
-- **Añadidas**: +X líneas
+- **Agregadas**: +X líneas
 - **Eliminadas**: -Y líneas
 - **Modificadas**: Z líneas
 
@@ -254,7 +292,7 @@ Si alguna métrica está fuera de lo aceptable:
 
 ## 🎯 Resultado
 
-Tras ejecutar este comando, tendrá:
+Después de ejecutar este comando, tendrás:
 - Informe completo de métricas
 - Comparación con baseline y metas
 - Identificación de problemas de calidad

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

@@ -12,7 +12,44 @@ Crear un registro estructurado de decisiones técnicas y de producto, garantizan
 
 **IMPORTANTE**: Este comando NO genera decisiones nuevas. Solo REGISTRA decisiones que ya fueron tomadas en el proceso de desarrollo.
 
-## 📋 Requisitos previos
+## 📋 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 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úe sin leer estos archivos!** Contienen información crítica para la correcta ejecución del comando.
+
+## 📋 Pre-requisitos
 
 - Haber ejecutado al menos uno de los comandos que generan decisiones:
   - `/spec` - genera PRD con decisiones de producto
@@ -28,7 +65,7 @@ Analice los archivos de la sesión (`./.sessions/<ISSUE-ID>/`) para identificar
 **Después de `/spec`** - Decisiones de Producto:
 - Lea `./.sessions/<ISSUE-ID>/prd.md`
 - Identifique decisiones en:
-  - Alcance (qué entra/no entra en la feature)
+  - Alcance (qué entra/no entra en la funcionalidad)
   - Personas atendidas (quién es el público objetivo)
   - Métricas de éxito (cómo medir resultados)
   - Requisitos no funcionales (performance, accesibilidad)
@@ -41,7 +78,7 @@ Analice los archivos de la sesión (`./.sessions/<ISSUE-ID>/`) para identificar
   - Elección de bibliotecas o herramientas
   - Patrones de implementación
   - Estructura de datos
-  - Estrategia de tests
+  - Estrategia de pruebas
 
 **Durante `/work`** - Decisiones de Implementación:
 - Lea `./.sessions/<ISSUE-ID>/work.md`
@@ -92,7 +129,7 @@ Guarde en `./.sessions/<ISSUE-ID>/decisions.md`:
 # Registro de Decisiones - [ISSUE-ID]
 
 ## Resumen
-[Breve resumen de las principales decisiones tomadas en esta feature]
+[Breve resumen de las principales decisiones tomadas en esta funcionalidad]
 
 ## Decisiones de Producto
 
@@ -161,7 +198,7 @@ Periódicamente, revise las decisiones tomadas:
 
 ## 🎯 Resultado
 
-Después de ejecutar este comando, tendrá:
+Después de ejecutar este comando, tendrás:
 - Registro completo de decisiones en `./.sessions/<ISSUE-ID>/decisions.md`
 - Trazabilidad de cada elección realizada
 - Documentación para futuras referencias

package/templates/commands/es/warm-up.md

@@ -14,6 +14,44 @@ pwd
 
 Si no está en un workspace, pregunte al usuario qué workspace usar o si debe crear uno nuevo con `feature:start`.
 
+## 📋 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 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á:
+- ✅ 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.
+
+
 ## 2. Cargar Configuración del Proyecto
 
 Ya está en el orchestrator del proyecto (raíz del repositorio actual).
@@ -32,7 +70,7 @@ Lea el `context-manifest.json` del orchestrator para entender:
 
 ## 4. Cargar MetaSpecs
 
-El repositorio de MetaSpecs es **separado** y está definido en `context-manifest.json` con `role: "metaspecs"`.
+El repositorio de MetaSpecs es **separado** y está definido en el `context-manifest.json` con `role: "metaspecs"`.
 
 **Localice el repositorio de metaspecs:**
 
@@ -46,14 +84,14 @@ El repositorio de MetaSpecs es **separado** y está definido en `context-manifes
 1. **`README.md`** - Visión general del proyecto y estructura de documentación
 2. **`index.md`** (en la raíz o en subcarpetas) - Índice de especificaciones disponibles
 
-**Use los índices como referencia** para navegar hasta las especificaciones específicas que necesita. No asuma que archivos específicos existen - siempre consulte los índices primero.
+**Use los índices como referencia** para navegar hasta las especificaciones específicas que necesite. No asuma que archivos específicos existen - siempre consulte los índices primero.
 
 ## 5. Cargar Sesión Actual (si existe)
 
 Verifique si existe una sesión guardada para este workspace:
 
 ```bash
-# Buscar sesión en orchestrator
+# Buscar sesión en el orchestrator
 ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
 ```
 
@@ -68,18 +106,18 @@ Para cada repositorio presente en el workspace, lea:
 ## 7. Navegación Inteligente
 
 - **Código**: Use herramientas de búsqueda (glob, grep) para localizar archivos relevantes
-- **Documentación**: Use los índices de MetaSpecs como referencia
+- **Documentación**: Use los índices de los MetaSpecs como referencia
 - **Espere Instrucciones**: NO lea otros archivos ahora. Espere el próximo comando.
 
 ## 8. Principio Jidoka (Parar al Detectar Problemas)
 
-Si detecta desalineamiento, conflictos o problemas:
+Si detecta desalineamientos, conflictos o problemas:
 1. 🛑 **PARE** inmediatamente
 2. 📝 **DOCUMENTE** el problema encontrado
-3. 💬 **ALERTE** al usuario antes de proceder
+3. 💬 **ALERTE** al usuario antes de continuar
 
 ---
 
 **Argumentos proporcionados**: #$ARGUMENTS
 
-**Estado**: Contexto cargado. Esperando próximo comando.
+**Estado**: Contexto cargado. Esperando próximo comando.