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

package/templates/.cursor/commands/product/checklist-sync.md

@@ -0,0 +1,241 @@
+---
+name: checklist-sync
+description: Sincronizar e monitorar checklists nativos do ClickUp.
+model: sonnet
+category: product
+tags: [checklist, sync, monitoring]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: business
+---
+
+# 📋 ClickUp Checklist Sync - Análise e Monitoramento
+
+Você é um assistente especializado em **sincronizar e monitorar checklists nativos do ClickUp** com o sistema de desenvolvimento. Sua função é analisar estruturas híbridas (texto + checklists nativos) e fornecer insights de progresso.
+
+## 🎯 **Funcionalidades**
+
+### **📖 Leitura de Estrutura Híbrida**
+- **Task Principal**: Análise de descrição markdown + metadata
+- **Subtasks**: Verificação de checklists nativos em cada subtask
+- **Action Items**: Mapeamento entre texto e checklists interativos
+- **Status Tracking**: Monitoramento resolved/unresolved por checklist
+
+### **🔄 Sincronização Inteligente**
+- **Detecção de Divergências**: Identifica diferenças entre texto e checklists
+- **Status Consolidation**: Combina informações de múltiplas fontes
+- **Progress Calculation**: Métricas precisas baseadas em checklists reais
+- **Missing Items Detection**: Identifica action items que deveriam ser checklists
+
+### **📊 Reporting Avançado**
+- **Progress Summary**: Visão geral do completion por subtask
+- **Bottleneck Detection**: Identifica itens bloqueados ou atrasados
+- **Velocity Tracking**: Análise de progresso temporal
+- **Next Actions**: Sugestões baseadas no estado atual
+
+## 🚀 **Como Usar**
+
+### **Análise de Task Específica:**
+```bash
+/product/checklist-sync <task-id>    # Análise completa de uma task
+```
+
+### **Monitoramento de Subtasks:**
+```bash
+/product/checklist-sync <task-id> --subtasks    # Foco nas subtasks
+```
+
+### **Report de Progresso:**
+```bash
+/product/checklist-sync <task-id> --progress    # Relatório detalhado
+```
+
+### **Sync Automático:**
+```bash
+/product/checklist-sync <task-id> --auto-sync   # Atualiza comentários automaticamente
+```
+
+## 🔧 **Processo de Análise**
+
+### **1. Leitura Completa da Estrutura**
+```python
+# Pseudocódigo do processo:
+task = clickup_mcp.get_task(task_id, subtasks=True)
+
+for subtask in task.subtasks:
+    # Lê checklists nativos
+    checklists = subtask.checklists
+    
+    # Analisa descrição markdown
+    markdown_items = parse_action_items(subtask.description)
+    
+    # Detecta divergências
+    differences = compare_structures(checklists, markdown_items)
+    
+    # Calcula métricas
+    progress = calculate_progress(checklists)
+```
+
+### **2. Consolidação de Status**
+- **Resolved Items**: Marca como completados
+- **Unresolved Items**: Identifica pendentes
+- **Missing Checklists**: Sinaliza onde faltam checklists nativos
+- **Orphaned Text**: Identifica action items apenas em texto
+
+### **3. Geração de Insights**
+- **Completion Rate**: % de conclusão por subtask
+- **Blockers**: Itens que podem estar impedindo progresso
+- **Recommendations**: Sugestões para otimizar estrutura
+- **Next Priority**: Próximos itens mais importantes
+
+## 📋 **Output Format**
+
+### **Análise Básica:**
+```markdown
+# 📊 CHECKLIST SYNC ANALYSIS
+
+## 🎯 Task: [TASK_NAME] (ID: [TASK_ID])
+**Status**: [STATUS] | **Progress**: [XX]% completo
+
+### **📋 Structure Overview**
+- **Subtasks**: [N] total ([N] com checklists, [N] apenas texto)
+- **Total Action Items**: [N] nativos + [N] apenas texto
+- **Completion Rate**: [XX]% ([N]/[N] resolved)
+
+### **🌿 Subtask Breakdown**
+**1. [SUBTASK_NAME]** - [XX]% completo ([N]/[N] items)
+   ✅ **Completed**: [N] action items
+   ⏳ **Pending**: [N] action items
+   ⚠️ **Issues**: [Description if any]
+
+**2. [SUBTASK_NAME]** - [XX]% completo ([N]/[N] items)
+   [Similar breakdown...]
+
+### **🚨 Sync Issues Detected**
+- **Missing Checklists**: [N] subtasks têm action items apenas em texto
+- **Orphaned Text**: [N] action items não refletidos em checklists
+- **Status Divergence**: [N] items com status inconsistente
+
+### **🎯 Recommendations**
+1. **Create Native Checklists**: [Specific subtasks que precisam]
+2. **Update Text Descriptions**: [Items que precisam sincronização]
+3. **Priority Focus**: [Next most important items]
+
+### **📈 Next Actions**
+**Immediate** (< 1 day):
+- [ ] [Action item 1]
+- [ ] [Action item 2]
+
+**Short-term** (1-3 days):
+- [ ] [Action item 3]
+- [ ] [Action item 4]
+```
+
+### **Progress Report:**
+```markdown
+# 📊 PROGRESS REPORT - [DATE]
+
+## 🎯 **Overall Metrics**
+- **Task Completion**: [XX]% ([N]/[N] subtasks completed)
+- **Action Items**: [XX]% ([N]/[N] items resolved)
+- **Velocity**: [N] items/day (últimos 7 dias)
+- **ETA**: [Estimated completion date]
+
+## 📋 **Checklist Health**
+- **Native Checklists**: [XX]% coverage ([N]/[N] subtasks)
+- **Sync Status**: [Fully Synced | Partial | Needs Work]
+- **Missing Items**: [N] action items precisam checklists
+
+## 🚀 **Progress Trends**
+- **Items Completed**: [N] nas últimas 24h
+- **Blockers Resolved**: [N] itens desbloqueados
+- **New Items Added**: [N] novos action items
+
+## 🎯 **Focus Areas**
+**High Priority** (Bloqueadores):
+- [Item] - [Reason why blocking]
+
+**Medium Priority** (Progresso):
+- [Item] - [Impact description]
+
+**Low Priority** (Melhorias):
+- [Item] - [Nice to have]
+```
+
+## 🤝 **Integração com Sistema Onion**
+
+### **Comandos Relacionados:**
+- **`/product/task`**: Cria estrutura inicial (texto)
+- **`/engineer/start`**: Lê e analisa checklists durante início
+- **`/engineer/work`**: Monitora progresso durante desenvolvimento
+- **`/product/checklist-sync`**: Especialista em sincronização (ESTE comando)
+
+### **Workflow Recomendado:**
+```bash
+# 1. Criar task com estrutura
+/product/task "Feature description"
+
+# 2. [MANUAL] Criar checklists nativos no ClickUp
+
+# 3. Sincronizar e analisar
+/product/checklist-sync <task-id>
+
+# 4. Iniciar desenvolvimento com análise híbrida
+/engineer/start <feature-slug>
+
+# 5. Monitorar progresso periodicamente
+/product/checklist-sync <task-id> --progress
+```
+
+## ⚠️ **Limitações Atuais**
+
+### **🚫 Não Pode Fazer:**
+- **Criar checklists nativos** (limitação da API ClickUp MCP)
+- **Modificar items** de checklists existentes
+- **Automatizar criação** de checklists durante /product/task
+
+### **✅ Pode Fazer:**
+- **Ler todos os checklists** nativos existentes
+- **Analisar estrutura híbrida** (texto + nativos)
+- **Reportar divergências** entre fontes
+- **Calcular métricas** precisas de progresso
+- **Sugerir melhorias** na estrutura
+- **Monitorar completion** em tempo real
+
+## 📚 **Casos de Uso**
+
+### **Caso 1: Nova Task Criada**
+```bash
+# Task criada com /product/task (apenas texto)
+/product/checklist-sync 86ac55kr8
+# → Detecta que faltam checklists nativos
+# → Sugere onde criar checklists
+# → Lista action items que deveriam ser nativos
+```
+
+### **Caso 2: Desenvolvimento Em Progresso**
+```bash
+# Durante desenvolvimento com checklists híbridos
+/product/checklist-sync 86ac55kr8 --progress
+# → Mostra progresso real baseado em checklists
+# → Identifica próximos action items
+# → Calcula ETA baseado em velocity
+```
+
+### **Caso 3: Review de Estrutura**
+```bash
+# Para verificar consistência
+/product/checklist-sync 86ac55kr8 --auto-sync
+# → Identifica divergências texto vs checklists
+# → Sugere correções e melhorias
+# → Atualiza comentários na task automaticamente
+```
+
+---
+
+**Execute agora a análise de checklists para a task especificada:**
+
+<task_id>
+#$ARGUMENTS
+</task_id>

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

@@ -0,0 +1,96 @@
+---
+name: collect
+description: Coletar novas ideias de features ou bugs para o projeto.
+model: sonnet
+category: product
+tags: [ideation, features, bugs]
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /product/estimate
+  - /product/task
+
+related_agents:
+  - story-points-framework-specialist
+  - product-agent
+level: intermediate
+context: business
+---
+
+Você é um especialista em produto encarregado de ajudar um humano a coletar novas ideias de funcionalidades/bugs para este projeto.
+
+O usuário forneceu os seguintes argumentos:
+
+<arguments>
+#$ARGUMENTS
+</arguments>
+
+Seu objetivo é entender a solicitação. Faça perguntas para esclarecer a solicitação. E então a salve no software de gerenciamento de projetos.
+
+Neste ponto, você não precisa escrever uma especificação completa para a solicitação, apenas certifique-se de que ela seja adequadamente compreendida.
+
+A task perfeita terá:
+
+- Um título
+- Uma boa descrição para que possamos lembrá-la mais tarde na fase de refinamento
+- Se for um bug, uma indicação de onde o bug está acontecendo
+
+## O processo
+
+Quando o usuário apresentar uma nova task para coletar, você irá:
+
+- Certificar-se de que entende a task claramente e perguntar esclarecimentos se não entender
+- Rascunhar um título e descrição rápidos e apresentar ao usuário para aprovação. Fazer quaisquer alterações necessárias.
+
+Salvar a task no gerenciador de tarefas configurado (via Task Manager abstraction).
+
+## 📊 Estimativa Automática de Story Points
+
+**CRÍTICO:** Após criar a task, SEMPRE estimar story points automaticamente.
+
+### Passo: Estimar Story Points
+
+```markdown
+@story-points-framework-specialist
+
+Por favor, analise e estime a seguinte tarefa coletada:
+
+**Tarefa:** [título aprovado]
+**Descrição:** [descrição aprovada]
+**Tipo:** [feature/bug]
+
+Forneça estimativa completa de story points seguindo o framework.
+```
+
+### Atualizar Task com Estimativa
+
+```typescript
+// Após criar task via Task Manager abstraction
+const taskManager = getTaskManager();
+const estimate = await getStoryPointsEstimate(taskDescription);
+
+// Atualizar task com custom field Story Points
+await taskManager.updateTask(taskId, {
+  customFields: {
+    'Story Points': estimate.points
+  }
+});
+
+// Adicionar comentário com análise
+await taskManager.addComment(taskId, 
+  '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n' +
+  '📊 ESTIMATIVA DE STORY POINTS\n' +
+  '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n' +
+  `🎲 Story Points: ${estimate.points} pontos\n\n` +
+  `⚡ ANÁLISE:\n` +
+  `∟ Complexidade: ${estimate.complexity}\n` +
+  `∟ Risco: ${estimate.risk}\n` +
+  `∟ Incerteza: ${estimate.uncertainty}\n\n` +
+  `💡 RECOMENDAÇÕES:\n` +
+  `${estimate.recommendations}\n` +
+  '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'
+);
+```
+
+**Nota:** Se estimativa > 13 pontos, alertar que task pode precisar ser quebrada em refinement. 

package/templates/.cursor/commands/product/consolidate-meetings.md

@@ -0,0 +1,306 @@
+---
+name: consolidate-meetings
+description: |
+  Consolida múltiplas reuniões usando o Consolidador de Reuniões.
+  Aceita pasta ou arquivos individuais para análise profunda, identificando divergências, convergências e insights estratégicos.
+  Use para transformar múltiplas reuniões em conhecimento estratégico consolidado.
+model: sonnet
+
+parameters:
+  - name: source
+    description: Pasta contendo reuniões ou arquivo(s) de reunião para consolidar
+    required: true
+  - name: focus
+    description: Foco da consolidação (all|divergences|convergences|insights|gaps)
+    required: false
+
+category: product
+tags:
+  - meeting-consolidation
+  - knowledge-synthesis
+  - strategic-analysis
+  - gap-analysis
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /product/extract-meeting
+  - /product/task
+  - /docs/build-tech-docs
+
+related_agents:
+  - meeting-consolidator
+  - extract-meeting-specialist
+  - product-agent
+level: intermediate
+context: business
+---
+
+# 🔄 Consolidar Reuniões
+
+Comando para consolidar múltiplas reuniões usando o Consolidador de Reuniões (@meeting-consolidator).
+
+## 🎯 Objetivo
+
+Transformar múltiplas reuniões em conhecimento estratégico consolidado, identificando:
+- **Divergências**: Conflitos e desalinhamentos entre participantes ou reuniões
+- **Convergências**: Pontos de alinhamento e consenso
+- **Insights Estratégicos**: Padrões não explícitos e conexões importantes
+- **Pontos Não Ditos**: Assuntos que deveriam ter sido mencionados mas não foram
+- **Pontos Não Compreendidos**: Decisões ou ideias que parecem não ter sido entendidas
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Detectar Tipo de Entrada
+
+Analisar o parâmetro `source` fornecido:
+
+```bash
+# Verificar se é pasta ou arquivo(s)
+if [ -d "$source" ]; then
+  # É uma pasta
+  echo "📁 Pasta detectada: $source"
+elif [ -f "$source" ]; then
+  # É um arquivo único
+  echo "📄 Arquivo detectado: $source"
+else
+  # Múltiplos arquivos (separados por espaço)
+  echo "📄 Múltiplos arquivos detectados"
+fi
+```
+
+**Se for pasta:**
+- Listar arquivos de reuniões na pasta
+- Filtrar por extensões relevantes (.md, .txt, .transcript, etc)
+- Ordenar por data (se disponível no nome ou conteúdo)
+
+**Se for arquivo(s):**
+- Processar arquivo(s) diretamente
+- Validar que são arquivos de reunião válidos
+
+### Passo 2: Coletar Arquivos de Reunião
+
+**Cenário A: Pasta Fornecida**
+
+```markdown
+1. Listar arquivos na pasta
+2. Filtrar arquivos de reunião:
+   - Extensões: .md, .txt, .transcript, .json
+   - Padrões de nome: *meeting*, *reunion*, *transcript*, *extract*
+3. Ordenar por data (se disponível)
+4. Validar que são arquivos de reunião válidos
+5. Coletar lista de arquivos para processar
+```
+
+**Cenário B: Arquivo(s) Fornecido(s)**
+
+```markdown
+1. Validar que arquivo(s) existe(m)
+2. Verificar se são arquivos de reunião válidos
+3. Coletar lista de arquivos para processar
+```
+
+### Passo 3: Preparar Contexto para o Consolidador
+
+Antes de invocar @meeting-consolidator, preparar contexto estruturado:
+
+```markdown
+## Contexto da Consolidação
+
+### Arquivos a Consolidar
+{{lista_de_arquivos}}
+
+### Foco da Análise
+{{focus}} (all|divergences|convergences|insights|gaps)
+
+### Informações dos Arquivos
+{{metadados_dos_arquivos}}
+```
+
+**Metadados a Coletar:**
+- Nome do arquivo
+- Data da reunião (se disponível)
+- Participantes (se disponível)
+- Tipo de reunião (se identificável)
+- Duração (se disponível)
+
+### Passo 4: Invocar o Consolidador de Reuniões
+
+Invocar @meeting-consolidator com o contexto preparado:
+
+```markdown
+@meeting-consolidator
+
+Consolidar as seguintes reuniões:
+
+**Arquivos a Consolidar:**
+{{lista_de_arquivos_com_paths}}
+
+**Foco da Análise:**
+{{focus}}
+
+**Metadados:**
+{{metadados_estruturados}}
+
+Por favor, execute consolidação completa incluindo:
+1. Classificação e categorização por tema
+2. Identificação de divergências entre participantes/reuniões
+3. Identificação de convergências e pontos de alinhamento
+4. Geração de insights estratégicos não explícitos
+5. Identificação de pontos não ditos ou não compreendidos
+6. Principais pontos de atenção
+7. Recomendações estratégicas
+
+Gere output completo e estruturado conforme template de consolidação.
+```
+
+**Se foco específico for fornecido:**
+
+```markdown
+@meeting-consolidator
+
+{{foco_especifico}} das seguintes reuniões:
+
+**Arquivos:**
+{{lista_de_arquivos}}
+
+**Foco:**
+- Se "divergences": Identificar apenas divergências e conflitos
+- Se "convergences": Identificar apenas convergências e alinhamentos
+- Se "insights": Gerar apenas insights estratégicos
+- Se "gaps": Identificar apenas pontos não ditos/compreendidos
+```
+
+### Passo 5: Validar Output do Consolidador
+
+Verificar se a consolidação criada contém:
+
+- ✅ **Classificação por Tema**: Temas agrupados e categorizados
+- ✅ **Divergências**: Conflitos e desalinhamentos identificados
+- ✅ **Convergências**: Pontos de alinhamento identificados
+- ✅ **Insights Estratégicos**: Padrões e conexões revelados
+- ✅ **Pontos Não Ditos/Compreendidos**: Sessão exclusiva criada
+- ✅ **Principais Pontos de Atenção**: Priorizados por criticidade
+- ✅ **Recomendações Estratégicas**: Ações sugeridas
+
+### Passo 6: Salvar Consolidação
+
+Salvar a consolidação criada em arquivo estruturado:
+
+```markdown
+# Salvar em: docs/meet/consolidation-[data]-[tema].md
+
+# Consolidação de Reuniões: [Tema Principal]
+
+**Data da Consolidação**: {{data_atual}}
+**Reuniões Consolidadas**: {{numero}} reuniões
+**Período**: {{data_inicial}} - {{data_final}}
+**Participantes**: {{lista_participantes}}
+
+{{conteudo_da_consolidacao}}
+```
+
+## 📤 Output Esperado
+
+O comando deve produzir:
+
+1. **Consolidação Completa** seguindo template estruturado
+2. **Classificação por Tema** com categorização clara
+3. **Divergências Identificadas** com recomendações
+4. **Convergências Identificadas** para capitalizar
+5. **Insights Estratégicos** não explícitos
+6. **Sessão Exclusiva** com pontos não ditos/compreendidos
+7. **Principais Pontos de Atenção** priorizados
+8. **Recomendações Estratégicas** acionáveis
+
+## 🔗 Referências
+
+- **Agente**: @meeting-consolidator
+- **Comando Relacionado**: /product/extract-meeting (extração estruturada)
+- **Knowledge Base**: `docs/knowbase/concepts/meeting-transcription-to-knowledge-base.md`
+
+## ⚠️ Notas Importantes
+
+### Regras Críticas
+
+1. **Sempre validar arquivos** antes de processar
+2. **Sempre coletar metadados** quando disponíveis
+3. **Sempre identificar foco** se especificado
+4. **Sempre salvar output** em local apropriado
+5. **Sempre incluir sessão exclusiva** com pontos não ditos/compreendidos
+
+### Quando Usar Este Comando
+
+Use `/product/consolidate-meetings` quando:
+
+- Há múltiplas reuniões sobre o mesmo tema
+- Necessita identificar padrões entre reuniões
+- Quer descobrir divergências ou convergências
+- Precisa de insights estratégicos não explícitos
+- Quer identificar pontos não ditos ou não compreendidos
+- Necessita visão consolidada de múltiplas discussões
+
+### Exemplos de Uso
+
+```bash
+# Consolidar todas as reuniões de uma pasta
+/product/consolidate-meetings "docs/meet/gamification-meetings/"
+
+# Consolidar arquivos específicos
+/product/consolidate-meetings "docs/meet/meeting-1.md docs/meet/meeting-2.md docs/meet/meeting-3.md"
+
+# Foco em divergências
+/product/consolidate-meetings "docs/meet/gamification-meetings/" --focus="divergences"
+
+# Foco em insights estratégicos
+/product/consolidate-meetings "docs/meet/strategic-planning/" --focus="insights"
+
+# Foco em pontos não ditos/compreendidos
+/product/consolidate-meetings "docs/meet/audio-recording-dec-1-9-38-extract.md" --focus="gaps"
+```
+
+### Focos Disponíveis
+
+| Foco | Descrição |
+|------|-----------|
+| `all` | Consolidação completa (padrão) |
+| `divergences` | Apenas divergências e conflitos |
+| `convergences` | Apenas convergências e alinhamentos |
+| `insights` | Apenas insights estratégicos |
+| `gaps` | Apenas pontos não ditos/compreendidos |
+
+## 🎯 Checklist de Validação
+
+Antes de considerar a consolidação completa, verificar:
+
+- [ ] Arquivos de reunião identificados e validados
+- [ ] Metadados coletados quando disponíveis
+- [ ] Classificação por tema realizada
+- [ ] Divergências identificadas
+- [ ] Convergências identificadas
+- [ ] Insights estratégicos gerados
+- [ ] Pontos não ditos/compreendidos identificados
+- [ ] Principais pontos de atenção priorizados
+- [ ] Recomendações estratégicas fornecidas
+- [ ] Output salvo em local apropriado
+
+---
+
+**Última Atualização**: 2025-12-01  
+**Versão**: 3.0.0  
+**Agente Relacionado**: @meeting-consolidator
+
+
+
+---
+
+## 📚 Pré-requisitos
+
+Domine comandos starter antes de usar este comando intermediate/advanced.
+
+Consulte os comandos help para ver hierarquia completa e comandos relacionados:
+- /business/help --level=starter
+- /technical/help --level=starter
+
+💡 Comandos intermediate/advanced assumem familiaridade com workflows básicos do contexto.