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

package/templates/.cursor/commands/onion.md

@@ -0,0 +1,168 @@
+---
+name: onion
+description: |
+  Ponto de entrada inteligente para o Sistema Onion.
+  Use para navegação, recomendações e orquestração de workflows.
+model: sonnet
+
+parameters:
+  - name: query
+    description: Sua pergunta ou necessidade
+    required: false
+
+category: meta
+tags:
+  - navigation
+  - orchestration
+  - help
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /product/task
+  - /engineer/start
+  - /git/feature/start
+
+related_agents:
+  - onion
+---
+
+# 🧅 Comando Onion
+
+Atalho inteligente para o agente orquestrador master @onion.
+
+## 🎯 Objetivo
+
+Acessar o Sistema Onion para navegação, recomendações e orquestração.
+
+## ⚡ Uso
+
+```bash
+/onion                    # Ajuda geral
+/onion "como criar task"  # Pergunta específica
+/onion "workflow de PR"   # Orientação de workflow
+```
+
+## 🔄 Fluxo de Execução
+
+### Passo 1: Detectar Tipo de Solicitação
+
+| Tipo | Indicadores | Ação |
+|------|-------------|------|
+| 🆘 Ajuda | "como", "o que" | Explicar sistema |
+| 🎯 Tarefa | "criar", "fazer" | Recomendar comando |
+| 🔍 Busca | "qual", "onde" | Encontrar recurso |
+| 🔧 Problema | "erro", "não funciona" | Diagnosticar |
+| 🔄 Workflow | "do zero", "completo" | Orquestrar fluxo |
+
+### Passo 2: Preparar Contexto
+
+```bash
+# Detectar sessões ativas
+ls .cursor/sessions/*/context.md 2>/dev/null
+
+# Verificar estado Git
+git branch --show-current
+git status --short
+```
+
+### Passo 3: Invocar @onion
+
+Delegar para o agente com contexto coletado.
+
+## 📤 Respostas Comuns
+
+### Ajuda Geral
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🧅 SISTEMA ONION
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Estrutura:
+∟ 57 comandos em 7 categorias
+∟ 38 agentes especializados
+∟ Integração ClickUp MCP
+
+🚀 Comandos Principais:
+∟ /product/task - Criar tasks
+∟ /engineer/start - Iniciar feature
+∟ /engineer/work - Continuar trabalho
+∟ /git/feature/start - Criar branch
+
+💡 Use: /onion "sua pergunta"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Recomendação de Comando
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 RECOMENDAÇÃO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Para: "criar task no ClickUp"
+
+✅ Use: /product/task [descrição]
+
+📋 Exemplo:
+/product/task Implementar autenticação OAuth2
+
+🔗 Relacionados:
+∟ /product/spec - Criar especificação
+∟ /product/feature - Detalhar feature
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Workflow Completo
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔄 WORKFLOW: Feature Completa
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 Sequência:
+1. /product/task [nome]
+2. /engineer/start [feature-slug]
+3. /git/feature/start
+4. /engineer/work
+5. /engineer/pre-pr
+6. /engineer/pr
+7. /git/sync
+
+💡 Dica: Cada comando atualiza ClickUp
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Agente master: @onion
+- Docs: `docs/onion/`
+- Sistema de Testes: `docs/onion/testing-validation-system.md` - Framework completo de testes e validação
+
+## ⚠️ Notas
+
+- Sempre começa com contexto do workspace
+- Detecta sessões ativas automaticamente
+- Para ajuda específica de agente: @nome-do-agente
+
+## 🔴 REGRA CRÍTICA: Criação de Tasks
+
+**SEMPRE criar tasks no Task Manager configurado:**
+
+Quando usar comandos que criam tasks (`/product/task`, `/product/feature`):
+1. ✅ **SEMPRE** detectar provedor via `.cursor/utils/task-manager/detector.md`
+2. ✅ **SEMPRE** usar abstração `getTaskManager()` para criar tasks
+3. ✅ **SEMPRE** criar task principal + subtasks no provedor configurado
+4. ✅ **SEMPRE** adicionar comentários e atualizar status
+5. ❌ **NUNCA** criar apenas documentos locais sem sincronizar
+6. ❌ **NUNCA** ignorar o provedor configurado no `.env`
+
+**Provedores suportados:**
+- ClickUp (via MCP) - `TASK_MANAGER_PROVIDER=clickup`
+- Asana (via MCP) - `TASK_MANAGER_PROVIDER=asana`
+- Linear (via API) - `TASK_MANAGER_PROVIDER=linear`
+- None (modo offline) - `TASK_MANAGER_PROVIDER=none`
+
+**Esta regra é OBRIGATÓRIA e será sempre executada.**

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

@@ -0,0 +1,230 @@
+# 📋 Comandos Product - Workflow Completo
+
+Este documento descreve o workflow completo dos comandos de produto no Sistema Onion.
+
+## 🔄 **Fluxo de Trabalho Ideal**
+
+```mermaid
+flowchart TD
+    A[Ideia] --> B[Create Task]
+    B --> C[Task Created]
+    B --> D[Branch Created]
+    B --> E[Session Created]
+    
+    E --> F[Start Development]
+    F --> G[Development]
+    
+    G --> H[Check Implementation]
+    H --> I{Implementation OK?}
+    
+    I -->|Yes| J[Next Phase]
+    I -->|No| K[Fix Issues]
+    K --> H
+    
+    J --> L[Validate Task]
+    L --> M[Analysis Complete]
+```
+
+## 🛠️ **Comandos Disponíveis**
+
+### 1. **`/product/task <description>`** 🚀
+**Objetivo**: Criar task no ClickUp + Setup completo para desenvolvimento
+
+**O que faz**:
+- ✅ Cria task estruturada no ClickUp
+- ✅ Cria feature branch `feature/<slug>`
+- ✅ Inicializa sessão em `.cursor/sessions/<slug>/`
+- ✅ Cria arquivos: `context.md`, `plan.md`, `notes.md`
+
+**Quando usar**: Início de qualquer nova funcionalidade
+
+### 2. **`/product/task-check <task-id>`** 🔍
+**Objetivo**: Verificar se task foi realmente implementada
+
+**O que faz**:
+- ✅ Carrega task do ClickUp
+- ✅ Audita projeto atual buscando implementação
+- ✅ Compara requisitos vs código real
+- ✅ Determina se pode avançar para próxima fase
+
+**Quando usar**: Após desenvolvimento, antes de fechar task
+
+### 3. **`/product/validate-task <task-id>`** 📊
+**Objetivo**: Análise estratégica e alinhamento com projeto
+
+**O que faz**:
+- ✅ Valida alinhamento com arquitetura
+- ✅ Analisa viabilidade técnica
+- ✅ Sugere melhorias nos requisitos
+- ✅ Fornece recomendações estratégicas
+
+**Quando usar**: Análise de requisitos, tasks problemáticas
+
+### 4. **`/product/presentation <description>`** 🎨
+**Objetivo**: Criar apresentações profissionais via Gamma.app
+
+**O que faz**:
+- ✅ Analisa tipo de apresentação (tema, task, doc, métricas)
+- ✅ Coleta dados relevantes automaticamente
+- ✅ Orquestra pipeline completo de geração
+- ✅ Entrega apresentação pronta com links
+
+**Quando usar**: Criar pitch decks, case studies, relatórios, apresentações técnicas
+
+### 5. **Outros comandos complementares**:
+- **`/product/check`**: Verificação contra meta-specs
+- **`/product/spec`**: Criação de especificações
+- **`/product/collect`**: Coleta de informações
+- **`/product/refine`**: Refinamento de requisitos
+
+## 🔄 **Sistema de Auto-Update ClickUp**
+
+Todos os comandos seguem uma **estratégia consistente de atualização automática** do ClickUp:
+
+### **✅ Updates Automáticos (Sem Confirmação)**
+- **Comments informativos** com progresso e resultados
+- **Tags de status** (verified, in-development, ready-for-pr)
+- **Tracking de atividade** com timestamps
+- **Progress updates** baseados em fases
+
+### **⚠️ Confirmação Necessária (Alto Impacto)**
+- **Mudanças de status** críticas (To Do → Done)
+- **Alterações de prioridade** baseadas em análise
+- **Quebra em subtasks** quando escopo é complexo
+- **Reatribuição** quando detecta skill mismatch
+
+### **📋 Identificação Inteligente de Tasks**
+1. **Sessão ativa**: Usa task-id do `context.md` da sessão atual
+2. **Argumento fornecido**: Usa task-id passado pelo usuário
+3. **Não identificada**: Pergunta qual task atualizar
+
+## 🎯 **Cenários de Uso**
+
+### **Cenário 1: Nova Feature Completa**
+```bash
+# 1. Criar task + setup completo
+/product/task "Sistema de notificações push"
+# ↳ AUTO: Cria task + comment setup + tags
+
+# 2. Iniciar desenvolvimento  
+/engineer/start notificacoes-push
+# ↳ AUTO: Status → "In Progress" + comment início
+
+# 3. Desenvolver com tracking automático
+/engineer/work notificacoes-push
+# ↳ AUTO: Comments de progresso a cada fase
+
+# 4. Preparar para PR
+/engineer/pre-pr
+# ↳ AUTO: Comment checklist + tag "ready-for-pr"
+
+# 5. Criar PR
+/engineer/pr
+# ↳ AUTO: Status ajustado + tag "under-review"
+
+# 6. Verificar implementação final
+/product/task-check 86abzwx0w
+# ↳ AUTO: Comment verificação + PERGUNTA: mover para Done?
+
+# 7. Análise estratégica final
+/product/validate-task 86abzwx0w
+# ↳ AUTO: Comment validação + tag "validated"
+```
+
+### **Cenário 2: Task Problemática**
+```bash
+# 1. Analisar task existente
+/product/validate-task 86abzwx0w
+# ↳ AUTO: Comment análise + PERGUNTA: mudar prioridade?
+
+# 2. Verificar o que foi implementado
+/product/task-check 86abzwx0w
+# ↳ AUTO: Comment verificação + tag "needs-work"
+
+# 3. Refinar requisitos se necessário
+/product/refine <task-description>
+```
+
+### **Cenário 3: Auditoria de Qualidade**
+```bash
+# 1. Verificar múltiplas tasks com tracking automático
+/product/task-check 86abzwx0w
+/product/task-check 86abzwx1x  
+/product/task-check 86abzwx2y
+# ↳ AUTO: Cada comando adiciona comment de verificação
+
+# 2. Validar alinhamento estratégico
+/product/validate-task 86abzwx0w
+# ↳ AUTO: Comment validação + decisões estratégicas
+```
+
+### **Cenário 4: Criar Apresentação**
+```bash
+# 1. Apresentação a partir de tema
+/product/presentation Crie apresentação sobre nova feature de IA para investidores
+# ↳ AUTO: Coleta dados + gera narrativa + diagramas + apresentação Gamma
+
+# 2. Apresentação a partir de task
+/product/presentation Transforme task #86abzwx0w em case study para stakeholders
+# ↳ AUTO: Busca task ClickUp + gera apresentação + comenta na task
+
+# 3. Apresentação técnica
+/product/presentation Converta docs/architecture.md em apresentação para time técnico
+# ↳ AUTO: Lê doc + adapta conteúdo + gera diagramas + apresentação
+
+# 4. Relatório de métricas
+/product/presentation Crie relatório com métricas do Q4 2024
+# ↳ AUTO: Busca dados + cria gráficos + apresentação data-driven
+```
+
+## 📁 **Estrutura da Sessão**
+
+Quando você usa `/product/task`, é criada esta estrutura:
+
+```
+.cursor/sessions/<feature-slug>/
+├── context.md          # Contexto e objetivos
+├── architecture.md     # Arquitetura técnica (criado por /engineer/start)
+├── plan.md            # Plano de implementação por fases
+└── notes.md           # Notas e decisões
+```
+
+### **Integração com Comandos**:
+- **`/engineer/start <slug>`**: Usa e expande a sessão
+- **`/product/task-check`**: Lê context.md para entender escopo
+- **`/product/validate-task`**: Considera arquitetura da sessão
+
+## 🚀 **Próximos Passos Recomendados**
+
+Depois de criar uma task com `/product/task`:
+
+1. **Revisar** os arquivos criados em `.cursor/sessions/<slug>/`
+2. **Executar** `/engineer/start <slug>` para iniciar desenvolvimento
+3. **Usar** `/product/task-check` periodicamente durante desenvolvimento
+4. **Finalizar** com `/product/validate-task` para análise completa
+
+## 📊 **Auto-Updates por Comando**
+
+### **✅ Updates Automáticos**
+- **`/product/task`**: Comment setup + tags automáticas
+- **`/product/presentation`**: Comment com links da apresentação (se baseada em task)
+- **`/engineer/start`**: Status → "In Progress" + comment início  
+- **`/engineer/work`**: Comments de progresso por fase
+- **`/engineer/pre-pr`**: Comment checklist + tags qualidade
+- **`/engineer/pr`**: Status ajuste + comment PR + tag "under-review"
+
+### **⚠️ Com Confirmação**
+- **`/product/task-check`**: Comment verificação + pergunta para status "Done"
+- **`/product/validate-task`**: Comment validação + confirmação para mudanças de prioridade
+
+## 💡 **Benefícios da Estratégia**
+
+1. **Rastreabilidade Total**: Cada ação gera histórico automático no ClickUp
+2. **Produtividade Máxima**: Elimina atualizações manuais repetitivas  
+3. **Controle Inteligente**: Confirma apenas mudanças críticas
+4. **Sincronização**: Sessões locais sempre sincronizadas com ClickUp
+5. **Visibilidade**: Stakeholders veem progresso em tempo real
+
+---
+
+**Sistema completamente integrado! Auto-updates inteligentes em todos os comandos! 🚀🧅**

package/templates/.cursor/commands/quick/analisys.md

@@ -0,0 +1,17 @@
+---
+name: analisys
+description: Análise rápida usando template padrão.
+model: sonnet
+category: quick
+tags: [analysis, quick, template]
+version: "3.0.0"
+updated: "2025-11-24"
+---
+
+faça uma analise usando o template @analysis-template.md sobre 
+
+<requiuirements>
+#ARGUMENTS
+</requiuirements>
+
+coloque o resultado em docs/alalisys/*.md