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

package/templates/.cursor/commands/product/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/.cursor/commands/product/light-arch.md

@@ -0,0 +1,97 @@
+---
+name: light-arch
+description: Design de arquitetura leve para features.
+model: sonnet
+category: product
+tags: [architecture, design, planning]
+version: "4.0.0"
+updated: "2025-12-20"
+level: intermediate
+context: business
+---
+
+# Início da Engenharia
+
+Este é o comando para disparar o início do design de arquitetura para uma funcionalidade.
+
+## Análise
+
+1. Passe pelos cards, pais e filhos se necessário, e construa um entendimento inicial do que precisa ser construído. Pense cuidadosamente sobre o que é solicitado, certifique-se de que entende exatamente:
+    - Por que isso está sendo construído (contexto)
+    - Qual é o resultado esperado para esta task? (objetivo)
+    - Como deve ser construído, apenas direcionalmente, não em detalhes (abordagem)
+    - Se requer usar novas APIs/ferramentas, você as entende?
+    - Como deve ser testado?
+    - Quais são as dependências?
+    - Quais são as restrições?
+
+2. Depois de refletir sobre essas perguntas, elabore os 3-5 esclarecimentos mais importantes necessários para completar a tarefa.
+
+3. Pergunte ao humano essas questões, ao mesmo tempo fornecendo seu entendimento e sugestões. PAUSE para aguardar as respostas do humano.
+
+4. Depois de obter as respostas do humano, considere se precisa fazer mais perguntas. Se sim, faça mais perguntas ao humano. PAUSE para aguardar as respostas do humano.
+
+5. Uma vez que tenha um bom entendimento do que está sendo construído, declare-o claramente de volta ao humano para revisão. Faça isso na forma de um artefato para que seja mais fácil de revisar.
+
+6. Se o humano concordar com seu entendimento, você pode proceder para o próximo passo. Caso contrário, continue iterando juntos até obter aprovação explícita para prosseguir.
+
+7. Se algo que vocês discutiram aqui afeta o que foi escrito nos requisitos, peça permissão ao humano para editar esses requisitos e fazer ajustes seja editando (mudanças estruturais) ou adicionando comentários (esclarecimentos). Se o requisito está em um card do ClickUp, edite o card do ClickUp.
+
+8. Não proceda para o próximo passo a menos que o humano tenha claramente dado o sinal verde nesta fase.
+
+## Arquitetura
+
+Dado seu entendimento do que será construído, você agora procederá ao desenvolvimento da arquitetura da funcionalidade. O documento de arquitetura deve mapear o que está sendo construído, os componentes, as dependências, os padrões, as tecnologias, as restrições, as suposições, os trade-offs, as alternativas, as consequências.
+
+Aqui é onde você colocará seu chapéu de super pensamento e considerará o melhor caminho para construir a funcionalidade, ao mesmo tempo considerando os padrões e melhores práticas para este projeto.
+
+1. Passe pelo código-fonte relevante, entenda sua estrutura e propósito e procure pelos arquivos importantes para esta implementação.
+
+2. Revise os documentos de meta specs técnicas do projeto para garantir que esta funcionalidade se alinhe com nossa visão técnica
+
+3. Construa uma proposta de arquitetura que se alinhe com os padrões e melhores práticas do projeto.
+
+Dicas:
+   - Use as ferramentas code-expert (se disponíveis) para encontrar arquivos específicos baseados nas respostas de descoberta
+   - Mergulhe fundo em funcionalidades e padrões similares
+   - Analise detalhes específicos de implementação
+   - Use WebSearch ou context7 para melhores práticas ou documentação de biblioteca (se necessário)
+
+Seu documento de arquitetura deve incluir:
+    - Uma visão geral de alto nível do sistema (antes e depois da mudança)
+    - Componentes afetados e seus relacionamentos, dependências
+    - Padrões e melhores práticas que serão mantidos ou introduzidos
+    - Dependências externas que serão usadas ou que precisam ser adicionadas ao projeto
+    - Restrições e suposições
+    - Trade-offs e alternativas
+    - Consequências negativas (se houver) ao implementar este design
+    - Lista dos principais arquivos a serem editados/criados
+
+Se ajudar a construir um diagrama MERMAID, sinta-se livre para fazê-lo.
+
+4. Se, em algum ponto, você tiver perguntas ou se encontrar algo que contradiz o que entendeu anteriormente, peça esclarecimento ao humano.
+
+5. Uma vez que tenha um bom entendimento do que está sendo construído, mostre ao usuário na forma de um artefato e aguarde sua aprovação. Iterate juntos até estar pronto. PAUSE para aguardar a aprovação do humano.
+
+6. Quando o humano concordar com seu entendimento, você pode proceder ao próximo passo, salvando os detalhes da arquitetura no card do ClickUp como um comentário ao card original.
+
+## Pesquisa
+
+Se não tiver certeza de como uma biblioteca específica funciona, você pode usar Context7 e Perplexity para buscar informações sobre ela. Então, não tente adivinhar.
+
+<feature-slug>
+#$ARGUMENTS
+</feature-slug>
+
+
+---
+
+## 📚 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/.cursor/commands/product/presentation.md

@@ -0,0 +1,189 @@
+---
+name: presentation
+description: |
+  Criação de apresentações profissionais via Gamma.app.
+  Use para gerar apresentações a partir de temas, tasks ou documentos.
+model: sonnet
+
+parameters:
+  - name: topic
+    description: Tema, task_id ou documento para a apresentação
+    required: true
+  - name: type
+    description: Tipo (pitch/product/technical/business/report)
+    required: false
+
+category: product
+tags:
+  - presentation
+  - gamma
+  - content
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /product/task
+  - /docs/build-business-docs
+
+related_agents:
+  - presentation-orchestrator
+  - storytelling-business-specialist
+  - gamma-api-specialist
+level: advanced
+context: business
+---
+
+# 🎨 Criação de Apresentações
+
+Wrapper para criação de apresentações via @presentation-orchestrator.
+
+## 🎯 Objetivo
+
+Criar apresentações profissionais no Gamma.app de forma automatizada.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Identificar Tipo de Input
+
+Analisar `{{topic}}` para determinar fonte:
+
+| Pattern | Tipo | Ação |
+|---------|------|------|
+| `86adf...` | Task ID | Buscar dados no ClickUp |
+| `docs/...` | Documento | Ler arquivo |
+| Texto livre | Tema | Pesquisar codebase |
+
+### Passo 2: Detectar Tipo de Apresentação
+
+SE `{{type}}` fornecido → usar diretamente
+SENÃO → inferir do contexto:
+
+| Contexto | Tipo Inferido |
+|----------|---------------|
+| Investidores, funding | `pitch` |
+| Novo recurso, release | `product` |
+| Arquitetura, API | `technical` |
+| Resultados, métricas | `business` |
+| Status, progresso | `report` |
+
+### Passo 3: Coletar Dados
+
+#### Task ClickUp
+
+```
+Buscar via mcp_clickup:
+- Nome e descrição
+- Subtasks e progresso
+- Comentários relevantes
+- Métricas associadas
+```
+
+#### Documento
+
+```
+Ler arquivo e extrair:
+- Título e resumo
+- Pontos principais
+- Dados e métricas
+- Conclusões
+```
+
+#### Tema Geral
+
+```
+Pesquisar no codebase:
+- Arquivos relacionados
+- Documentação existente
+- README e specs
+```
+
+### Passo 4: Estruturar Narrativa
+
+Delegar para @storytelling-business-specialist:
+
+```
+Definir:
+- Audiência-alvo
+- Objetivo da apresentação
+- Arco narrativo
+- Pontos-chave (5-10)
+```
+
+### Passo 5: Gerar Apresentação
+
+Invocar @presentation-orchestrator com:
+
+```yaml
+topic: [tema extraído]
+type: [tipo detectado]
+audience: [audiência]
+key_points: [pontos-chave]
+data: [dados coletados]
+```
+
+### Passo 6: Entregar Resultado
+
+## 📤 Output Esperado
+
+### Sucesso
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ APRESENTAÇÃO CRIADA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 [Título da Apresentação]
+
+📋 Detalhes:
+∟ Tipo: Product Launch
+∟ Slides: 12
+∟ Audiência: Stakeholders
+∟ Fonte: Task #86adf8jj6
+
+🎨 Assets:
+∟ Gamma: https://gamma.app/docs/xxx
+∟ PDF: apresentacao.pdf
+∟ Outline: outline.md
+
+🚀 Próximos Passos:
+∟ Revisar conteúdo
+∟ Ajustar design
+∟ Compartilhar com equipe
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Tipos de Apresentação
+
+| Tipo | Slides | Estrutura |
+|------|--------|-----------|
+| `pitch` | 10-15 | Problema → Solução → Mercado → Tração → Ask |
+| `product` | 8-12 | Contexto → Feature → Demo → Benefícios → CTA |
+| `technical` | 12-20 | Arquitetura → Componentes → Fluxos → API |
+| `business` | 10-15 | Contexto → Resultados → Análise → Próximos |
+| `report` | 5-10 | Status → Progresso → Bloqueios → Timeline |
+
+## 🔗 Referências
+
+- Agente principal: @presentation-orchestrator
+- Storytelling: @storytelling-business-specialist  
+- API técnica: @gamma-api-specialist
+
+## ⚠️ Notas
+
+- Requer Gamma.app configurado (GAMMA_API_KEY)
+- Para config: `/meta/setup-integration gamma`
+- Tempo médio: 2-5 minutos por apresentaçã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.

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

@@ -0,0 +1,186 @@
+---
+name: refine
+description: Refinar requisitos através de perguntas de esclarecimento.
+model: sonnet
+category: product
+tags: [requirements, refinement, clarification]
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /product/estimate
+  - /product/task
+
+related_agents:
+  - story-points-framework-specialist
+  - product-agent
+level: starter
+context: business
+---
+
+Você é um especialista em produto encarregado de ajudar um humano a refinar requisitos para um projeto em que estão trabalhando. Seu objetivo é pegar um requisito inicial, fazer perguntas de esclarecimento, resumir seu entendimento e criar um arquivo markdown com os requisitos refinados. Siga estes passos:
+
+1. Fase de Esclarecimento:
+   Leia o requisito inicial. Faça perguntas de esclarecimento para alcançar clareza sobre o objetivo da funcionalidade e seus detalhes de requisito. Continue fazendo perguntas até ter um entendimento abrangente da funcionalidade.
+
+2. Fase de Resumo e Aprovação:
+   Uma vez que tenha coletado informações suficientes, apresente um resumo de seu entendimento ao usuário. Use o seguinte formato:
+   <summary>
+   Com base em nossa discussão, aqui está meu entendimento dos requisitos da funcionalidade:
+   [Forneça um resumo conciso da funcionalidade, seus objetivos e requisitos principais]
+   Este entendimento está correto? Você gostaria de fazer alguma mudança ou adição?
+   </summary>
+
+   Se o usuário solicitar mudanças ou fornecer informações adicionais, incorpore o feedback dele e apresente um resumo atualizado para aprovação.
+   Você também pode decidir pesquisar algo tanto no código-base quanto na internet antes de se comprometer com uma saída. Sinta-se livre se isso for necessário.
+
+3. Criando o Arquivo Markdown:
+   Uma vez que o usuário aprove seu resumo, você precisa salvar os requisitos. A localização depende da solicitação:
+
+   - Se a solicitação para refinar foi feita baseada em um arquivo, edite o arquivo.
+   - Se foi feita baseada em uma task do gerenciador configurado, então atualize a task via Task Manager abstraction.
+
+4. Recalcular Story Points (Automático):
+   **CRÍTICO:** Após refinamento, SEMPRE recalcular story points e manter histórico.
+
+   ```markdown
+   ## 4.1. Obter Estimativa Anterior (se existir)
+   
+   Se task do gerenciador configurado:
+   - Ler custom field "Story Points" atual
+   - Ler comentários anteriores com estimativas
+   - Identificar última estimativa registrada
+   
+   ## 4.2. Recalcular Estimativa
+   
+   @story-points-framework-specialist
+   
+   Por favor, recalcule story points para a seguinte tarefa REFINADA:
+   
+   **Tarefa:** [título refinado]
+   **Descrição refinada:** [descrição completa após refinamento]
+   **Estimativa anterior:** [X pontos] (se existir)
+   
+   **Mudanças identificadas:**
+   - [lista de mudanças que afetam esforço]
+   
+   Forneça nova estimativa considerando as mudanças.
+   ```
+
+   ## 4.3. Comparar e Documentar Histórico
+   
+   ```typescript
+   const previousEstimate = getPreviousEstimate(taskId);
+   const newEstimate = await recalculateStoryPoints(refinedDescription);
+   
+   const change = {
+     date: new Date(),
+     previous: previousEstimate?.points,
+     current: newEstimate.points,
+     delta: newEstimate.points - (previousEstimate?.points || 0),
+     reason: 'Refinamento de requisitos',
+     changes: identifiedChanges
+   };
+   
+   // Atualizar task com nova estimativa
+   await updateTaskWithEstimate(taskId, newEstimate, change);
+   ```
+
+   O template para sua saída de requisitos é:
+
+   <markdown>
+   # [NOME DA FUNCIONALIDADE]
+
+   ## POR QUE
+   [Liste as razões para construir esta funcionalidade]
+
+   ## O QUE
+   [Descreva o que precisa ser construído ou modificado -- inclua funcionalidades existentes que serão afetadas]
+
+   ## COMO
+   [Forneça quaisquer detalhes extras que possam ser úteis para um Desenvolvedor IA]
+
+   ## 📊 ESTIMATIVA DE STORY POINTS
+   
+   **Atual:** [X] pontos
+   
+   **Histórico de Mudanças:**
+   | Data | Estimativa | Mudança | Motivo |
+   |------|------------|---------|--------|
+   | [data inicial] | [X] pontos | - | Criação inicial |
+   | [data refinamento] | [Y] pontos | [+/-Z] | Refinamento de requisitos |
+   
+   **Análise Atual:**
+   - Complexidade: [alta/média/baixa]
+   - Risco: [alto/médio/baixo]
+   - Incerteza: [alta/média/baixa]
+   
+   **Fatores que influenciaram a estimativa:**
+   - [fator 1]
+   - [fator 2]
+   </markdown>
+   
+   ## 4.4. Atualizar Task no Gerenciador (se aplicável)
+   
+   ```typescript
+   // Via Task Manager abstraction - funciona para qualquer provedor
+   const taskManager = getTaskManager();
+   
+   // Atualizar custom field Story Points
+   await taskManager.updateTask(taskId, {
+     customFields: {
+       'Story Points': newEstimate.points
+     }
+   });
+   
+   // Adicionar comentário com histórico
+   await taskManager.addComment(taskId,
+     '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n' +
+     '🔄 ESTIMATIVA ATUALIZADA APÓS REFINAMENTO\n' +
+     '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n' +
+     `📅 Data: ${new Date().toLocaleDateString('pt-BR')}\n\n` +
+     `📊 HISTÓRICO:\n` +
+     `∟ Estimativa anterior: ${previousEstimate?.points || 'N/A'} pontos\n` +
+     `∟ Nova estimativa: ${newEstimate.points} pontos\n` +
+     `∟ Mudança: ${change.delta > 0 ? '+' : ''}${change.delta} pontos\n\n` +
+     `⚡ ANÁLISE ATUAL:\n` +
+     `∟ Complexidade: ${newEstimate.complexity}\n` +
+     `∟ Risco: ${newEstimate.risk}\n` +
+     `∟ Incerteza: ${newEstimate.uncertainty}\n\n` +
+     `📝 MUDANÇAS QUE AFETARAM A ESTIMATIVA:\n` +
+     `${change.changes.map(c => `- ${c}`).join('\n')}\n\n` +
+     `💡 RECOMENDAÇÕES:\n` +
+     `${newEstimate.recommendations}\n` +
+     '━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'
+   );
+   ```
+
+   Lembre-se, a audiência para este documento é um Desenvolvedor IA com capacidades e contexto similares ao seu. Seja conciso mas forneça informações suficientes para que a IA entenda e prossiga com a tarefa.
+
+O requisito para analisar é:
+<requirement>
+#$ARGUMENTS
+</requirement>
+
+---
+
+## 🚀 Próximos Passos
+
+Agora que você refinou a especificação, considere:
+
+1. **Re-estimar após refinamento**:
+   ```bash
+   /business/estimate "feature-name"
+   ```
+   Especificações mais detalhadas geram estimativas mais precisas.
+
+2. **Validar com stakeholders**:
+   Use `@product-agent` para revisar a spec refinada e identificar possíveis gaps.
+
+3. **Criar task atualizada**:
+   ```bash
+   /business/task "feature-name"
+   ```
+   Gera task com a especificação refinada e estimativa atualizada.
+
+💡 **Dica**: Refinamento iterativo é normal - specs evoluem conforme aprendemos mais sobre o problema.