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

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

@@ -0,0 +1,294 @@
+---
+name: validate-task
+description: Validar e analisar task existente do ClickUp.
+model: sonnet
+category: product
+tags: [validation, clickup, analysis]
+version: "4.0.0"
+updated: "2025-12-20"
+level: intermediate
+context: business
+---
+
+# 🔍 Validação de Task ClickUp
+
+Você é um especialista em produto e arquitetura encarregado de carregar, analisar e validar tasks existentes do ClickUp. Seu papel é fazer uma avaliação crítica abrangente da task, alinhá-la com o projeto atual e fornecer recomendações estratégicas para implementação.
+
+## 📋 **Processo de Validação**
+
+### **1. Carregamento da Task**
+- Carregue a task do ClickUp usando o ID fornecido
+- Identifique se é uma task simples, task com subtasks, ou subtask
+- Analise toda a hierarquia (task pai, subtasks, dependências)
+- Extraia informações completas: descrição, critérios de aceitação, tags, prioridade, assignees
+
+### **2. Análise de Contexto do Projeto**
+- Revise a documentação atual do projeto (README.md, docs/, meta-specs/)
+- Identifique a arquitetura, stack tecnológico e padrões estabelecidos
+- Analise comandos existentes em `.cursor/commands/` para entender workflows
+- Examine agentes especializados em `.cursor/agents/` para recursos disponíveis
+
+### **3. Avaliação Crítica da Task**
+Conduza uma análise estruturada abordando:
+
+#### **📊 Análise de Viabilidade**
+- **Clareza dos Requisitos**: A task está bem definida? Faltam informações críticas?
+- **Escopo Adequado**: O escopo é realista? Muito amplo ou muito restrito?
+- **Critérios de Aceitação**: São específicos, mensuráveis e testáveis?
+- **Dependências**: Todas as dependências foram identificadas?
+
+#### **🏗️ Alinhamento Arquitetural**
+- **Compatibilidade Técnica**: Alinha com a stack e padrões do projeto?
+- **Impacto na Arquitetura**: Requer mudanças significativas na arquitetura?
+- **Consistência**: Segue os padrões de nomenclatura e estrutura?
+- **Performance**: Impactos potenciais na performance?
+
+#### **🎯 Alinhamento Estratégico**
+- **Valor de Negócio**: Justifica o esforço de implementação?
+- **Prioridade**: Está corretamente priorizada em relação a outras tasks?
+- **Roadmap**: Se encaixa na visão de produto e roadmap?
+- **Meta-specs**: Alinha com as especificações meta do projeto?
+
+### **4. Identificação de Gaps e Riscos**
+- **Informações Faltantes**: Que dados adicionais são necessários?
+- **Riscos Técnicos**: Potenciais bloqueadores ou complexidades não identificadas?
+- **Riscos de Escopo**: Possibilidade de scope creep ou mal-entendidos?
+- **Riscos de Dependência**: Dependências externas ou bloqueantes?
+
+### **5. Coleta de Informações Adicionais**
+Formule perguntas específicas para esclarecer:
+- **Requisitos Funcionais**: Comportamentos esperados não documentados
+- **Requisitos Não-Funcionais**: Performance, segurança, escalabilidade
+- **Restrições**: Limitações técnicas, de tempo ou recursos
+- **Casos de Uso**: Cenários de uso não cobertos
+- **Integração**: Como se integra com funcionalidades existentes
+
+### **6. Sugestões de Melhoria**
+Forneça recomendações para:
+- **Refinamento da Task**: Como melhorar a definição
+- **Quebra de Escopo**: Se deve ser dividida em subtasks menores
+- **Critérios de Aceitação**: Melhorias específicas
+- **Plano de Implementação**: Sugestão de fases ou etapas
+- **Testes**: Estratégia de validação e testes
+
+## 🎯 **Formato de Saída**
+
+Após a análise, apresente um relatório estruturado no seguinte formato:
+
+```markdown
+# 📊 RELATÓRIO DE VALIDAÇÃO - [NOME DA TASK]
+
+**Task ID**: [ID_CLICKUP]  
+**Tipo**: [Task/Subtask/Task com Subtasks]  
+**Prioridade**: [PRIORIDADE_ATUAL]  
+**Status**: [STATUS_ATUAL]
+
+---
+
+## 🎯 **Resumo Executivo**
+
+[Resumo de 2-3 linhas sobre o que a task propõe e sua viabilidade geral]
+
+---
+
+## 📋 **Análise Detalhada**
+
+### ✅ **Pontos Fortes**
+- [Liste aspectos bem definidos da task]
+- [Alinhamentos com o projeto]
+- [Critérios claros]
+
+### ⚠️ **Pontos de Atenção**
+- [Áreas que precisam de clarificação]
+- [Riscos identificados]
+- [Gaps de informação]
+
+### ❌ **Problemas Críticos**
+- [Questões que impedem a implementação]
+- [Desalinhamentos com a arquitetura]
+- [Bloqueadores técnicos]
+
+---
+
+## 🏗️ **Alinhamento com o Projeto**
+
+### **Stack Tecnológico**
+- ✅/❌ Compatível com [stack_atual]
+- ✅/❌ Segue padrões estabelecidos
+- ✅/❌ Utiliza ferramentas apropriadas
+
+### **Arquitetura**
+- ✅/❌ Impacto na arquitetura: [BAIXO/MÉDIO/ALTO]
+- ✅/❌ Requer mudanças estruturais: [SIM/NÃO]
+- ✅/❌ Mantém consistência de padrões
+
+### **Integração**
+- ✅/❌ Integra bem com funcionalidades existentes
+- ✅/❌ Respeita contratos de API
+- ✅/❌ Compatível com fluxos atuais
+
+---
+
+## ❓ **Perguntas de Esclarecimento**
+
+### **Requisitos Funcionais**
+1. [Pergunta específica sobre comportamento]
+2. [Pergunta sobre casos de uso]
+3. [Pergunta sobre regras de negócio]
+
+### **Requisitos Técnicos**
+1. [Pergunta sobre performance]
+2. [Pergunta sobre integração]
+3. [Pergunta sobre dados]
+
+### **Contexto de Negócio**
+1. [Pergunta sobre prioridade]
+2. [Pergunta sobre valor]
+3. [Pergunta sobre usuários]
+
+---
+
+## 💡 **Recomendações**
+
+### **📝 Refinamento da Task**
+- [Sugestão específica para melhorar a descrição]
+- [Melhoria nos critérios de aceitação]
+- [Ajustes de escopo]
+
+### **🔧 Implementação Sugerida**
+- **Fase 1**: [Primeira etapa sugerida]
+- **Fase 2**: [Segunda etapa sugerida]
+- **Fase 3**: [Terceira etapa se necessário]
+
+### **🧪 Estratégia de Testes**
+- [Tipos de teste necessários]
+- [Cenários críticos para validar]
+- [Critérios de qualidade]
+
+### **📊 Métricas de Sucesso**
+- [KPIs para medir o sucesso]
+- [Critérios de aceitação mensuráveis]
+
+---
+
+## 🚀 **Próximos Passos Recomendados**
+
+1. **[AÇÃO_PRIORITÁRIA]** - [Descrição e justificativa]
+2. **[AÇÃO_SECUNDÁRIA]** - [Descrição e justificativa]  
+3. **[AÇÃO_TERCEIRA]** - [Descrição e justificativa]
+
+---
+
+## 📈 **Estimativa de Esforço**
+
+**Complexidade**: [BAIXA/MÉDIA/ALTA]  
+**Estimativa**: [X-Y dias/semanas]  
+**Confiança**: [BAIXA/MÉDIA/ALTA]
+
+**Justificativa**: [Explicação da estimativa baseada na análise]
+
+---
+
+**Status da Validação**: ✅ APROVADA / ⚠️ REQUER AJUSTES / ❌ NÃO RECOMENDADA  
+**Validado por**: Sistema de Validação Onion  
+**Data**: [DATA_ATUAL]
+```
+
+## 🛠️ **Instruções de Uso**
+
+Execute o comando fornecendo o ID da task ClickUp:
+
+```bash
+/product/validate-task 86abzwx0w
+```
+
+O sistema irá:
+1. Carregar automaticamente a task do ClickUp
+2. Analisar sua estrutura e conteúdo
+3. Validar contra o projeto atual
+4. Gerar relatório de validação completo
+5. Fornecer recomendações acionáveis
+
+---
+
+## 🎯 **Casos de Uso**
+
+### **Scenario 1: Task Nova**
+- Validar viabilidade antes de iniciar desenvolvimento
+- Identificar gaps de requisitos
+- Sugerir melhorias na definição
+
+### **Scenario 2: Task Problemática**
+- Analisar tasks que estão travadas
+- Identificar bloqueadores
+- Propor soluções
+
+### **Scenario 3: Task Complexa**
+- Avaliar se deve ser quebrada em subtasks
+- Definir fases de implementação
+- Mapear dependências
+
+### **Scenario 4: Review de Qualidade**
+- Validar tasks antes de hand-off para dev
+- Garantir alignment com arquitetura
+- Confirmar critérios de aceitação
+
+---
+
+## 🔄 **Auto-Update ClickUp**
+
+Este comando **automaticamente atualiza** a task ClickUp quando executa:
+
+### **✅ Updates Automáticos SEMPRE:**
+- **Comentário de validação** com análise estratégica detalhada usando formatação Unicode
+- **Tag 'validated'** após análise completa
+- **Tag 'needs-refinement'** se requisitos precisam ser melhorados
+- **Atualização do notes.md** da sessão com insights e decisões
+
+### **⚠️ Confirmação Necessária PARA:**
+- **Mudança de prioridade** baseada na análise de valor/complexidade
+- **Alteração de timeline** se análise revela maior complexidade
+- **Quebra em subtasks** se escopo for muito amplo
+- **Mudança de assignee** se requer skills específicos não disponíveis
+
+### **📋 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 validar
+
+### **💬 Formato do Comentário Automático:**
+```
+📊 VALIDAÇÃO ESTRATÉGICA
+
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎯 ANÁLISE EXECUTIVA:
+   ∟ Viabilidade: [X]/10
+   ∟ Alinhamento: [Y]/10
+   ∟ Complexidade: [BAIXA/MÉDIA/ALTA]
+   ∟ Valor de Negócio: [Z]/10
+
+✅ PONTOS FORTES:
+   ∟ [Lista dos aspectos bem definidos]
+
+⚠️ RISCOS IDENTIFICADOS:
+   ∟ [Lista dos riscos técnicos/negócio]
+
+💡 RECOMENDAÇÕES:
+   ∟ [Ações específicas para melhorar a task]
+
+🚀 STATUS VALIDAÇÃO:
+   ∟ [APROVADA/REQUER_AJUSTES/NÃO_RECOMENDADA]
+
+━━━━━━━━━━━━━━━━━━━━━━━━
+
+⏰ Validado: [TIMESTAMP] | 🤖 Sistema de Validação Onion
+```
+
+---
+
+**Agora proceda com a validação da task fornecida:**
+
+<task_id>
+#$ARGUMENTS
+</task_id>

package/templates/.cursor/commands/product/warm-up.md

@@ -0,0 +1,187 @@
+---
+name: warm-up
+description: |
+  Preparação de contexto de produto e negócio.
+  Foca em documentação de produto, especificações, knowledge bases de negócio e frameworks de produto.
+model: sonnet
+category: product
+tags: [warmup, context, product, business]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: business
+---
+
+# 🔥 Warm-up de Produto
+
+Preparação específica para trabalho de produto, negócio e gestão de features.
+
+## 🎯 Objetivo
+
+Estabelecer contexto focado em:
+- Documentação de produto e negócio
+- Especificações de features e domínios
+- Knowledge bases de produto
+- Frameworks de produto (Story Points, etc)
+- Comandos e agentes de produto
+
+## 📋 Checklist de Preparação
+
+### 1. Contexto Geral (Base)
+- ✅ Revisar `README.md` para visão geral do Sistema Onion
+- ✅ Entender estrutura de documentação em `docs/`
+
+### 2. Meta Especificações
+- ✅ Revisar `docs/meta-specs/index.md`
+- ✅ Memorizar hierarquia de especificações
+- ✅ Entender quando consultar meta specs para decisões de produto
+
+### 3. Documentação de Produto
+- ✅ Revisar `docs/onion/commands-guide.md` - Seção "Comandos de Produto"
+- ✅ Mapear comandos de produto disponíveis:
+
+**Gestão de Tasks:**
+- `/product/task` - Criar tasks com estimativas automáticas
+- `/product/feature` - Criar tasks de feature para backlog
+- `/product/collect` - Coletar ideias de features/bugs
+- `/product/task-check` - Verificar status de tasks
+- `/product/validate-task` - Validar tasks contra meta-specs
+- `/product/checklist-sync` - Sincronizar checklists
+
+**Especificação e Refinamento:**
+- `/product/spec` - Especificações técnicas
+- `/product/refine` - Refinamento de requisitos
+- `/product/estimate` - Estimar story points
+- `/product/light-arch` - Arquitetura leve
+
+**Processamento de Reuniões:**
+- `/product/extract-meeting` - Extrair insights de reuniões (Framework EXTRACT)
+- `/product/consolidate-meetings` - Consolidar múltiplas reuniões
+
+**Análise e Validação:**
+- `/product/check` - Verificar requisitos contra meta-specs
+- `/product/analyze-pain-price` - Analisar dor do cliente e precificação
+
+**Comunicação:**
+- `/product/branding` - Trabalhar em branding e posicionamento
+- `/product/presentation` - Criar apresentações
+
+**Documentação Relacionada:**
+- `/docs/consolidate-documents` - Consolidar documentos de produto/negócio
+
+### 4. Knowledge Bases de Produto
+- ✅ Revisar `docs/knowbase/frameworks/framework_story_points.md`
+- ✅ Revisar `docs/knowbase/concepts/task-manager-abstraction.md`
+- ✅ Revisar `docs/knowbase/concepts/meeting-transcription-to-knowledge-base.md`
+- ✅ Revisar `docs/knowbase/concepts/identificar-precificar-dor-cliente.md`
+- ✅ Revisar `docs/knowbase/concepts/branding-posicionamento-marca.md`
+
+### 5. Agentes de Produto
+- ✅ Conhecer agentes especializados:
+  - `@product-agent` - Orquestração estratégica
+  - `@story-points-framework-specialist` - Estimativas ágeis
+  - `@extract-meeting-specialist` - Extração de reuniões
+  - `@meeting-consolidator` - Consolidação de reuniões
+  - `@storytelling-business-specialist` - Narrativas de negócio
+  - `@branding-positioning-specialist` - Branding e posicionamento
+
+### 6. Task Manager Integration
+- ✅ Verificar `TASK_MANAGER_PROVIDER` no `.env`
+- ✅ Entender abstração de Task Manager (ClickUp, Asana, Linear)
+- ✅ Revisar `docs/knowbase/concepts/task-manager-abstraction.md`
+
+### 7. Especificações de Features
+- ✅ Mapear estrutura de especificações:
+  - Domain Specs (L1) - Regras de negócio
+  - Feature Specs (L2) - Especificações de features
+- ✅ Entender formato de especificações do projeto
+
+## 🔍 Contexto Específico de Produto
+
+### Documentação Essencial
+- `docs/onion/commands-guide.md` - Comandos de produto
+- `docs/onion/practical-examples.md` - Exemplos práticos
+- `docs/knowbase/frameworks/framework_story_points.md` - Framework de estimativas
+- `docs/knowbase/concepts/meeting-transcription-to-knowledge-base.md` - Processamento de reuniões
+
+### Workflows de Produto
+
+**Workflow Completo de Feature:**
+1. **Coletar**: `/product/collect` → Coletar ideias de features/bugs
+2. **Criar Task**: `/product/task` → Cria com story points automáticos
+3. **Criar Feature**: `/product/feature` → Criar task de feature para backlog
+4. **Validar**: `/product/check` → Verificar requisitos contra meta-specs
+5. **Especificar**: `/product/spec` → Documenta feature completa
+6. **Estimar**: `/product/estimate` → Ajusta estimativas
+7. **Refinar**: `/product/refine` → Recalcula estimativas após mudanças
+8. **Arquitetura**: `/product/light-arch` → Arquitetura leve da feature
+
+**Workflow de Reuniões:**
+1. **Extrair Reunião**: `/product/extract-meeting` → Framework EXTRACT (7 dimensões)
+2. **Consolidar**: `/product/consolidate-meetings` → Análise de múltiplas reuniões
+3. **Consolidar Docs**: `/docs/consolidate-documents` → Consolidar documentos relacionados
+
+**Workflow de Validação:**
+1. **Validar Task**: `/product/validate-task` → Validar task contra meta-specs
+2. **Verificar**: `/product/task-check` → Verificar status e completude
+3. **Sincronizar**: `/product/checklist-sync` → Sincronizar checklists com Task Manager
+
+**Workflow de Análise:**
+1. **Analisar Dor**: `/product/analyze-pain-price` → Analisar dor do cliente e precificação
+2. **Branding**: `/product/branding` → Trabalhar em branding e posicionamento
+3. **Apresentação**: `/product/presentation` → Criar apresentações
+
+## 💡 Quando Usar Este Warm-up
+
+- ✅ Trabalho em especificações de features
+- ✅ Criação ou refinamento de tasks (`/product/task`, `/product/feature`, `/product/collect`)
+- ✅ Estimativas de story points (`/product/estimate`)
+- ✅ Processamento de reuniões (`/product/extract-meeting`, `/product/consolidate-meetings`)
+- ✅ Consolidação de documentos (`/docs/consolidate-documents`)
+- ✅ Análise de requisitos de negócio (`/product/check`, `/product/validate-task`)
+- ✅ Análise de dor do cliente (`/product/analyze-pain-price`)
+- ✅ Trabalho com Product Owners
+- ✅ Branding e posicionamento (`/product/branding`)
+- ✅ Criação de apresentações (`/product/presentation`)
+
+## 🔗 Integração com Engenharia
+
+Após preparar contexto de produto:
+- Tasks criadas são validadas por `/engineer/start`
+- Story points são verificados antes de iniciar desenvolvimento
+- Especificações alimentam sessões de engenharia
+
+## ⚠️ Notas
+
+- Foco em contexto de negócio e produto, não técnico
+- Mantenha conhecimento de frameworks de produto no contexto
+- Use agentes especializados para tarefas específicas
+- Sempre sincronize tasks com Task Manager configurado
+
+
+
+---
+
+## 🚀 Próximos Passos
+
+Agora que você preparou o contexto, comece o trabalho:
+
+1. **Criar nova especificação**:
+   ```bash
+   /business/spec "feature-name"
+   ```
+   O contexto carregado ajudará a criar specs mais completas.
+
+2. **Extrair informações de reunião**:
+   ```bash
+   /business/extract-meeting
+   ```
+   Use para documentar decisões e ações de meetings recentes.
+
+3. **Explorar comandos intermediate**:
+   ```bash
+   /business/help --level=intermediate
+   ```
+   Descubra workflows mais avançados como `/business/feature` (spec + tasks em um comando).
+
+💡 **Dica**: Warm-up é especialmente útil ao retomar trabalho após pausas ou ao entrar em novo projeto.