context-first-cli 2.2.0 → 2.2.1

package/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/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/templates/commands/es/products/refine.md

@@ -1,6 +1,6 @@
 # Refinamiento de Requisitos
 
-Eres un especialista en producto encargado de ayudar a refinar requisitos para el proyecto.
+Usted es un especialista en producto encargado de ayudar a refinar requisitos para el proyecto.
 
 ## ⚠️ IMPORTANTE: Este Comando NO Implementa Código
 
@@ -8,7 +8,7 @@ Eres un especialista en producto encargado de ayudar a refinar requisitos para e
 - ✅ Validar requisitos contra metaspecs
 - ✅ Crear especificación refinada
 - ✅ Guardar documentación en `.sessions/`
-- ✅ Actualizar issue en el task manager
+- ✅ Actualizar issue en el gestor de tareas
 - ❌ **NO implementar código**
 - ❌ **NO hacer ediciones en archivos de código**
 - ❌ **NO ejecutar pruebas o deploy**
@@ -17,76 +17,114 @@ Eres un especialista en producto encargado de ayudar a refinar requisitos para e
 
 ---
 
+## 📋 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, usted 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.
+
+
 ## Objetivo
 
-Transformar un requisito inicial en especificación refinada y validada, lista para convertirse en PRD completo.
+Transformar un requisito inicial en especificación refinada y validada, lista para convertirse en un PRD completo.
 
 ## Proceso
 
 ### 1. Fase de Aclaración
 
-Lee el requisito inicial y haz preguntas para alcanzar claridad total sobre:
+Lea el requisito inicial y haga preguntas para alcanzar claridad total sobre:
 - **Objetivo**: ¿Por qué construir esto?
 - **Valor de Negocio**: ¿Qué métrica/persona impacta?
 - **Alcance**: ¿Qué incluye y qué NO incluye?
-- **Interacciones**: ¿Qué features/componentes existentes se ven afectados?
+- **Interacciones**: ¿Qué funcionalidades/componentes existentes se ven afectados?
 
-Continúa haciendo preguntas hasta tener entendimiento completo.
+Continúe haciendo preguntas hasta tener entendimiento completo.
 
 ### 2. Validación Contra Metaspecs
 
-**IMPORTANTE**: Primero lee `ai.properties.md` para obtener el `base_path`. Los índices YA deben estar en contexto (corriste `/warm-up`). Consulta los índices y lee SÓLO los documentos relevantes para validar el requisito.
+**IMPORTANTE**: Primero lea `ai.properties.md` para obtener el `base_path`. Los índices YA deben estar en contexto (usted ejecutó `/warm-up`). Consulte los índices y lea SÓLO los documentos relevantes para validar el requisito.
 
 **Proceso de Validación**:
 
-1. **Consulta los índices cargados** por `/warm-up`:
-   - Lee `context-manifest.json` para encontrar el repositorio con `role: "metaspecs"`
-   - Obtén el `id` de ese repositorio (ej: "my-project-metaspecs")
-   - Lee `ai.properties.md` para obtener el `base_path`
+1. **Consulte los índices cargados** por `/warm-up`:
+   - Lea `context-manifest.json` para encontrar el repositorio con `role: "metaspecs"`
+   - Obtenga el `id` de ese repositorio (ej: "my-project-metaspecs")
+   - Lea `ai.properties.md` para obtener el `base_path`
    - El repositorio de metaspecs está en: `{base_path}/{metaspecs-id}/`
-   - Consulta `{base_path}/{metaspecs-id}/index.md` - Visión general del proyecto
-   - Consulta índices específicos (ej: `specs/business/index.md`, `specs/technical/index.md`)
+   - Consulte `{base_path}/{metaspecs-id}/index.md` - Visión general del proyecto
+   - Consulte índices específicos (ej: `specs/business/index.md`, `specs/technical/index.md`)
 
-2. **Identifica documentos relevantes** para este requisito específico:
+2. **Identifique documentos relevantes** para este requisito específico:
    - En `specs/business/`: ¿Qué documentos de negocio son relevantes?
    - En `specs/technical/`: ¿Qué documentos técnicos son relevantes?
 
-3. **Lee SÓLO los documentos relevantes** identificados (¡no leas todo!)
+3. **Lea SÓLO los documentos relevantes** identificados (¡no lea todo!)
 
-4. **Valida el requisito** contra las metaspecs leídas:
+4. **Valide el requisito** contra las metaspecs leídas:
    - ✅ Alineación con estrategia y visión de producto
    - ✅ Atiende necesidades de las personas correctas
    - ✅ Compatible con stack tecnológico aprobado
-   - ✅ Respeta decisiones arquitecturales (ADRs)
+   - ✅ Respeta decisiones arquitectónicas (ADRs)
    - ✅ Sigue reglas de negocio existentes
-   - ⚠️ Identifica conflictos o violaciones
+   - ⚠️ Identifique conflictos o violaciones
 
-**Si identificas violaciones**: 🛑 **DETENTE** y pide aclaración al usuario antes de continuar (Principio Jidoka).
+**Si identifica violaciones**: 🛑 **PARE** y pida aclaración al usuario antes de continuar (Principio Jidoka).
 
 ### 3. Fase de Resumen y Aprobación
 
-Una vez que hayas recopilado información suficiente y validado contra metaspecs, presenta un resumen estructurado con:
+Una vez que haya recopilado información suficiente y validado contra metaspecs, presente un resumen estructurado con:
 - **Feature**: Nombre de la funcionalidad
 - **Objetivo**: Por qué construir (1-2 frases)
-- **Valor de Negocio**: Métrica, persona, fase del roadmap (consulta metaspecs)
+- **Valor de Negocio**: Métrica, persona, fase del roadmap (consulte metaspecs)
 - **Alcance**: Qué INCLUYE y qué NO INCLUYE
-- **Componentes Afectados**: Lista basada en la arquitectura actual (consulta metaspecs técnicas)
+- **Componentes Afectados**: Lista basada en la arquitectura actual (consulte metaspecs técnicas)
 - **Validación contra Metaspecs**: ✅ Aprobado / ⚠️ Atención necesaria
 - **Estimación de Esfuerzo**: Pequeño (< 1 día) / Medio (1-3 días) / Grande (3-5 días) / Muy Grande (> 5 días)
 
 **Evaluación de Complejidad y Sugerencia de División**:
 
 **Si la implementación parece grande** (> 5 días de esfuerzo estimado):
-- 🚨 **Sugiere dividir en múltiples issues menores**
-- Explica el racional de la división (ej: "Esta feature involucra 3 áreas distintas que pueden implementarse independientemente")
-- Propón una división **lógica** basada en:
+- 🚨 **Sugiera dividir en múltiples issues más pequeñas**
+- Explique el razonamiento de la división (ej: "Esta feature involucra 3 áreas distintas que pueden implementarse independientemente")
+- Proponga una división **lógica** basada en:
   - Funcionalidades independientes
   - Repositorios diferentes
   - Capas de la aplicación (backend, frontend, infra)
   - Fases de implementación (MVP, mejoras, optimizaciones)
 - Ejemplo de división:
   ```
-  Issue Original: "Sistema de notificaciones multi-canal"
+  Issue Original: "Sistema de notificaciones multicanal"
   
   División Sugerida:
   - FIN-201: Infraestructura de colas y workers (backend)
@@ -97,59 +135,59 @@ Una vez que hayas recopilado información suficiente y validado contra metaspecs
 - **Importante**: La decisión final es del usuario - puede aceptar la división o mantener como issue única
 
 **Si el usuario acepta la división**:
-- Documenta cada issue por separado
-- Añade referencias cruzadas entre las issues relacionadas
-- Sugiere orden de implementación si hay dependencias
+- Documente cada issue por separado
+- Añada referencias cruzadas entre las issues relacionadas
+- Sugiera orden de implementación si hay dependencias
 - Cada issue dividida debe pasar por el mismo proceso de refinamiento
 
-Pide aprobación del usuario e incorpora feedback si es necesario.
+Solicite aprobación del usuario e incorpore feedback si es necesario.
 
-**Consejo**: Puedes buscar en el código base o internet antes de finalizar, si es necesario.
+**Consejo**: Puede investigar en el código base o internet antes de finalizar, si es necesario.
 
 ### 4. Guardado de los Requisitos Refinados
 
-Una vez que el usuario apruebe, guarda los requisitos:
+Una vez que el usuario apruebe, guarde los requisitos:
 
-**IMPORTANTE**: Siempre crea backup local Y actualiza el task manager (si está configurado).
+**IMPORTANTE**: Siempre cree backup local Y actualice el gestor de tareas (si está configurado).
 
 **Proceso de Guardado**:
 
 1. **SIEMPRE crear backup local primero**:
-   - Crea archivo completo en `./.sessions/<ISSUE-ID>/refined.md` (ej: `./.sessions/FIN-5/refined.md`)
+   - Cree archivo completo en `./.sessions/<ISSUE-ID>/refined.md` (ej: `./.sessions/FIN-5/refined.md`)
    - Donde `<ISSUE-ID>` es el ID de la issue (ej: FIN-5, FIN-123)
-   - Incluye TODOS los detalles del refinamiento (backup completo)
-
-2. **Si el task manager está configurado** (lee `ai.properties.md` para identificar `task_management_system`):
-   - Identifica la herramienta MCP del task manager
-   - **Actualiza el BODY (description) de la issue** con versión CONCISA de los requisitos refinados
-     - Para Jira: Usa MCP de Jira con campo `description`
-     - Para Linear: Usa MCP de Linear con campo `description`
-     - Para GitHub: Usa MCP de GitHub con campo `body`
-     - Para Azure Boards: Usa MCP de Azure Boards con campo `description`
-     - Incluye todo el contenido refinado en el campo description/body de la issue
-     - Si el contenido es muy extenso y hay error de API, considera crear versión resumida
-   - **SIEMPRE sobrescribe** el body existente (no agregar al final)
+   - Incluya TODOS los detalles del refinamiento (backup completo)
+
+2. **Si el gestor de tareas está configurado** (lea `ai.properties.md` para identificar `task_management_system`):
+   - Identifique la herramienta MCP del gestor de tareas
+   - **Actualice el BODY (descripción) de la issue** con versión CONCISA de los requisitos refinados
+     - Para Jira: Use MCP de Jira con campo `description`
+     - Para Linear: Use MCP de Linear con campo `description`
+     - Para GitHub: Use MCP de GitHub con campo `body`
+     - Para Azure Boards: Use MCP de Azure Boards con campo `description`
+     - Incluya todo el contenido refinado en el campo description/body de la issue
+     - Si el contenido es muy extenso y hay error de API, considere crear versión resumida
+   - **SIEMPRE sobrescriba** el body existente (no añadir al final)
 
 **Observación**:
 - El backup local SIEMPRE está guardado y completo
-- Si hay error de API, verifica manualmente si la issue fue actualizada en el task manager
+- Si hay error de API, verifique manualmente si la issue fue actualizada en el gestor de tareas
 
-**Template de Salida**:
+**Plantilla de Salida**:
 
-**IMPORTANTE**: El template estándar para requisitos refinados puede estar documentado en el repositorio de metaspecs. Consulta `{base_path}/{metaspecs-id}/specs/refined/` o similar.
+**IMPORTANTE**: La plantilla estándar para requisitos refinados puede estar documentada en el repositorio de metaspecs. Consulte `{base_path}/{metaspecs-id}/specs/refined/` o similar.
 
-**Template COMPLETO** (para backup local `.sessions/<ISSUE-ID>/refined.md`):
+**Plantilla COMPLETA** (para backup local `.sessions/<ISSUE-ID>/refined.md`):
 - **Metadatos**: Issue, ID, Task Manager, Proyecto, Fecha, Sprint, Prioridad
 - **🎯 POR QUÉ**: Razones, valor de negocio, métrica, persona, alineamiento estratégico
 - **📦 QUÉ**: Funcionalidades detalladas, componentes afectados, integraciones, alcance negativo completo
-- **🔧 CÓMO**: Stack, patrones de código, estructura de archivos, dependencias, orden de implementación, failure modes, consideraciones de performance/costo/UX
+- **🔧 CÓMO**: Stack, patrones de código, estructura de archivos, dependencias, orden de implementación, modos de fallo, consideraciones de performance/costo/UX
 - **✅ Validación contra Metaspecs**: Documentos consultados (business y technical), ADRs verificados, resultado de la validación
 - **📊 Métricas de Éxito**: Técnicas, producto/UX, criterios de aceptación
 - **🔄 Impacto en el Producto**: Alineamiento con objetivos, habilitadores, riesgos mitigados
 - **⚠️ Limitaciones Conocidas**: Limitaciones del MVP
-- **📝 Checklist de Implementación**: Tareas por área (backend, frontend, tests, seguridad, etc.)
+- **📝 Checklist de Implementación**: Tareas por área (backend, frontend, pruebas, seguridad, etc.)
 
-**Template para Task Manager**:
+**Plantilla para Gestor de Tareas**:
 ```markdown
 # [Nombre Feature] - Requisitos Refinados
 
@@ -160,7 +198,7 @@ Una vez que el usuario apruebe, guarda los requisitos:
 
 ## Alcance
 
-### Funcionalidades Principales
+### Principales Funcionalidades
 - Funcionalidad 1: [resumen]
 - Funcionalidad 2: [resumen]
 - Validaciones/Guards: [resumen]
@@ -170,10 +208,10 @@ Una vez que el usuario apruebe, guarda los requisitos:
 - Componente 2: [tipo de cambio]
 
 ### Seguridad
-✅ [ítem 1] ✅ [ítem 2] ✅ [ítem 3]
+✅ [item 1] ✅ [item 2] ✅ [item 3]
 
 ## Alcance Negativo
-❌ [ítem 1] ❌ [ítem 2] ❌ [ítem 3]
+❌ [item 1] ❌ [item 2] ❌ [item 3]
 
 ## Stack
 [Tech stack resumida por área]
@@ -181,14 +219,14 @@ Una vez que el usuario apruebe, guarda los requisitos:
 ## Estructura
 [Árbol de archivos RESUMIDO - módulos principales solamente]
 
-## Failure Modes (Evitar)
+## Modos de Fallo (Evitar)
 🔴 [crítico 1] 🔴 [crítico 2]
 🟡 [medio 1] 🟡 [medio 2]
 
 ## Criterios de Aceptación
-- [ ] [ítem 1]
-- [ ] [ítem 2]
-- [ ] [ítem 3]
+- [ ] [item 1]
+- [ ] [item 2]
+- [ ] [item 3]
 
 ## Validación
 **ADRs**: [lista]
@@ -202,7 +240,7 @@ Una vez que el usuario apruebe, guarda los requisitos:
 📄 **Documento completo**: `.sessions/<ISSUE-ID>/refined.md`
 ```
 
-**Audiencia**: Desarrollador IA con capacidades similares a las tuyas. Sé conciso pero completo.
+**Audiencia**: Desarrollador IA con capacidades similares a las suyas. Sea conciso pero completo.
 
 ---
 
@@ -216,7 +254,7 @@ Una vez que el usuario apruebe, guarda los requisitos:
 
 ## 🎯 Próximo Paso
 
-**Tras la aprobación del usuario y guardado de los requisitos refinados**, el flujo natural es:
+**Tras la aprobación del usuario y el guardado de los requisitos refinados**, el flujo natural es:
 
 ```bash
 /spec [ISSUE-ID]