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

package/templates/.cursor/commands/git/fast-commit.md

@@ -0,0 +1,45 @@
+---
+name: fast-commit
+description: |
+  Adiciona todas as mudanças e faz commit rápido.
+  Use para commits típicos no fluxo do Sistema Onion.
+model: sonnet
+category: git
+tags: [git, commit, fast]
+version: "4.0.0"
+updated: "2025-12-20"
+level: intermediate
+context: technical
+---
+
+# Fast Commit
+
+Adiciona todas as mudanças e faz commit com mensagem especificada.
+
+## 🎯 Uso
+
+```bash
+/git/fast-commit "feat: implement admin dashboard basic flow"
+```
+
+## ⚡ Fluxo de Execução
+
+1. `git add .` — adiciona todas as mudanças
+2. `git commit -m "<mensagem>"` — commit com a mensagem
+
+## 📋 Convenção de Mensagens
+
+Use [Conventional Commits](https://conventionalcommits.org):
+
+| Tipo | Descrição |
+|------|-----------|
+| `feat:` | Nova funcionalidade |
+| `fix:` | Correção de bug |
+| `docs:` | Documentação |
+| `refactor:` | Refatoração |
+| `chore:` | Manutenção |
+
+## ⚠️ Notas
+
+- SEMPRE revise `git status` antes
+- Prefira commits atômicos e descritivos

package/templates/.cursor/commands/git/feature/finish.md

@@ -0,0 +1,90 @@
+---
+name: finish
+description: Finalizar feature com merge para develop e cleanup.
+model: sonnet
+category: git
+tags: [feature, gitflow, merge]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# ✅ Git Flow - Finalizar Feature
+
+Finalizar desenvolvimento de feature realizando merge seguro para develop branch com validações automáticas e cleanup completo. Processo seguro com confirmações obrigatórias para prevenir erros de produção.
+
+## 🎯 Funcionalidades
+
+### Safety-First e Validações
+- Confirmação obrigatória antes de merge feature → develop
+- Análise automática de conflitos e working directory  
+- Validação de status da develop branch (sincronização)
+- Preview detalhado das mudanças que serão mergeadas
+- Guidance para resolução de problemas encontrados
+
+### GitFlow Compliance e Automação
+- Merge seguindo padrão oficial GitFlow (feature → develop)
+- Cleanup automático de branch local e remote após merge
+- Atualização de ClickUp task e session archival
+- Integração preservada com @gitflow-specialist para operações complexas
+
+### Educação e UX
+- Context display mostrando impacto das mudanças
+- Progress indicators durante operação
+- Educational content sobre GitFlow workflow
+- Next steps guidance após finalização
+
+## 🚀 Como Usar
+
+```bash
+/git/feature/finish                    # Auto-detecta branch atual
+```
+
+**Pré-requisitos**: Execute na branch de feature que deseja finalizar
+
+### Processo Executado
+1. **Análise**: Detecta branch atual e valida estado do repositório
+2. **Validações**: Verifica working directory, conflicts e status develop
+3. **Preview**: Exibe impacto das mudanças (commits, files, lines)
+4. **Confirmação**: Solicita confirmação explícita do usuário  
+5. **Merge**: Executa merge seguro feature → develop
+6. **Cleanup**: Remove branch local/remote e atualiza ClickUp task
+7. **Archive**: Move session para estado finalizado
+
+### Educational Context
+Durante execução, o comando ensina conceitos GitFlow:
+- Visualização do workflow: `develop → feature/name → develop`
+- Impacto da operação na team collaboration
+- Best practices para feature development
+- Guidance para próximos passos
+
+## 🤝 Integração @gitflow-specialist
+
+*Este comando sempre consulta @gitflow-specialist para análise de conflitos, validação de merge strategy, execução segura do merge e guidance para resolução de problemas complexos.*
+
+## ⚠️ Resolução de Problemas
+
+### Uncommitted Changes
+- **Sintoma**: Working directory não está limpo
+- **Solução**: `git add . && git commit -m "final changes"` antes de finalizar
+
+### Merge Conflicts Detectados  
+- **Causa**: Mudanças conflitantes entre feature e develop
+- **Fix**: Resolver conflicts manualmente ou usar `git merge develop` na feature branch primeiro
+
+### Develop Branch Desatualizada
+- **Sintoma**: Develop branch está atrás do remote
+- **Solução**: `git checkout develop && git pull origin develop` antes de finalizar feature
+
+### Tests Failing
+- **Sintoma**: Testes automatizados falhando
+- **Solução**: Corrigir testes ou usar flag de override (não recomendado)
+
+### Feature Branch Não Encontrada
+- **Causa**: Not em uma feature branch ou branch name incorreto
+- **Fix**: `git checkout feature/your-feature-name` antes de executar comando
+
+### Remote Branch Issues
+- **Sintoma**: Problemas com remote branch tracking
+- **Solução**: `git push -u origin feature/name` para estabelecer tracking

package/templates/.cursor/commands/git/feature/publish.md

@@ -0,0 +1,91 @@
+---
+name: publish
+description: Publicar feature branch no remote para colaboração.
+model: sonnet
+category: git
+tags: [feature, gitflow, remote]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 🤝 Git Flow - Publicar Feature
+
+Publicar feature branch para remote repository permitindo colaboração em equipe com setup automático de tracking, validações de readiness e integração com ClickUp para team awareness e code review workflow.
+
+## 🎯 Funcionalidades
+
+### Team Collaboration e Sharing
+- Push seguro da feature branch para remote origin
+- Setup automático de upstream tracking para colaboração
+- Validações de collaboration readiness (tests, commits, documentation)
+- Team notification integration via ClickUp status updates
+- Code review preparation automática
+
+### Git Flow Compliance e Automação  
+- Publicação seguindo padrão oficial GitFlow (feature → remote)
+- Automatic branch tracking configuration
+- ClickUp task status update para "In Review"
+- Team guidance para next steps após publicação
+- Integration com workflows de code review
+
+### Educational e Team UX
+- Context display mostrando impacto da publicação na equipe
+- Progress indicators durante operações de remote
+- Educational content sobre feature collaboration
+- Team guidance e best practices para colaboração
+
+## 🚀 Como Usar
+
+```bash
+/git/feature/publish                   # Publica branch atual (se feature)
+/git/feature/publish feature-name     # Publica feature específica
+```
+
+**Pré-requisitos**: Branch deve existir localmente e ser uma feature branch
+
+### Processo Executado
+1. **Validation**: Verifica se é feature branch e se está ready para publicação
+2. **Readiness Check**: Valida tests, commits, working directory
+3. **Remote Setup**: Configura upstream tracking se necessário
+4. **Push**: Executa push seguro para remote origin
+5. **ClickUp Update**: Atualiza status para "In Review" e notifica team
+6. **Team Guidance**: Fornece next steps para code review workflow
+
+### Team Collaboration Features
+Durante execução, facilita colaboração em equipe:
+- Automatic remote branch creation se não existir
+- Team notification via ClickUp integration
+- Code review readiness validation
+- Next steps guidance para collaboration workflow
+
+## 🤝 Integração @gitflow-specialist
+
+*Este comando sempre consulta @gitflow-specialist para validação de remote operations, configuração de tracking, análise de readiness para team collaboration e guidance para code review preparation.*
+
+## ⚠️ Resolução de Problemas
+
+### Feature Branch Não Encontrada
+- **Sintoma**: Branch especificada não existe localmente
+- **Solução**: `git checkout -b feature/name` ou usar branch existente
+
+### Not on Feature Branch
+- **Causa**: Branch atual não é uma feature branch
+- **Fix**: `git checkout feature/name` ou especificar feature-name no comando
+
+### Remote Already Exists
+- **Sintoma**: Branch já existe no remote com divergências
+- **Solução**: `git pull origin feature/name` para sincronizar antes de publicar
+
+### Tests Failing
+- **Sintoma**: Validation detecta testes falhando
+- **Solução**: Corrigir testes antes da publicação para manter qualidade da team
+
+### Working Directory Not Clean
+- **Causa**: Uncommitted changes impedem publicação segura
+- **Fix**: `git add . && git commit -m "changes"` antes de publicar
+
+### Remote Tracking Issues
+- **Sintoma**: Problemas de configuração de upstream tracking
+- **Solução**: Comando configura automaticamente via @gitflow-specialist

package/templates/.cursor/commands/git/feature/start.md

@@ -0,0 +1,158 @@
+---
+name: start
+description: Iniciar feature branch GitFlow com ambiente configurado.
+model: sonnet
+category: git
+tags: [feature, gitflow, branch]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 🌿 Git Flow - Iniciar Feature
+
+Iniciar desenvolvimento de uma nova funcionalidade criando uma branch GitFlow apropriada e configurando ambiente de desenvolvimento. Integração obrigatória com @gitflow-specialist para guidance especializada.
+
+## 🎯 Funcionalidades
+
+### Criação Inteligente de Feature Branch
+- Criar branch GitFlow no formato `feature/nome-da-funcionalidade`
+- Detectar automaticamente branch base apropriada (develop/main)
+- Validar nomenclatura seguindo convenções GitFlow
+- Configurar tracking com repositório remoto quando disponível
+
+### Integração com @gitflow-specialist
+- Consultar especialista para análise do repositório atual
+- Receber estratégia de branching personalizada
+- Validar compliance com workflows da equipe
+- Guidance contextual para desenvolvimento
+
+### Session Management Automático
+- Criar diretório `.cursor/sessions/<feature-slug>/` automaticamente
+- Gerar `context.md` com metadados da feature
+- Criar `plan.md` com template de desenvolvimento
+- Integração opcional com ClickUp tasks existentes
+
+## 🚀 Como Usar
+
+```bash
+/git/feature/start "nome-da-funcionalidade"
+```
+
+### Exemplos de Nomenclatura
+```bash
+/git/feature/start "implement-oauth-authentication"
+/git/feature/start "add-user-dashboard-filters"  
+/git/feature/start "fix-payment-validation"
+/git/feature/start "update-api-documentation"
+```
+
+## 🤖 Integração com @gitflow-specialist
+
+Para cada nova feature:
+
+1. **Consultar @gitflow-specialist** para análise do estado atual do repositório
+2. **Receber estratégia** de criação de branch baseada no contexto
+3. **Validar nomenclatura** e compliance com padrões da equipe
+4. **Executar criação** seguindo as recomendações do especialista
+5. **Configurar ambiente** de desenvolvimento otimizado
+
+## 📋 Processo de Criação
+
+### Validações Pré-Criação
+- **Parameter check**: Verificar se nome da feature foi fornecido
+- **Repository check**: Confirmar que GitFlow está inicializado  
+- **Status check**: Garantir working directory limpo
+- **Naming validation**: Validar convenções de nomenclatura
+
+### Criação da Branch
+- **Base detection**: Identificar branch base apropriada (develop)
+- **Branch creation**: Criar `feature/nome` baseada na develop
+- **Remote setup**: Configurar tracking se repositório remoto disponível
+- **Checkout**: Trocar para a nova branch automaticamente
+
+### Setup do Ambiente
+- **Session creation**: Criar estrutura `.cursor/sessions/`
+- **Context setup**: Gerar arquivos de contexto e planejamento
+- **ClickUp integration**: Conectar com tasks existentes se detectadas
+- **Development ready**: Ambiente pronto para desenvolvimento
+
+## ⚙️ Estrutura Criada
+
+### Branch GitFlow
+```
+feature/nome-da-funcionalidade ← nova branch
+├── baseada em: develop (branch de desenvolvimento)  
+├── tracking: origin/feature/nome (se remoto disponível)
+└── estado: pronta para desenvolvimento
+```
+
+### Session Directory
+```
+.cursor/sessions/nome-da-funcionalidade/
+├── context.md          # Metadados e objetivos da feature
+├── plan.md            # Plano de desenvolvimento estruturado  
+├── notes.md           # Notas de desenvolvimento
+└── (outros arquivos conforme necessário)
+```
+
+## ✅ Resultado da Execução
+
+Após execução bem-sucedida:
+
+- ✅ **Feature branch criada** no padrão GitFlow
+- ✅ **Branch checkout realizado** automaticamente
+- ✅ **Session configurada** com estrutura completa
+- ✅ **Ambiente pronto** para desenvolvimento
+- ✅ **Próximos passos** fornecidos contextualmente
+
+## 🔄 Fluxo de Desenvolvimento Sugerido
+
+Após criar a feature:
+
+1. **Desenvolvimento**: Implementar funcionalidade na branch criada
+2. **Commits frequentes**: Usar conventional commits para histórico limpo
+3. **Push regular**: `git push` para backup e colaboração  
+4. **Compartilhamento**: `/git/feature/publish` para code review
+5. **Finalização**: `/git/feature/finish` quando completo
+
+## ⚠️ Tratamento de Problemas
+
+### GitFlow não inicializado
+**Problema**: Repository não tem GitFlow configurado
+**Solução**: Execute `/git/init` primeiro para configurar GitFlow
+
+### Nome de feature inválido
+**Problema**: Nome não segue convenções ou contém caracteres inválidos
+**Solução**: Use nomes descritivos em kebab-case (letras, números, hífen)
+
+### Working directory não limpo
+**Problema**: Há mudanças não commitadas no repositório
+**Solução**: Commit ou stash mudanças antes de criar nova feature
+
+### Feature branch já existe
+**Problema**: Já existe branch com mesmo nome
+**Solução**: Use nome diferente ou finalize feature existente primeiro
+
+### Branch develop não encontrada
+**Problema**: Branch develop não existe (GitFlow mal configurado)
+**Solução**: @gitflow-specialist fornecerá estratégia de resolução
+
+## 💡 Melhores Práticas
+
+### Nomenclatura de Features
+- **Descritiva**: Nome deve explicar claramente a funcionalidade
+- **Kebab-case**: Use hífens para separar palavras
+- **Concisa**: Evite nomes muito longos, máximo 50 caracteres
+- **Sem prefixos**: Não usar "feature-" pois já está no path da branch
+
+### Desenvolvimento
+- **Commits atômicos**: Commits pequenos e focados
+- **Conventional commits**: Seguir padrão (feat:, fix:, docs:, etc.)
+- **Push frequente**: Backup regular do trabalho
+- **Testes**: Implementar testes conforme desenvolvimento
+
+---
+
+*Este comando sempre consulta @gitflow-specialist para garantir criação otimizada e compliance com padrões da equipe.*

package/templates/.cursor/commands/git/help.md

@@ -0,0 +1,306 @@
+---
+name: help
+description: Ajuda interativa para comandos de documentação Onion.
+model: sonnet
+category: docs
+tags: [help, documentation, guide]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: technical
+---
+
+# 📚 Sistema de Ajuda - Comandos de Documentação
+
+Você é um assistente de IA especializado em **fornecer ajuda interativa para comandos de documentação** do Sistema Onion. Seu papel é educar usuários sobre os comandos disponíveis através de uma interface clara e educativa.
+
+## 🎯 **Funcionalidades**
+
+### **📚 Sistema de Ajuda Educativo:**
+- **Help geral** - Visão geral de todos os comandos de documentação
+- **Help específico** - Detalhes profundos sobre cada comando individual
+- **Orientação contextual** sobre quando usar cada ferramenta
+- **Exemplos práticos** para acelerar a adoção
+- **Workflows educativos** para dominar os comandos
+
+### **🔍 Inteligência Contextual:**
+- Detectar comando específico solicitado
+- Fornecer orientação baseada no contexto
+- Sugerir próximos passos lógicos
+- Explicar diferenças entre comandos similares
+
+---
+
+## 📋 **Comandos Disponíveis**
+
+O Sistema Onion oferece **4 comandos especializados** para documentação:
+
+### **🔧 `/docs/build-tech-docs`** - Documentação Técnica Completa
+**Objetivo**: Gerar documentação técnica abrangente para projetos
+**Quando usar**: Projetos que precisam de contexto técnico para desenvolvedores
+**Workflow**: Análise codebase → Q&A interativo → Múltiplos arquivos técnicos
+**Output**: project_charter.md, CURSOR.meta.md, CODEBASE_GUIDE.md, etc.
+
+### **📊 `/docs/build-business-docs`** - Contexto de Negócio
+**Objetivo**: Criar inteligência de negócios otimizada para IA
+**Quando usar**: Compreender clientes, mercado e estratégia de produto
+**Workflow**: Análise produto → Q&A estratégico → Múltiplos arquivos de negócio  
+**Output**: CUSTOMER_PERSONAS.md, COMPETITIVE_LANDSCAPE.md, etc.
+
+### **🗂️ `/docs/build-index`** - Construção de Índices
+**Objetivo**: Organizar documentação através de índices estruturados
+**Quando usar**: Múltiplos projetos precisam de organização centralizada
+**Workflow**: Análise estrutura → Geração/atualização de índices
+**Sintaxe**: 
+- `/docs/build-index` (índice geral de projetos)
+- `/docs/build-index <project-name>` (índice específico)
+
+### **🚧 `/docs/refine-vision`** - Refinamento de Visão *(Implementação Futura)*
+**Status**: Em desenvolvimento  
+**Objetivo**: Refinar e otimizar visão estratégica de projetos
+**Disponibilidade**: Próxima versão do Sistema Onion
+
+---
+
+## 🚀 **Uso do Comando**
+
+### **Sintaxe:**
+```bash
+/docs/help                    # Help geral - todos os comandos
+/docs/help [comando]          # Help específico detalhado
+```
+
+### **Exemplos:**
+```bash
+/docs/help                    # Visão geral completa
+/docs/help build-tech-docs    # Documentação técnica detalhada  
+/docs/help build-business-docs # Contexto de negócio detalhado
+/docs/help build-index        # Construção de índices detalhada
+/docs/help refine-vision      # Status de implementação futura
+```
+
+---
+
+## ⚙️ **Sistema de Detecção de Argumentos**
+
+<arguments>
+#$ARGUMENTS
+</arguments>
+
+# Detectar comando específico ou help geral
+COMANDO_ESPECIFICO="${1:-}"
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📚 SISTEMA DE AJUDA - COMANDOS DE DOCUMENTAÇÃO"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+if [ "$COMANDO_ESPECIFICO" = "build-tech-docs" ]; then
+    echo "🔧 **HELP ESPECÍFICO: /docs/build-tech-docs**"
+    echo ""
+    echo "**📋 Objetivo Detalhado:**"
+    echo "Gerador de documentação técnica especializado em criar contexto"
+    echo "de projeto abrangente e otimizado para IA. Analisa codebase completo"
+    echo "e gera estrutura multi-arquivo para desenvolvedores e sistemas IA."
+    echo ""
+    echo "**🏗️ Workflow Completo:**"
+    echo "   ▶ **Fase 1**: Descoberta do Codebase"
+    echo "     ∟ Análise da estrutura do projeto" 
+    echo "     ∟ Reconhecimento de padrões arquiteturais"
+    echo "     ∟ Descoberta do workflow de desenvolvimento"
+    echo ""
+    echo "   ▶ **Fase 2**: Q&A Interativo com Usuário"
+    echo "     ∟ Perguntas estratégicas sobre arquitetura"
+    echo "     ∟ Validação de decisões técnicas importantes" 
+    echo "     ∟ Esclarecimento de contexto específico"
+    echo ""
+    echo "   ▶ **Fase 3**: Geração de Contexto Multi-Arquivo"
+    echo "     ∟ project_charter.md (visão e objetivos)"
+    echo "     ∟ CURSOR.meta.md (guia de desenvolvimento IA)"
+    echo "     ∟ CODEBASE_GUIDE.md (navegação do código)"
+    echo "     ∟ BUSINESS_LOGIC.md (regras de negócio)"
+    echo "     ∟ API_SPECIFICATION.md (APIs e interfaces)"
+    echo ""
+    echo "**📚 Argumentos Obrigatórios:**"
+    echo "Você deve fornecer links para arquivos, repositórios ou outras"
+    echo "fontes de materiais para análise técnica."
+    echo ""
+    echo "**✅ Quando Usar:**"
+    echo "   ▶ Novos desenvolvedores precisam entender o projeto rapidamente"
+    echo "   ▶ Sistemas de IA precisam de contexto técnico abrangente"
+    echo "   ▶ Decisões técnicas precisam de documentação arquitetural"
+    echo "   ▶ Code reviews precisam focar em lógica vs arquitetura"
+    echo ""
+    echo "**🎯 Exemplo de Uso:**"
+    echo '   /docs/build-tech-docs "https://github.com/user/projeto"'
+    echo ""
+
+elif [ "$COMANDO_ESPECIFICO" = "build-business-docs" ]; then
+    echo "📊 **HELP ESPECÍFICO: /docs/build-business-docs**"
+    echo ""
+    echo "**📋 Objetivo Detalhado:**"
+    echo "Analista de negócios especializado em criar inteligência de negócios"
+    echo "abrangente e otimizada para IA. Analisa produto/projeto e gera"
+    echo "contexto completo de negócio usando abordagem multi-arquivo."
+    echo ""
+    echo "**🏗️ Workflow Completo:**"
+    echo "   ▶ **Fase 1**: Descoberta do Produto"
+    echo "     ∟ Entendimento do produto e proposta de valor"
+    echo "     ∟ Pesquisa de mercado e panorama competitivo"
+    echo "     ∟ Coleta de inteligência do cliente"
+    echo ""
+    echo "   ▶ **Fase 2**: Q&A Estratégico com Usuário"
+    echo "     ∟ Perguntas sobre visão do produto"
+    echo "     ∟ Identificação de personas e concorrentes"
+    echo "     ∟ Validação de estratégia de negócio"
+    echo ""
+    echo "   ▶ **Fase 3**: Geração de Contexto Multi-Arquivo"
+    echo "     ∟ CUSTOMER_PERSONAS.md (perfis de cliente)"
+    echo "     ∟ CUSTOMER_JOURNEY.md (jornada completa)" 
+    echo "     ∟ VOICE_OF_CUSTOMER.md (feedback e padrões)"
+    echo "     ∟ COMPETITIVE_LANDSCAPE.md (análise competitiva)"
+    echo "     ∟ PRODUCT_STRATEGY.md (estratégia e posicionamento)"
+    echo ""
+    echo "**📚 Argumentos Obrigatórios:**"
+    echo "Você deve fornecer links para materiais de produto, landing pages,"
+    echo "documentação de marketing ou outras fontes de contexto de negócio."
+    echo ""
+    echo "**✅ Quando Usar:**"
+    echo "   ▶ Times de vendas precisam alinhar mensagens com mercado"
+    echo "   ▶ Sistemas de IA precisam fornecer suporte contextual ao cliente"  
+    echo "   ▶ Decisões de produto precisam de contexto completo de mercado"
+    echo "   ▶ Planejamento estratégico requer inteligência competitiva"
+    echo ""
+    echo "**🎯 Exemplo de Uso:**"
+    echo '   /docs/build-business-docs "https://empresa.com" "docs/produto/"'
+    echo ""
+
+elif [ "$COMANDO_ESPECIFICO" = "build-index" ]; then
+    echo "🗂️ **HELP ESPECÍFICO: /docs/build-index**"
+    echo ""
+    echo "**📋 Objetivo Detalhado:**" 
+    echo "Construtor especializado de índices para organização de documentação"
+    echo "de múltiplos projetos. Cria estrutura canônica de navegação que"
+    echo "funciona como fonte única da verdade para todos os projetos."
+    echo ""
+    echo "**🏗️ Workflow Simplificado:**"
+    echo "   ▶ **Análise**: Examina estrutura de pastas e arquivos existentes"
+    echo "   ▶ **Organização**: Identifica projetos e recursos principais" 
+    echo "   ▶ **Geração**: Cria/atualiza arquivos index.md estruturados"
+    echo ""
+    echo "**📚 Sintaxe e Argumentos:**"
+    echo "   ▶ **Índice Geral**: /docs/build-index"
+    echo "     ∟ Constrói index.md raiz com todos os projetos"
+    echo "     ∟ Informações: nome, descrição, ClickUp IDs, repositório"
+    echo ""
+    echo "   ▶ **Índice Específico**: /docs/build-index <project-name>"  
+    echo "     ∟ Reconstrói índice após mudanças estruturais"
+    echo "     ∟ Mapeia recursos úteis dentro do projeto específico"
+    echo ""
+    echo "**✅ Quando Usar:**"
+    echo "   ▶ Múltiplos projetos precisam de organização centralizada"
+    echo "   ▶ Estrutura de diretórios foi modificada significativamente"
+    echo "   ▶ Novos projetos foram adicionados à organização" 
+    echo "   ▶ Navegação de documentação precisa ser atualizada"
+    echo ""
+    echo "**🎯 Exemplos de Uso:**"
+    echo "   /docs/build-index                    # Índice geral"
+    echo "   /docs/build-index projeto-mobile     # Índice específico"
+    echo ""
+
+elif [ "$COMANDO_ESPECIFICO" = "refine-vision" ]; then
+    echo "🚧 **HELP ESPECÍFICO: /docs/refine-vision**"
+    echo ""
+    echo "**📋 Status Atual:**"
+    echo "Este comando está em **desenvolvimento ativo** e será incluído"
+    echo "em uma próxima versão do Sistema Onion."
+    echo ""  
+    echo "**🔮 Objetivo Planejado:**"
+    echo "Especialista em refinamento de visão estratégica de projetos."
+    echo "Analisará documentação existente e facilitará processo colaborativo"
+    echo "para refinar e otimizar visão de produto/projeto."
+    echo ""
+    echo "**🛠️ Funcionalidades Futuras:**"
+    echo "   ▶ **Análise de Visão Atual**: Auditoria de documentação estratégica"
+    echo "   ▶ **Workshop Guiado**: Facilitação de sessões de refinamento"  
+    echo "   ▶ **Alinhamento de Stakeholders**: Validação com partes interessadas"
+    echo "   ▶ **Documentação Atualizada**: Geração de artefatos refinados"
+    echo ""
+    echo "**📅 Timeline Estimado:**"
+    echo "Implementação planejada para próximo release do Sistema Onion."
+    echo ""
+    echo "**💡 Alternativas Atuais:**"
+    echo "   ▶ Use /docs/build-business-docs para contexto estratégico"
+    echo "   ▶ Use /docs/build-tech-docs para visão técnica de produto"
+    echo "   ▶ Combine ambos para contexto abrangente de projeto"
+    echo ""
+
+else
+    echo "🎯 **HELP GERAL - VISÃO COMPLETA DOS COMANDOS**"
+    echo ""
+    echo "O Sistema Onion oferece **4 comandos especializados** para"
+    echo "documentação inteligente otimizada para IA:"
+    echo ""
+    echo "**🔧 Documentação Técnica:**"
+    echo "   ▶ **/docs/build-tech-docs** - Contexto técnico completo"
+    echo "     ∟ Para: Desenvolvedores, sistemas IA, decisões técnicas"
+    echo "     ∟ Output: project_charter.md, CURSOR.meta.md, CODEBASE_GUIDE.md"
+    echo "     ∟ Uso: /docs/help build-tech-docs (detalhes)"
+    echo ""
+    echo "**📊 Contexto de Negócio:**" 
+    echo "   ▶ **/docs/build-business-docs** - Inteligência de mercado"
+    echo "     ∟ Para: Produto, vendas, suporte contextual ao cliente"
+    echo "     ∟ Output: CUSTOMER_PERSONAS.md, COMPETITIVE_LANDSCAPE.md"
+    echo "     ∟ Uso: /docs/help build-business-docs (detalhes)"
+    echo ""
+    echo "**🗂️ Organização:**"
+    echo "   ▶ **/docs/build-index** - Índices de documentação" 
+    echo "     ∟ Para: Múltiplos projetos, navegação centralizada"
+    echo "     ∟ Output: index.md estruturados e organizados"
+    echo "     ∟ Uso: /docs/help build-index (detalhes)"
+    echo ""
+    echo "**🚧 Em Desenvolvimento:**"
+    echo "   ▶ **/docs/refine-vision** - Refinamento estratégico"
+    echo "     ∟ Status: Implementação futura (próximo release)"
+    echo "     ∟ Uso: /docs/help refine-vision (roadmap)"
+    echo ""
+    echo "**🚀 Para Help Específico:**"
+    echo "   ▶ /docs/help [comando]     # Detalhes profundos"  
+    echo "   ▶ /docs/help build-tech-docs"
+    echo "   ▶ /docs/help build-business-docs"
+    echo "   ▶ /docs/help build-index"
+    echo ""
+fi
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "📚 **Sistema Onion** - Comandos inteligentes para desenvolvimento ágil"
+echo "🆘 **Precisa de mais ajuda?** Use /docs/help [comando] para detalhes específicos"
+echo ""
+
+
+---
+
+## 🚀 Próximos Passos
+
+Após explorar os comandos disponíveis:
+
+1. **Comece com um workflow completo**:
+   ```bash
+   /technical/start "test-feature"
+   ```
+   Experimenta o ciclo completo: start → work → pr.
+
+2. **Explore agentes especializados**:
+   - `@react-developer` para desenvolvimento frontend
+   - `@test-engineer` para estratégia de testes
+   - `@code-reviewer` para análise de qualidade
+
+3. **Veja comandos intermediate**:
+   ```bash
+   /technical/help --level=intermediate
+   ```
+   Descubra workflows mais avançados conforme ganha experiência.
+
+💡 **Dica**: Foque nos 8 starter commands primeiro - eles cobrem 80% do desenvolvimento diário.