context-first-cli 2.1.4 → 2.1.6

package/templates/commands/en/engineer/work.md

@@ -36,16 +36,40 @@ Before executing, make sure that:
 - ❌ NEVER checkout branches in the main repositories
 - ❌ NEVER navigate to `{base_path}/{repo-id}/`
 
+## 🛑 CRITICAL: WHERE TO CREATE CODE
+
+**⚠️ ATTENTION: ALL CODE MUST BE CREATED INSIDE THE REPOSITORY WORKTREE!**
+
+**✅ CORRECT** - Create code inside the 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>/package.json  ✅
+```
+
+**❌ WRONG** - NEVER create code directly in .sessions:
+```
+<orchestrator>/.sessions/src/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/src/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+```
+
+**ABSOLUTE RULE**:
+- 🛑 **EVERY code file** (`.ts`, `.js`, `.py`, `.java`, etc.) **MUST be inside** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NEVER create code** directly in `<orchestrator>/.sessions/` or `<orchestrator>/.sessions/<ISSUE-ID>/`
+- ✅ **Only valid place**: Inside the specific repository worktree
+
 ## ⚠️ IMPORTANT: Immutable Files
 
 **This command must READ but NOT MODIFY:**
 - ✅ **READ** `.sessions/<ISSUE-ID>/context.md` (immutable)
 - ✅ **READ** `.sessions/<ISSUE-ID>/architecture.md` (immutable)
 - ✅ **UPDATE** `.sessions/<ISSUE-ID>/plan.md` (mark progress)
-- ✅ **IMPLEMENT** code in the workspace repositories
-- ✅ **MAKE COMMITS** in the workspace repositories
+- ✅ **IMPLEMENT** code **INSIDE THE WORKTREE**: `.sessions/<ISSUE-ID>/<repo-name>/`
+- ✅ **MAKE COMMITS** in the worktrees: `.sessions/<ISSUE-ID>/<repo-name>/`
 - ❌ **DO NOT modify `context.md` or `architecture.md`**
-- ❌ **DO NOT checkout branches in the main repositories (outside workspace)**
+- ❌ **DO NOT checkout branches in the main repositories (outside the workspace)**
+- 🛑 **NEVER create code directly in `.sessions/` or `.sessions/<ISSUE-ID>/`**
 
 ## 📚 Load MetaSpecs
 
@@ -53,8 +77,8 @@ Before executing, make sure that:
 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}/`
-5. Read the relevant `index.md` files during implementation to:
+4. The metaspecs are at: `{base_path}/{metaspecs-repo-id}/`
+5. Read relevant `index.md` files during implementation to:
    - Follow coding standards
    - Respect defined architecture
    - Use correct conventions
@@ -71,7 +95,7 @@ Implement a specific unit of work from the plan, which may involve:
 
 **⚠️ IMPORTANT: PROGRESS CONTROL**
 
-This command executes work in **incremental phases**. After completing each **MAIN PHASE** (e.g., Phase 1 → Phase 2):
+This command executes the work in **incremental phases**. After completing each **MAIN PHASE** (e.g., Phase 1 → Phase 2):
 
 1. 🛑 **STOP** execution
 2. 📊 **PRESENT** a summary of what was done
@@ -84,7 +108,7 @@ This command executes work in **incremental phases**. After completing each **MA
 - ✅ **PAUSE** between main phases (Phase 1 → Phase 2 → Phase 3)
 - ❌ **DO NOT pause** between subphases (Phase 1.1 → Phase 1.2 → Phase 1.3)
 
-**DO NOT implement everything at once**. Work main phase by main phase, waiting for developer confirmation.
+**DO NOT implement everything at once**. Work main phase by main phase, awaiting developer confirmation.
 
 ---
 
@@ -92,7 +116,7 @@ This command executes work in **incremental phases**. After completing each **MA
 
 Based on the technical plan (`./.sessions/<ISSUE-ID>/plan.md`), identify:
 - Which specific task will be implemented now
-- In which workspace repository(ies)
+- In which repository(ies) of the workspace
 - Which files will be created/modified
 - Dependencies with other tasks
 
@@ -100,7 +124,7 @@ Based on the technical plan (`./.sessions/<ISSUE-ID>/plan.md`), identify:
 
 
 
-**IMPORTANT**: Work ONLY inside the workspace at `.sessions/<ISSUE-ID>/`
+**IMPORTANT**: Work ONLY inside the workspace in `.sessions/<ISSUE-ID>/`
 
 For each repository in the workspace:
 
@@ -133,7 +157,7 @@ Before committing:
 
 ### 4. Commit
 
-For each modified repository **inside the workspace**:
+For each repository modified **inside the workspace**:
 
 ```bash
 # Navigate to the worktree inside the workspace

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

@@ -5,18 +5,41 @@ Este comando crea Pull Requests para todos los repositorios modificados en el wo
 ## 📋 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
 
+## 🛑 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
 ```
@@ -25,7 +48,7 @@ git log origin/main..HEAD  # Ver commits no pushados
 
 Para cada repositorio modificado:
 ```bash
-cd <repositório>
+cd <repositorio>
 git push origin <branch-name>
 ```
 
@@ -35,7 +58,7 @@ Para cada repositorio, crea un PR usando el GitHub CLI o la 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 +73,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]
@@ -70,17 +93,17 @@ 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 (después de crear el PR)
+- [ ] Revisado por pares (tras creación del PR)
 
-## 🧪 Cómo Testear
+## 🧪 Cómo Probar
 
 1. [Paso 1]
 2. [Paso 2]
 3. [Resultado esperado]
 
-## 📸 Screenshots/Demos
+## 📸 Capturas/Demos
 
-[Si aplica, añade capturas de pantalla o enlaces a demos]
+[Si aplica, añade capturas o enlaces a demos]
 
 ## 🔍 Notas para Revisores
 
@@ -112,12 +135,12 @@ Actualiza `./.sessions/<ISSUE-ID>/pr.md`:
 ## PRs Creados
 
 ### <repo-1>
-- **Link**: <URL del PR>
+- **Enlace**: <URL del PR>
 - **Estado**: Abierto
 - **Commits**: X commits
 
 ### <repo-2>
-- **Link**: <URL del PR>
+- **Enlace**: <URL del PR>
 - **Estado**: Abierto
 - **Commits**: Y commits
 
@@ -163,5 +186,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

@@ -12,6 +12,29 @@ Este comando valida que todo está listo para crear Pull Requests.
 
 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 modifiques** el repositorio principal en `{base_path}/<repo-name>/`
+- ✅ **Trabaja SOLO** dentro del worktree del repositorio específico
+
 ## ✅ Checklist de Validación
 
 ### 1. Completitud de la Implementación
@@ -79,14 +102,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 +119,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 +140,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
@@ -141,7 +164,7 @@ Checklist:
 - [ ] Comentarios de código adecuados
 - [ ] Documentación de APIs actualizada (si hay cambios)
 - [ ] Changelog actualizado
-- [ ] Documentación técnica actualizada en las metaspecs (si aplica)
+- [ ] Documentación técnica actualizada en metaspecs (si aplica)
 ```
 
 ### 5. Commits
@@ -150,9 +173,9 @@ Checklist:
 ## Commits
 
 - [ ] Todos los commits tienen mensajes claros y descriptivos
-- [ ] Los commits siguen el estándar del proyecto (conventional commits, etc.)
+- [ ] Commits siguen el estándar del proyecto (conventional commits, etc.)
 - [ ] No hay commits con mensajes genéricos ("fix", "update", etc.)
-- [ ] Los commits están organizados lógicamente
+- [ ] Commits están organizados lógicamente
 - [ ] No hay commits de debug o temporales
 ```
 
@@ -161,7 +184,7 @@ Checklist:
 ```markdown
 ## Sincronización
 
-- [ ] Las branches están actualizadas con la branch base (main/develop)
+- [ ] Branches están actualizadas con la branch base (main/develop)
 - [ ] No hay conflictos de merge
 - [ ] Cambios entre repositorios están sincronizados
 - [ ] Dependencias entre repos fueron probadas
@@ -172,7 +195,7 @@ 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
@@ -183,7 +206,7 @@ Checklist:
 ```markdown
 ## Performance
 
-- [ ] No hay regresiones de performance evidentes
+- [ ] No hay regresiones de performance obvias
 - [ ] Queries/operaciones costosas fueron optimizadas
 - [ ] No hay memory leaks introducidos
 - [ ] Requisitos de performance del PRD fueron cumplidos
@@ -191,7 +214,7 @@ Checklist:
 
 ## 🔍 Validación Cruzada
 
-Si se modificaron múltiples repositorios:
+Si múltiples repositorios fueron modificados:
 
 ```markdown
 ## Validación Cruzada
@@ -199,12 +222,12 @@ Si se modificaron múltiples repositorios:
 - [ ] Probé la integración entre los repositorios localmente
 - [ ] APIs/contratos entre repos están consistentes
 - [ ] No hay breaking changes no documentados
-- [ ] El orden de deploy/merge está claro
+- [ ] Orden de deploy/merge está claro
 ```
 
 ## 📄 Preparación de la Descripción del PR
 
-Cree `./.sessions/<ISSUE-ID>/pr-description.md`:
+Crea `./.sessions/<ISSUE-ID>/pr-description.md`:
 
 ```markdown
 ## 🎯 Objetivo
@@ -215,15 +238,15 @@ 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
@@ -241,17 +264,17 @@ Cree `./.sessions/<ISSUE-ID>/pr-description.md`:
 ## 🚨 Problemas Encontrados
 
 Si alguna validación falla:
-1. 🛑 **PARE** el proceso de creación de PR
-2. 📝 **DOCUMENTE** el problema
-3. 🔧 **CORRIJA** el problema
-4. 🔄 **EJECUTE** `/pre-pr` nuevamente
+1. 🛑 **DETÉN** el proceso de creación de PR
+2. 📝 **DOCUMENTA** el problema
+3. 🔧 **CORRIGE** el problema
+4. 🔄 **EJECUTA** `/pre-pr` nuevamente
 
-## 📊 Informe de Validación
+## 📊 Reporte de Validación
 
-Cree `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
+Crea `./.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 +286,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/work.md

@@ -2,19 +2,19 @@
 
 Este comando ejecuta una unidad de trabajo en el workspace actual, implementando parte del plan técnico.
 
-## 📋 Requisitos Previos
+## 📋 Prerrequisitos
 
-Antes de ejecutar, asegúrese de que:
-- Ha ejecutado `/start` y `/plan` para tener el plan técnico
-- Está en el workspace correcto: `<orchestrator>/.sessions/<ISSUE-ID>/`
-- Tiene los archivos `.sessions/<ISSUE-ID>/` disponibles:
+Antes de ejecutar, asegúrate de que:
+- Has ejecutado `/start` y `/plan` para tener el plan técnico
+- Estás en el workspace correcto: `<orchestrator>/.sessions/<ISSUE-ID>/`
+- Tienes disponibles los archivos `.sessions/<ISSUE-ID>/`:
   - `context.md` (inmutable)
   - `architecture.md` (inmutable)
   - `plan.md` (mutable)
 
-## 📍 IMPORTANTE: Entienda la Estructura
+## 📍 IMPORTANTE: Entiende la Estructura
 
-**Workspace** (donde trabaja):
+**Workspace** (donde trabajas):
 ```
 <orchestrator>/.sessions/<ISSUE-ID>/
 ├── repo-1/          # worktree con branch feature/<ISSUE-ID>
@@ -31,10 +31,33 @@ Antes de ejecutar, asegúrese de que:
 ```
 
 **REGLA DE ORO**:
-- ✅ Trabaje SÓLO dentro de `<orchestrator>/.sessions/<ISSUE-ID>/`
-- ✅ Haga commits en los worktrees dentro del workspace
-- ❌ NUNCA haga checkout en los repositorios principales
-- ❌ NUNCA navegue a `{base_path}/{repo-id}/`
+- ✅ Trabaja SÓLO dentro de `<orchestrator>/.sessions/<ISSUE-ID>/`
+- ✅ Haz commits en los worktrees dentro del workspace
+- ❌ NUNCA hagas checkout en los repositorios principales
+- ❌ NUNCA navegues a `{base_path}/{repo-id}/`
+
+## 🛑 CRÍTICO: DÓNDE CREAR CÓDIGO
+
+**⚠️ ATENCIÓN: TODO CÓDIGO DEBE SER CREADO DENTRO DEL WORKTREE DEL REPOSITORIO!**
+
+**✅ CORRECTO** - Crear código 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>/package.json  ✅
+```
+
+**❌ INCORRECTO** - NUNCA crear código directamente en .sessions:
+```
+<orchestrator>/.sessions/src/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/src/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+```
+
+**REGLA ABSOLUTA**:
+- 🛑 **TODO archivo de código** (`.ts`, `.js`, `.py`, `.java`, etc.) **DEBE estar dentro de** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA crees código** directamente en `<orchestrator>/.sessions/` o `<orchestrator>/.sessions/<ISSUE-ID>/`
+- ✅ **Único lugar válido**: Dentro del worktree del repositorio específico
 
 ## ⚠️ IMPORTANTE: Archivos Inmutables
 
@@ -42,19 +65,20 @@ Antes de ejecutar, asegúrese de que:
 - ✅ **LEER** `.sessions/<ISSUE-ID>/context.md` (inmutable)
 - ✅ **LEER** `.sessions/<ISSUE-ID>/architecture.md` (inmutable)
 - ✅ **ACTUALIZAR** `.sessions/<ISSUE-ID>/plan.md` (marcar progreso)
-- ✅ **IMPLEMENTAR** código en los repositorios del workspace
-- ✅ **HACER COMMITS** en los repositorios del workspace
+- ✅ **IMPLEMENTAR** código **DENTRO DEL WORKTREE**: `.sessions/<ISSUE-ID>/<repo-name>/`
+- ✅ **HACER COMMITS** en los worktrees: `.sessions/<ISSUE-ID>/<repo-name>/`
 - ❌ **NO modificar `context.md` o `architecture.md`**
 - ❌ **NO hacer checkout de branches en los repositorios principales (fuera del workspace)**
+- 🛑 **NUNCA crear código en `.sessions/` o `.sessions/<ISSUE-ID>/` directamente**
 
 ## 📚 Cargar MetaSpecs
 
 **Localizar MetaSpecs automáticamente**:
-1. Lea `context-manifest.json` del orchestrator
-2. Encuentre el repositorio con `"role": "metaspecs"`
-3. Lea `ai.properties.md` para obtener el `base_path`
+1. Lee `context-manifest.json` del orchestrator
+2. Encuentra el repositorio con `"role": "metaspecs"`
+3. Lee `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 durante la implementación para:
+5. Lee los archivos `index.md` relevantes durante la implementación para:
    - Seguir patrones de código
    - Respetar arquitectura definida
    - Usar convenciones correctas
@@ -71,27 +95,27 @@ Implementar una unidad de trabajo específica del plan, que puede involucrar:
 
 **⚠️ IMPORTANTE: CONTROL DE PROGRESO**
 
-Este comando ejecuta el trabajo en **fases incrementales**. Después de completar cada **FASE PRINCIPAL** (ej: Fase 1 → Fase 2):
+Este comando ejecuta el trabajo en **fases incrementales**. Tras completar cada **FASE PRINCIPAL** (ej: Fase 1 → Fase 2):
 
-1. 🛑 **PARE** la ejecución
-2. 📊 **PRESENTE** un resumen de lo realizado
-3. ❓ **PREGUNTE** al desarrollador si quiere:
+1. 🛑 **DETÉN** la ejecución
+2. 📊 **PRESENTA** un resumen de lo realizado
+3. ❓ **PREGUNTA** al desarrollador si quiere:
    - Revisar el código implementado
    - Hacer ajustes antes de continuar
    - Continuar a la siguiente fase
 
 **IMPORTANTE**:
-- ✅ **PAUSE** entre fases principales (Fase 1 → Fase 2 → Fase 3)
-- ❌ **NO pause** entre subfases (Fase 1.1 → Fase 1.2 → Fase 1.3)
+- ✅ **PAUSA** entre fases principales (Fase 1 → Fase 2 → Fase 3)
+- ❌ **NO pauses** entre subfases (Fase 1.1 → Fase 1.2 → Fase 1.3)
 
-**NO implemente todo de una vez**. Trabaje fase principal por fase principal, esperando confirmación del desarrollador.
+**NO implementes todo de una vez**. Trabaja fase principal por fase principal, esperando confirmación del desarrollador.
 
 ---
 
 ### 1. Identificar Unidad de Trabajo
 
-Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifique:
-- Qué tarea específica será implementada ahora
+Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifica:
+- Qué tarea específica se implementará ahora
 - En cuál(es) repositorio(s) del workspace
 - Qué archivos serán creados/modificados
 - Dependencias con otras tareas
@@ -100,34 +124,34 @@ Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifique:
 
 
 
-**IMPORTANTE**: Trabaje SÓLO dentro del workspace en `.sessions/<ISSUE-ID>/`
+**IMPORTANTE**: Trabaja SÓLO dentro del workspace en `.sessions/<ISSUE-ID>/`
 
 Para cada repositorio en el workspace:
 
 ```bash
-# Navegue al worktree dentro del workspace
+# Navega al worktree dentro del workspace
 cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
 
-# Verifique que está en la branch correcta
+# Verifica que estás en la branch correcta
 git branch  # debe mostrar * feature/<ISSUE-ID>
 
-# Implemente el código aquí
+# Implementa el código aquí
 ```
 
-Ejecute la implementación siguiendo:
-- **Patrones del proyecto**: Consulte guías de estilo y arquitectura
-- **Stack aprobada**: Use sólo tecnologías documentadas en las metaspecs
-- **Pruebas**: Implemente pruebas conforme a los patrones del proyecto
-- **Documentación**: Actualice comentarios y docs cuando sea necesario
+Ejecuta la implementación siguiendo:
+- **Patrones del proyecto**: Consulta guías de estilo y arquitectura
+- **Stack aprobada**: Usa sólo tecnologías documentadas en las metaspecs
+- **Pruebas**: Implementa pruebas conforme a los estándares del proyecto
+- **Documentación**: Actualiza comentarios y docs cuando sea necesario
 
 
 
 ### 3. Validación Local
 
 Antes de commitear:
-- Ejecute pruebas unitarias/integración
-- Verifique linting y formato
-- Confirme que no rompió funcionalidades existentes
+- Ejecuta pruebas unitarias/integración
+- Verifica linting y formato
+- Confirma que no rompiste funcionalidades existentes
 
 
 
@@ -136,10 +160,10 @@ Antes de commitear:
 Para cada repositorio modificado **dentro del workspace**:
 
 ```bash
-# Navegue al worktree dentro del workspace
+# Navega al worktree dentro del workspace
 cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
 
-# Añada los cambios
+# Añade los cambios
 git add .
 
 # Commit
@@ -153,15 +177,15 @@ Refs: <ISSUE-ID>"
 
 **Tipos de commit**: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
 
-**⚠️ PAUSA OBLIGATORIA**: Después de completar TODA la fase principal (identificación + implementación + validación + commit + actualización del plan.md), **PARE** y muestre al desarrollador:
+**⚠️ PAUSA OBLIGATORIA**: Tras completar TODA la fase principal (identificación + implementación + validación + commit + actualización del plan.md), **DETÉN** y muestra al desarrollador:
 - Resumen completo de la fase
 - Archivos creados/modificados
 - Commits realizados
-- Pregunte si quiere revisar o continuar a la siguiente fase
+- Pregunta si quiere revisar o continuar a la siguiente fase
 
 ### 5. Actualización del Plan.md
 
-**POR CADA tarea completada**, actualice `./.sessions/<ISSUE-ID>/plan.md`:
+**POR CADA tarea completada**, actualiza `./.sessions/<ISSUE-ID>/plan.md`:
 
 ```markdown
 #### 1.1 - [Nombre de la Tarea] [Completada ✅]
@@ -182,9 +206,9 @@ Refs: <ISSUE-ID>"
 - Aprendizaje: [Algo aprendido durante implementación]
 ```
 
-**Marque estado de las tareas**:
+**Marca el estado de las tareas**:
 - `[No Iniciada ⏳]` - Tarea aún no comenzó
-- `[En Progreso ⏰]` - Tarea en curso ahora
+- `[En Progreso ⏰]` - Tarea en curso
 - `[Completada ✅]` - Tarea finalizada y validada
 
 ## 🔍 Checklist de Calidad
@@ -199,11 +223,11 @@ Antes de considerar la unidad completa:
 
 ## ⚠️ Principio Jidoka
 
-Si encuentra problemas durante la implementación:
-1. 🛑 **PARE** la implementación
-2. 📝 **DOCUMENTE** el problema encontrado
-3. 💬 **ALERTE** al usuario y discuta soluciones
-4. 🔄 **AJUSTE** el plan si es necesario
+Si encuentras problemas durante la implementación:
+1. 🛑 **DETÉN** la implementación
+2. 📝 **DOCUMENTA** el problema encontrado
+3. 💬 **ALERTA** al usuario y discute soluciones
+4. 🔄 **AJUSTA** el plan si es necesario
 
 ---
 
@@ -217,12 +241,12 @@ Si encuentra problemas durante la implementación:
 
 ## 🎯 Próximos Pasos
 
-- **Continuar implementación**: Ejecute `/work` nuevamente para la siguiente unidad
-- **Finalizar feature**: Cuando todo esté implementado, ejecute `/pre-pr`
+- **Continuar implementación**: Ejecuta `/work` nuevamente para la siguiente unidad
+- **Finalizar feature**: Cuando todo esté implementado, ejecuta `/pre-pr`
 
 ## 💡 Consejos
 
-- Trabaje en unidades pequeñas e incrementales
+- Trabaja en unidades pequeñas e incrementales
 - Commit frecuente (commits atómicos)
-- Documente decisiones importantes en la sesión
-- Mantenga los repositorios sincronizados entre sí
+- Documenta decisiones importantes en la sesión
+- Mantén los repositorios sincronizados entre sí