context-first-cli 1.0.0 → 1.1.0

package/templates/commands/engineer/plan.md

@@ -0,0 +1,251 @@
+# Planejamento Técnico
+
+Este comando cria o plano técnico detalhado para implementação da feature.
+
+## 📋 Pré-requisitos
+
+- PRD criado via `/spec`
+- Análise inicial feita via `/start`
+- Contexto técnico carregado
+
+## 🎯 Objetivo
+
+Criar um plano técnico detalhado que guiará a implementação, dividindo o trabalho em unidades menores e sequenciais.
+
+## 📝 Estrutura do Plano
+
+### 1. Visão Geral Técnica
+
+```markdown
+# Plano Técnico - [Título da Feature]
+
+## Resumo
+[Breve descrição técnica do que será implementado]
+
+## Repositórios Envolvidos
+- **<repo-1>**: [Papel nesta feature]
+- **<repo-2>**: [Papel nesta feature]
+
+## Abordagem Técnica
+[Estratégia geral de implementação]
+```
+
+### 2. Arquitetura da Solução
+
+```markdown
+## Arquitetura
+
+### Diagrama de Componentes
+[Descrição textual ou ASCII art dos componentes e suas relações]
+
+### Fluxo de Dados
+1. [Passo 1 do fluxo]
+2. [Passo 2 do fluxo]
+3. [Passo 3 do fluxo]
+
+### Integrações
+- **<repo-1> → <repo-2>**: [Como se comunicam]
+- **Sistema → API Externa**: [Se houver]
+```
+
+### 3. Decisões Técnicas
+
+```markdown
+## Decisões Técnicas
+
+### Decisão 1: [Título]
+**Contexto**: [Por que precisamos decidir isso]
+**Opções consideradas**:
+- Opção A: [Prós e contras]
+- Opção B: [Prós e contras]
+**Decisão**: [Opção escolhida]
+**Justificativa**: [Por que escolhemos esta opção]
+
+### Decisão 2: [Título]
+[Mesmo formato acima]
+```
+
+### 4. Plano de Implementação
+
+Divida o trabalho em unidades pequenas e sequenciais:
+
+```markdown
+## Plano de Implementação
+
+### Fase 1: [Nome da Fase]
+**Objetivo**: [O que será alcançado nesta fase]
+**Repositórios**: [repos afetados]
+
+#### Tarefa 1.1: [Descrição]
+- **Repo**: <repo-1>
+- **Arquivos**: [arquivos a criar/modificar]
+- **Descrição**: [O que fazer]
+- **Testes**: [Testes a implementar]
+- **Estimativa**: [tempo estimado]
+
+#### Tarefa 1.2: [Descrição]
+- **Repo**: <repo-2>
+- **Arquivos**: [arquivos a criar/modificar]
+- **Descrição**: [O que fazer]
+- **Testes**: [Testes a implementar]
+- **Estimativa**: [tempo estimado]
+
+### Fase 2: [Nome da Fase]
+[Mesmo formato acima]
+
+### Fase 3: [Nome da Fase]
+[Mesmo formato acima]
+```
+
+### 5. Estrutura de Arquivos
+
+Para cada repositório, defina a estrutura:
+
+```markdown
+## Estrutura de Arquivos
+
+### <repo-1>
+```
+src/
+├── components/
+│   ├── NewComponent.tsx (CRIAR)
+│   └── ExistingComponent.tsx (MODIFICAR)
+├── services/
+│   └── NewService.ts (CRIAR)
+└── tests/
+    └── NewComponent.test.tsx (CRIAR)
+```
+
+### <repo-2>
+```
+src/
+├── controllers/
+│   └── NewController.ts (CRIAR)
+└── tests/
+    └── NewController.test.ts (CRIAR)
+```
+```
+
+### 6. APIs e Contratos
+
+```markdown
+## APIs e Contratos
+
+### Endpoints Novos
+
+#### POST /api/resource
+**Request**:
+```json
+{
+  "field1": "string",
+  "field2": "number"
+}
+```
+
+**Response**:
+```json
+{
+  "id": "string",
+  "status": "string"
+}
+```
+
+### Endpoints Modificados
+
+#### GET /api/resource/:id
+**Mudanças**: [O que muda]
+**Breaking Change**: Sim / Não
+```
+
+### 7. Estratégia de Testes
+
+```markdown
+## Estratégia de Testes
+
+### Testes Unitários
+- **<repo-1>**: [Componentes/funções a testar]
+- **<repo-2>**: [Componentes/funções a testar]
+
+### Testes de Integração
+- **Cenário 1**: [Descrição e repos envolvidos]
+- **Cenário 2**: [Descrição e repos envolvidos]
+
+### Testes E2E (se aplicável)
+- **Fluxo 1**: [Descrição]
+- **Fluxo 2**: [Descrição]
+```
+
+### 8. Riscos Técnicos
+
+```markdown
+## Riscos Técnicos
+
+### Risco 1: [Descrição]
+- **Impacto**: Alto / Médio / Baixo
+- **Probabilidade**: Alta / Média / Baixa
+- **Mitigação**: [Como mitigar]
+- **Plano B**: [Alternativa se ocorrer]
+
+### Risco 2: [Descrição]
+[Mesmo formato acima]
+```
+
+### 9. Checklist de Implementação
+
+```markdown
+## Checklist de Implementação
+
+### Fase 1
+- [ ] Tarefa 1.1
+- [ ] Tarefa 1.2
+- [ ] Testes da Fase 1
+
+### Fase 2
+- [ ] Tarefa 2.1
+- [ ] Tarefa 2.2
+- [ ] Testes da Fase 2
+
+### Fase 3
+- [ ] Tarefa 3.1
+- [ ] Tarefa 3.2
+- [ ] Testes da Fase 3
+
+### Finalização
+- [ ] Documentação atualizada
+- [ ] Code review
+- [ ] Testes de integração
+- [ ] PR criado
+```
+
+## 📄 Salvamento do Plano
+
+Salve em `./.context-sessions/<ISSUE-ID>/plan.md`
+
+## 🔍 Revisão
+
+Revise o plano verificando:
+- Todas as tarefas estão claras e executáveis
+- Dependências entre tarefas estão identificadas
+- Estimativas são realistas
+- Riscos foram considerados
+- Estratégia de testes é adequada
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximo Passo
+
+Após aprovação do plano:
+
+```bash
+/work
+```
+
+Este comando iniciará a execução da primeira unidade de trabalho do plano.

package/templates/commands/engineer/pr.md

@@ -0,0 +1,167 @@
+# Criação de Pull Request
+
+Este comando cria Pull Requests para todos os repositórios modificados no workspace.
+
+## 📋 Pré-requisitos
+
+Antes de criar PRs, certifique-se de que:
+- Executou `/pre-pr` e todas as validações passaram
+- Todos os commits foram feitos
+- Todos os testes estão passando
+- A documentação está atualizada
+
+## 🎯 Processo de Criação de PRs
+
+### 1. Identificar Repositórios Modificados
+
+Para cada repositório no workspace, verifique:
+```bash
+cd <repositório>
+git status
+git log origin/main..HEAD  # Ver commits não pushados
+```
+
+### 2. Push das Branches
+
+Para cada repositório modificado:
+```bash
+cd <repositório>
+git push origin <branch-name>
+```
+
+### 3. Criar Pull Requests
+
+Para cada repositório, crie um PR usando o GitHub CLI ou interface web:
+
+**Usando GitHub CLI**:
+```bash
+cd <repositório>
+gh pr create --title "[ISSUE-ID] Título da Feature" \
+  --body "$(cat ../.context-sessions/<ISSUE-ID>/pr-description.md)" \
+  --base main
+```
+
+**Template de Descrição do PR**:
+
+```markdown
+## 🎯 Objetivo
+
+[Breve descrição do que esta PR faz]
+
+## 📝 Mudanças
+
+### Repositório: <nome-do-repo>
+
+- [Mudança 1]
+- [Mudança 2]
+- [Mudança 3]
+
+## 🔗 Relacionamentos
+
+- **Issue**: <ISSUE-ID>
+- **PRs Relacionados**: 
+  - <repo-1>#<PR-number>
+  - <repo-2>#<PR-number>
+
+## ✅ Checklist
+
+- [ ] Código implementado e testado
+- [ ] Testes unitários adicionados/atualizados
+- [ ] Testes de integração passando
+- [ ] Documentação atualizada
+- [ ] Sem breaking changes (ou documentados)
+- [ ] Revisado por pares (após criação do PR)
+
+## 🧪 Como Testar
+
+1. [Passo 1]
+2. [Passo 2]
+3. [Resultado esperado]
+
+## 📸 Screenshots/Demos
+
+[Se aplicável, adicione screenshots ou links para demos]
+
+## 🔍 Notas para Revisores
+
+- [Ponto de atenção 1]
+- [Ponto de atenção 2]
+```
+
+### 4. Vincular PRs
+
+Se houver múltiplos PRs (um por repositório):
+- Adicione links cruzados entre os PRs
+- Documente a ordem de merge recomendada
+- Indique dependências entre PRs
+
+### 5. Atualizar Issue no Task Manager
+
+Se task manager estiver configurado:
+- Mova a issue para "Em Revisão" ou "PR Aberto"
+- Adicione links dos PRs na issue
+- Adicione comentário com resumo das mudanças
+
+### 6. Documentação da Sessão
+
+Atualize `./.context-sessions/<ISSUE-ID>/pr.md`:
+
+```markdown
+# [Título da Feature] - Pull Requests
+
+## PRs Criados
+
+### <repo-1>
+- **Link**: <URL do PR>
+- **Status**: Aberto
+- **Commits**: X commits
+
+### <repo-2>
+- **Link**: <URL do PR>
+- **Status**: Aberto
+- **Commits**: Y commits
+
+## Ordem de Merge Recomendada
+
+1. <repo-1> - [Justificativa]
+2. <repo-2> - [Justificativa]
+
+## Notas para Merge
+
+- [Nota importante 1]
+- [Nota importante 2]
+```
+
+## 🔍 Checklist Final
+
+Antes de solicitar revisão:
+- [ ] Todos os PRs criados
+- [ ] Descrições completas e claras
+- [ ] PRs vinculados entre si
+- [ ] Issue atualizada no task manager
+- [ ] Testes passando em CI/CD
+- [ ] Documentação da sessão completa
+
+## 📢 Comunicação
+
+Notifique o time sobre os PRs:
+- Mencione revisores relevantes
+- Destaque mudanças críticas ou breaking changes
+- Indique urgência se aplicável
+
+---
+
+**Argumentos fornecidos**:
+
+```
+#$ARGUMENTS
+```
+
+---
+
+## 🎯 Próximos Passos
+
+1. Aguardar revisão dos PRs
+2. Responder comentários e fazer ajustes
+3. Após aprovação, fazer merge na ordem recomendada
+4. Executar `context-cli feature:end <ISSUE-ID>` para limpar o workspace

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