@onion-architect-ai/cli 4.1.0-beta.3 → 4.1.0-beta.5

package/templates/.cursor/commands/product/spec.md

@@ -0,0 +1,107 @@
+---
+name: spec
+description: Criar especificação de produto a partir de requisitos iniciais.
+model: sonnet
+category: product
+tags: [specification, requirements, product]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: business
+---
+
+Você é um especialista em produto encarregado de ajudar um humano a levar um requisito de issue ao seu estágio final para prepará-lo para desenvolvimento.
+
+Seu objetivo é pegar um requisito inicial, entender profundamente seus requisitos,
+
+1. Validar os requisitos atuais
+
+Revise os requisitos que foram dados a você e valide que eles contêm todas as informações básicas necessárias, que incluem:
+
+- POR QUE estamos fazendo isso
+- O QUE está sendo construído
+- COMO está sendo construído -- menos importante que os outros, mas é bom ter uma noção disso
+
+Se os requisitos iniciais não forem suficientes para continuarmos a um PRD, peça ao usuário perguntas de esclarecimento e atualize o documento/issue de requisitos antes de prosseguirmos. Não assuma nada, apenas pergunte.
+
+2. Verifique as META SPECS do projeto para identificar se há alguma regra específica a seguir ou se esta solicitação viola uma spec principal. Se violar, peça esclarecimento. Só prossiga se o usuário pedir.
+
+3. Construa seu entendimento sobre os elementos-chave do PRD:
+
+- Visão Geral do Produto
+    - Declaração do problema e oportunidade de mercado
+    - Usuários-alvo e personas
+    - Visão e objetivos do produto
+    - Métricas de sucesso e KPIs
+
+- Requisitos Funcionais
+    - Funcionalidades e capacidades principais
+    - User stories ou casos de uso
+    - Fluxos de usuário e interações
+    - Especificações técnicas
+    - Requisitos de API (se aplicável)
+
+- Requisitos Não-Funcionais
+    - Benchmarks de performance
+    - Necessidades de segurança e compliance
+    - Requisitos de escalabilidade
+    - Padrões de acessibilidade
+
+- Design e Experiência do Usuário
+    - Diretrizes de UI/UX
+    - Wireframes ou mockups
+    - Referências do sistema de design
+    - Considerações específicas da plataforma
+
+- Considerações Técnicas
+    - Visão geral da arquitetura
+    - Requisitos de integração
+    - Requisitos de dados
+    - Dependências de terceiros
+
+- Detalhes do Projeto
+    - Riscos e estratégias de mitigação
+    - Critérios de lançamento e plano de rollout
+
+- Restrições e Suposições
+    - Restrições técnicas
+    - Restrições de negócio
+    - Principais suposições sendo feitas
+
+Não pense demais nisso. Se a issue não requer alguns destes itens, sinta-se livre para pulá-los. Menos é mais. Mas sem perder detalhes importantes.
+
+4. Apresente seu entendimento ao usuário, junto com quaisquer esclarecimentos que precisar. Iterate sobre isso até ter 100% de clareza.
+
+5. Depois que o usuário aprovar sua visão, você deve editar o documento de requisitos, issue ou arquivo, aprimorando-o com o que foi descoberto.
+
+
+O requisito para analisar é:
+<requirement>
+#$ARGUMENTS
+</requirement>
+
+---
+
+## 🚀 Próximos Passos
+
+Agora que você criou uma especificação, considere:
+
+1. **Estimar complexidade da feature**:
+   ```bash
+   /business/estimate "sua-feature"
+   ```
+   Use o framework de story points para dimensionar o esforço necessário.
+
+2. **Criar task no gerenciador**:
+   ```bash
+   /business/task "sua-feature"
+   ```
+   Converte a spec em task rastreável com story points e critérios de aceitação.
+
+3. **Iniciar desenvolvimento**:
+   ```bash
+   /technical/start "sua-feature"
+   ```
+   Cria sessão de desenvolvimento, branch git e plano técnico.
+
+💡 **Dica**: Use `@story-points-specialist` para estimativas mais precisas e `@product-agent` para validar sua especificação.

package/templates/.cursor/commands/product/task-check.md

@@ -0,0 +1,340 @@
+---
+name: task-check
+description: Verificar se task do ClickUp foi implementada no código.
+model: sonnet
+category: product
+tags: [verification, implementation, audit]
+version: "4.0.0"
+updated: "2025-12-20"
+level: intermediate
+context: business
+---
+
+# 🔎 Verificação de Implementação de Task ClickUp
+
+Você é um especialista em validação técnica encarregado de verificar se uma task do ClickUp foi **realmente implementada** no projeto atual. Seu papel é fazer uma auditoria prática comparando o que foi solicitado na task vs o que existe no código/projeto atual.
+
+## 🎯 **Objetivo Principal**
+
+Realizar uma **verificação factual e técnica** para determinar se:
+- ✅ A task foi **completamente implementada**
+- ⚠️ A task foi **parcialmente implementada** 
+- ❌ A task **não foi implementada**
+- 🚀 A task está **pronta para próxima fase**
+
+## 📋 **Processo de Verificação**
+
+### **1. Carregamento e Análise da Task**
+- Carregue a task do ClickUp usando o ID fornecido
+- Extraia **todos os requisitos específicos** da descrição
+- Identifique **critérios de aceitação** mensuráveis
+- Mapeie **arquivos/componentes** que deveriam ser afetados
+- Analise **subtasks** e dependências se aplicável
+
+### **2. Auditoria do Projeto Atual**
+- Examine a estrutura atual do projeto
+- Identifique **arquivos modificados** relacionados à task
+- Verifique **funcionalidades implementadas**
+- Analise **testes** criados/atualizados
+- Examine **documentação** adicionada/modificada
+
+### **3. Comparação Detalhada**
+Para cada requisito da task, verifique:
+
+#### **📝 Requisitos Funcionais**
+- ✅/❌ Funcionalidade X implementada
+- ✅/❌ Comportamento Y funcionando
+- ✅/❌ Regra de negócio Z aplicada
+- ✅/❌ Interface/API criada
+
+#### **🏗️ Requisitos Técnicos**
+- ✅/❌ Arquivos criados/modificados
+- ✅/❌ Componentes desenvolvidos
+- ✅/❌ Integração funcionando
+- ✅/❌ Performance adequada
+
+#### **🧪 Requisitos de Qualidade**
+- ✅/❌ Testes unitários criados
+- ✅/❌ Testes de integração funcionando
+- ✅/❌ Documentação atualizada
+- ✅/❌ Code review realizado
+
+### **4. Análise de Código Específica**
+Execute verificações práticas:
+- **Buscar por arquivos** relacionados à funcionalidade
+- **Analisar commits** recentes relevantes
+- **Verificar imports/exports** novos
+- **Testar funcionalidades** quando possível
+- **Validar configurações** adicionadas
+
+### **5. Identificação de Gaps**
+Liste especificamente:
+- **O que está faltando** para completar a task
+- **O que foi feito além** do solicitado
+- **O que foi feito diferente** do especificado
+- **Problemas encontrados** na implementação
+
+## 📊 **Formato de Saída**
+
+```markdown
+# 🔍 VERIFICAÇÃO DE IMPLEMENTAÇÃO - [NOME DA TASK]
+
+**Task ID**: [ID_CLICKUP]  
+**Data da Verificação**: [DATA_ATUAL]  
+**Status Verificado**: [IMPLEMENTADA/PARCIAL/NÃO_IMPLEMENTADA/PRONTA_PARA_PRÓXIMA_FASE]
+
+---
+
+## 📋 **Resumo da Task**
+
+**Descrição**: [Breve resumo do que a task solicita]  
+**Critérios de Aceitação**: [Lista dos critérios principais]  
+**Arquivos/Componentes Esperados**: [Lista do que deveria ser criado/modificado]
+
+---
+
+## ✅ **Implementação Verificada**
+
+### **Funcionalidades Completas**
+- ✅ [Funcionalidade 1] - Implementada em `caminho/arquivo.ext`
+- ✅ [Funcionalidade 2] - Implementada em `caminho/arquivo.ext`
+- ✅ [Funcionalidade 3] - Implementada em `caminho/arquivo.ext`
+
+### **Arquivos Criados/Modificados**
+- ✅ `src/components/NovoComponente.tsx` - Criado conforme especificação
+- ✅ `src/services/novoService.ts` - Implementado com todas as funções
+- ✅ `docs/nova-feature.md` - Documentação adicionada
+
+### **Testes Implementados**
+- ✅ `__tests__/novoComponente.test.tsx` - Testes unitários completos
+- ✅ `e2e/nova-feature.spec.ts` - Testes E2E funcionando
+
+---
+
+## ⚠️ **Implementação Parcial**
+
+### **Funcionalidades Incompletas**
+- ⚠️ [Funcionalidade X] - 70% implementada, falta [detalhe específico]
+- ⚠️ [Funcionalidade Y] - Interface criada, mas lógica de negócio pendente
+
+### **Gaps Identificados**
+- ❌ Validação de formulário não implementada
+- ❌ Tratamento de erro em API calls faltando
+- ❌ Responsividade mobile não testada
+
+---
+
+## ❌ **Não Implementado**
+
+### **Funcionalidades Ausentes**
+- ❌ [Funcionalidade Z] - Não encontrada no projeto
+- ❌ [Integração W] - Não implementada
+
+### **Arquivos Faltantes**
+- ❌ `src/types/novos-tipos.ts` - Definições de tipo pendentes
+- ❌ `src/utils/helper-functions.ts` - Utilitários não criados
+
+---
+
+## 🔍 **Evidências Técnicas**
+
+### **Análise de Código**
+```typescript
+// Evidência 1: Funcionalidade implementada
+// Arquivo: src/components/Example.tsx
+export const NovoComponente = () => {
+  // Implementação encontrada...
+}
+```
+
+### **Commits Relacionados**
+- `abc123d` - feat: adiciona novo componente conforme task
+- `def456e` - test: adiciona testes para nova funcionalidade
+- `ghi789f` - docs: atualiza documentação da feature
+
+### **Configurações Verificadas**
+- ✅ `package.json` - Dependências adicionadas
+- ✅ `tsconfig.json` - Paths configurados
+- ✅ `.env.example` - Variáveis documentadas
+
+---
+
+## 🚀 **Avaliação de Prontidão**
+
+### **Para Próxima Fase**
+**Status**: ✅ PRONTA / ⚠️ QUASE PRONTA / ❌ NÃO PRONTA
+
+**Justificativa**: 
+[Explicação baseada na análise se pode avançar para próxima fase]
+
+**Bloqueadores**:
+- [Lista de itens que impedem o avanço]
+
+**Recomendações**:
+- [Ações específicas para resolver gaps]
+
+---
+
+## 📝 **Próximas Ações Recomendadas**
+
+### **Para Completar a Task** ⚠️
+1. **[AÇÃO_CRÍTICA]** - [Descrição específica e arquivos envolvidos]
+2. **[AÇÃO_IMPORTANTE]** - [Descrição específica e arquivos envolvidos]
+3. **[AÇÃO_COMPLEMENTAR]** - [Descrição específica e arquivos envolvidos]
+
+### **Para Próxima Fase** 🚀
+1. **[PREPARAÇÃO_1]** - [O que fazer antes de iniciar próxima fase]
+2. **[PREPARAÇÃO_2]** - [Validações necessárias]
+3. **[PREPARAÇÃO_3]** - [Documentação/comunicação]
+
+---
+
+## 📈 **Métricas de Completude**
+
+**Funcionalidades**: [X/Y] (Z% completa)  
+**Testes**: [X/Y] (Z% cobertura estimada)  
+**Documentação**: [X/Y] (Z% completa)  
+**Qualidade**: [ALTA/MÉDIA/BAIXA]
+
+**Score Geral**: [0-100]% implementado
+
+---
+
+## 🔄 **Recomendação Final**
+
+**Decisão**: ✅ APROVAR CONCLUSÃO / ⚠️ REQUER AJUSTES / ❌ REFAZER / 🚀 AVANÇAR PARA PRÓXIMA FASE
+
+**Justificativa**: [Explicação da decisão baseada na verificação técnica]
+
+**Próximo Passo**: [Ação específica recomendada]
+
+---
+
+**Verificado por**: Sistema de Verificação Onion  
+**Método**: Auditoria técnica completa do projeto atual  
+**Confiabilidade**: [ALTA/MÉDIA/BAIXA] baseada na evidência encontrada
+```
+
+## 🛠️ **Instruções de Uso**
+
+Execute o comando fornecendo o ID da task ClickUp:
+
+```bash
+/product/task-check 86abzwx0w
+```
+
+O sistema irá:
+1. **Carregar** a task do ClickUp automaticamente
+2. **Analisar** todos os requisitos e critérios
+3. **Auditar** o projeto atual buscando implementação
+4. **Comparar** o solicitado vs implementado
+5. **Verificar** evidências técnicas no código
+6. **Determinar** se está pronto para próxima fase
+7. **Recomendar** ações específicas
+
+---
+
+## 🎯 **Diferencial vs /product/validate-task**
+
+| Aspecto | `/product/validate-task` | `/product/task-check` |
+|---------|-------------------------|----------------------|
+| **Foco** | Análise estratégica | Verificação técnica |
+| **Objetivo** | Validar requisitos | Auditar implementação |
+| **Método** | Conceitual | Baseado em evidência |
+| **Saída** | Recomendações | Status factual |
+| **Quando usar** | Antes de implementar | Após implementar |
+
+---
+
+## 📚 **Casos de Uso**
+
+### **Scenario 1: Task Alegadamente Concluída**
+- Verificar se foi realmente implementada
+- Validar qualidade da implementação
+- Determinar se pode fechar a task
+
+### **Scenario 2: Preparação para Próxima Fase**
+- Garantir que prerequisites foram atendidos
+- Identificar dependências resolvidas
+- Validar base sólida para avanço
+
+### **Scenario 3: Auditoria de Qualidade**
+- Verificar aderência aos critérios
+- Identificar gaps de implementação
+- Garantir padrões de código
+
+### **Scenario 4: Debug de Problemas**
+- Investigar por que funcionalidade não funciona
+- Identificar o que está faltando
+- Propor correções específicas
+
+---
+
+## 🔄 **Auto-Update ClickUp**
+
+Este comando **automaticamente atualiza** a task ClickUp quando executa:
+
+### **✅ Updates Automáticos SEMPRE:**
+- **Comentário de verificação** com resultados detalhados usando formatação Unicode
+- **Tag 'verified'** se verificação passou completamente
+- **Tag 'needs-work'** se há gaps críticos identificados
+- **Atualização do notes.md** da sessão com timestamp e resultados
+
+### **⚠️ Confirmação Necessária PARA:**
+- **Mudança de status para 'Done'** quando verificação indica 100% completo
+- **Mudança de prioridade** se análise indica urgência diferente
+- **Quebra em subtasks** se escopo for muito complexo
+- **Reatribuição** se detectar que precisa de skills diferentes
+
+### **📋 Identificação da Task:**
+1. **Sessão ativa**: Usa task-id do arquivo `.cursor/sessions/*/context.md`
+2. **Argumento fornecido**: Usa task-id passado pelo usuário  
+3. **Não identificada**: Pergunta ao usuário qual task verificar
+
+### **💬 Formato do Comentário Automático:**
+```
+🔍 VERIFICAÇÃO DE IMPLEMENTAÇÃO
+
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 RESULTADO DA VERIFICAÇÃO:
+   ∟ Status: [IMPLEMENTADA/PARCIAL/NÃO_IMPLEMENTADA]
+   ∟ Completude: [X]%
+   ∟ Arquivos verificados: [N] arquivos
+
+✅ IMPLEMENTADO:
+   ∟ [Lista do que foi encontrado implementado]
+
+⚠️ PENDENTE:
+   ∟ [Lista do que ainda falta]
+
+🎯 PRÓXIMOS PASSOS:
+   ∟ [Ações específicas recomendadas]
+
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+⏰ Verificado: [TIMESTAMP] | 🤖 Sistema de Verificação Onion
+```
+
+## 🔗 **Integração com Sistema Onion**
+
+Este comando se integra perfeitamente com:
+- **`/product/task <description>`**: Para criar tasks com workflow completo
+- **`/engineer/start <slug>`**: Para iniciar desenvolvimento
+- **`/product/validate-task <task-id>`**: Para análise estratégica
+- **Sessions em `.cursor/sessions/`**: Utiliza contexto das sessões ativas
+
+### **📁 Uso da Sessão Ativa**
+Se existir uma sessão ativa em `.cursor/sessions/` relacionada à task:
+- Analise o arquivo `context.md` para entender o escopo original
+- Examine `architecture.md` para validar implementação vs design
+- Consulte `plan.md` para verificar progresso das fases
+- Atualize `notes.md` com resultados da verificação
+
+---
+
+**Agora proceda com a verificação técnica da task fornecida:**
+
+<task_id>
+#$ARGUMENTS
+</task_id>