context-first-cli 2.1.6 → 2.2.0

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

@@ -12,6 +12,43 @@ This command validates requirements, decisions, or implementations against the p
 - ❌ **DO NOT modify code**
 - ❌ **DO NOT modify `context.md` or `architecture.md`**
 
+## 📋 Project Configuration
+
+**⚠️ IMPORTANT: Always read the project configuration files BEFORE running this command!**
+
+### Required Files
+
+1. **`context-manifest.json`** (root of the orchestrator)
+   - List of project repositories
+   - Roles of each repository (metaspecs, application, etc.)
+   - URLs and dependencies between repositories
+
+2. **`ai.properties.md`** (root of the orchestrator)
+   - Project settings (`project_name`, `base_path`)
+   - Task management system
+   - Credentials and specific configurations
+
+### How to Read
+
+```bash
+# 1. Read context-manifest.json
+cat context-manifest.json
+
+# 2. Read ai.properties.md
+cat ai.properties.md
+```
+
+### Essential Information
+
+After reading the files, you will have:
+- ✅ Complete list of project repositories
+- ✅ Location of the metaspecs repository
+- ✅ Base path to locate repositories
+- ✅ Configured task management system
+- ✅ Specific project configurations
+
+**🛑 DO NOT proceed without reading these files!** They contain critical information for the correct execution of the command.
+
 ## 🎯 Objective
 
 Ensure alignment with:
@@ -34,7 +71,7 @@ Run this command:
 1. Read `context-manifest.json` from the orchestrator
 2. Find the repository with `"role": "metaspecs"`
 3. Read `ai.properties.md` to get the `base_path`
-4. The metaspecs are located at: `{base_path}/{metaspecs-repo-id}/
+4. The metaspecs are located at: `{base_path}/{metaspecs-repo-id}/`
 
 ## 🔍 Validation Process
 
@@ -48,7 +85,7 @@ ls -la {base_path}/{metaspecs-repo-id}/
 
 ### 2. Business Validation
 
-If there are business metaspecs (`MetaSpecs repository (business section)`):
+If business metaspecs exist (`MetaSpecs repository (business section)`):
 
 ```markdown
 ## Business Validation
@@ -56,25 +93,25 @@ If there are business metaspecs (`MetaSpecs repository (business section)`):
 ### Product Strategy
 - **File**: `MetaSpecs repository (business section)PRODUCT_STRATEGY.md`
 - **Validation**: [Is this feature aligned with the strategy?]
-- **Status**: ✅ Aligned / ⚠️ Partially / ❌ Not aligned
+- **Status**: ✅ Aligned / ⚠️ Partial / ❌ Misaligned
 - **Notes**: [Observations]
 
 ### Personas
 - **File**: `MetaSpecs repository (business section)CUSTOMER_PERSONAS.md`
 - **Validation**: [Does it meet the correct persona?]
-- **Status**: ✅ Aligned / ⚠️ Partially / ❌ Not aligned
+- **Status**: ✅ Aligned / ⚠️ Partial / ❌ Misaligned
 - **Notes**: [Observations]
 
 ### Metrics
 - **File**: `MetaSpecs repository (business section)PRODUCT_METRICS.md`
 - **Validation**: [Is the success metric documented?]
-- **Status**: ✅ Aligned / ⚠️ Partially / ❌ Not aligned
+- **Status**: ✅ Aligned / ⚠️ Partial / ❌ Misaligned
 - **Notes**: [Observations]
 ```
 
 ### 3. Technical Validation
 
-If there are technical metaspecs (`MetaSpecs repository (technical section)`):
+If technical metaspecs exist (`MetaSpecs repository (technical section)`):
 
 ```markdown
 ## Technical Validation
@@ -128,14 +165,14 @@ If there are technical metaspecs (`MetaSpecs repository (technical section)`):
 
 ### 5. Conflict Identification
 
-If there are conflicts or misalignments:
+If conflicts or misalignments exist:
 
 ```markdown
 ## Identified Conflicts
 
 ### Conflict 1: [Description]
 - **Severity**: Critical / High / Medium / Low
-- **Metaspec**: [File being violated]
+- **Metaspec**: [Violated file]
 - **Description**: [Conflict details]
 - **Recommendation**: [How to resolve]
 
@@ -151,7 +188,7 @@ If there are justified deviations:
 ## Justified Exceptions
 
 ### Exception 1: [Description]
-- **Metaspec**: [File being deviated]
+- **Metaspec**: [Deviated file]
 - **Deviation**: [What is different]
 - **Justification**: [Why it is necessary]
 - **Approval**: [Who approved]
@@ -166,7 +203,7 @@ If there are justified deviations:
 - Use the appropriate MCP to add the report to the issue:
   - Add as a comment on the issue
   - Update labels/tags according to the result (e.g., "validated", "needs-adjustment", "blocked")
-  - If there are critical conflicts, update the issue status
+  - If critical conflicts exist, update the issue status
 - Inform the user: "✅ Validation report added to issue [ID]"
 
 **FALLBACK: Create .md file only if MCP fails**
@@ -212,7 +249,7 @@ If critical conflicts are found:
 2. 📝 **DOCUMENT** all conflicts
 3. 💬 **ALERT** the user and stakeholders
 4. **Via MCP**: Update issue status to "Blocked" or "Requires Adjustments"
-5. 🔄 **ADJUST** the plan/implementation as needed
+5. 🔄 **ADJUST** plan/implementation as needed
 6. ✅ **REVALIDATE** after adjustments
 
 ---

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

@@ -18,20 +18,57 @@ You are a product specialist responsible for collecting and documenting new idea
 
 ---
 
+## 📋 Project Setup
+
+**⚠️ IMPORTANT: Always read the project configuration files BEFORE running this command!**
+
+### Mandatory Files
+
+1. **`context-manifest.json`** (orchestrator root)
+   - List of project repositories
+   - Roles of each repository (metaspecs, application, etc.)
+   - URLs and dependencies between repositories
+
+2. **`ai.properties.md`** (orchestrator root)
+   - Project settings (`project_name`, `base_path`)
+   - Task management system (`task_management_system`)
+   - Credentials and specific configurations
+
+### How to Read
+
+```bash
+# 1. Read context-manifest.json
+cat context-manifest.json
+
+# 2. Read ai.properties.md
+cat ai.properties.md
+```
+
+### Essential Information
+
+After reading the files, you will have:
+- ✅ Complete list of project repositories
+- ✅ Location of the metaspecs repository
+- ✅ Base path to locate repositories
+- ✅ Configured task management system
+- ✅ Project-specific configurations
+
+**🛑 DO NOT proceed without reading these files!** They contain critical information for the correct execution of the command.
+
 ## Project Context
 
 Before starting, load the context by consulting:
 
-1. **Automatically Locate MetaSpecs**:
+1. **Automatically locate MetaSpecs**:
    - Read `context-manifest.json` from the orchestrator
    - Find the repository with `"role": "metaspecs"`
    - Read `ai.properties.md` to get the `base_path`
-   - The metaspecs are at: `{base_path}/{metaspecs-repo-id}/`
+   - The metaspecs are located at: `{base_path}/{metaspecs-repo-id}/`
    - Read the `index.md` files as reference
 
-2. **Project Structure**:
+2. **Project structure**:
    - `context-manifest.json` - List of repositories and their roles
-   - `README.md` of the involved repositories
+   - `README.md` of involved repositories
 
 ## Your Goal
 
@@ -87,14 +124,14 @@ Just ensure the idea is **adequately understood**.
    - Suggested priority
 
 3. **Complexity Assessment and Suggestion to Split**
-   
+
    Before finalizing, assess the issue complexity:
-   
+
    **If the implementation seems large** (> 5 days estimated effort):
    - 🚨 **Suggest splitting into multiple smaller issues**
-   - Explain the rationale for splitting (e.g., "This feature involves 3 distinct areas: authentication, processing, and notification")
+   - Explain the rationale for the split (e.g., "This feature involves 3 distinct areas: authentication, processing, and notification")
    - Propose a **logical** split (by functionality, repository, layer, etc.)
-   - Example of splitting:
+   - Example split:
      ```
      Original Issue: "Complete payment system"
      
@@ -104,7 +141,7 @@ Just ensure the idea is **adequately understood**.
      - FIN-103: Confirmation webhook and notifications (backend + jobs)
      ```
    - **Important**: The final decision is the user's - they can accept the split or keep it as a single issue
-   
+
    **If the user accepts the split**:
    - Create each issue separately using the same process
    - Add cross-references between related issues
@@ -112,10 +149,10 @@ Just ensure the idea is **adequately understood**.
 
 4. **User Approval**
    - Present the draft (or drafts, if split)
-   - Make adjustments based on feedback
+   - Make adjustments according to feedback
    - Obtain final approval
 
-5. **Saving the Issue**
+5. **Issue Saving**
 
    **PRIORITY 1: Use MCP (Model Context Protocol)**
    
@@ -134,8 +171,8 @@ Just ensure the idea is **adequately understood**.
    
    **FALLBACK: Create .md file only if MCP fails**
    
-   If MCP is unavailable or fails:
-   - Create a file at `./.sessions/<ISSUE-ID>/collect.md`
+   If MCP is not available or fails:
+   - Create a file in `./.sessions/<ISSUE-ID>/collect.md`
    - Use manual ID format: `LOCAL-001`, `LOCAL-002`, etc.
    - Include date, type, and full content
    - Inform the user: "⚠️ Issue saved locally in .sessions/ (task manager not available)"
@@ -157,7 +194,7 @@ Just ensure the idea is **adequately understood**.
 
 **For Improvements**:
 - What is working but can be improved?
-- What metric do we want to impact?
+- Which metric do we want to impact?
 - Is it a technical or business optimization?
 
 ---

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

@@ -1,20 +1,58 @@
 # Planificación Técnica
 
-Este comando crea el plan técnico detallado para la implementación de la feature.
+Este comando crea el plan técnico detallado para la implementación de la funcionalidad.
 
-## 📋 Prerrequisitos
+## 📋 Requisitos Previos
 
 - PRD creado vía `/spec`
-- Análisis inicial hecho vía `/start`
+- 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 (será usado no /work)
-├── repo-2/          # worktree (será usado no /work)
+├── 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)
@@ -29,7 +67,7 @@ Este comando crea el plan técnico detallado para la implementación de la featu
 **REGLA DE ORO**:
 - ✅ Lea `context.md` y `architecture.md` (inmutables)
 - ✅ Cree `plan.md` en `.sessions/<ISSUE-ID>/`
-- ✅ Lea código de los repositorios principales (read-only)
+- ✅ Lea código de los repositorios principales (solo lectura)
 - ❌ NUNCA haga checkout en los repositorios principales
 - ❌ NUNCA modifique `context.md` o `architecture.md`
 
@@ -38,17 +76,17 @@ Este comando crea el plan técnico detallado para la implementación de la featu
 **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 - será actualizado durante `/work`)
+- ✅ **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 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 y código
    - Estructura de carpetas y archivos
@@ -63,14 +101,14 @@ Crear un plan técnico detallado que guiará la implementación, dividiendo el t
 ### 1. Visión General Técnica
 
 ```markdown
-# Plan Técnico - [Título de la Feature]
+# Plan Técnico - [Título de la Funcionalidad]
 
 ## Resumen
 [Breve descripción técnica de lo que se implementará]
 
 ## Repositorios Involucrados
-- **<repo-1>**: [Papel en esta feature]
-- **<repo-2>**: [Papel en esta feature]
+- **<repo-1>**: [Rol en esta funcionalidad]
+- **<repo-2>**: [Rol en esta funcionalidad]
 
 ## Enfoque Técnico
 [Estrategia general de implementación]
@@ -82,7 +120,7 @@ Crear un plan técnico detallado que guiará la implementación, dividiendo el t
 ## Arquitectura
 
 ### Diagrama de Componentes
-[Descripción textual o ASCII art de los componentes y sus relaciones]
+[Descripción textual o arte ASCII de los componentes y sus relaciones]
 
 ### Flujo de Datos
 1. [Paso 1 del flujo]
@@ -91,7 +129,7 @@ Crear un plan técnico detallado que guiará la implementación, dividiendo el t
 
 ### Integraciones
 - **<repo-1> → <repo-2>**: [Cómo se comunican]
-- **Sistema → API Externa**: [Si hay]
+- **Sistema → API Externa**: [Si aplica]
 ```
 
 ### 3. Decisiones Técnicas
@@ -108,7 +146,7 @@ Crear un plan técnico detallado que guiará la implementación, dividiendo el t
 **Justificación**: [Por qué elegimos esta opción]
 
 ### Decisión 2: [Título]
-[Mismo formato arriba]
+[Mismo formato anterior]
 ```
 
 ### 4. Plan de Implementación
@@ -137,10 +175,10 @@ Divida el trabajo en unidades pequeñas y secuenciales:
 - **Estimación**: [tiempo estimado]
 
 ### Fase 2: [Nombre de la Fase]
-[Mismo formato arriba]
+[Mismo formato anterior]
 
 ### Fase 3: [Nombre de la Fase]
-[Mismo formato arriba]
+[Mismo formato anterior]
 ```
 
 ### 5. Estructura de Archivos
@@ -233,7 +271,7 @@ src/
 - **Plan B**: [Alternativa si ocurre]
 
 ### Riesgo 2: [Descripción]
-[Mismo formato arriba]
+[Mismo formato anterior]
 ```
 
 ### 9. Checklist de Implementación
@@ -272,9 +310,9 @@ Guarde en `./.sessions/<ISSUE-ID>/plan.md`
 Revise el plan verificando:
 - Todas las tareas están claras y ejecutables
 - Dependencias entre tareas están identificadas
-- Estimaciones son realistas
-- Riesgos fueron considerados
-- Estrategia de pruebas es adecuada
+- Las estimaciones son realistas
+- Los riesgos fueron considerados
+- La estrategia de pruebas es adecuada
 
 ---
 
@@ -288,7 +326,7 @@ Revise el plan verificando:
 
 ## 🎯 Próximo Paso
 
-Tras la aprobación del plan:
+Después de la aprobación del plan:
 
 ```bash
 /work

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

@@ -2,7 +2,7 @@
 
 Este comando crea Pull Requests para todos los repositorios modificados en el workspace.
 
-## 📋 Requisitos previos
+## 📋 Requisitos Previos
 
 Antes de crear PRs, asegúrate de que:
 - Ejecutaste `/pre-pr` y todas las validaciones pasaron
@@ -10,9 +10,47 @@ Antes de crear PRs, asegúrate de que:
 - 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!**
+**⚠️ ATENCIÓN: Si necesitas hacer ajustes de última hora, TODO EL CÓDIGO DEBE SER CREADO DENTRO DEL WORKTREE!**
 
 **✅ CORRECTO** - Trabajar dentro del worktree:
 ```
@@ -41,7 +79,7 @@ Para cada repositorio en el workspace, verifica:
 ```bash
 cd <repositorio>
 git status
-git log origin/main..HEAD  # Ver commits no pushados
+git log origin/main..HEAD  # Ver commits no pusheados
 ```
 
 ### 2. Push de las Branches
@@ -54,7 +92,7 @@ git push origin <branch-name>
 
 ### 3. Crear Pull Requests
 
-Para cada repositorio, crea un PR usando el GitHub CLI o la interfaz web:
+Para cada repositorio, crea un PR usando GitHub CLI o interfaz web:
 
 **Usando GitHub CLI**:
 ```bash
@@ -93,7 +131,7 @@ gh pr create --title "[ISSUE-ID] Título de la Feature" \
 - [ ] Pruebas de integración pasando
 - [ ] Documentación actualizada
 - [ ] Sin breaking changes (o documentados)
-- [ ] Revisado por pares (tras creación del PR)
+- [ ] Revisado por pares (después de crear el PR)
 
 ## 🧪 Cómo Probar
 
@@ -101,9 +139,9 @@ gh pr create --title "[ISSUE-ID] Título de la Feature" \
 2. [Paso 2]
 3. [Resultado esperado]
 
-## 📸 Capturas/Demos
+## 📸 Screenshots/Demos
 
-[Si aplica, añade capturas o enlaces a demos]
+[Si aplica, añade capturas de pantalla o enlaces a demos]
 
 ## 🔍 Notas para Revisores
 
@@ -135,12 +173,12 @@ Actualiza `./.sessions/<ISSUE-ID>/pr.md`:
 ## PRs Creados
 
 ### <repo-1>
-- **Enlace**: <URL del PR>
+- **Link**: <URL del PR>
 - **Estado**: Abierto
 - **Commits**: X commits
 
 ### <repo-2>
-- **Enlace**: <URL del PR>
+- **Link**: <URL del PR>
 - **Estado**: Abierto
 - **Commits**: Y commits