context-first-cli 2.1.5 → 2.2.0

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

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

@@ -8,10 +8,71 @@ Este comando valida que tudo está pronto para criar Pull Requests.
 - Todos os commits realizados
 - Workspace limpo e organizado
 
+## 📋 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.
+
+
 ## 🎯 Objetivo
 
 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/start.md

@@ -26,6 +26,44 @@ Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
 - ❌ NUNCA faça checkout nos repositórios principais
 - ❌ NUNCA modifique código neste comando (use `/work` depois)
 
+## 📋 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.
+
+
 ## 📚 Carregar MetaSpecs
 
 **Localizar MetaSpecs automaticamente**:

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

@@ -12,6 +12,44 @@ Antes de executar, certifique-se de que:
   - `architecture.md` (imutável)
   - `plan.md` (mutável)
 
+## 📋 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** (onde você trabalha):

package/dist/templates/commands/pt-BR/products/check.md

@@ -12,6 +12,44 @@ Este comando valida requisitos, decisões ou implementações contra as metaspec
 - ❌ **NÃO modificar código**
 - ❌ **NÃO modificar `context.md` ou `architecture.md`**
 
+## 📋 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.
+
+
 ## 🎯 Objetivo
 
 Garantir alinhamento com:

package/dist/templates/commands/pt-BR/products/collect.md

@@ -18,6 +18,44 @@ Você é um especialista em produto responsável por coletar e documentar novas
 
 ---
 
+## 📋 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.
+
+
 ## Contexto do Projeto
 
 Antes de iniciar, carregue o contexto consultando:

package/dist/templates/commands/pt-BR/products/refine.md

@@ -17,6 +17,44 @@ Você é um especialista em produto encarregado de ajudar a refinar requisitos p
 
 ---
 
+## 📋 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.
+
+
 ## Objetivo
 
 Transformar um requisito inicial em especificação refinada e validada, pronta para se tornar PRD completo.