context-first-cli 2.1.4 → 2.1.6

package/dist/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í

package/dist/templates/commands/pt-BR/engineer/pr.md

@@ -10,6 +10,29 @@ Antes de criar PRs, certifique-se de que:
 - Todos os testes estão passando
 - A documentação está atualizada
 
+## 🛑 CRÍTICO: ONDE TRABALHAR
+
+**⚠️ ATENÇÃO: Se precisar fazer ajustes de última hora, TODO CÓDIGO DEVE SER CRIADO DENTRO DO WORKTREE!**
+
+**✅ CORRETO** - Trabalhar dentro do 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  ✅
+```
+
+**❌ ERRADO** - NUNCA criar código fora do worktree:
+```
+<orchestrator>/.sessions/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+{base_path}/<repo-name>/file.ts  ❌ (repositório principal!)
+```
+
+**REGRA ABSOLUTA**:
+- 🛑 **Qualquer ajuste de código** (docs, changelog, fixes) **DEVE estar em** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA modifique** o repositório principal em `{base_path}/<repo-name>/`
+- ✅ **Trabalhe APENAS** dentro do worktree do repositório específico
+
 ## 🎯 Processo de Criação de PRs
 
 ### 1. Identificar Repositórios Modificados

package/dist/templates/commands/pt-BR/engineer/pre-pr.md

@@ -12,6 +12,29 @@ Este comando valida que tudo está pronto para criar Pull Requests.
 
 Garantir que a implementação está completa, testada e pronta para revisão antes de criar os PRs.
 
+## 🛑 CRÍTICO: ONDE TRABALHAR
+
+**⚠️ ATENÇÃO: TODO CÓDIGO (testes, fixes, ajustes) DEVE SER CRIADO DENTRO DO WORKTREE!**
+
+**✅ CORRETO** - Trabalhar dentro do 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  ✅
+```
+
+**❌ ERRADO** - NUNCA criar código fora do worktree:
+```
+<orchestrator>/.sessions/test.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/test.ts  ❌
+{base_path}/<repo-name>/test.ts  ❌ (repositório principal!)
+```
+
+**REGRA ABSOLUTA**:
+- 🛑 **TODO código** (testes, fixes, configurações) **DEVE estar em** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA modifique** o repositório principal em `{base_path}/<repo-name>/`
+- ✅ **Trabalhe APENAS** dentro do worktree do repositório específico
+
 ## ✅ Checklist de Validação
 
 ### 1. Completude da Implementação

package/dist/templates/commands/pt-BR/engineer/work.md

@@ -36,16 +36,40 @@ Antes de executar, certifique-se de que:
 - ❌ NUNCA faça checkout nos repositórios principais
 - ❌ NUNCA navegue para `{base_path}/{repo-id}/`
 
+## 🛑 CRÍTICO: ONDE CRIAR CÓDIGO
+
+**⚠️ ATENÇÃO: TODO CÓDIGO DEVE SER CRIADO DENTRO DO WORKTREE DO REPOSITÓRIO!**
+
+**✅ CORRETO** - Criar código dentro do 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  ✅
+```
+
+**❌ ERRADO** - NUNCA criar código diretamente em .sessions:
+```
+<orchestrator>/.sessions/src/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/src/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+```
+
+**REGRA ABSOLUTA**:
+- 🛑 **TODO arquivo de código** (`.ts`, `.js`, `.py`, `.java`, etc.) **DEVE estar dentro de** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NUNCA crie código** diretamente em `<orchestrator>/.sessions/` ou `<orchestrator>/.sessions/<ISSUE-ID>/`
+- ✅ **Único lugar válido**: Dentro do worktree do repositório específico
+
 ## ⚠️ IMPORTANTE: Arquivos Imutáveis
 
 **Este comando deve LER mas NÃO MODIFICAR:**
 - ✅ **LER** `.sessions/<ISSUE-ID>/context.md` (imutável)
 - ✅ **LER** `.sessions/<ISSUE-ID>/architecture.md` (imutável)
 - ✅ **ATUALIZAR** `.sessions/<ISSUE-ID>/plan.md` (marcar progresso)
-- ✅ **IMPLEMENTAR** código nos repositórios do workspace
-- ✅ **FAZER COMMITS** nos repositórios do workspace
+- ✅ **IMPLEMENTAR** código **DENTRO DO WORKTREE**: `.sessions/<ISSUE-ID>/<repo-name>/`
+- ✅ **FAZER COMMITS** nos worktrees: `.sessions/<ISSUE-ID>/<repo-name>/`
 - ❌ **NÃO modificar `context.md` ou `architecture.md`**
 - ❌ **NÃO fazer checkout de branches nos repositórios principais (fora do workspace)**
+- 🛑 **NUNCA criar código em `.sessions/` ou `.sessions/<ISSUE-ID>/` diretamente**
 
 ## 📚 Carregar MetaSpecs
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-first-cli",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "A generic CLI to manage the Context-First development methodology across any project.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -10,32 +10,55 @@ Before creating PRs, make sure that:
 - All tests are passing
 - Documentation is up to date
 
+## 🛑 CRITICAL: WHERE TO WORK
+
+**⚠️ ATTENTION: If you need to make last-minute adjustments, ALL CODE MUST BE CREATED INSIDE THE WORKTREE!**
+
+**✅ CORRECT** - Work inside the 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  ✅
+```
+
+**❌ WRONG** - NEVER create code outside the worktree:
+```
+<orchestrator>/.sessions/file.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/file.ts  ❌
+{base_path}/<repo-name>/file.ts  ❌ (main repository!)
+```
+
+**ABSOLUTE RULE**:
+- 🛑 **Any code adjustment** (docs, changelog, fixes) **MUST be in** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NEVER modify** the main repository in `{base_path}/<repo-name>/`
+- ✅ **Work ONLY** inside the specific repository’s worktree
+
 ## 🎯 PR Creation Process
 
 ### 1. Identify Modified Repositories
 
 For each repository in the workspace, check:
 ```bash
-cd <repositório>
+cd <repository>
 git status
-git log origin/main..HEAD  # View unpushed commits
+git log origin/main..HEAD  # See unpushed commits
 ```
 
 ### 2. Push Branches
 
 For each modified repository:
 ```bash
-cd <repositório>
+cd <repository>
 git push origin <branch-name>
 ```
 
 ### 3. Create Pull Requests
 
-For each repository, create a PR using GitHub CLI or the web interface:
+For each repository, create a PR using GitHub CLI or web interface:
 
 **Using GitHub CLI**:
 ```bash
-cd <repositório>
+cd <repository>
 gh pr create --title "[ISSUE-ID] Feature Title" \
   --body "$(cat ../.sessions/<ISSUE-ID>/pr-description.md)" \
   --base main
@@ -50,7 +73,7 @@ gh pr create --title "[ISSUE-ID] Feature Title" \
 
 ## 📝 Changes
 
-### Repository: <nome-do-repo>
+### Repository: <repo-name>
 
 - [Change 1]
 - [Change 2]
@@ -84,22 +107,22 @@ gh pr create --title "[ISSUE-ID] Feature Title" \
 
 ## 🔍 Notes for Reviewers
 
-- [Point of attention 1]
-- [Point of attention 2]
+- [Attention point 1]
+- [Attention point 2]
 ```
 
 ### 4. Link PRs
 
 If there are multiple PRs (one per repository):
-- Add cross-links between the PRs
-- Document the recommended merge order
+- Add cross-links between PRs
+- Document recommended merge order
 - Indicate dependencies between PRs
 
 ### 5. Update Issue in Task Manager
 
-If the task manager is configured:
+If a task manager is configured:
 - Move the issue to "In Review" or "PR Open"
-- Add PR links in the issue
+- Add PR links to the issue
 - Add a comment summarizing the changes
 
 ### 6. Session Documentation
@@ -126,7 +149,7 @@ Update `./.sessions/<ISSUE-ID>/pr.md`:
 1. <repo-1> - [Justification]
 2. <repo-2> - [Justification]
 
-## Merge Notes
+## Notes for Merge
 
 - [Important note 1]
 - [Important note 2]
@@ -146,7 +169,7 @@ Before requesting review:
 
 Notify the team about the PRs:
 - Mention relevant reviewers
-- Highlight critical changes or breaking changes
+- Highlight critical or breaking changes
 - Indicate urgency if applicable
 
 ---
@@ -161,7 +184,7 @@ Notify the team about the PRs:
 
 ## 🎯 Next Steps
 
-1. Await PR review
+1. Await PR reviews
 2. Respond to comments and make adjustments
 3. After approval, merge in the recommended order
 4. Run `context-cli feature:end <ISSUE-ID>` to clean the workspace

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

@@ -4,7 +4,7 @@ This command validates that everything is ready to create Pull Requests.
 
 ## 📋 Prerequisites
 
-- Complete implementation (all `/plan` tasks executed)
+- Complete implementation (all tasks from `/plan` executed)
 - All commits made
 - Clean and organized workspace
 
@@ -12,6 +12,29 @@ This command validates that everything is ready to create Pull Requests.
 
 Ensure that the implementation is complete, tested, and ready for review before creating the PRs.
 
+## 🛑 CRITICAL: WHERE TO WORK
+
+**⚠️ ATTENTION: ALL CODE (tests, fixes, adjustments) MUST BE CREATED INSIDE THE WORKTREE!**
+
+**✅ CORRECT** - Work 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>/.eslintrc.js  ✅
+```
+
+**❌ WRONG** - NEVER create code outside the worktree:
+```
+<orchestrator>/.sessions/test.ts  ❌
+<orchestrator>/.sessions/<ISSUE-ID>/test.ts  ❌
+{base_path}/<repo-name>/test.ts  ❌ (main repository!)
+```
+
+**ABSOLUTE RULE**:
+- 🛑 **ALL code** (tests, fixes, configurations) **MUST be in** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
+- 🛑 **NEVER modify** the main repository at `{base_path}/<repo-name>/`
+- ✅ **Work ONLY** inside the specific repository’s worktree
+
 ## ✅ Validation Checklist
 
 ### 1. Implementation Completeness
@@ -19,10 +42,10 @@ Ensure that the implementation is complete, tested, and ready for review before
 ```markdown
 ## Completeness Check
 
-- [ ] All plan tasks have been executed
+- [ ] All tasks from the plan have been executed
 - [ ] All functional requirements from the PRD have been implemented
 - [ ] All acceptance criteria have been met
-- [ ] No functionality is left half-done
+- [ ] No functionality is half-done
 ```
 
 ### 2. Code Quality
@@ -163,7 +186,7 @@ Checklist:
 
 - [ ] Branches are up to date with the base branch (main/develop)
 - [ ] No merge conflicts
-- [ ] Changes between repositories are synchronized
+- [ ] Changes across repositories are synchronized
 - [ ] Dependencies between repos have been tested
 ```
 
@@ -184,7 +207,7 @@ Checklist:
 ## Performance
 
 - [ ] No obvious performance regressions
-- [ ] Costly queries/operations have been optimized
+- [ ] Expensive queries/operations have been optimized
 - [ ] No memory leaks introduced
 - [ ] PRD performance requirements have been met
 ```
@@ -234,16 +257,16 @@ Create `./.sessions/<ISSUE-ID>/pr-description.md`:
 3. [Expected result]
 
 ## 🔍 Notes for Reviewers
-- [Attention point 1]
-- [Attention point 2]
+- [Point of attention 1]
+- [Point of attention 2]
 ```
 
 ## 🚨 Issues Found
 
 If any validation fails:
 1. 🛑 **STOP** the PR creation process
-2. 📝 **DOCUMENT** the issue
-3. 🔧 **FIX** the issue
+2. 📝 **DOCUMENT** the problem
+3. 🔧 **FIX** the problem
 4. 🔄 **RUN** `/pre-pr` again
 
 ## 📊 Validation Report
@@ -253,11 +276,11 @@ Create `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
 ```markdown
 # Pre-PR Validation Report
 
-**Date**: [date/time]
+**Date**: [date/time]  
 **Issue**: [ISSUE-ID]
 
 ## Overall Status
-✅ Ready for PR / ⚠️ Pending / ❌ Blocked
+✅ Ready for PR / ⚠️ Pending Issues / ❌ Blocked
 
 ## Validated Repositories
 - **<repo-1>**: ✅ OK
@@ -268,9 +291,9 @@ Create `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
 - **Integration Tests**: Y/Y passing
 - **Coverage**: Z%
 
-## Pending Items (if any)
-- [Pending item 1]
-- [Pending item 2]
+## Pending Issues (if any)
+- [Pending issue 1]
+- [Pending issue 2]
 
 ## Next Steps
 - [x] All validations passed
@@ -295,4 +318,4 @@ If all validations passed:
 /pr
 ```
 
-This command will create the Pull Requests for all modified repositories.
+This command will create Pull Requests for all modified repositories.