context-first-cli 1.0.0 → 1.1.0

package/templates/commands/products/refine.md

@@ -0,0 +1,182 @@
+# Refinamento de Requisitos
+
+Este comando refina uma issue coletada, transformando-a em requisitos claros e validados.
+
+## ⚠️ IMPORTANTE: Este Comando NÃO Implementa Código
+
+Este comando é para refinamento de requisitos, não implementação.
+
+**Próximo passo**: `/spec [ISSUE-ID]` para criar a especificação completa (PRD).
+
+---
+
+## 📋 Pré-requisitos
+
+- Issue já coletada via `/collect`
+- Contexto do projeto carregado (execute `/warm-up` se necessário)
+
+## 🎯 Objetivo
+
+Refinar a issue coletada, esclarecendo:
+- Escopo exato (o que entra e o que não entra)
+- Critérios de aceitação claros
+- Impacto em cada repositório
+- Dependências técnicas
+- Riscos e restrições
+
+## 📝 Processo de Refinamento
+
+### 1. Carregar Issue
+
+**Se task manager configurado**:
+- Leia a issue usando o MCP apropriado
+
+**Senão**:
+- Leia `./.context-sessions/<ISSUE-ID>/collect.md`
+
+### 2. Análise de Escopo
+
+Defina claramente:
+
+**O que ESTÁ no escopo**:
+- Funcionalidades específicas a serem implementadas
+- Repositórios que serão modificados
+- Integrações necessárias
+
+**O que NÃO ESTÁ no escopo**:
+- Funcionalidades relacionadas mas que ficam para depois
+- Otimizações futuras
+- Features "nice to have"
+
+### 3. Critérios de Aceitação
+
+Defina critérios mensuráveis e testáveis:
+
+```markdown
+## Critérios de Aceitação
+
+### Funcional
+- [ ] [Critério 1 - específico e testável]
+- [ ] [Critério 2 - específico e testável]
+
+### Técnico
+- [ ] [Critério técnico 1]
+- [ ] [Critério técnico 2]
+
+### Qualidade
+- [ ] Testes unitários implementados
+- [ ] Testes de integração implementados
+- [ ] Documentação atualizada
+```
+
+### 4. Análise de Impacto
+
+Para cada repositório afetado:
+
+```markdown
+## Impacto por Repositório
+
+### <repo-1>
+- **Componentes afetados**: [lista]
+- **Tipo de mudança**: Nova feature / Modificação / Refatoração
+- **Complexidade estimada**: Baixa / Média / Alta
+- **Riscos**: [riscos específicos]
+
+### <repo-2>
+- **Componentes afetados**: [lista]
+- **Tipo de mudança**: Nova feature / Modificação / Refatoração
+- **Complexidade estimada**: Baixa / Média / Alta
+- **Riscos**: [riscos específicos]
+```
+
+### 5. Dependências e Restrições
+
+Identifique:
+- Dependências entre repositórios
+- Dependências de outras features/issues
+- Restrições técnicas
+- Restrições de negócio
+- Bloqueadores conhecidos
+
+### 6. Estimativa Inicial
+
+Forneça estimativa de esforço:
+- **Pequeno**: < 1 dia
+- **Médio**: 1-3 dias
+- **Grande**: 3-5 dias
+- **Muito Grande**: > 5 dias (considere quebrar em issues menores)
+
+### 7. Perguntas Pendentes
+
+Liste perguntas que ainda precisam ser respondidas antes de iniciar a implementação.
+
+## 📄 Documentação do Refinamento
+
+Crie/atualize `./.context-sessions/<ISSUE-ID>/refine.md`:
+
+```markdown
+# [Título da Issue] - Refinamento
+
+## Escopo
+
+### Incluído
+- [Item 1]
+- [Item 2]
+
+### Excluído
+- [Item 1]
+- [Item 2]
+
+## Critérios de Aceitação
+[Conforme seção 3 acima]
+
+## Impacto por Repositório
+[Conforme seção 4 acima]
+
+## Dependências
+- [Dependência 1]
+- [Dependência 2]
+
+## Restrições
+- [Restrição 1]
+- [Restrição 2]
+
+## Estimativa
+[Pequeno/Médio/Grande/Muito Grande] - [Justificativa]
+
+## Perguntas Pendentes
+1. [Pergunta 1]
+2. [Pergunta 2]
+
+## Riscos Identificados
+- [Risco 1 e mitigação]
+- [Risco 2 e mitigação]
+```
+
+## 🔍 Validação
+
+Valide o refinamento contra:
+- Estratégia do produto (se documentada)
+- Arquitetura técnica (se documentada)
+- Capacidade do time
+- Prioridades do roadmap
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Passo
+
+Após refinamento aprovado:
+
+```bash
+/spec [ISSUE-ID]
+```
+
+Este comando criará a especificação completa (PRD) da feature.

package/templates/commands/products/spec.md

@@ -0,0 +1,239 @@
+# Criação de Especificação (PRD)
+
+Este comando cria a especificação completa (Product Requirements Document) da feature.
+
+## ⚠️ IMPORTANTE: Este Comando NÃO Implementa Código
+
+Este comando é para documentação de requisitos, não implementação.
+
+**Próximo passo**: `/start` para iniciar o desenvolvimento.
+
+---
+
+## 📋 Pré-requisitos
+
+- Issue refinada via `/refine`
+- Contexto do projeto carregado
+- Aprovação para prosseguir com a feature
+
+## 🎯 Objetivo
+
+Criar um PRD completo que servirá como fonte única de verdade para a implementação.
+
+## 📝 Estrutura do PRD
+
+### 1. Visão Geral
+
+```markdown
+# [Título da Feature]
+
+## Contexto
+[Por que estamos construindo isso? Qual problema resolve?]
+
+## Objetivo
+[O que queremos alcançar com esta feature?]
+
+## Métricas de Sucesso
+- [Métrica 1]: [Como medir]
+- [Métrica 2]: [Como medir]
+```
+
+### 2. Requisitos Funcionais
+
+```markdown
+## Requisitos Funcionais
+
+### RF-01: [Nome do Requisito]
+**Descrição**: [Descrição detalhada]
+**Prioridade**: Must Have / Should Have / Could Have
+**Repositórios**: [repos afetados]
+
+### RF-02: [Nome do Requisito]
+**Descrição**: [Descrição detalhada]
+**Prioridade**: Must Have / Should Have / Could Have
+**Repositórios**: [repos afetados]
+```
+
+### 3. Requisitos Não-Funcionais
+
+```markdown
+## Requisitos Não-Funcionais
+
+### Performance
+- [Requisito de performance]
+
+### Segurança
+- [Requisito de segurança]
+
+### Acessibilidade
+- [Requisito de acessibilidade]
+
+### Escalabilidade
+- [Requisito de escalabilidade]
+```
+
+### 4. Fluxos de Usuário
+
+```markdown
+## Fluxos de Usuário
+
+### Fluxo Principal
+1. [Passo 1]
+2. [Passo 2]
+3. [Passo 3]
+
+### Fluxos Alternativos
+**Cenário**: [Nome do cenário]
+1. [Passo 1]
+2. [Passo 2]
+
+### Tratamento de Erros
+**Erro**: [Tipo de erro]
+**Comportamento**: [Como o sistema deve reagir]
+```
+
+### 5. Especificação Técnica
+
+```markdown
+## Especificação Técnica
+
+### Arquitetura
+
+#### <repo-1>
+- **Componentes novos**: [lista]
+- **Componentes modificados**: [lista]
+- **APIs**: [endpoints novos/modificados]
+
+#### <repo-2>
+- **Componentes novos**: [lista]
+- **Componentes modificados**: [lista]
+- **APIs**: [endpoints novos/modificados]
+
+### Integrações
+- **Entre repos**: [como os repos se comunicam]
+- **Externas**: [APIs externas, se houver]
+
+### Modelo de Dados
+[Descreva mudanças no modelo de dados, se houver]
+```
+
+### 6. Critérios de Aceitação
+
+```markdown
+## Critérios de Aceitação
+
+### Funcional
+- [ ] [Critério específico e testável]
+- [ ] [Critério específico e testável]
+
+### Técnico
+- [ ] Testes unitários com cobertura >= X%
+- [ ] Testes de integração implementados
+- [ ] Performance dentro dos requisitos
+- [ ] Documentação atualizada
+
+### Qualidade
+- [ ] Code review aprovado
+- [ ] Sem regressões
+- [ ] Acessibilidade validada
+```
+
+### 7. Fora do Escopo
+
+```markdown
+## Fora do Escopo
+
+Funcionalidades que NÃO serão implementadas nesta versão:
+- [Item 1]
+- [Item 2]
+
+Justificativa: [Por que ficam para depois]
+```
+
+### 8. Riscos e Mitigações
+
+```markdown
+## Riscos e Mitigações
+
+### Risco 1: [Descrição]
+- **Probabilidade**: Alta / Média / Baixa
+- **Impacto**: Alto / Médio / Baixo
+- **Mitigação**: [Como mitigar]
+
+### Risco 2: [Descrição]
+- **Probabilidade**: Alta / Média / Baixa
+- **Impacto**: Alto / Médio / Baixo
+- **Mitigação**: [Como mitigar]
+```
+
+### 9. Dependências
+
+```markdown
+## Dependências
+
+### Técnicas
+- [Dependência técnica 1]
+- [Dependência técnica 2]
+
+### De Negócio
+- [Dependência de negócio 1]
+- [Dependência de negócio 2]
+
+### Bloqueadores
+- [Bloqueador 1 e plano para resolver]
+```
+
+### 10. Plano de Testes
+
+```markdown
+## Plano de Testes
+
+### Testes Unitários
+- [Área 1 a ser testada]
+- [Área 2 a ser testada]
+
+### Testes de Integração
+- [Cenário 1]
+- [Cenário 2]
+
+### Testes Manuais
+- [Cenário 1]
+- [Cenário 2]
+```
+
+## 📄 Salvamento do PRD
+
+**Se task manager configurado**:
+- Adicione o PRD como comentário na issue
+- Ou anexe como arquivo
+
+**Senão**:
+- Salve em `./.context-sessions/<ISSUE-ID>/prd.md`
+
+## 🔍 Revisão e Aprovação
+
+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"
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Passo
+
+Após aprovação do PRD:
+
+```bash
+/start
+```
+
+Este comando iniciará o desenvolvimento da feature.

package/templates/commands/warm-up.md

@@ -0,0 +1,65 @@
+# Aquecimento - Carregamento de Contexto
+
+Este comando prepara o ambiente carregando o contexto completo do projeto e do workspace atual.
+
+## 1. Identificar Workspace Atual
+
+Verifique se você está dentro de um workspace criado pelo `context-cli`:
+
+```bash
+# Procurar pelo arquivo .workspace.json no diretório atual ou pais
+pwd
+ls -la .workspace.json 2>/dev/null || echo "Não está em um workspace"
+```
+
+Se não estiver em um workspace, pergunte ao usuário qual workspace usar ou se deve criar um novo.
+
+## 2. Carregar Configuração do Orchestrator
+
+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
+
+## 3. Carregar Metaspecs (se disponíveis)
+
+Navegue até o diretório do orchestrator (geralmente `../.context-orchestrator/`) e leia:
+
+1. **Manifesto do Projeto**: `context-manifest.json`
+   - Entenda a estrutura de repositórios
+   - Identifique dependências entre repos
+
+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
+
+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
+
+## 4. Contexto dos Repositórios
+
+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
+
+## 5. 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
+- **Aguarde Instruções**: NÃO leia outros arquivos agora. Aguarde o próximo comando.
+
+## 6. Princípio Jidoka (Parar ao Detectar Problemas)
+
+Se detectar desalinhamento, conflitos ou problemas:
+1. 🛑 **PARE** imediatamente
+2. 📝 **DOCUMENTE** o problema encontrado
+3. 💬 **ALERTE** o usuário antes de prosseguir
+
+---
+
+**Argumentos fornecidos**: #$ARGUMENTS
+
+**Status**: Contexto carregado. Aguardando próximo comando.