context-first-cli 1.0.0 → 1.1.0

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

@@ -0,0 +1,262 @@
+# Preparação para Pull Request
+
+Este comando valida que tudo está pronto para criar Pull Requests.
+
+## 📋 Pré-requisitos
+
+- Implementação completa (todas as tarefas do `/plan` executadas)
+- Todos os commits realizados
+- Workspace limpo e organizado
+
+## 🎯 Objetivo
+
+Garantir que a implementação está completa, testada e pronta para revisão antes de criar os PRs.
+
+## ✅ Checklist de Validação
+
+### 1. Completude da Implementação
+
+```markdown
+## Verificação de Completude
+
+- [ ] Todas as tarefas do plano foram executadas
+- [ ] Todos os requisitos funcionais do PRD foram implementados
+- [ ] Todos os critérios de aceitação foram atendidos
+- [ ] Nenhuma funcionalidade ficou pela metade
+```
+
+### 2. Qualidade do Código
+
+Para cada repositório modificado:
+
+```bash
+cd <repositório>
+
+# Verificar status
+git status
+
+# Verificar linting
+npm run lint  # ou comando equivalente
+
+# Verificar formatação
+npm run format:check  # ou comando equivalente
+
+# Verificar build
+npm run build  # ou comando equivalente
+```
+
+Checklist:
+```markdown
+## Qualidade do Código
+
+### <repo-1>
+- [ ] Linting sem erros
+- [ ] Formatação correta
+- [ ] Build sem erros
+- [ ] Sem warnings críticos
+
+### <repo-2>
+- [ ] Linting sem erros
+- [ ] Formatação correta
+- [ ] Build sem erros
+- [ ] Sem warnings críticos
+```
+
+### 3. Testes
+
+Para cada repositório:
+
+```bash
+cd <repositório>
+
+# Executar testes unitários
+npm run test:unit  # ou comando equivalente
+
+# Executar testes de integração
+npm run test:integration  # ou comando equivalente
+
+# Verificar cobertura
+npm run test:coverage  # ou comando equivalente
+```
+
+Checklist:
+```markdown
+## Testes
+
+### <repo-1>
+- [ ] Todos os testes unitários passando
+- [ ] Todos os testes de integração passando
+- [ ] Cobertura de testes adequada (>= X%)
+- [ ] Novos testes adicionados para novas funcionalidades
+
+### <repo-2>
+- [ ] Todos os testes unitários passando
+- [ ] Todos os testes de integração passando
+- [ ] Cobertura de testes adequada (>= X%)
+- [ ] Novos testes adicionados para novas funcionalidades
+```
+
+### 4. Documentação
+
+```markdown
+## Documentação
+
+- [ ] README atualizado (se necessário)
+- [ ] Comentários de código adequados
+- [ ] Documentação de APIs atualizada (se houver mudanças)
+- [ ] Changelog atualizado
+- [ ] Documentação técnica atualizada nas metaspecs (se aplicável)
+```
+
+### 5. Commits
+
+```markdown
+## Commits
+
+- [ ] Todos os commits têm mensagens claras e descritivas
+- [ ] Commits seguem o padrão do projeto (conventional commits, etc.)
+- [ ] Não há commits com mensagens genéricas ("fix", "update", etc.)
+- [ ] Commits estão organizados logicamente
+- [ ] Não há commits de debug ou temporários
+```
+
+### 6. Sincronização
+
+```markdown
+## Sincronização
+
+- [ ] Branches estão atualizadas com a branch base (main/develop)
+- [ ] Não há conflitos de merge
+- [ ] Mudanças entre repositórios estão sincronizadas
+- [ ] Dependências entre repos foram testadas
+```
+
+### 7. Segurança
+
+```markdown
+## Segurança
+
+- [ ] Não há credenciais ou secrets no código
+- [ ] Não há dados sensíveis em logs
+- [ ] Dependências de segurança foram verificadas
+- [ ] Não há vulnerabilidades conhecidas introduzidas
+```
+
+### 8. Performance
+
+```markdown
+## Performance
+
+- [ ] Não há regressões de performance óbvias
+- [ ] Queries/operações custosas foram otimizadas
+- [ ] Não há memory leaks introduzidos
+- [ ] Requisitos de performance do PRD foram atendidos
+```
+
+## 🔍 Validação Cruzada
+
+Se múltiplos repositórios foram modificados:
+
+```markdown
+## Validação Cruzada
+
+- [ ] Testei a integração entre os repositórios localmente
+- [ ] APIs/contratos entre repos estão consistentes
+- [ ] Não há breaking changes não documentados
+- [ ] Ordem de deploy/merge está clara
+```
+
+## 📄 Preparação da Descrição do PR
+
+Crie `./.context-sessions/<ISSUE-ID>/pr-description.md`:
+
+```markdown
+## 🎯 Objetivo
+[Breve descrição do que esta feature faz]
+
+## 📝 Mudanças Principais
+- [Mudança 1]
+- [Mudança 2]
+- [Mudança 3]
+
+## 🔗 Links
+- **Issue**: [ISSUE-ID]
+- **PRD**: [link ou caminho]
+- **Plano Técnico**: [link ou caminho]
+
+## ✅ Checklist
+- [x] Código implementado e testado
+- [x] Testes unitários adicionados/atualizados
+- [x] Testes de integração passando
+- [x] Documentação atualizada
+- [x] Linting e formatação OK
+- [x] Build sem erros
+
+## 🧪 Como Testar
+1. [Passo 1]
+2. [Passo 2]
+3. [Resultado esperado]
+
+## 🔍 Notas para Revisores
+- [Ponto de atenção 1]
+- [Ponto de atenção 2]
+```
+
+## 🚨 Problemas Encontrados
+
+Se alguma validação falhar:
+1. 🛑 **PARE** o processo de criação de PR
+2. 📝 **DOCUMENTE** o problema
+3. 🔧 **CORRIJA** o problema
+4. 🔄 **EXECUTE** `/pre-pr` novamente
+
+## 📊 Relatório de Validação
+
+Crie `./.context-sessions/<ISSUE-ID>/pre-pr-report.md`:
+
+```markdown
+# Relatório de Validação Pre-PR
+
+**Data**: [data/hora]
+**Issue**: [ISSUE-ID]
+
+## Status Geral
+✅ Pronto para PR / ⚠️ Pendências / ❌ Bloqueado
+
+## Repositórios Validados
+- **<repo-1>**: ✅ OK
+- **<repo-2>**: ✅ OK
+
+## Resumo de Testes
+- **Testes Unitários**: X/X passando
+- **Testes de Integração**: Y/Y passando
+- **Cobertura**: Z%
+
+## Pendências (se houver)
+- [Pendência 1]
+- [Pendência 2]
+
+## Próximos Passos
+- [x] Todas as validações passaram
+- [ ] Executar `/pr` para criar Pull Requests
+```
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Passo
+
+Se todas as validações passaram:
+
+```bash
+/pr
+```
+
+Este comando criará os Pull Requests para todos os repositórios modificados.

package/dist/templates/commands/engineer/start.md

@@ -0,0 +1,115 @@
+# Início do Desenvolvimento
+
+Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
+
+## 🎯 Contexto do Projeto
+
+Antes de iniciar, carregue o contexto consultando:
+- `context-manifest.json` - Estrutura de repositórios
+- `specs/business/index.md` - Contexto de negócio
+- `specs/technical/index.md` - Stack, arquitetura e padrões técnicos
+- `.workspace.json` - Informações do workspace atual
+
+## ⚙️ Configuração Inicial
+
+1. **Verificar Workspace**:
+   - Confirme que está no workspace correto (verifique `.workspace.json`)
+   - Liste os repositórios disponíveis no workspace
+
+2. **Verificar Branches**:
+   - Para cada repositório no workspace, verifique a branch atual
+   - Confirme que todas as branches estão sincronizadas
+
+3. **Carregar Especificação**:
+   - **Se task manager configurado**: Leia a issue usando o MCP apropriado
+   - **Senão**: Peça ao usuário o arquivo de especificação ou descrição da feature
+
+4. **Atualizar Status** (se task manager configurado):
+   - Mova a issue para "Em Progresso"
+
+## 📋 Análise e Entendimento
+
+Analise a especificação e construa entendimento completo respondendo:
+
+### Negócio
+- **Por que** isso está sendo construído?
+- **Quem** se beneficia?
+- **Qual** métrica queremos impactar?
+
+### Funcional
+- **Qual resultado esperado**? (comportamento do usuário, output do sistema)
+- **Quais componentes** serão criados/modificados em cada repositório?
+- **Quais integrações** entre repositórios são necessárias?
+
+### Técnico
+- **Stack aprovada**? Verificar contra especificações técnicas
+- **Padrões arquiteturais**? Verificar ADRs (se disponíveis)
+- **Dependências novas**? Justificar e documentar
+- **Como testar**? (conforme padrões do projeto)
+
+### Validação contra Metaspecs
+
+Se metaspecs estiverem disponíveis, validar:
+- Alinhado com estratégia e roadmap?
+- Usa stack tecnológica aprovada?
+- Respeita Architecture Decision Records?
+- Segue regras de negócio documentadas?
+
+## 🤔 Perguntas de Esclarecimento
+
+Após análise inicial, formule **3-5 clarificações mais importantes**:
+
+**Exemplos de perguntas relevantes**:
+- Qual repositório deve conter a lógica principal?
+- Como os repositórios devem se comunicar?
+- Há dependências entre as mudanças nos diferentes repos?
+- Qual a ordem de implementação recomendada?
+- Há impacto em APIs ou contratos entre serviços?
+
+## 📝 Documentação da Sessão
+
+Crie arquivo `./.context-sessions/<ISSUE-ID>/start.md` com:
+
+```markdown
+# [Título da Feature] - Início
+
+## Entendimento
+[Resumo do que será construído e por quê]
+
+## Repositórios Afetados
+- **repo-1**: [O que será feito]
+- **repo-2**: [O que será feito]
+
+## Perguntas Pendentes
+1. [Pergunta 1]
+2. [Pergunta 2]
+
+## Validações Realizadas
+- [x] Alinhado com estratégia
+- [x] Stack aprovada
+- [ ] Pendente: [algo a validar]
+
+## Próximos Passos
+1. Aguardar respostas das perguntas
+2. Executar `/plan` para planejamento técnico detalhado
+```
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Passo
+
+Após esclarecimentos e aprovação:
+
+```bash
+/plan
+```
+
+Este comando criará o planejamento técnico detalhado da implementação.

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

@@ -0,0 +1,125 @@
+# Execução do Trabalho
+
+Este comando executa uma unidade de trabalho no workspace atual, implementando parte do plano técnico.
+
+## 📋 Pré-requisitos
+
+Antes de executar, certifique-se de que:
+- Executou `/warm-up` para carregar o contexto
+- Executou `/start` e `/plan` para ter o planejamento técnico
+- Está no workspace correto (verifique `.workspace.json`)
+- Tem o arquivo `./.context-sessions/<ISSUE-ID>/plan.md` disponível
+
+## 🎯 Objetivo
+
+Implementar uma unidade de trabalho específica do plano, que pode envolver:
+- Criar novos arquivos/componentes
+- Modificar arquivos existentes
+- Adicionar testes
+- Atualizar documentação
+
+## 📝 Processo de Trabalho
+
+### 1. Identificar Unidade de Trabalho
+
+Com base no plano técnico (`./.context-sessions/<ISSUE-ID>/plan.md`), identifique:
+- Qual tarefa específica será implementada agora
+- Em qual(is) repositório(s) do workspace
+- Quais arquivos serão criados/modificados
+- Dependências com outras tarefas
+
+### 2. Implementação
+
+Execute a implementação seguindo:
+- **Padrões do projeto**: Consulte guias de estilo e arquitetura
+- **Stack aprovada**: Use apenas tecnologias documentadas nas metaspecs
+- **Testes**: Implemente testes conforme padrões do projeto
+- **Documentação**: Atualize comentários e docs quando necessário
+
+### 3. Validação Local
+
+Antes de commitar:
+- Execute testes unitários/integração
+- Verifique linting e formatação
+- Confirme que não quebrou funcionalidades existentes
+
+### 4. Commit
+
+Para cada repositório modificado:
+
+```bash
+cd <repositório>
+git add .
+git commit -m "tipo: descrição concisa
+
+- Detalhe 1
+- Detalhe 2
+
+Refs: <ISSUE-ID>"
+```
+
+**Tipos de commit**: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
+
+### 5. Documentação da Sessão
+
+Atualize `./.context-sessions/<ISSUE-ID>/work.md`:
+
+```markdown
+# [Título da Feature] - Trabalho Executado
+
+## [Data/Hora] - [Descrição da Unidade]
+
+### Repositórios Modificados
+- **repo-1**: [Arquivos modificados e o que foi feito]
+- **repo-2**: [Arquivos modificados e o que foi feito]
+
+### Decisões Tomadas
+- [Decisão 1 e justificativa]
+- [Decisão 2 e justificativa]
+
+### Testes Adicionados
+- [Descrição dos testes]
+
+### Próxima Unidade
+- [O que será feito a seguir]
+```
+
+## 🔍 Checklist de Qualidade
+
+Antes de considerar a unidade completa:
+- [ ] Código implementado e testado
+- [ ] Testes passando
+- [ ] Linting/formatação OK
+- [ ] Documentação atualizada (se necessário)
+- [ ] Commit realizado em todos os repos afetados
+- [ ] Sessão documentada
+
+## ⚠️ Princípio Jidoka
+
+Se encontrar problemas durante a implementação:
+1. 🛑 **PARE** a implementação
+2. 📝 **DOCUMENTE** o problema encontrado
+3. 💬 **ALERTE** o usuário e discuta soluções
+4. 🔄 **AJUSTE** o plano se necessário
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximos Passos
+
+- **Continuar implementação**: Execute `/work` novamente para próxima unidade
+- **Finalizar feature**: Quando tudo estiver implementado, execute `/pre-pr`
+
+## 💡 Dicas
+
+- Trabalhe em unidades pequenas e incrementais
+- Commit frequentemente (atomic commits)
+- Documente decisões importantes na sessão
+- Mantenha os repositórios sincronizados entre si

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

@@ -0,0 +1,201 @@
+# Validação contra Metaspecs
+
+Este comando valida requisitos, decisões ou implementações contra as metaspecs do projeto.
+
+## 🎯 Objetivo
+
+Garantir alinhamento com:
+- Estratégia de produto
+- Arquitetura técnica
+- Padrões e convenções
+- ADRs (Architecture Decision Records)
+
+## 📋 Quando Usar
+
+Execute este comando:
+- Após `/spec` - validar PRD
+- Após `/plan` - validar plano técnico
+- Durante `/work` - validar decisões de implementação
+- Antes de `/pr` - validação final
+
+## 🔍 Processo de Validação
+
+### 1. Identificar Metaspecs Disponíveis
+
+Navegue até o diretório do orchestrator e identifique quais metaspecs existem:
+
+```bash
+ls -la ../.context-orchestrator/specs/
+```
+
+### 2. Validação de Negócio
+
+Se existirem metaspecs de negócio (`specs/business/`):
+
+```markdown
+## Validação de Negócio
+
+### Estratégia de Produto
+- **Arquivo**: `specs/business/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`
+- **Validação**: [Atende a persona correta?]
+- **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
+- **Notas**: [Observações]
+
+### Métricas
+- **Arquivo**: `specs/business/PRODUCT_METRICS.md`
+- **Validação**: [Métrica de sucesso está documentada?]
+- **Status**: ✅ Alinhado / ⚠️ Parcialmente / ❌ Desalinhado
+- **Notas**: [Observações]
+```
+
+### 3. Validação Técnica
+
+Se existirem metaspecs técnicas (`specs/technical/`):
+
+```markdown
+## Validação Técnica
+
+### Stack Tecnológica
+- **Arquivo**: `specs/technical/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`
+- **Validação**: [Segue padrões arquiteturais?]
+- **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
+- **Notas**: [Observações]
+
+### ADRs (Architecture Decision Records)
+- **Diretório**: `specs/technical/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`
+- **Validação**: [Implementa regras de negócio corretamente?]
+- **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
+- **Notas**: [Observações]
+```
+
+### 4. Validação de Padrões
+
+```markdown
+## Validação de Padrões
+
+### Código
+- **Arquivo**: `specs/technical/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`
+- **Validação**: [Estratégia de testes adequada?]
+- **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
+
+### Documentação
+- **Arquivo**: `specs/technical/DOC_STANDARDS.md`
+- **Validação**: [Documentação adequada?]
+- **Status**: ✅ Conforme / ⚠️ Parcialmente / ❌ Não conforme
+```
+
+### 5. Identificação de Conflitos
+
+Se houver conflitos ou desalinhamentos:
+
+```markdown
+## Conflitos Identificados
+
+### Conflito 1: [Descrição]
+- **Severidade**: Crítico / Alto / Médio / Baixo
+- **Metaspec**: [Arquivo que está sendo violado]
+- **Descrição**: [Detalhe do conflito]
+- **Recomendação**: [Como resolver]
+
+### Conflito 2: [Descrição]
+[Mesmo formato acima]
+```
+
+### 6. Exceções Justificadas
+
+Se houver desvios justificados:
+
+```markdown
+## Exceções Justificadas
+
+### Exceção 1: [Descrição]
+- **Metaspec**: [Arquivo que está sendo desviado]
+- **Desvio**: [O que está diferente]
+- **Justificativa**: [Por que é necessário]
+- **Aprovação**: [Quem aprovou]
+- **Documentação**: [Onde foi documentado]
+```
+
+## 📄 Relatório de Validação
+
+Crie `./.context-sessions/<ISSUE-ID>/check-report.md`:
+
+```markdown
+# Relatório de Validação - [ISSUE-ID]
+
+**Data**: [data/hora]
+**Fase**: [spec/plan/work/pre-pr]
+
+## Status Geral
+✅ Validado / ⚠️ Validado com ressalvas / ❌ Não validado
+
+## Validações Realizadas
+- Negócio: ✅ / ⚠️ / ❌
+- Técnica: ✅ / ⚠️ / ❌
+- Padrões: ✅ / ⚠️ / ❌
+
+## Conflitos
+[Lista de conflitos, se houver]
+
+## Exceções
+[Lista de exceções justificadas, se houver]
+
+## Recomendações
+1. [Recomendação 1]
+2. [Recomendação 2]
+
+## Aprovação
+- [ ] Aprovado para prosseguir
+- [ ] Requer ajustes
+- [ ] Bloqueado
+```
+
+## 🚨 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
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Resultado
+
+Após validação:
+- Se ✅: Prossiga para próxima fase
+- Se ⚠️: Documente ressalvas e prossiga com aprovação
+- Se ❌: Corrija conflitos antes de prosseguir