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

package/templates/.cursor/commands/meta/create-task-structure.md

@@ -0,0 +1,150 @@
+---
+name: create-task-structure
+description: |
+  Decomposição de tarefas complexas em estrutura hierárquica.
+  Use para criar estrutura organizada de subtarefas.
+model: sonnet
+
+parameters:
+  - name: task
+    description: Descrição da tarefa complexa
+    required: true
+  - name: output
+    description: Formato de saída (markdown/json/clickup)
+    required: false
+    default: markdown
+
+category: meta
+tags:
+  - task-decomposition
+  - planning
+  - structure
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /product/task
+  - /engineer/start
+
+related_agents:
+  - task-specialist
+---
+
+# 📋 Criar Estrutura de Tarefas
+
+Decomposição de tarefas complexas em hierarquia gerenciável.
+
+## 🎯 Objetivo
+
+Transformar tarefa complexa em estrutura organizada de subtarefas.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Analisar Tarefa
+
+Entender `{{task}}`:
+
+| Aspecto | Pergunta |
+|---------|----------|
+| Objetivo | O que precisa estar pronto? |
+| Escopo | Quais áreas são afetadas? |
+| Complexidade | Quantas etapas? |
+| Dependências | Ordem obrigatória? |
+| Riscos | Pontos críticos? |
+
+### Passo 2: Identificar Subtarefas
+
+#### Por Camada Técnica
+
+- 📊 **Data**: schemas, migrations, modelos
+- 🔌 **API**: endpoints, validação, business logic
+- 🎨 **UI**: componentes, páginas, styling
+- 🧪 **Testing**: unit, integration, e2e
+- 📚 **Docs**: documentação, comentários
+
+#### Por Tipo de Atividade
+
+- 🔍 Análise e pesquisa
+- 🏗️ Implementação
+- 🧪 Testes
+- 📝 Documentação
+- 🔄 Integração
+
+### Passo 3: Estruturar Hierarquia
+
+Consultar @task-specialist para estrutura:
+
+```
+📋 TASK PRINCIPAL
+├── 🔧 Fase 1: [Nome]
+│   ├── ✅ Subtask 1.1
+│   └── ✅ Subtask 1.2
+├── 🔧 Fase 2: [Nome]
+│   ├── ✅ Subtask 2.1
+│   └── ✅ Subtask 2.2
+└── 🔧 Fase 3: [Nome]
+    └── ✅ Subtask 3.1
+```
+
+### Passo 4: Gerar Output
+
+SE `{{output}}` = "markdown":
+```markdown
+# Estrutura de Tarefas: [Nome]
+
+## Resumo
+- Total de fases: X
+- Total de subtasks: Y
+- Estimativa: Z dias
+
+## Estrutura
+[hierarquia]
+```
+
+SE `{{output}}` = "json":
+```json
+{
+  "task": "...",
+  "phases": [...],
+  "estimatedDays": X
+}
+```
+
+SE `{{output}}` = "clickup":
+→ Delegar para @clickup-specialist
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ ESTRUTURA CRIADA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 Task: {{task}}
+
+📊 Decomposição:
+∟ Fases: 4
+∟ Subtasks: 12
+∟ Estimativa: 5 dias
+
+🔧 Estrutura:
+├── Fase 1: Setup (1d)
+├── Fase 2: Implementação (2d)
+├── Fase 3: Testes (1d)
+└── Fase 4: Deploy (1d)
+
+🚀 Próximo: /product/task
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Decomposição: @task-specialist
+- Criação no ClickUp: /product/task
+
+## ⚠️ Notas
+
+- Máximo 6 fases por task
+- Subtasks de 1-4h cada
+- Se muito grande: quebrar em múltiplas tasks

package/templates/.cursor/commands/meta/setup-integration.md

@@ -0,0 +1,257 @@
+---
+name: setup-integration
+description: |
+  Configura integrações do Sistema Onion (Task Managers, Gamma, etc).
+  Guia o usuário na configuração segura de variáveis de ambiente para MCPs e APIs.
+model: sonnet
+parameters:
+  - name: integration
+    description: Nome da integração (task-manager, clickup, asana, linear, gamma, postgres)
+    required: false
+category: meta
+tags:
+  - meta
+  - setup
+  - integrations
+  - task-manager
+version: "3.0.0"
+updated: "2025-12-02"
+related_commands:
+  - /product/task
+  - /engineer/start
+related_agents:
+  - clickup-specialist
+---
+
+# ⚙️ Configuração de Integrações
+
+Você é um assistente de configuração do Sistema Onion. Sua missão é guiar o usuário na configuração segura de integrações externas, especialmente **Task Managers** (ClickUp, Asana, Linear).
+
+## 🎯 Objetivo
+
+Configurar variáveis de ambiente necessárias para integrações do Sistema Onion, com foco especial em **Task Manager Abstraction** que permite usar múltiplos gerenciadores de tarefas.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Identificar Integração
+
+SE `{{integration}}` foi fornecido:
+- Use diretamente
+SENÃO:
+- Pergunte qual integração configurar:
+  - **task-manager** - Configurar gerenciador de tarefas (ClickUp, Asana, Linear) - **RECOMENDADO PRIMEIRO**
+  - **clickup** - ClickUp MCP para gestão de tarefas
+  - **asana** - Asana MCP para gestão de tarefas
+  - **linear** - Linear API para gestão de tarefas
+  - **gamma** - Gamma.App API para apresentações
+  - **postgres** - PostgreSQL para banco de dados
+
+### Passo 2: Verificar Estado Atual
+
+**CRÍTICO:** Usar `read_file` para ler `.env` sem expor valores sensíveis:
+
+```bash
+# Verificar se .env existe
+test -f .env && echo "✅ .env existe" || echo "⚠️ .env não encontrado"
+
+# Ler .env usando read_file (não usar cat/grep que expõe valores)
+read_file .env
+
+# Verificar variáveis específicas (sem expor valores)
+# Usar apenas para detectar presença, não para exibir conteúdo
+```
+
+**⚠️ REGRA DE SEGURANÇA:** 
+- **NUNCA** usar `cat .env` ou `grep` que mostre valores completos
+- **SEMPRE** usar `read_file` que permite análise sem exposição
+- **NUNCA** exibir tokens/senhas no output
+
+### Passo 3: Guiar Configuração por Integração
+
+#### 🎯 Task Manager (Recomendado - Configuração Principal)
+
+**Este é o passo mais importante!** O Sistema Onion usa **Task Manager Abstraction** que suporta múltiplos provedores.
+
+**1. Escolher Provedor:**
+```env
+# ═══════════════════════════════════════
+# GERENCIADOR DE TAREFAS (escolha um)
+# ═══════════════════════════════════════
+TASK_MANAGER_PROVIDER=clickup  # clickup | asana | linear | none
+```
+
+**2. Configurar ClickUp (se escolhido):**
+```env
+# ClickUp MCP
+CLICKUP_API_TOKEN=pk_xxxxxxx_xxxxxxxxxxxxxxx
+CLICKUP_WORKSPACE_ID=90131664218  # Opcional, detectado automaticamente
+CLICKUP_DEFAULT_LIST_ID=901314121395  # Opcional, lista padrão
+```
+
+**Como obter:**
+- **API Token**: Settings > Apps > API Token no ClickUp
+- **Workspace ID**: URL do workspace `https://app.clickup.com/XXXXXXXX/home` → `XXXXXXXX`
+- **List ID**: URL da lista `https://app.clickup.com/XXXXXXXX/v/li/YYYYYYYY` → `YYYYYYYY`
+
+**3. Configurar Asana (alternativa):**
+```env
+# Asana MCP
+ASANA_ACCESS_TOKEN=1/xxxxx_xxxxxxxxxxxxxxx
+ASANA_DEFAULT_WORKSPACE=1234567890  # Opcional
+ASANA_DEFAULT_PROJECT_ID=0987654321  # Opcional
+```
+
+**Como obter:**
+- **Access Token**: [Asana Developer Console](https://app.asana.com/0/my-apps)
+- **Workspace ID**: URL do workspace ou via API
+- **Project ID**: URL do projeto ou via API
+
+**4. Configurar Linear (alternativa):**
+```env
+# Linear API
+LINEAR_API_KEY=lin_api_xxxxxxxxxxxxxxx
+LINEAR_TEAM_ID=abc123  # Opcional
+```
+
+**Como obter:**
+- **API Key**: Settings > API no Linear
+- **Team ID**: URL do time ou via API
+
+**5. Modo Offline (sem gerenciador):**
+```env
+TASK_MANAGER_PROVIDER=none
+# Sistema funcionará em modo local sem sincronização
+```
+
+#### Gamma.App
+1. Acesse: gamma.app/settings/api
+2. Gere uma API Key
+3. Adicione ao `.env`:
+```env
+# Gamma.App API
+GAMMA_API_KEY=gm_xxxxxxxxxxxxxxxx
+```
+
+#### PostgreSQL
+1. Configure conexão local ou cloud
+2. Adicione ao `.env`:
+```env
+# PostgreSQL
+POSTGRES_HOST=localhost
+POSTGRES_PORT=5432
+POSTGRES_DB=mydb
+POSTGRES_USER=myuser
+POSTGRES_PASSWORD=mypassword  # Use senhas seguras!
+```
+
+### Passo 4: Criar/Atualizar .env
+
+**SE `.env` não existir:**
+```bash
+# Verificar se .env.example existe
+if [ -f .env.example ]; then
+  cp .env.example .env
+  echo "✅ .env criado a partir de .env.example"
+else
+  # Criar .env básico
+  touch .env
+  echo "# Sistema Onion - Variáveis de Ambiente" >> .env
+  echo "# Gerado por /meta/setup-integration" >> .env
+  echo "" >> .env
+  echo "✅ .env criado"
+fi
+```
+
+**SE `.env` já existir:**
+- **NUNCA** sobrescrever valores existentes
+- **SEMPRE** adicionar novas variáveis ao final
+- **AVISAR** se variável já existe com valor diferente
+
+### Passo 5: Validar Configuração
+
+Após o usuário adicionar as credenciais:
+
+**Para Task Manager:**
+```bash
+# Verificar se TASK_MANAGER_PROVIDER está configurado
+# Verificar se variáveis obrigatórias do provedor estão presentes
+# Sugerir teste: /product/task "Task de teste"
+```
+
+**Para outras integrações:**
+```bash
+# Teste de conexão específico da integração
+# Depende da integração escolhida
+```
+
+### Passo 6: Atualizar .gitignore
+
+**CRÍTICO:** Verificar se `.env` está protegido:
+
+```bash
+# Verificar se .env está no .gitignore
+if ! grep -q "^\.env$" .gitignore 2>/dev/null; then
+  echo ".env" >> .gitignore
+  echo "✅ .env adicionado ao .gitignore"
+else
+  echo "✅ .env já está protegido no .gitignore"
+fi
+
+# Verificar se há .env commitado no Git
+if git ls-files --error-unmatch .env >/dev/null 2>&1; then
+  echo "⚠️ ATENÇÃO: .env está sendo rastreado pelo Git!"
+  echo "💡 Execute: git rm --cached .env"
+fi
+```
+
+## 🔒 Regras de Segurança
+
+1. **NUNCA** exiba tokens/senhas completos no output
+2. **SEMPRE** use `read_file` para ler `.env` (não `cat` ou `grep` que expõem valores)
+3. **SEMPRE** verifique `.gitignore` antes de concluir
+4. **ALERTE** se detectar credenciais em arquivos não protegidos
+5. **SUGIRA** uso de vault/secrets manager para produção
+6. **VALIDE** se `.env` está sendo rastreado pelo Git e alerte
+
+## 📤 Output Final
+
+Apresente um resumo formatado:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Configuração de [INTEGRAÇÃO] Concluída
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 Status:
+∟ .env: ✅ Configurado
+∟ .gitignore: ✅ Protegido
+∟ [INTEGRAÇÃO]: ✅ Pronta para uso
+
+🔧 Configuração:
+∟ TASK_MANAGER_PROVIDER: [clickup/asana/linear/none]
+∟ [Variáveis específicas configuradas]
+
+🚀 Próximos Passos:
+∟ Execute /product/task para criar sua primeira task
+∟ Use @clickup-specialist para operações ClickUp
+∟ Ou execute /engineer/start para iniciar desenvolvimento
+
+💡 Dica: Teste a integração criando uma task de teste:
+   /product/task "Task de teste do sistema"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 📚 Referências
+
+- **Task Manager Abstraction**: `.cursor/utils/task-manager/README.md`
+- **Detector de Provedor**: `.cursor/utils/task-manager/detector.md`
+- **Documentação ClickUp**: `.cursor/docs/onion/clickup-integration.md`
+- **Comando de Task**: `/product/task` - Criar tasks com decomposição
+
+## ⚠️ Notas Importantes
+
+- **Task Manager é OBRIGATÓRIO** para comandos como `/product/task` funcionarem com sincronização
+- **Modo `none`** permite funcionamento offline sem gerenciador
+- **Múltiplos provedores** podem ser configurados, mas apenas um será usado por vez via `TASK_MANAGER_PROVIDER`
+- **Variáveis opcionais** melhoram UX mas não são obrigatórias (sistema detecta automaticamente)
+