context-first-cli 1.8.2 → 2.0.0

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

@@ -0,0 +1,222 @@
+# 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 é APENAS para refinamento de requisitos:**
+- ✅ Refinar e validar requisitos
+- ✅ Atualizar issue no task manager via MCP
+- ✅ **LER** arquivos dos repositórios principais (read-only)
+- ❌ **NÃO implementar código**
+- ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
+
+**Próximo passo**: `/spec [ISSUE-ID]` para criar a especificação completa (PRD).
+
+---
+
+## 📋 Pré-requisitos
+
+- Issue já coletada via `/collect`
+- Contexto do projeto será carregado automaticamente (veja seção "Carregar MetaSpecs" abaixo)
+
+## 🎯 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
+
+**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**
+
+- Leia `./.sessions/<ISSUE-ID>/collect.md`
+- Se o arquivo não existir, informe o erro ao usuário
+
+### 2. Carregar MetaSpecs
+
+**Localizar MetaSpecs automaticamente**:
+1. Leia `context-manifest.json` do orchestrator
+2. Encontre o repositório com `"role": "metaspecs"`
+3. Leia `ai.properties.md` para obter o `base_path`
+4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
+5. Leia os arquivos `index.md` relevantes para entender:
+   - Arquitetura do sistema
+   - Padrões de design
+   - Restrições técnicas
+   - Convenções do projeto
+
+### 3. 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"
+
+### 4. 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
+```
+
+### 5. 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]
+```
+
+### 6. 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
+
+### 7. 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)
+
+### 8. Perguntas Pendentes
+
+Liste perguntas que ainda precisam ser respondidas antes de iniciar a implementação.
+
+## 📄 Salvamento do Refinamento
+
+**PRIORIDADE 1: Atualizar via MCP**
+
+- 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
+
+## 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]
+```
+
+Informe ao usuário: "⚠️ Refinamento salvo localmente em .sessions/ (task manager não disponível)"
+
+## 🔍 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/pt-BR/products/spec.md

@@ -0,0 +1,267 @@
+# 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 é APENAS para documentação de requisitos:**
+- ✅ Criar PRD (Product Requirements Document)
+- ✅ Atualizar issue no task manager via MCP
+- ✅ **LER** arquivos dos repositórios principais (read-only)
+- ❌ **NÃO implementar código**
+- ❌ **NÃO fazer edits em arquivos de código**
+- ❌ **NÃO fazer checkout de branches nos repositórios principais**
+- ❌ **NÃO fazer commits**
+
+**Próximo passo**: `/start` para iniciar o desenvolvimento.
+
+---
+
+## 📋 Pré-requisitos
+
+- Issue refinada via `/refine`
+- Aprovação para prosseguir com a feature
+
+## 📚 Carregar MetaSpecs
+
+**Localizar MetaSpecs automaticamente**:
+1. Leia `context-manifest.json` do orchestrator
+2. Encontre o repositório com `"role": "metaspecs"`
+3. Leia `ai.properties.md` para obter o `base_path`
+4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
+5. Leia os arquivos `index.md` relevantes para garantir conformidade com:
+   - Arquitetura do sistema
+   - Padrões de design
+   - Restrições técnicas
+   - Convenções do projeto
+
+## 🎯 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
+
+**PRIORIDADE 1: Usar MCP (Model Context Protocol)**
+
+- 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
+
+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. **Via MCP**: Atualize a issue no task manager com status "Pronto para Desenvolvimento"
+5. **Fallback**: Documente aprovação em `./.sessions/<ISSUE-ID>/prd.md`
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Passo
+
+Após aprovação do PRD:
+
+```bash
+/start
+```
+
+Este comando iniciará o desenvolvimento da feature.

package/templates/commands/pt-BR/quality/metrics.md

@@ -0,0 +1,240 @@
+# Métricas de Qualidade
+
+Este comando coleta e analisa métricas de qualidade do código e do processo de desenvolvimento.
+
+## 🎯 Objetivo
+
+Medir e documentar a qualidade da implementação através de métricas objetivas:
+- Cobertura de testes
+- Complexidade do código
+- Dívida técnica
+- Performance
+- Conformidade com padrões
+
+## 📋 Pré-requisitos
+
+- Implementação concluída (após `/work`)
+- Testes implementados
+- Build funcionando
+
+## 📊 Métricas a Coletar
+
+### 1. Cobertura de Testes
+
+Para cada repositório modificado:
+
+```bash
+cd <repositório>
+
+# Executar testes com cobertura
+npm run test:coverage  # ou comando equivalente
+
+# Capturar resultados
+```
+
+Documente:
+```markdown
+## Cobertura de Testes
+
+### <repo-1>
+- **Cobertura Total**: X%
+- **Statements**: X%
+- **Branches**: X%
+- **Functions**: X%
+- **Lines**: X%
+- **Arquivos não cobertos**: [lista]
+
+### <repo-2>
+[Mesmo formato]
+```
+
+### 2. Complexidade do Código
+
+Analise a complexidade ciclomática dos arquivos modificados:
+
+```markdown
+## Complexidade do Código
+
+### Arquivos com Alta Complexidade
+- **arquivo1.ts**: Complexidade 15 (recomendado: < 10)
+- **arquivo2.ts**: Complexidade 12
+
+### Recomendações
+- [Sugestão de refatoração 1]
+- [Sugestão de refatoração 2]
+```
+
+### 3. Qualidade do Código
+
+```bash
+# Executar linting
+npm run lint
+
+# Verificar formatação
+npm run format:check
+
+# Análise estática (se disponível)
+npm run analyze
+```
+
+Documente:
+```markdown
+## Qualidade do Código
+
+### Linting
+- **Erros**: 0
+- **Warnings**: X
+- **Warnings Justificados**: [lista com justificativas]
+
+### Formatação
+- **Status**: ✅ Conforme / ⚠️ Ajustes necessários
+
+### Análise Estática
+- **Problemas Críticos**: 0
+- **Problemas Médios**: X
+- **Problemas Baixos**: Y
+```
+
+### 4. Performance
+
+Se aplicável, meça performance:
+
+```markdown
+## Performance
+
+### Benchmarks
+- **Operação X**: Yms (baseline: Zms)
+- **Operação Y**: Yms (baseline: Zms)
+
+### Otimizações Aplicadas
+- [Otimização 1 e impacto]
+- [Otimização 2 e impacto]
+
+### Gargalos Identificados
+- [Gargalo 1 e plano de mitigação]
+```
+
+### 5. Tamanho e Impacto
+
+```markdown
+## Tamanho e Impacto
+
+### Linhas de Código
+- **Adicionadas**: +X linhas
+- **Removidas**: -Y linhas
+- **Modificadas**: Z linhas
+
+### Arquivos
+- **Novos**: X arquivos
+- **Modificados**: Y arquivos
+- **Removidos**: Z arquivos
+
+### Dependências
+- **Novas dependências**: [lista]
+- **Tamanho do bundle**: +X KB
+```
+
+### 6. Dívida Técnica
+
+Identifique dívida técnica introduzida ou resolvida:
+
+```markdown
+## Dívida Técnica
+
+### Dívida Introduzida
+- **Item 1**: [Descrição e justificativa]
+  - Severidade: Alta / Média / Baixa
+  - Plano de resolução: [quando e como resolver]
+
+### Dívida Resolvida
+- **Item 1**: [O que foi resolvido]
+  - Impacto: [melhoria obtida]
+```
+
+## 📄 Relatório de Métricas
+
+Crie `./.sessions/<ISSUE-ID>/metrics.md`:
+
+```markdown
+# Relatório de Métricas - [ISSUE-ID]
+
+**Data**: [data/hora]
+**Repositórios**: [lista]
+
+## Resumo Executivo
+
+- **Cobertura de Testes**: X% (meta: Y%)
+- **Qualidade do Código**: ✅ / ⚠️ / ❌
+- **Performance**: ✅ / ⚠️ / ❌
+- **Dívida Técnica**: Baixa / Média / Alta
+
+## Métricas Detalhadas
+
+[Incluir todas as seções acima]
+
+## Comparação com Baseline
+
+| Métrica | Antes | Depois | Variação |
+|---------|-------|--------|----------|
+| Cobertura | X% | Y% | +Z% |
+| Complexidade Média | X | Y | +Z |
+| Bundle Size | X KB | Y KB | +Z KB |
+
+## Ações Recomendadas
+
+1. [Ação 1 - prioridade alta]
+2. [Ação 2 - prioridade média]
+3. [Ação 3 - prioridade baixa]
+
+## Aprovação para Merge
+
+- [ ] Cobertura de testes >= meta
+- [ ] Sem problemas críticos de qualidade
+- [ ] Performance dentro dos requisitos
+- [ ] Dívida técnica documentada e aprovada
+```
+
+## 🎯 Metas de Qualidade
+
+Se o projeto tiver metas definidas nas metaspecs, valide:
+
+```markdown
+## Validação contra Metas
+
+### Metas do Projeto
+- **Cobertura mínima**: 80%
+- **Complexidade máxima**: 10
+- **Performance**: < 100ms
+
+### Status
+- Cobertura: ✅ 85% (meta: 80%)
+- Complexidade: ⚠️ 12 (meta: 10) - Justificado
+- Performance: ✅ 85ms (meta: 100ms)
+```
+
+## 🚨 Alertas
+
+Se alguma métrica estiver fora do aceitável:
+1. 🛑 **DOCUMENTE** o problema
+2. 💬 **ALERTE** o usuário
+3. 🔧 **PROPONHA** ações corretivas
+4. ⏸️ **CONSIDERE** bloquear o merge até resolução
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Resultado
+
+Após executar este comando, você terá:
+- Relatório completo de métricas
+- Comparação com baseline e metas
+- Identificação de problemas de qualidade
+- Recomendações de ações
+- Base objetiva para aprovação de merge