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

package/templates/.onion/contexts/business/commands/intermediate/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.

package/templates/.onion/contexts/business/commands/intermediate/extract-meeting.md

@@ -0,0 +1,241 @@
+---
+name: extract-meeting
+description: |
+  Extração estruturada de conhecimento de transcrições de reuniões usando Framework EXTRACT.
+  Use para transformar arquivos de contexto bruto em artefatos de alto valor para humanos, sistemas e IA.
+model: sonnet
+
+parameters:
+  - name: source
+    description: Caminho do arquivo ou pasta com transcrição(ões)
+    required: true
+  - name: level
+    description: Nível de output (compact, executive, complete, graph)
+    required: false
+  - name: focus
+    description: Foco específico (decisions, tasks, gaps, all)
+    required: false
+
+category: product
+tags:
+  - meeting
+  - extraction
+  - knowledge-base
+  - documentation
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /product/task
+  - /docs/build-tech-docs
+  - /meta/create-knowledge-base
+
+related_agents:
+  - extract-meeting-specialist
+  - product-agent
+  - task-specialist
+
+knowledge_bases:
+  - docs/knowbase/concepts/meeting-transcription-to-knowledge-base.md
+level: intermediate
+context: business
+---
+
+# 📋 Extrair Conhecimento de Reunião
+
+Transformação de transcrições brutas em conhecimento estruturado usando o Framework EXTRACT.
+
+## 🎯 Objetivo
+
+Processar transcrições de reuniões e gerar outputs estruturados consumíveis por humanos, sistemas e IA, seguindo as 7 dimensões do Framework EXTRACT.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Validar Input
+
+```bash
+# Verificar se source existe
+test -e "{{source}}" || echo "❌ Arquivo/pasta não encontrado"
+
+# Identificar tipo (arquivo ou pasta)
+if [ -d "{{source}}" ]; then
+  echo "📁 Processando pasta com múltiplos arquivos"
+  FILES=$(find "{{source}}" -type f \( -name "*.txt" -o -name "*.md" \))
+else
+  echo "📄 Processando arquivo único"
+  FILES="{{source}}"
+fi
+```
+
+### Passo 2: Ler Conteúdo
+
+```bash
+# Ler transcrição(ões)
+read_file "{{source}}"
+```
+
+### Passo 3: Aplicar Framework EXTRACT
+
+Invocar `@extract-meeting-specialist` com instruções:
+
+```markdown
+## Tarefa
+Processar a transcrição abaixo aplicando o Framework EXTRACT completo.
+
+## Framework EXTRACT (7 Dimensões)
+- **E**ssência: Resumo executivo em 3 linhas
+- **X**pectativas: Objetivos da reunião e status (atingido/parcial/não)
+- **T**arefas: Ações definidas (quem, o quê, quando)
+- **R**esoluções: Decisões tomadas com justificativa
+- **A**mbiguidades: Gaps, contradições, pontos não resolvidos
+- **C**onexões: Dependências, stakeholders, documentos relacionados
+- **T**imeline: Datas e marcos mencionados
+
+## Nível de Output
+{{level}} (default: executive)
+
+## Foco
+{{focus}} (default: all)
+
+## Regras
+1. NUNCA inventar informações — usar [INFERIDO] ou [NÃO ESPECIFICADO]
+2. Indicar confidence level em decisões (high/medium/low)
+3. Capturar TODOS os gaps — o que NÃO foi decidido é crítico
+4. Tasks devem ter owner + deadline sempre que possível
+5. Preservar citações importantes entre aspas
+
+## Transcrição
+[CONTEÚDO DO ARQUIVO]
+```
+
+### Passo 4: Gerar Output
+
+**Nível `compact`:**
+```markdown
+## Reunião: [Título] | [Data]
+**Decisão**: [Principal decisão]
+**Ações**: [Nome] faz [quê] até [quando]
+**Pendente**: [Principal gap]
+```
+
+**Nível `executive`:**
+```markdown
+## [Título] - [Data]
+
+### Resumo
+[3-5 linhas]
+
+### Decisões
+- ✅ [Decisão 1]
+- ✅ [Decisão 2]
+
+### Ações
+| Responsável | Ação | Prazo |
+|-------------|------|-------|
+| [Nome] | [Descrição] | [Data] |
+
+### Pendências
+- ⚠️ [Gap 1]
+- ⚠️ [Gap 2]
+
+### Timeline
+- 📅 [Data]: [Marco]
+```
+
+**Nível `complete`:**
+Output YAML completo seguindo schema do knowledge base.
+
+**Nível `graph`:**
+JSON com entidades e relacionamentos para sistemas.
+
+### Passo 5: Salvar Resultado
+
+```bash
+# Determinar nome do output
+OUTPUT_NAME=$(basename "{{source}}" | sed 's/\.[^.]*$//')
+OUTPUT_FILE="docs/meetings/${OUTPUT_NAME}-extract.md"
+
+# Criar diretório se não existir
+mkdir -p docs/meetings/
+
+# Salvar
+write "${OUTPUT_FILE}"
+```
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ EXTRAÇÃO CONCLUÍDA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 Arquivo: docs/meetings/[nome]-extract.md
+
+📊 Extração EXTRACT:
+∟ Essência: ✅
+∟ Expectativas: ✅
+∟ Tarefas: [N] itens
+∟ Resoluções: [N] decisões
+∟ Ambiguidades: [N] gaps
+∟ Conexões: [N] links
+∟ Timeline: [N] datas
+
+📈 Qualidade:
+∟ Confidence Score: [0.X]
+∟ Tasks com Owner: [X]%
+∟ Tasks com Deadline: [X]%
+∟ Gaps com Owner Sugerido: [X]%
+
+🚀 Próximos Passos:
+1. Revisar gaps críticos
+2. Validar decisões com participantes
+3. Criar tasks no gerenciador (@task-specialist)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🎯 Exemplos de Uso
+
+```bash
+# Extrair reunião específica (nível executivo default)
+/product/extract-meeting source=rhilo-reuniao-28-nov.txt
+
+# Nível completo com YAML
+/product/extract-meeting source=reuniao.txt level=complete
+
+# Foco apenas em decisões
+/product/extract-meeting source=reuniao.txt focus=decisions
+
+# Processar pasta de contexto
+/product/extract-meeting source=contextos/projeto-x/
+
+# Gerar grafo para sistemas
+/product/extract-meeting source=reuniao.txt level=graph
+```
+
+## 🔗 Referências
+
+- **Agente**: `@extract-meeting-specialist`
+- **Knowledge Base**: `docs/knowbase/concepts/meeting-transcription-to-knowledge-base.md`
+- **Framework**: EXTRACT (7 dimensões)
+
+## ⚠️ Notas
+
+- Processar em até 24h após reunião (contexto fresco)
+- Validar decisões críticas com participantes
+- Gaps são tão importantes quanto decisões
+- Para criar tasks automaticamente, usar `@task-specialist` após extração
+
+
+
+---
+
+## 📚 Pré-requisitos
+
+Domine comandos starter antes de usar este comando intermediate/advanced.
+
+Consulte os comandos help para ver hierarquia completa:
+- /business/help --level=starter
+- /technical/help --level=starter
+
+💡 Comandos intermediate/advanced assumem familiaridade com workflows básicos.