context-first-cli 2.1.5 → 2.2.0

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

@@ -2,19 +2,57 @@
 
 Este comando ejecuta una unidad de trabajo en el workspace actual, implementando parte del plan técnico.
 
-## 📋 Prerrequisitos
+## 📋 Requisitos Previos
 
-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>/`:
+Antes de ejecutar, asegúrese de que:
+- Ha ejecutado `/start` y `/plan` para obtener el plan técnico
+- Está en el workspace correcto: `<orchestrator>/.sessions/<ISSUE-ID>/`
+- Tiene disponibles los archivos `.sessions/<ISSUE-ID>/`:
   - `context.md` (inmutable)
   - `architecture.md` (inmutable)
   - `plan.md` (mutable)
 
-## 📍 IMPORTANTE: Entiende la Estructura
+## 📋 Configuración del Proyecto
 
-**Workspace** (donde trabajas):
+**⚠️ 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!
+
+
+## 📍 IMPORTANTE: Entienda la Estructura
+
+**Workspace** (donde trabaja):
 ```
 <orchestrator>/.sessions/<ISSUE-ID>/
 ├── repo-1/          # worktree con branch feature/<ISSUE-ID>
@@ -31,10 +69,10 @@ Antes de ejecutar, asegúrate de que:
 ```
 
 **REGLA DE ORO**:
-- ✅ 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}/`
+- ✅ Trabaje SOLO 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}/`
 
 ## 🛑 CRÍTICO: DÓNDE CREAR CÓDIGO
 
@@ -56,7 +94,7 @@ Antes de ejecutar, asegúrate de que:
 
 **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>/`
+- 🛑 **NUNCA cree 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
@@ -74,11 +112,11 @@ Antes de ejecutar, asegúrate de que:
 ## 📚 Cargar MetaSpecs
 
 **Localizar MetaSpecs automáticamente**:
-1. Lee `context-manifest.json` del orchestrator
-2. Encuentra el repositorio con `"role": "metaspecs"`
-3. Lee `ai.properties.md` para obtener el `base_path`
+1. Lea `context-manifest.json` del orchestrator
+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. Lee los archivos `index.md` relevantes durante la implementación para:
+5. Lea los archivos `index.md` relevantes durante la implementación para:
    - Seguir patrones de código
    - Respetar arquitectura definida
    - Usar convenciones correctas
@@ -95,26 +133,26 @@ Implementar una unidad de trabajo específica del plan, que puede involucrar:
 
 **⚠️ IMPORTANTE: CONTROL DE PROGRESO**
 
-Este comando ejecuta el trabajo en **fases incrementales**. Tras completar cada **FASE PRINCIPAL** (ej: Fase 1 → Fase 2):
+Este comando ejecuta el trabajo en **fases incrementales**. Después de completar cada **FASE PRINCIPAL** (ej: Fase 1 → Fase 2):
 
-1. 🛑 **DETÉN** la ejecución
-2. 📊 **PRESENTA** un resumen de lo realizado
-3. ❓ **PREGUNTA** al desarrollador si quiere:
+1. 🛑 **PARE** la ejecución
+2. 📊 **PRESENTE** un resumen de lo realizado
+3. ❓ **PREGUNTE** al desarrollador si desea:
    - Revisar el código implementado
    - Hacer ajustes antes de continuar
    - Continuar a la siguiente fase
 
 **IMPORTANTE**:
-- ✅ **PAUSA** entre fases principales (Fase 1 → Fase 2 → Fase 3)
-- ❌ **NO pauses** entre subfases (Fase 1.1 → Fase 1.2 → Fase 1.3)
+- ✅ **PAUSE** entre fases principales (Fase 1 → Fase 2 → Fase 3)
+- ❌ **NO pause** entre subfases (Fase 1.1 → Fase 1.2 → Fase 1.3)
 
-**NO implementes todo de una vez**. Trabaja fase principal por fase principal, esperando confirmación del desarrollador.
+**NO implemente todo de una vez**. Trabaje 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`), identifica:
+Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifique:
 - Qué tarea específica se implementará ahora
 - En cuál(es) repositorio(s) del workspace
 - Qué archivos serán creados/modificados
@@ -124,34 +162,34 @@ Basado en el plan técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifica:
 
 
 
-**IMPORTANTE**: Trabaja SÓLO dentro del workspace en `.sessions/<ISSUE-ID>/`
+**IMPORTANTE**: Trabaje SOLO dentro del workspace en `.sessions/<ISSUE-ID>/`
 
 Para cada repositorio en el workspace:
 
 ```bash
-# Navega al worktree dentro del workspace
+# Navegue al worktree dentro del workspace
 cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
 
-# Verifica que estás en la branch correcta
+# Verifique que está en la rama correcta
 git branch  # debe mostrar * feature/<ISSUE-ID>
 
-# Implementa el código aquí
+# Implemente el código aquí
 ```
 
-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
+Ejecute la implementación siguiendo:
+- **Patrones del proyecto**: Consulte guías de estilo y arquitectura
+- **Stack aprobada**: Use solo tecnologías documentadas en metaspecs
+- **Pruebas**: Implemente pruebas conforme a los patrones del proyecto
+- **Documentación**: Actualice comentarios y docs cuando sea necesario
 
 
 
 ### 3. Validación Local
 
 Antes de commitear:
-- Ejecuta pruebas unitarias/integración
-- Verifica linting y formato
-- Confirma que no rompiste funcionalidades existentes
+- Ejecute pruebas unitarias/integración
+- Verifique linting y formato
+- Confirme que no rompió funcionalidades existentes
 
 
 
@@ -160,10 +198,10 @@ Antes de commitear:
 Para cada repositorio modificado **dentro del workspace**:
 
 ```bash
-# Navega al worktree dentro del workspace
+# Navegue al worktree dentro del workspace
 cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
 
-# Añade los cambios
+# Añada los cambios
 git add .
 
 # Commit
@@ -177,15 +215,15 @@ Refs: <ISSUE-ID>"
 
 **Tipos de commit**: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
 
-**⚠️ 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:
+**⚠️ 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:
 - Resumen completo de la fase
 - Archivos creados/modificados
 - Commits realizados
-- Pregunta si quiere revisar o continuar a la siguiente fase
+- Pregunte si desea revisar o continuar a la siguiente fase
 
 ### 5. Actualización del Plan.md
 
-**POR CADA tarea completada**, actualiza `./.sessions/<ISSUE-ID>/plan.md`:
+**POR CADA tarea completada**, actualice `./.sessions/<ISSUE-ID>/plan.md`:
 
 ```markdown
 #### 1.1 - [Nombre de la Tarea] [Completada ✅]
@@ -206,8 +244,8 @@ Refs: <ISSUE-ID>"
 - Aprendizaje: [Algo aprendido durante implementación]
 ```
 
-**Marca el estado de las tareas**:
-- `[No Iniciada ⏳]` - Tarea aún no comenzó
+**Marque estado de las tareas**:
+- `[No Iniciada ⏳]` - Tarea aún no comenzada
 - `[En Progreso ⏰]` - Tarea en curso
 - `[Completada ✅]` - Tarea finalizada y validada
 
@@ -223,11 +261,11 @@ Antes de considerar la unidad completa:
 
 ## ⚠️ Principio Jidoka
 
-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
+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
 
 ---
 
@@ -241,12 +279,12 @@ Si encuentras problemas durante la implementación:
 
 ## 🎯 Próximos Pasos
 
-- **Continuar implementación**: Ejecuta `/work` nuevamente para la siguiente unidad
-- **Finalizar feature**: Cuando todo esté implementado, ejecuta `/pre-pr`
+- **Continuar implementación**: Ejecute `/work` nuevamente para la próxima unidad
+- **Finalizar feature**: Cuando todo esté implementado, ejecute `/pre-pr`
 
 ## 💡 Consejos
 
-- Trabaja en unidades pequeñas e incrementales
+- Trabaje en unidades pequeñas e incrementales
 - Commit frecuente (commits atómicos)
-- Documenta decisiones importantes en la sesión
-- Mantén los repositorios sincronizados entre sí
+- Documente decisiones importantes en la sesión
+- Mantenga los repositorios sincronizados entre sí

package/templates/commands/es/products/check.md

@@ -1,4 +1,4 @@
-# Validación contra Metaspecs
+# Validación contra MetaSpecs
 
 Este comando valida requisitos, decisiones o implementaciones contra las metaspecs del proyecto.
 
@@ -12,6 +12,44 @@ Este comando valida requisitos, decisiones o implementaciones contra las metaspe
 - ❌ **NO modificar código**
 - ❌ **NO modificar `context.md` o `architecture.md`**
 
+## 📋 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.
+
+
 ## 🎯 Objetivo
 
 Garantizar alineación con:
@@ -38,7 +76,7 @@ Ejecute este comando:
 
 ## 🔍 Proceso de Validación
 
-### 1. Identificar Metaspecs Disponibles
+### 1. Identificar MetaSpecs Disponibles
 
 Navegue hasta el directorio de metaspecs e identifique qué metaspecs existen:
 
@@ -55,7 +93,7 @@ Si existen metaspecs de negocio (`repositorio de MetaSpecs (sección de negocio)
 
 ### Estrategia de Producto
 - **Archivo**: `repositorio de MetaSpecs (sección de negocio)PRODUCT_STRATEGY.md`
-- **Validación**: [¿Esta funcionalidad está alineada con la estrategia?]
+- **Validación**: [¿Esta feature está alineada con la estrategia?]
 - **Estado**: ✅ Alineado / ⚠️ Parcialmente / ❌ Desalineado
 - **Notas**: [Observaciones]
 
@@ -87,7 +125,7 @@ Si existen metaspecs técnicas (`repositorio de MetaSpecs (sección técnica)`):
 
 ### Arquitectura
 - **Archivo**: `repositorio de MetaSpecs (sección técnica)ARCHITECTURE.md`
-- **Validación**: [¿Sigue estándares arquitectónicos?]
+- **Validación**: [¿Sigue patrones arquitectónicos?]
 - **Estado**: ✅ Conforme / ⚠️ Parcialmente / ❌ No conforme
 - **Notas**: [Observaciones]
 
@@ -140,7 +178,7 @@ Si hay conflictos o desalineamientos:
 - **Recomendación**: [Cómo resolver]
 
 ### Conflicto 2: [Descripción]
-[Mismo formato anterior]
+[Mismo formato arriba]
 ```
 
 ### 6. Excepciones Justificadas
@@ -203,17 +241,17 @@ Si el MCP no está disponible o falla, cree `./.sessions/<ISSUE-ID>/check-report
 - [ ] Bloqueado
 ```
 
-Informe al usuario: "⚠️ Informe guardado localmente en .sessions/ (task manager no disponible)"
+Informe al usuario: "⚠️ Informe guardado localmente en .sessions/ (gestor de tareas no disponible)"
 
 ## 🚨 Acción en Caso de Conflictos
 
 Si se encuentran conflictos críticos:
-1. 🛑 **PARE** el proceso actual
+1. 🛑 **DETENGA** el proceso actual
 2. 📝 **DOCUMENTE** todos los conflictos
 3. 💬 **ALERTE** al usuario y stakeholders
-4. **Via MCP**: Actualice estado de la issue a "Bloqueado" o "Requiere Ajustes"
+4. **Vía MCP**: Actualice el estado de la issue a "Bloqueado" o "Requiere Ajustes"
 5. 🔄 **AJUSTE** el plan/implementación según sea necesario
-6. ✅ **REVALIDE** después de los ajustes
+6. ✅ **REVALIDE** tras los ajustes
 
 ---
 
@@ -228,6 +266,6 @@ Si se encuentran conflictos críticos:
 ## 🎯 Resultado
 
 Después de la validación:
-- Si ✅: Proceda a la siguiente fase
+- Si ✅: Continúe a la siguiente fase
 - Si ⚠️: Documente reservas y continúe con aprobación
 - Si ❌: Corrija conflictos antes de continuar

package/templates/commands/es/products/collect.md

@@ -18,26 +18,63 @@ Eres un especialista en producto responsable de recopilar y documentar nuevas id
 
 ---
 
+## 📋 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.
+
 ## Contexto del Proyecto
 
-Antes de comenzar, carga el contexto consultando:
+Antes de iniciar, carga el contexto consultando:
 
 1. **Localizar MetaSpecs automáticamente**:
-   - Lee `context-manifest.json` del orquestador
+   - Lee `context-manifest.json` del orchestrator
    - Encuentra el repositorio con `"role": "metaspecs"`
    - Lee `ai.properties.md` para obtener el `base_path`
    - El metaspecs está en: `{base_path}/{metaspecs-repo-id}/`
    - Lee los archivos `index.md` como referencia
 
 2. **Estructura del proyecto**:
-   - `context-manifest.json` - Lista de repositorios y sus funciones
+   - `context-manifest.json` - Lista de repositorios y sus roles
    - `README.md` de los repositorios involucrados
 
 ## Tu Objetivo
 
 Entender la solicitud del usuario y capturarla como issue en el gestor de tareas (vía MCP).
 
-**En esta fase, NO necesitas:**
+**En esta fase NO necesitas:**
 - ❌ Escribir especificación completa
 - ❌ Validar contra metaspecs (esto se hace en `/refine` o `/spec`)
 - ❌ Detallar implementación técnica
@@ -50,20 +87,20 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
 # [Título Claro y Descriptivo]
 
 ## Descripción
-[2-3 párrafos explicando qué es la funcionalidad/bug y por qué es importante]
+[2-3 párrafos explicando qué es la feature/bug y por qué es importante]
 
 ## Tipo
-- [ ] Nueva Funcionalidad
-- [ ] Mejora de Funcionalidad Existente
+- [ ] Nueva Feature
+- [ ] Mejora de Feature Existente
 - [ ] Bug
 - [ ] Deuda Técnica
 - [ ] Documentación
 
 ## Contexto Adicional
-[Información relevante: dónde ocurre el bug, inspiración para la funcionalidad, etc.]
+[Información relevante: dónde ocurre el bug, inspiración para la feature, etc.]
 
 ## Repositorios Afectados
-[Lista de los repositorios del proyecto que serán impactados]
+[Lista de repositorios del proyecto que serán impactados]
 
 ## Prioridad Sugerida
 - [ ] 🔴 Crítica
@@ -76,7 +113,7 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
 
 1. **Entendimiento Inicial**
    - Haz preguntas de aclaración si es necesario
-   - Identifica: ¿Es funcionalidad nueva? ¿Mejora? ¿Bug?
+   - Identifica: ¿Es feature nueva? ¿Mejora? ¿Bug?
    - Identifica qué repositorios serán afectados
 
 2. **Borrador de la Issue**
@@ -92,11 +129,11 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
    
    **Si la implementación parece grande** (> 5 días de esfuerzo estimado):
    - 🚨 **Sugiere dividir en múltiples issues más pequeñas**
-   - Explica la razón de la división (ej: "Esta funcionalidad involucra 3 áreas distintas: autenticación, procesamiento y notificación")
+   - Explica la razón de la división (ej: "Esta feature involucra 3 áreas distintas: autenticación, procesamiento y notificación")
    - Propón una división **lógica** (por funcionalidad, por repositorio, por capa, etc.)
    - Ejemplo de división:
      ```
-     Issue Original: "Sistema completo de pagos"
+     Issue Original: "Sistema de pagos completo"
      
      División Sugerida:
      - FIN-101: Integración con gateway de pago (backend)
@@ -120,7 +157,7 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
    **PRIORIDAD 1: Usar MCP (Model Context Protocol)**
    
    Verifica si hay MCP configurado para el gestor de tareas:
-   - Lee `ai.properties.md` del orquestador para identificar el `task_management_system`
+   - Lee `ai.properties.md` del orchestrator para identificar el `task_management_system`
    - Si `task_management_system=jira`: Usa MCP de Jira para crear la issue
    - Si `task_management_system=linear`: Usa MCP de Linear para crear la issue
    - Si `task_management_system=github`: Usa MCP de GitHub para crear la issue
@@ -138,16 +175,16 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
    - Crea archivo en `./.sessions/<ISSUE-ID>/collect.md`
    - Usa formato de ID manual: `LOCAL-001`, `LOCAL-002`, etc.
    - Incluye fecha, tipo y contenido completo
-   - Informa al usuario: "⚠️ Issue guardada localmente en .sessions/ (gestor de tareas no disponible)"
+   - Informa al usuario: "⚠️ Issue guardada localmente en .sessions/ (task manager no disponible)"
 
 ## Preguntas de Aclaración
 
-**Para Funcionalidades**:
+**Para Features**:
 - ¿Qué problema resuelve?
 - ¿Quién se beneficia?
 - ¿Es funcionalidad visible o infraestructura?
-- ¿Tiene relación con alguna funcionalidad existente?
-- ¿Qué repositorios necesitan ser modificados?
+- ¿Tiene relación con alguna feature existente?
+- ¿Qué repositorios necesitan modificarse?
 
 **Para Bugs**:
 - ¿Dónde ocurre el bug? (repositorio, componente, flujo)
@@ -172,7 +209,7 @@ Solo asegúrate de que la idea esté **adecuadamente comprendida**.
 
 ## 🎯 Próximo Paso
 
-Tras la aprobación y guardado de la issue:
+Después de la aprobación y guardado de la issue:
 
 ```bash
 /refine [ISSUE-ID]

package/templates/commands/pt-BR/engineer/plan.md

@@ -8,6 +8,44 @@ Este comando cria o plano técnico detalhado para implementação da feature.
 - Análise inicial feita via `/start`
 - Arquivos `context.md` e `architecture.md` criados e aprovados
 
+## 📋 Configuração do Projeto
+
+**⚠️ IMPORTANTE: Sempre leia os arquivos de configuração do projeto ANTES de executar este comando!**
+
+### Arquivos Obrigatórios
+
+1. **`context-manifest.json`** (raiz do orchestrator)
+   - Lista de repositórios do projeto
+   - Roles de cada repositório (metaspecs, application, etc.)
+   - URLs e dependências entre repositórios
+
+2. **`ai.properties.md`** (raiz do orchestrator)
+   - Configurações do projeto (`project_name`, `base_path`)
+   - Sistema de gerenciamento de tarefas (`task_management_system`)
+   - Credenciais e configurações específicas
+
+### Como Ler
+
+```bash
+# 1. Ler context-manifest.json
+cat context-manifest.json
+
+# 2. Ler ai.properties.md
+cat ai.properties.md
+```
+
+### Informações Essenciais
+
+Após ler os arquivos, você terá:
+- ✅ Lista completa de repositórios do projeto
+- ✅ Localização do repositório de metaspecs
+- ✅ Base path para localizar repositórios
+- ✅ Sistema de task management configurado
+- ✅ Configurações específicas do projeto
+
+**🛑 NÃO prossiga sem ler estes arquivos!** Eles contêm informações críticas para a execução correta do comando.
+
+
 ## 📍 IMPORTANTE: Entenda a Estrutura
 
 **Workspace**:

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

@@ -10,6 +10,67 @@ Antes de criar PRs, certifique-se de que:
 - Todos os testes estão passando
 - A documentação está atualizada
 
+## 📋 Configuração do Projeto
+
+**⚠️ IMPORTANTE: Sempre leia os arquivos de configuração do projeto ANTES de executar este comando!**
+
+### Arquivos Obrigatórios
+
+1. **`context-manifest.json`** (raiz do orchestrator)
+   - Lista de repositórios do projeto
+   - Roles de cada repositório (metaspecs, application, etc.)
+   - URLs e dependências entre repositórios
+
+2. **`ai.properties.md`** (raiz do orchestrator)
+   - Configurações do projeto (`project_name`, `base_path`)
+   - Sistema de gerenciamento de tarefas (`task_management_system`)
+   - Credenciais e configurações específicas
+
+### Como Ler
+
+```bash
+# 1. Ler context-manifest.json
+cat context-manifest.json
+
+# 2. Ler ai.properties.md
+cat ai.properties.md
+```
+
+### Informações Essenciais
+
+Após ler os arquivos, você terá:
+- ✅ Lista completa de repositórios do projeto
+- ✅ Localização do repositório de metaspecs
+- ✅ Base path para localizar repositórios
+- ✅ Sistema de task management configurado
+- ✅ Configurações específicas do projeto
+
+**🛑 NÃO prossiga sem ler estes arquivos!** Eles contêm informações críticas para a execução correta do comando.
+
+
+## 🛑 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