context-first-cli 2.1.5 → 2.2.0

package/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/templates/commands/es/engineer/pr.md

@@ -2,40 +2,101 @@
 
 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:
-- Has ejecutado `/pre-pr` y todas las validaciones pasaron
+- Ejecutaste `/pre-pr` y todas las validaciones pasaron
 - Todos los commits fueron realizados
 - 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!**
+
+**✅ CORRECTO** - Trabajar dentro del worktree:
+```
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/README.md  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/CHANGELOG.md  ✅
+```
+
+**❌ INCORRECTO** - NUNCA crear código fuera del worktree:
+```
+<orchestrator>/.sessions/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+{base_path}/<repo-name>/file.ts  ❌ (¡repositorio principal!)
+```
+
+**REGLA ABSOLUTA**:
+- 🛑 **Cualquier ajuste de código** (docs, changelog, fixes) **DEBE estar en** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA modifiques** el repositorio principal en `{base_path}/<repo-name>/`
+- ✅ **Trabaja SÓLO** dentro del worktree del repositorio específico
+
 ## 🎯 Proceso de Creación de PRs
 
 ### 1. Identificar Repositorios Modificados
 
 Para cada repositorio en el workspace, verifica:
 ```bash
-cd <repositório>
+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
 
 Para cada repositorio modificado:
 ```bash
-cd <repositório>
+cd <repositorio>
 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
-cd <repositório>
+cd <repositorio>
 gh pr create --title "[ISSUE-ID] Título de la Feature" \
   --body "$(cat ../.sessions/<ISSUE-ID>/pr-description.md)" \
   --base main
@@ -50,7 +111,7 @@ gh pr create --title "[ISSUE-ID] Título de la Feature" \
 
 ## 📝 Cambios
 
-### Repositorio: <nome-do-repo>
+### Repositorio: <nombre-del-repo>
 
 - [Cambio 1]
 - [Cambio 2]
@@ -72,7 +133,7 @@ gh pr create --title "[ISSUE-ID] Título de la Feature" \
 - [ ] Sin breaking changes (o documentados)
 - [ ] Revisado por pares (después de crear el PR)
 
-## 🧪 Cómo Testear
+## 🧪 Cómo Probar
 
 1. [Paso 1]
 2. [Paso 2]
@@ -163,5 +224,5 @@ Notifica al equipo sobre los PRs:
 
 1. Esperar revisión de los PRs
 2. Responder comentarios y hacer ajustes
-3. Tras la aprobación, hacer merge en el orden recomendado
+3. Tras aprobación, hacer merge en el orden recomendado
 4. Ejecutar `context-cli feature:end <ISSUE-ID>` para limpiar el workspace

package/templates/commands/es/engineer/pre-pr.md

@@ -2,16 +2,77 @@
 
 Este comando valida que todo está listo para crear Pull Requests.
 
-## 📋 Requisitos previos
+## 📋 Requisitos Previos
 
 - Implementación completa (todas las tareas del `/plan` ejecutadas)
 - Todos los commits realizados
 - Workspace limpio y organizado
 
+## 📋 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!
+
+
 ## 🎯 Objetivo
 
 Garantizar que la implementación está completa, probada y lista para revisión antes de crear los PRs.
 
+## 🛑 CRÍTICO: DÓNDE TRABAJAR
+
+**⚠️ ATENCIÓN: TODO CÓDIGO (tests, fixes, ajustes) DEBE SER CREADO DENTRO DEL WORKTREE!**
+
+**✅ CORRECTO** - Trabajar dentro del worktree:
+```
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/tests/test.ts  ✅
+<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/.eslintrc.js  ✅
+```
+
+**❌ INCORRECTO** - NUNCA crear código fuera del worktree:
+```
+<orchestrator>/.sessions/test.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/test.ts  ❌
+{base_path}/<repo-name>/test.ts  ❌ (¡repositorio principal!)
+```
+
+**REGLA ABSOLUTA**:
+- 🛑 **TODO código** (tests, fixes, configuraciones) **DEBE estar en** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA modifique** el repositorio principal en `{base_path}/<repo-name>/`
+- ✅ **Trabaje SOLO** dentro del worktree del repositorio específico
+
 ## ✅ Checklist de Validación
 
 ### 1. Completitud de la Implementación
@@ -22,7 +83,7 @@ Garantizar que la implementación está completa, probada y lista para revisión
 - [ ] Todas las tareas del plan fueron ejecutadas
 - [ ] Todos los requisitos funcionales del PRD fueron implementados
 - [ ] Todos los criterios de aceptación fueron cumplidos
-- [ ] Ninguna funcionalidad quedó a medias
+- [ ] Ninguna funcionalidad quedó incompleta
 ```
 
 ### 2. Calidad del Código
@@ -79,14 +140,14 @@ Checklist:
 - [ ] Sin warnings críticos
 ```
 
-### 3. Pruebas
+### 3. Tests
 
 Para cada repositorio:
 
 ```bash
 cd <repositorio>
 
-# Ejecutar pruebas unitarias (ejemplos por stack):
+# Ejecutar tests unitarios (ejemplos por stack):
 # Node.js: npm run test:unit / jest / vitest
 # Python: pytest tests/unit / python -m unittest
 # Java: mvn test / gradle test
@@ -96,7 +157,7 @@ cd <repositorio>
 # PHP: ./vendor/bin/phpunit --testsuite=unit
 # C#: dotnet test --filter Category=Unit
 
-# Ejecutar pruebas de integración (ejemplos por stack):
+# Ejecutar tests de integración (ejemplos por stack):
 # Node.js: npm run test:integration
 # Python: pytest tests/integration
 # Java: mvn verify / gradle integrationTest
@@ -117,19 +178,19 @@ cd <repositorio>
 
 Checklist:
 ```markdown
-## Pruebas
+## Tests
 
 ### <repo-1>
-- [ ] Todas las pruebas unitarias pasando
-- [ ] Todas las pruebas de integración pasando
-- [ ] Cobertura de pruebas adecuada (>= X%)
-- [ ] Nuevas pruebas añadidas para nuevas funcionalidades
+- [ ] Todos los tests unitarios pasan
+- [ ] Todos los tests de integración pasan
+- [ ] Cobertura de tests adecuada (>= X%)
+- [ ] Nuevos tests añadidos para nuevas funcionalidades
 
 ### <repo-2>
-- [ ] Todas las pruebas unitarias pasando
-- [ ] Todas las pruebas de integración pasando
-- [ ] Cobertura de pruebas adecuada (>= X%)
-- [ ] Nuevas pruebas añadidas para nuevas funcionalidades
+- [ ] Todos los tests unitarios pasan
+- [ ] Todos los tests de integración pasan
+- [ ] Cobertura de tests adecuada (>= X%)
+- [ ] Nuevos tests añadidos para nuevas funcionalidades
 ```
 
 ### 4. Documentación
@@ -139,7 +200,7 @@ Checklist:
 
 - [ ] README actualizado (si es necesario)
 - [ ] Comentarios de código adecuados
-- [ ] Documentación de APIs actualizada (si hay cambios)
+- [ ] Documentación de APIs actualizada (si hubo cambios)
 - [ ] Changelog actualizado
 - [ ] Documentación técnica actualizada en las metaspecs (si aplica)
 ```
@@ -161,7 +222,7 @@ Checklist:
 ```markdown
 ## Sincronización
 
-- [ ] Las branches están actualizadas con la branch base (main/develop)
+- [ ] Las ramas están actualizadas con la rama base (main/develop)
 - [ ] No hay conflictos de merge
 - [ ] Cambios entre repositorios están sincronizados
 - [ ] Dependencias entre repos fueron probadas
@@ -172,10 +233,10 @@ Checklist:
 ```markdown
 ## Seguridad
 
-- [ ] No hay credenciales ni secrets en el código
+- [ ] No hay credenciales o secretos en el código
 - [ ] No hay datos sensibles en logs
 - [ ] Dependencias de seguridad fueron verificadas
-- [ ] No hay vulnerabilidades conocidas introducidas
+- [ ] No se introdujeron vulnerabilidades conocidas
 ```
 
 ### 8. Performance
@@ -185,7 +246,7 @@ Checklist:
 
 - [ ] No hay regresiones de performance evidentes
 - [ ] Queries/operaciones costosas fueron optimizadas
-- [ ] No hay memory leaks introducidos
+- [ ] No se introdujeron memory leaks
 - [ ] Requisitos de performance del PRD fueron cumplidos
 ```
 
@@ -215,20 +276,20 @@ Cree `./.sessions/<ISSUE-ID>/pr-description.md`:
 - [Cambio 2]
 - [Cambio 3]
 
-## 🔗 Enlaces
+## 🔗 Links
 - **Issue**: [ISSUE-ID]
 - **PRD**: [link o ruta]
 - **Plan Técnico**: [link o ruta]
 
 ## ✅ Checklist
 - [x] Código implementado y probado
-- [x] Pruebas unitarias añadidas/actualizadas
-- [x] Pruebas de integración pasando
+- [x] Tests unitarios añadidos/actualizados
+- [x] Tests de integración pasando
 - [x] Documentación actualizada
 - [x] Linting y formateo OK
 - [x] Build sin errores
 
-## 🧪 Cómo Testear
+## 🧪 Cómo Probar
 1. [Paso 1]
 2. [Paso 2]
 3. [Resultado esperado]
@@ -246,12 +307,12 @@ Si alguna validación falla:
 3. 🔧 **CORRIJA** el problema
 4. 🔄 **EJECUTE** `/pre-pr` nuevamente
 
-## 📊 Informe de Validación
+## 📊 Reporte de Validación
 
 Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
 
 ```markdown
-# Informe de Validación Pre-PR
+# Reporte de Validación Pre-PR
 
 **Fecha**: [fecha/hora]
 **Issue**: [ISSUE-ID]
@@ -263,12 +324,12 @@ Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
 - **<repo-1>**: ✅ OK
 - **<repo-2>**: ✅ OK
 
-## Resumen de Pruebas
-- **Pruebas Unitarias**: X/X pasando
-- **Pruebas de Integración**: Y/Y pasando
+## Resumen de Tests
+- **Tests Unitarios**: X/X pasando
+- **Tests de Integración**: Y/Y pasando
 - **Cobertura**: Z%
 
-## Pendientes (si las hay)
+## Pendientes (si hay)
 - [Pendiente 1]
 - [Pendiente 2]
 

package/templates/commands/es/engineer/start.md

@@ -26,6 +26,43 @@ Este comando inicia el desarrollo de una funcionalidad en el workspace actual.
 - ❌ NUNCA haga checkout en los repositorios principales
 - ❌ NUNCA modifique código en este comando (use `/work` después)
 
+## 📋 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.
+
 ## 📚 Cargar MetaSpecs
 
 **Localizar MetaSpecs automáticamente**:
@@ -43,7 +80,7 @@ Este comando inicia el desarrollo de una funcionalidad en el workspace actual.
 
 Antes de iniciar, cargue el contexto consultando:
 - `context-manifest.json` - Estructura de repositorios
-- MetaSpecs (localizado arriba) - Arquitectura y patrones
+- MetaSpecs (ubicado arriba) - Arquitectura y patrones
 - `directorio del workspace` - Información del workspace actual
 
 ## ⚙️ Configuración Inicial
@@ -57,10 +94,10 @@ Antes de iniciar, cargue el contexto consultando:
    - Confirme que todas las branches están sincronizadas
 
 3. **Cargar Especificación**:
-   - **Si task manager configurado**: Lea la issue usando el MCP apropiado
+   - **Si el task manager está configurado**: Lea la issue usando el MCP apropiado
    - **Si no**: Pida al usuario el archivo de especificación o descripción de la feature
 
-4. **Actualizar Estado** (si task manager configurado):
+4. **Actualizar Estado** (si el task manager está configurado):
    - Mueva la issue a "En Progreso"
 
 ## 📋 Análisis y Entendimiento
@@ -86,7 +123,7 @@ Analice la especificación y construya un entendimiento completo respondiendo:
 ### Validación contra MetaSpecs
 
 Si metaspecs están disponibles, validar:
-- ¿Está alineado con la estrategia y roadmap?
+- ¿Está alineado con estrategia y roadmap?
 - ¿Usa stack tecnológica aprobada?
 - ¿Respeta Architecture Decision Records?
 - ¿Sigue reglas de negocio documentadas?
@@ -134,11 +171,11 @@ Cree el archivo `./.sessions/<ISSUE-ID>/context.md` con:
 ## Restricciones
 [Limitaciones técnicas, objetivos de performance, presupuesto]
 
-## Tests
-[E2E críticos, unit tests necesarios, cobertura esperada]
+## Pruebas
+[E2E críticos, pruebas unitarias necesarias, cobertura esperada]
 ```
 
-**Después de crear `context.md`, pida revisión y aprobación al usuario antes de continuar.**
+**Después de crear `context.md`, solicite revisión y aprobación del usuario antes de continuar.**
 
 ---
 
@@ -160,9 +197,9 @@ Cree el archivo `./.sessions/<ISSUE-ID>/context.md` con:
    - Lea patrones de código en metaspecs
    - Identifique patrones existentes en el código (use Glob/Grep para encontrar ejemplos similares)
 
-3. **Validar compliance con ADRs**:
+3. **Validar cumplimiento con ADRs**:
    - Para cada ADR relevante, verifique si la solución propuesta respeta las decisiones
-   - Documente compliance en architecture.md
+   - Documente el cumplimiento en architecture.md
    - Si hay violación, justifique o proponga corrección
 
 4. **Analizar código existente**:
@@ -204,16 +241,16 @@ repo-1/
 ```
 
 ## Patrones y Mejores Prácticas
-[Patrones que se mantendrán o introducirán]
+[Patrones que serán mantenidos o introducidos]
 
 ## Validación de ADRs
-[Lista de ADRs consultados y compliance]
+[Lista de ADRs consultados y cumplimiento]
 
-- [x] ADR-001: [Nombre] - Compliant
-- [x] ADR-002: [Nombre] - Compliant
+- [x] ADR-001: [Nombre] - Cumple
+- [x] ADR-002: [Nombre] - Cumple
 
 ## Dependencias Externas
-[Bibliotecas que se usarán o añadirán]
+[Bibliotecas que serán usadas o añadidas]
 
 ## Decisiones Técnicas
 
@@ -248,7 +285,7 @@ repo-1/
 - `repo-2/src/controllers/NewController.ts` (CREAR)
 ```
 
-**Después de crear `architecture.md`, pida revisión y aprobación al usuario antes de continuar.**
+**Después de crear `architecture.md`, solicite revisión y aprobación del usuario antes de continuar.**
 
 ---