context-first-cli 1.3.2 → 1.5.2

package/templates/commands/products/check.md

@@ -25,30 +25,30 @@ Execute este comando:
 Navegue até o diretório do orchestrator e identifique quais metaspecs existem:
 
 ```bash
-ls -la ../.context-orchestrator/specs/
+ls -la repositório de MetaSpecs
 ```
 
 ### 2. Validação de Negócio
 
-Se existirem metaspecs de negócio (`specs/business/`):
+Se existirem metaspecs de negócio (`repositório de MetaSpecs (seção de negócio)`):
 
 ```markdown
 ## Validação de Negócio
 
 ### Estratégia de Produto
-- **Arquivo**: `specs/business/PRODUCT_STRATEGY.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)PRODUCT_STRATEGY.md`
 - **Validação**: [Esta feature está alinhada com a estratégia?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
 
 ### Personas
-- **Arquivo**: `specs/business/CUSTOMER_PERSONAS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)CUSTOMER_PERSONAS.md`
 - **Validação**: [Atende a persona correta?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
 
 ### Métricas
-- **Arquivo**: `specs/business/PRODUCT_METRICS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção de negócio)PRODUCT_METRICS.md`
 - **Validação**: [Métrica de sucesso está documentada?]
 - **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
 - **Notas**: [Observações]
@@ -56,32 +56,32 @@ Se existirem metaspecs de negócio (`specs/business/`):
 
 ### 3. Validação Técnica
 
-Se existirem metaspecs técnicas (`specs/technical/`):
+Se existirem metaspecs técnicas (`repositório de MetaSpecs (seção técnica)`):
 
 ```markdown
 ## Validação Técnica
 
 ### Stack Tecnológica
-- **Arquivo**: `specs/technical/meta/stack.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)meta/stack.md`
 - **Validação**: [Usa apenas tecnologias aprovadas?]
 - **Status**: ✅ Conforme / ⚠️ Exceção justificada / ❌ Não conforme
 - **Notas**: [Tecnologias usadas e justificativas]
 
 ### Arquitetura
-- **Arquivo**: `specs/technical/ARCHITECTURE.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)ARCHITECTURE.md`
 - **Validação**: [Segue padrões arquiteturais?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 - **Notas**: [Observações]
 
 ### ADRs (Architecture Decision Records)
-- **Diretório**: `specs/technical/adr/`
+- **Diretório**: `repositório de MetaSpecs (seção técnica)adr/`
 - **Validação**: [Respeita decisões arquiteturais documentadas?]
 - **ADRs Relevantes**: [Lista de ADRs verificados]
 - **Status**: ✅ Conforme / ⚠️ Conflito menor / ❌ Conflito crítico
 - **Notas**: [Observações]
 
 ### Regras de Negócio
-- **Arquivo**: `specs/technical/BUSINESS_LOGIC.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)BUSINESS_LOGIC.md`
 - **Validação**: [Implementa regras de negócio corretamente?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 - **Notas**: [Observações]
@@ -93,17 +93,17 @@ Se existirem metaspecs técnicas (`specs/technical/`):
 ## Validação de Padrões
 
 ### Código
-- **Arquivo**: `specs/technical/CODE_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)CODE_STANDARDS.md`
 - **Validação**: [Segue padrões de código?]
 - **Status**: ✅ Conforme / ⚠️ Pequenos desvios / ❌ Não conforme
 
 ### Testes
-- **Arquivo**: `specs/technical/TEST_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)TEST_STANDARDS.md`
 - **Validação**: [Estratégia de testes adequada?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 
 ### Documentação
-- **Arquivo**: `specs/technical/DOC_STANDARDS.md`
+- **Arquivo**: `repositório de MetaSpecs (seção técnica)DOC_STANDARDS.md`
 - **Validação**: [Documentação adequada?]
 - **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
 ```
@@ -140,9 +140,20 @@ Se houver desvios justificados:
 - **Documentação**: [Onde foi documentado]
 ```
 
-## 📄 Relatório de Validação
+## 📄 Salvamento do Relatório de Validação
 
-Crie `./.sessions/<ISSUE-ID>/check-report.md`:
+**PRIORIDADE 1: Usar MCP (Model Context Protocol)**
+
+- Leia `ai.properties.md` do orchestrator para identificar o `task_management_system`
+- Use o MCP apropriado para adicionar o relatório à issue:
+  - Adicione como comentário na issue
+  - Atualize labels/tags conforme resultado (ex: "validated", "needs-adjustment", "blocked")
+  - Se houver conflitos críticos, atualize status da issue
+- Informe ao usuário: "✅ Relatório de validação adicionado à issue [ID]"
+
+**FALLBACK: Criar arquivo .md apenas se MCP falhar**
+
+Se o MCP não estiver disponível ou falhar, crie `./.sessions/<ISSUE-ID>/check-report.md`:
 
 ```markdown
 # Relatório de Validação - [ISSUE-ID]
@@ -174,14 +185,17 @@ Crie `./.sessions/<ISSUE-ID>/check-report.md`:
 - [ ] Bloqueado
 ```
 
+Informe ao usuário: "⚠️ Relatório salvo localmente em .sessions/ (task manager não disponível)"
+
 ## 🚨 Ação em Caso de Conflitos
 
 Se conflitos críticos forem encontrados:
 1. 🛑 **PARE** o processo atual
 2. 📝 **DOCUMENTE** todos os conflitos
 3. 💬 **ALERTE** o usuário e stakeholders
-4. 🔄 **AJUSTE** o plano/implementação conforme necessário
-5. ✅ **REVALIDE** após ajustes
+4. **Via MCP**: Atualize status da issue para "Bloqueado" ou "Requer Ajustes"
+5. 🔄 **AJUSTE** o plano/implementação conforme necessário
+6. ✅ **REVALIDE** após ajustes
 
 ---
 

package/templates/commands/products/collect.md

@@ -6,7 +6,7 @@ Você é um especialista em produto responsável por coletar e documentar novas
 
 **Este comando é APENAS para planejamento e documentação:**
 - ✅ Coletar e entender requisitos
-- ✅ Criar issue no task manager (se configurado)
+- ✅ Criar issue no task manager via MCP
 - ✅ Fazer perguntas de esclarecimento
 - ❌ **NÃO implementar código**
 - ❌ **NÃO fazer edits em arquivos de código**
@@ -18,13 +18,13 @@ Você é um especialista em produto responsável por coletar e documentar novas
 ## Contexto do Projeto
 
 Antes de iniciar, carregue o contexto consultando:
-- `context-manifest.json` - Estrutura do projeto
-- `specs/business/` - Contexto de negócio (se disponível)
-- `specs/technical/` - Contexto técnico (se disponível)
+- `context-manifest.json` do orchestrator - Estrutura do projeto
+- Repositório de MetaSpecs (definido no manifest) - Leia os arquivos `index.md` como referência
+- `README.md` dos repositórios envolvidos
 
 ## Seu Objetivo
 
-Entender a solicitação do usuário e capturá-la como issue para refinamento posterior.
+Entender a solicitação do usuário e capturá-la como issue no task manager (via MCP).
 
 **Nesta fase, você NÃO precisa:**
 - ❌ Escrever especificação completa
@@ -80,13 +80,29 @@ Apenas certifique-se de que a ideia esteja **adequadamente compreendida**.
    - Faça ajustes conforme feedback
    - Obtenha aprovação final
 
-4. **Salvamento**
-   - **Se task manager estiver configurado**:
-     - Use o MCP apropriado para criar a issue (ex: Linear, Jira)
-     - Todos os dados ficam no task manager
-   - **Se não houver task manager**:
-     - Crie arquivo em `./.sessions/<ISSUE-ID>/collect.md`
-     - Inclua data, tipo e conteúdo completo
+4. **Salvamento da Issue**
+
+   **PRIORIDADE 1: Usar MCP (Model Context Protocol)**
+   
+   Verifique se há MCP configurado para task manager:
+   - Leia `ai.properties.md` do orchestrator para identificar o `task_management_system`
+   - Se `task_management_system=jira`: Use MCP do Jira para criar a issue
+   - Se `task_management_system=linear`: Use MCP do Linear para criar a issue
+   - Se `task_management_system=github`: Use MCP do GitHub para criar a issue
+   
+   **Ao usar MCP:**
+   - Crie a issue diretamente no task manager
+   - Obtenha o ID da issue criada (ex: FIN-123, LIN-456)
+   - Informe ao usuário: "✅ Issue [ID] criada no [task manager]"
+   - **NÃO crie arquivo .md**
+   
+   **FALLBACK: Criar arquivo .md apenas se MCP falhar**
+   
+   Se o MCP não estiver disponível ou falhar:
+   - Crie arquivo em `./.sessions/<ISSUE-ID>/collect.md`
+   - Use formato de ID manual: `LOCAL-001`, `LOCAL-002`, etc.
+   - Inclua data, tipo e conteúdo completo
+   - Informe ao usuário: "⚠️ Issue salva localmente em .sessions/ (task manager não disponível)"
 
 ## Perguntas de Esclarecimento
 

package/templates/commands/products/refine.md

@@ -28,11 +28,19 @@ Refinar a issue coletada, esclarecendo:
 
 ### 1. Carregar Issue
 
-**Se task manager configurado**:
-- Leia a issue usando o MCP apropriado
+**PRIORIDADE 1: Usar MCP (Model Context Protocol)**
+
+- Leia `ai.properties.md` do orchestrator para identificar o `task_management_system`
+- Use o MCP apropriado para buscar a issue:
+  - `task_management_system=jira`: Use MCP do Jira
+  - `task_management_system=linear`: Use MCP do Linear
+  - `task_management_system=github`: Use MCP do GitHub
+- Carregue todos os dados da issue (título, descrição, labels, etc.)
+
+**FALLBACK: Se MCP não estiver disponível ou falhar**
 
-**Senão**:
 - Leia `./.sessions/<ISSUE-ID>/collect.md`
+- Se o arquivo não existir, informe o erro ao usuário
 
 ### 2. Análise de Escopo
 
@@ -110,9 +118,19 @@ Forneça estimativa de esforço:
 
 Liste perguntas que ainda precisam ser respondidas antes de iniciar a implementação.
 
-## 📄 Documentação do Refinamento
+## 📄 Salvamento do Refinamento
+
+**PRIORIDADE 1: Atualizar via MCP**
 
-Crie/atualize `./.sessions/<ISSUE-ID>/refine.md`:
+- Use o MCP do task manager para atualizar a issue
+- Adicione os critérios de aceitação como comentário ou campo customizado
+- Atualize labels/tags se necessário (ex: "refined", "ready-for-spec")
+- Adicione estimativa se o task manager suportar
+- Informe ao usuário: "✅ Issue [ID] atualizada com refinamento"
+
+**FALLBACK: Criar arquivo .md apenas se MCP falhar**
+
+Se o MCP não estiver disponível ou falhar, crie/atualize `./.sessions/<ISSUE-ID>/refine.md`:
 
 ```markdown
 # [Título da Issue] - Refinamento
@@ -153,6 +171,8 @@ Crie/atualize `./.sessions/<ISSUE-ID>/refine.md`:
 - [Risco 2 e mitigação]
 ```
 
+Informe ao usuário: "⚠️ Refinamento salvo localmente em .sessions/ (task manager não disponível)"
+
 ## 🔍 Validação
 
 Valide o refinamento contra:

package/templates/commands/products/spec.md

@@ -203,12 +203,20 @@ Justificativa: [Por que ficam para depois]
 
 ## 📄 Salvamento do PRD
 
-**Se task manager configurado**:
-- Adicione o PRD como comentário na issue
-- Ou anexe como arquivo
+**PRIORIDADE 1: Usar MCP (Model Context Protocol)**
 
-**Senão**:
+- Leia `ai.properties.md` do orchestrator para identificar o `task_management_system`
+- Use o MCP apropriado para atualizar a issue com o PRD:
+  - Adicione o PRD completo como comentário na issue
+  - Ou anexe como arquivo (se o task manager suportar)
+  - Atualize status/labels (ex: "spec-ready", "ready-for-dev")
+- Informe ao usuário: "✅ PRD adicionado à issue [ID]"
+
+**FALLBACK: Criar arquivo .md apenas se MCP falhar**
+
+Se o MCP não estiver disponível ou falhar:
 - Salve em `./.sessions/<ISSUE-ID>/prd.md`
+- Informe ao usuário: "⚠️ PRD salvo localmente em .sessions/ (task manager não disponível)"
 
 ## 🔍 Revisão e Aprovação
 
@@ -216,7 +224,8 @@ Antes de finalizar:
 1. Revise o PRD com stakeholders
 2. Valide contra metaspecs (se disponíveis)
 3. Obtenha aprovação para iniciar implementação
-4. Atualize a issue no task manager com status "Pronto para Desenvolvimento"
+4. **Via MCP**: Atualize a issue no task manager com status "Pronto para Desenvolvimento"
+5. **Fallback**: Documente aprovação em `./.sessions/<ISSUE-ID>/prd.md`
 
 ---
 

package/templates/commands/warm-up.md

@@ -7,51 +7,64 @@ Este comando prepara o ambiente carregando o contexto completo do projeto e do w
 Verifique se você está dentro de um workspace criado pelo `context-cli`:
 
 ```bash
-# Procurar pelo arquivo .workspace.json no diretório atual ou pais
+# Verificar se está em um diretório de workspace
 pwd
-ls -la .workspace.json 2>/dev/null || echo "Não está em um workspace"
+# O workspace geralmente está em ~/workspaces/<ISSUE-ID>/
 ```
 
-Se não estiver em um workspace, pergunte ao usuário qual workspace usar ou se deve criar um novo.
+Se não estiver em um workspace, pergunte ao usuário qual workspace usar ou se deve criar um novo com `feature:start`.
 
-## 2. Carregar Configuração do Orchestrator
+## 2. Carregar Configuração do Projeto
 
-Leia o arquivo `.workspace.json` para identificar:
-- Issue ID do workspace
-- Repositórios incluídos neste workspace
-- Data de criação e última atualização
+Identifique o orchestrator do projeto:
 
-## 3. Carregar Metaspecs (se disponíveis)
+1. **Procure o arquivo `.contextrc.json`** em qualquer um dos repositórios do workspace
+2. Este arquivo contém a URL do repositório orchestrator
+3. Se o orchestrator ainda não estiver clonado localmente, clone-o
 
-Navegue até o diretório do orchestrator (geralmente `../.context-orchestrator/`) e leia:
+## 3. Carregar Manifesto do Projeto
 
-1. **Manifesto do Projeto**: `context-manifest.json`
-   - Entenda a estrutura de repositórios
-   - Identifique dependências entre repos
+Leia o `context-manifest.json` do orchestrator para entender:
+- Lista completa de repositórios do ecossistema
+- URL do repositório de MetaSpecs
+- Dependências entre repositórios
+- Roles de cada repositório (application, library, service, specs-provider)
 
-2. **Índices de Documentação** (se existirem):
-   - `specs/business/index.md` - Contexto de negócio
-   - `specs/technical/index.md` - Contexto técnico
-   - `README.md` - Visão geral do projeto
+## 4. Carregar MetaSpecs
 
-3. **Especificações Core** (se existirem):
-   - `specs/business/PRODUCT_STRATEGY.md` - Estratégia do produto
-   - `specs/technical/meta/intent.md` - Objetivos e constraints
-   - `specs/technical/meta/stack.md` - Stack tecnológica e ADRs
+O repositório de MetaSpecs está definido no `context-manifest.json` (geralmente com `role: "specs-provider"`).
 
-## 4. Contexto dos Repositórios
+**Leia sempre os arquivos de índice primeiro:**
 
-Para cada repositório no workspace, leia:
-- `README.md` - Entenda o propósito do repositório
-- `package.json` ou arquivo equivalente - Identifique dependências e scripts
+1. **`README.md`** - Visão geral do projeto e estrutura de documentação
+2. **`index.md`** (na raiz ou em subpastas) - Índice de especificações disponíveis
 
-## 5. Navegação Inteligente
+**Use os índices como referência** para navegar até as especificações específicas que você precisa. Não assuma que arquivos específicos existem - sempre consulte os índices primeiro.
+
+## 5. Carregar Sessão Atual (se existir)
+
+Verifique se existe uma sessão salva para este workspace:
+
+```bash
+# Procurar por sessão no orchestrator
+ls -la .sessions/<ISSUE-ID>/ 2>/dev/null
+```
+
+Se existir, leia os arquivos de sessão para recuperar o contexto da última execução.
+
+## 6. Contexto dos Repositórios
+
+Para cada repositório presente no workspace, leia:
+- `README.md` - Propósito e visão geral do repositório
+- Arquivo de configuração principal (`package.json`, `pom.xml`, `requirements.txt`, etc.)
+
+## 7. Navegação Inteligente
 
 - **Código**: Use ferramentas de busca (glob, grep) para localizar arquivos relevantes
-- **Documentação**: Use os índices carregados para encontrar especificações
+- **Documentação**: Use os índices dos MetaSpecs como referência
 - **Aguarde Instruções**: NÃO leia outros arquivos agora. Aguarde o próximo comando.
 
-## 6. Princípio Jidoka (Parar ao Detectar Problemas)
+## 8. Princípio Jidoka (Parar ao Detectar Problemas)
 
 Se detectar desalinhamento, conflitos ou problemas:
 1. 🛑 **PARE** imediatamente