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

package/templates/.cursor/commands/product/convert-to-tasks.md

@@ -0,0 +1,220 @@
+---
+name: convert-to-tasks
+description: |
+  Converte documentos consolidados em tasks organizadas hierarquicamente.
+  Delega para comandos existentes do Sistema Onion para criação de tasks.
+model: sonnet
+
+parameters:
+  - name: source
+    description: Arquivo consolidado ou pasta contendo consolidações
+    required: true
+
+category: product
+tags:
+  - task-generation
+  - consolidated-processing
+  - knowledge-transformation
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /product/task
+  - /product/collect
+  - /product/consolidate-meetings
+  - /docs/consolidate-documents
+
+related_agents:
+  - product-agent
+level: intermediate
+context: business
+---
+
+# 🔄 Converter para Tasks
+
+Converte documentos consolidados em tasks usando comandos existentes do Sistema Onion.
+
+## 🎯 Objetivo
+
+Transformar conhecimento consolidado em tasks acionáveis delegando para comandos especializados:
+- Analisa documento consolidado
+- Extrai elementos acionáveis
+- Cria tasks usando `/product/task` ou `/product/collect`
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Identificar Arquivos Relevantes (Análise Inteligente)
+
+**SE `{{source}}` é arquivo:**
+- Usar arquivo diretamente
+
+**SE `{{source}}` é pasta:**
+- Listar todos os arquivos markdown na pasta (recursivo)
+- Delegar para `@product-agent` identificar arquivos relevantes
+
+```markdown
+@product-agent
+
+Analise os arquivos abaixo e identifique quais são relevantes para converter em tasks:
+
+**Arquivos na pasta {{source}}:**
+{{lista_de_todos_arquivos_markdown_com_paths}}
+
+**Critérios para identificar arquivos relevantes:**
+1. **Documentos Consolidados:**
+   - Contém seções como "Tarefas", "Decisões", "Gaps", "Insights"
+   - Estrutura de consolidação (divergências, convergências, etc)
+   - Metadados de consolidação (data, origem, participantes)
+   - Formato estruturado de conhecimento consolidado
+
+2. **Arquivos Relacionados (que ajudam a construir contexto):**
+   - Análises e estudos relacionados
+   - Documentos de evolução e refinamento
+   - Especificações e requisitos relacionados
+   - Notas e rascunhos que complementam o conhecimento
+   - Documentos de contexto de negócio ou técnico relacionados
+
+3. **Evitar Duplicatas:**
+   - Não incluir versões antigas de documentos já consolidados
+   - Não incluir rascunhos que foram incorporados em documentos finais
+   - Priorizar documentos mais recentes e completos
+   - Identificar documentos que são evoluções/refinamentos de outros
+
+**Para cada arquivo, forneça:**
+- ✅/❌ Relevante para conversão em tasks?
+- Tipo: consolidado | análise | especificação | contexto | outro
+- Relação com outros arquivos (evolução de X, complementa Y, etc)
+- Prioridade de inclusão (alta/média/baixa)
+- Justificativa breve
+
+**Output:** Lista de arquivos relevantes ordenados por prioridade, sem duplicatas, com tipo e relação identificados.
+```
+
+**Processar arquivos identificados:**
+- Ordenar por prioridade (alta → média → baixa)
+- Agrupar por tipo e relação
+- Carregar conteúdo de todos os arquivos relevantes
+
+### Passo 2: Analisar Arquivos Relevantes com @product-agent
+
+Delegar análise completa considerando todos os arquivos relevantes identificados:
+
+```markdown
+@product-agent
+
+Analise os seguintes arquivos (consolidados e relacionados) e extraia elementos acionáveis organizados hierarquicamente:
+
+**Arquivos Relevantes Identificados:**
+{{lista_de_arquivos_relevantes_com_tipos_e_relações}}
+
+**Conteúdo dos Arquivos:**
+{{conteudo_de_todos_os_arquivos_relevantes}}
+
+**Contexto:**
+- Arquivos consolidados fornecem conhecimento estruturado
+- Arquivos relacionados (análises, especificações, contexto) complementam e refinam
+- Considerar evolução e refinamento entre documentos relacionados
+
+**Extraia:**
+- Tarefas identificadas (com título, descrição, owner, deadline, prioridade)
+- Decisões que requerem implementação
+- Gaps críticos que bloqueiam progresso
+- Insights acionáveis de alto valor
+- Hierarquia sugerida (Task → Subtasks)
+- Contexto adicional de arquivos relacionados (para enriquecer tasks)
+
+**Output:** Lista estruturada de tasks prontas para criação, considerando contexto completo de todos os arquivos relevantes.
+```
+
+### Passo 3: Criar Tasks usando Comandos Existentes
+
+Para cada task identificada, usar comandos existentes:
+
+**Para tasks estruturadas (com subtasks):**
+```markdown
+Use /product/task para criar task principal com decomposição hierárquica:
+/product/task "{{descricao_completa_da_task}}"
+```
+
+**Para tasks simples ou ideias:**
+```markdown
+Use /product/collect para criar task de ideia/bug:
+/product/collect "{{titulo_da_task}}"
+```
+
+**Nota:** Os comandos `/product/task` e `/product/collect` já:
+- Detectam Task Manager automaticamente
+- Criam tasks e subtasks hierarquicamente
+- Estimam story points automaticamente
+- Preservam contexto nos comentários
+
+## 📤 Output Esperado
+
+Lista de tasks criadas com IDs e URLs, apresentada de forma clara:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ CONVERSÃO CONCLUÍDA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📄 **Documento:** {{arquivo}}
+📊 **Tasks Criadas:** {{total}}
+
+{{lista_de_tasks_com_urls}}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🎯 Casos de Uso
+
+### Após Consolidar Reuniões
+
+```bash
+# 1. Consolidar reuniões
+/product/consolidate-meetings "docs/meet/sprint-planning/"
+
+# 2. Converter em tasks
+/product/convert-to-tasks "docs/meet/consolidation-*.md"
+```
+
+### Após Consolidar Documentos
+
+```bash
+# 1. Consolidar documentos
+/docs/consolidate-documents "docs/business-context/"
+
+# 2. Converter em tasks
+/product/convert-to-tasks "docs/consolidated/"
+```
+
+## 🔗 Integração
+
+Este comando delega para:
+- **`@product-agent`** - Análise e extração
+- **`/product/task`** - Criação de tasks estruturadas
+- **`/product/collect`** - Criação de tasks simples
+
+Todos os comandos já lidam com:
+- Detecção automática de Task Manager
+- Criação hierárquica (tasks e subtasks)
+- Estimativas automáticas de story points
+- Preservação de contexto
+
+---
+
+**Versão:** 3.0.0  
+**Última atualização:** 2025-12-02
+
+
+
+---
+
+## 📚 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.