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

package/templates/.onion/contexts/business/commands/help.md

@@ -0,0 +1,212 @@
+---
+name: help
+description: Lista comandos disponíveis do contexto Business organizados por nível de complexidade
+model: sonnet
+category: business
+tags: [help, discovery, onboarding, levels]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: business
+---
+
+# Business Context - Help
+
+Lista todos os comandos disponíveis no contexto **Business**, organizados por nível de complexidade (starter, intermediate, advanced).
+
+---
+
+## 🎯 Uso
+
+```bash
+# Listar comandos starter (padrão - 80% dos casos)
+/business/help
+
+# Listar comandos de um nível específico
+/business/help --level=starter
+/business/help --level=intermediate
+/business/help --level=advanced
+
+# Listar todos os comandos
+/business/help --level=all
+```
+
+---
+
+## 📋 Sistema de Níveis
+
+O Sistema Onion organiza comandos em **3 níveis** baseados na frequência de uso:
+
+| Nível | % Uso | Descrição | Onboarding |
+|-------|-------|-----------|------------|
+| **Starter** | 80% | Comandos essenciais para uso diário | ~15 min |
+| **Intermediate** | 15% | Workflows avançados e especializados | ~30 min |
+| **Advanced** | 5% | Casos específicos e automações complexas | ~45 min |
+
+---
+
+## 📊 Comandos Disponíveis
+
+Você me pediu para executar o comando help. Vou listar os comandos organizados por nível:
+
+### 🌟 STARTER COMMANDS (5 comandos - 80% dos casos)
+**⏱️ Tempo de onboarding: ~15 minutos**
+
+Estes são os comandos que você usará no dia a dia:
+
+1. **`/business/spec "feature-name"`**
+   - Criar especificação de produto a partir de requisitos iniciais
+   - Use quando: Precisar documentar uma nova feature ou requisito
+   - Exemplo: `/business/spec "dashboard-analytics"`
+
+2. **`/business/task "task-description"`**
+   - Criar task no gerenciador com estimativa de story points
+   - Use quando: Converter especificação em task rastreável
+   - Exemplo: `/business/task "implementar filtro de datas"`
+
+3. **`/business/estimate "feature"`**
+   - Estimar story points de uma feature usando framework estruturado
+   - Use quando: Precisar dimensionar esforço de desenvolvimento
+   - Exemplo: `/business/estimate "sistema de notificações"`
+
+4. **`/business/refine "spec.md"`**
+   - Refinar e validar especificação existente, identificar gaps
+   - Use quando: Spec inicial precisa de mais detalhes ou clareza
+   - Exemplo: `/business/refine "docs/specs/user-auth.md"`
+
+5. **`/business/warm-up`**
+   - Preparar contexto do projeto, carregar informações relevantes
+   - Use quando: Iniciar trabalho em nova sessão ou projeto
+   - Exemplo: `/business/warm-up`
+
+---
+
+### 🔧 INTERMEDIATE COMMANDS (10 comandos - 15% dos casos)
+**⏱️ Tempo de onboarding: ~30 minutos**
+
+Comandos para workflows mais avançados:
+
+1. **`/business/collect`** - Coletar informações de múltiplas fontes
+2. **`/business/light-arch`** - Criar arquitetura leve de solução
+3. **`/business/extract-meeting`** - Extrair ações e decisões de reunião
+4. **`/business/consolidate-meetings`** - Consolidar múltiplas reuniões
+5. **`/business/convert-to-tasks`** - Converter especificações em tasks
+6. **`/business/whisper`** - Transcrever áudio de reunião
+7. **`/business/task-check`** - Validar completude de task
+8. **`/business/validate-task`** - Validar task contra critérios
+9. **`/business/check`** - Verificar conformidade de especificação
+10. **`/business/feature`** - Criar feature completa (spec + tasks)
+
+---
+
+### ⚡ ADVANCED COMMANDS (5 comandos - 5% dos casos)
+**⏱️ Tempo de onboarding: ~45 minutos**
+
+Comandos especializados para casos específicos:
+
+1. **`/business/transform-consolidated`** - Transformar reuniões consolidadas em docs estruturados
+2. **`/business/presentation`** - Criar apresentação profissional via Gamma
+3. **`/business/branding`** - Análise e estratégia de branding/posicionamento
+4. **`/business/analyze-pain-price`** - Análise detalhada de dor vs preço
+5. **`/business/checklist-sync`** - Sincronizar checklists com task manager
+
+---
+
+## 🚀 Próximos Passos
+
+### Se você é novo no Business Context:
+
+1. **Comece pelos Starter Commands** (os 5 primeiros)
+   - Foque em `/business/spec` e `/business/task`
+   - Pratique criando uma spec simples
+   - Tempo estimado: 15-30 minutos
+
+2. **Explore um Intermediate Command**
+   - Experimente `/business/feature` para workflow completo
+   - Ou `/business/extract-meeting` se trabalha com reuniões
+   - Tempo estimado: +30 minutos
+
+3. **Descubra Agentes Especializados**
+   ```bash
+   @product-agent              # Orquestração de produto
+   @story-points-specialist    # Estimativas precisas
+   @extract-meeting-specialist # Extração de reuniões
+   ```
+
+### Pronto para Technical Context?
+
+Uma vez confortável com Business, explore:
+```bash
+/technical/help              # Comandos de desenvolvimento
+/technical/work "task-id"    # Iniciar desenvolvimento
+```
+
+---
+
+## 📚 Documentação Relacionada
+
+- **Sistema de Níveis**: `docs/onion/levels-system.md`
+- **READMEs**: `.onion/contexts/business/README.md`
+- **Agentes**: `.onion/contexts/business/agents/`
+- **Configuração**: `.onion/contexts/business/.context-config.yml`
+
+---
+
+## 💡 Dicas Úteis
+
+### Filosofia 80/15/5
+- **80%** do seu tempo: Use apenas comandos **starter**
+- **15%** do seu tempo: Use comandos **intermediate**
+- **5%** do seu tempo: Use comandos **advanced**
+
+### Descoberta Progressiva
+Cada comando inclui seção "🚀 Próximos Passos" sugerindo o que fazer em seguida.
+
+### Flags e Opções
+```bash
+--level=starter       # Filtrar por nível
+--level=all          # Ver todos os níveis
+```
+
+---
+
+## 🎓 Onboarding Recomendado
+
+### Dia 1 (30 minutos)
+1. Execute `/business/warm-up`
+2. Pratique `/business/spec "test-feature"`
+3. Teste `/business/estimate "test-feature"`
+
+### Semana 1 (2 horas)
+- Domine os 5 starter commands
+- Experimente 2-3 intermediate commands
+- Crie specs reais do seu projeto
+
+### Mês 1 (5 horas)
+- Explore todos os intermediate commands
+- Teste 1-2 advanced commands conforme necessidade
+- Integre no workflow diário
+
+---
+
+**📊 Estatísticas do Business Context:**
+- **Total**: 20 comandos
+- **Starter**: 5 (25%)
+- **Intermediate**: 10 (50%)
+- **Advanced**: 5 (25%)
+- **Agentes**: 12 especializados
+- **Tempo total onboarding**: ~90 minutos (todos os níveis)
+
+---
+
+## 🆘 Precisa de Ajuda?
+
+- **Help de outro contexto**: `/technical/help`, `/customer-success/help`
+- **Help global**: `/help`
+- **Agente de ajuda**: `@onion` (orquestrador principal)
+- **Documentação**: `docs/onion/`
+
+---
+
+**Sistema Onion v4.0** - Multi-Context Development Orchestrator 🧅
+

package/templates/.onion/contexts/business/commands/intermediate/check.md

@@ -0,0 +1,48 @@
+---
+name: check
+description: Verificar requisitos contra meta-specs do projeto.
+model: sonnet
+category: product
+tags: [validation, metaspec, product]
+version: "4.0.0"
+updated: "2025-12-20"
+level: intermediate
+context: business
+---
+
+# Verificação de Produto
+
+Você é um especialista em produto encarregado de ajudar um humano a analisar seus requisitos de produto verificando-os contra as meta especificações do projeto.
+
+As Meta Specs são documentos vivos que incorporam contexto de negócio, intenções estratégicas, critérios de sucesso e instruções executáveis que podem ser interpretadas tanto por humanos quanto por sistemas de IA. Elas funcionam como o "DNA" de um projeto - contendo todas as informações necessárias para gerar documentação de funcionalidades e validá-la conforme é produzida a partir de princípios fundamentais.
+
+Como a "Constituição" do projeto, elas garantem que toda solução esteja alinhada com objetivos estratégicos, personas de usuário e realidades operacionais da organização. Ao combinar princípios de Engenharia de Contexto com especificações executáveis, as Meta Specs se tornam o artefato primário de valor e validação.
+
+O usuário apresentará uma ou mais funcionalidades que planeja construir.
+
+Seu objetivo é revisar as funcionalidades descritas na solicitação e garantir que elas se alinhem com as meta specs do projeto. Então, você fornecerá uma resposta no seguinte formato:
+
+```
+[título da funcionalidade]
+
+[descrição da funcionalidade em 2 parágrafos]
+
+# Alinhamento com Meta Spec
+
+## Alinhamento
+
+- Liste tudo que está alinhado/bom de acordo com a meta spec.
+
+## Desalinhamento
+
+- Liste tudo que não está alinhado/ruim de acordo com a meta spec. Explique por quê. Cite a meta spec que contradiz esta funcionalidade.
+
+```
+
+Não faça mudanças no código ou requisitos a menos que o usuário peça.
+
+O usuário forneceu os seguintes argumentos:
+
+<arguments>
+#$ARGUMENTS
+</arguments>

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