context-first-cli 2.1.6 → 2.2.1

package/dist/templates/commands/en/quality/metrics.md

@@ -11,6 +11,43 @@ Measure and document the quality of the implementation through objective metrics
 - Performance
 - Compliance with standards
 
+## 📋 Project Configuration
+
+**⚠️ IMPORTANT: Always read the project configuration files BEFORE running this command!**
+
+### Required 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.
+
 ## 📋 Prerequisites
 
 - Implementation completed (after `/work`)
@@ -57,14 +94,14 @@ Document:
 
 ### 2. Code Complexity
 
-Analyze the cyclomatic complexity of the modified files:
+Analyze the cyclomatic complexity of modified files:
 
 ```markdown
 ## Code Complexity
 
 ### Files with High Complexity
-- **arquivo1.ts**: Complexity 15 (recommended: < 10)
-- **arquivo2.ts**: Complexity 12
+- **file1.ts**: Complexity 15 (recommended: < 10)
+- **file2.ts**: Complexity 12
 
 ### Recommendations
 - [Refactoring suggestion 1]
@@ -163,12 +200,12 @@ Identify technical debt introduced or resolved:
 ```markdown
 ## Technical Debt
 
-### Introduced Debt
+### Debt Introduced
 - **Item 1**: [Description and justification]
   - Severity: High / Medium / Low
   - Resolution plan: [when and how to resolve]
 
-### Resolved Debt
+### Debt Resolved
 - **Item 1**: [What was resolved]
   - Impact: [improvement achieved]
 ```
@@ -185,7 +222,7 @@ Create `./.sessions/<ISSUE-ID>/metrics.md`:
 
 ## Executive Summary
 
-- **Test Coverage**: X% (target: Y%)
+- **Test Coverage**: X% (goal: Y%)
 - **Code Quality**: ✅ / ⚠️ / ❌
 - **Performance**: ✅ / ⚠️ / ❌
 - **Technical Debt**: Low / Medium / High
@@ -210,7 +247,7 @@ Create `./.sessions/<ISSUE-ID>/metrics.md`:
 
 ## Approval for Merge
 
-- [ ] Test coverage >= target
+- [ ] Test coverage >= goal
 - [ ] No critical quality issues
 - [ ] Performance within requirements
 - [ ] Technical debt documented and approved
@@ -229,18 +266,18 @@ If the project has goals defined in metaspecs, validate:
 - **Performance**: < 100ms
 
 ### Status
-- Coverage: ✅ 85% (target: 80%)
-- Complexity: ⚠️ 12 (target: 10) - Justified
-- Performance: ✅ 85ms (target: 100ms)
+- Coverage: ✅ 85% (goal: 80%)
+- Complexity: ⚠️ 12 (goal: 10) - Justified
+- Performance: ✅ 85ms (goal: 100ms)
 ```
 
 ## 🚨 Alerts
 
 If any metric is out of acceptable range:
-1. 🛑 **DOCUMENT** the problem
+1. 🛑 **DOCUMENT** the issue
 2. 💬 **ALERT** the user
 3. 🔧 **PROPOSE** corrective actions
-4. ⏸️ **CONSIDER** blocking the merge until resolved
+4. ⏸️ **CONSIDER** blocking the merge until resolution
 
 ---
 
@@ -252,11 +289,11 @@ If any metric is out of acceptable range:
 
 ---
 
-## 🎯 Result
+## 🎯 Outcome
 
 After running this command, you will have:
 - Complete metrics report
 - Comparison with baseline and goals
 - Identification of quality issues
-- Recommended actions
+- Recommendations for actions
 - Objective basis for merge approval

package/dist/templates/commands/en/quality/observe.md

@@ -10,11 +10,49 @@ Create a structured record of technical and product decisions, ensuring:
 - **Audit**: Complete history of choices for future review
 - **Learning**: Documentation of trade-offs and alternatives considered
 
-**IMPORTANT**: This command does NOT generate new decisions. It only RECORDS decisions that have already been made during the development process.
+**IMPORTANT**: This command DOES NOT generate new decisions. It only RECORDS decisions that have already been made during the development process.
+
+## 📋 Project Configuration
+
+**⚠️ IMPORTANT: Always read the project configuration files BEFORE running this command!**
+
+### Required 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.
+
 
 ## 📋 Prerequisites
 
-- You have run at least one of the commands that generate decisions:
+- Have executed at least one of the commands that generate decisions:
   - `/spec` - generates PRD with product decisions
   - `/plan` - generates plan.md with technical decisions
   - `/work` - implementation generates decisions during development
@@ -47,9 +85,9 @@ Analyze the session files (`./.sessions/<ISSUE-ID>/`) to identify decisions:
 - Read `./.sessions/<ISSUE-ID>/work.md`
 - Identify decisions in:
   - Refactorings performed
-  - Changes in approach
-  - Optimizations applied
-  - Handling of edge cases
+  - Approach changes
+  - Applied optimizations
+  - Edge case handling
 
 ### 2. Document Each Decision
 
@@ -145,7 +183,7 @@ For critical decisions, document the impact:
 
 Periodically review the decisions made:
 - Do they still make sense?
-- Were the trade-offs proven correct?
+- Have the trade-offs proven correct?
 - Are there learnings to document?
 - Does any decision need to be reversed?
 

package/dist/templates/commands/en/warm-up.md

@@ -1,34 +1,71 @@
 # Warm-up - Context Loading
 
-This command prepares the environment by loading the complete context of the project and current workspace.
+This command prepares the environment by loading the full context of the current project and workspace.
 
 ## 1. Identify Current Workspace
 
 Check if you are inside a workspace created by `context-cli`:
 
 ```bash
-# Check if you're in a workspace directory
+# Check if you are in a workspace directory
 pwd
-# The workspace is usually at ~/workspaces/<ISSUE-ID>/
+# The workspace is usually located at ~/workspaces/<ISSUE-ID>/
 ```
 
-If you're not in a workspace, ask the user which workspace to use or if you should create a new one with `feature:start`.
+If you are not in a workspace, ask the user which workspace to use or if a new one should be created with `feature:start`.
+
+## 📋 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 (`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.
 
 ## 2. Load Project Configuration
 
-You are already in the project's orchestrator (current repository root).
+You are already in the project orchestrator (root of the current repository).
 
-1. **Verify you're at the orchestrator root**: `pwd` should show the orchestrator directory
+1. **Verify you are at the orchestrator root**: `pwd` should show the orchestrator directory
 2. **Read the `context-manifest.json` file** at the orchestrator root
-3. **Read the `ai.properties.md` file** to get local configurations (base_path, etc.)
+3. **Read the `ai.properties.md` file** to obtain local configurations (base_path, etc.)
 
 ## 3. Load Project Manifest
 
 Read the `context-manifest.json` from the orchestrator to understand:
 - Complete list of ecosystem repositories
-- MetaSpecs repository URL
+- URL of the MetaSpecs repository
 - Dependencies between repositories
-- Role of each repository (application, library, service, specs-provider)
+- Roles of each repository (application, library, service, specs-provider)
 
 ## 4. Load MetaSpecs
 
@@ -37,32 +74,32 @@ The MetaSpecs repository is **separate** and defined in `context-manifest.json`
 **Locate the metaspecs repository:**
 
 1. Read `context-manifest.json` and find the repository with `role: "metaspecs"`
-2. Get the `id` of that repository (e.g., "my-project-metaspecs")
+2. Obtain the `id` of that repository (e.g., "my-project-metaspecs")
 3. Read `ai.properties.md` to get the `base_path`
-4. The metaspecs repository is at: `{base_path}/{metaspecs-id}/`
+4. The metaspecs repository is located at: `{base_path}/{metaspecs-id}/`
 
 **Always read the index files first:**
 
 1. **`README.md`** - Project overview and documentation structure
 2. **`index.md`** (in root or subfolders) - Index of available specifications
 
-**Use the indexes as reference** to navigate to the specific specifications you need. Don't assume specific files exist - always consult the indexes first.
+**Use the indexes as a reference** to navigate to the specific specifications you need. Do not assume specific files exist — always consult the indexes first.
 
-## 5. Load Current Session (if exists)
+## 5. Load Current Session (if any)
 
-Check if there's a saved session for this workspace:
+Check if there is a saved session for this workspace:
 
 ```bash
-# Look for session in orchestrator
+# Look for session in the orchestrator
 ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
 ```
 
-If it exists, read the session files to recover the context from the last execution.
+If it exists, read the session files to recover the context of the last execution.
 
 ## 6. Repository Context
 
 For each repository present in the workspace, read:
-- `README.md` - Repository purpose and overview
+- `README.md` - Purpose and overview of the repository
 - Main configuration file (`package.json`, `pom.xml`, `requirements.txt`, etc.)
 
 ## 7. Smart Navigation
@@ -71,7 +108,7 @@ For each repository present in the workspace, read:
 - **Documentation**: Use MetaSpecs indexes as reference
 - **Wait for Instructions**: DO NOT read other files now. Wait for the next command.
 
-## 8. Jidoka Principle (Stop When Detecting Problems)
+## 8. Jidoka Principle (Stop Upon Detecting Problems)
 
 If you detect misalignment, conflicts, or problems:
 1. 🛑 **STOP** immediately
@@ -82,4 +119,4 @@ If you detect misalignment, conflicts, or problems:
 
 **Provided arguments**: #$ARGUMENTS
 
-**Status**: Context loaded. Waiting for next command.
+**Status**: Context loaded. Awaiting next command.

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