@onion-ai/cli 1.0.0-beta.1

package/framework/commands/docs/build-tech-docs.md

@@ -0,0 +1,221 @@
+---
+name: build-tech-docs
+description: Generate comprehensive technical documentation from the codebase.
+model: sonnet
+category: docs
+tags: [technical, architecture, documentation]
+version: '3.0.0'
+updated: '2025-11-24'
+---
+
+# Technical Documentation Generator
+
+You are a technical documentation architect specialized in creating comprehensive, AI-optimized project context. Your mission is to analyze the project codebase, repository, and other source materials to generate a complete technical documentation structure using the multi-file architecture approach.
+
+## Primary Objective
+
+Generate a complete technical context architecture following the template in `.claude/commands/common/templates/technical_context_template.md`. Create a modular, multi-file documentation structure that enables both human developers and AI systems to understand and work effectively with the codebase.
+
+## Input Parameters
+
+**Required Arguments:**
+You must receive links to files, repositories, and other source materials to generate the technical documentation. These will be placed in your arguments. If you have not received arguments, you must request them before proceeding.
+
+<arguments>
+#$ARGUMENTS
+</arguments>
+
+## Analysis Framework
+
+### Phase 1: Codebase Discovery
+
+1. **Project Structure Analysis**
+   - Scan directory structure and identify key architectural patterns
+   - Analyze package.json, requirements.txt, Cargo.toml, or equivalent dependency files
+   - Identify build systems, test frameworks, and deployment configurations
+   - Detect technology stack, frameworks, and key dependencies
+
+2. **Architectural Pattern Recognition**
+   - Identify design patterns (MVC, microservices, event-driven, etc.)
+   - Analyze data flow and integration points
+   - Understand deployment and scaling architecture
+   - Document key abstractions and interfaces
+
+3. **Development Workflow Discovery**
+   - Analyze CI/CD configurations (.github/workflows, .gitlab-ci.yml, etc.)
+   - Identify testing strategies and coverage requirements
+   - Review contribution guidelines and development setup
+   - Document build, lint, and deployment processes
+
+### Phase 2: User Discussion
+
+After building a good understanding of the project, you will ask the human a series of questions to clarify doubts or missing information. Plan to ask at least 10 questions that cover most strategic areas in the documentation. Be selective about the questions you ask, and try to avoid questions that are not relevant to the project.
+
+- If the stack is clear from the codebase, no need to ask about it.
+- Identify the main architectural decisions and ask about why they were made -- this should help guide your ADR development
+- Ask about the product development process and workflow, if not clear
+- Ask about the product testing process and workflow, if not clear
+- Ask about the product deployment process and workflow, if not clear
+- Ask about the product maintenance process and workflow, if not clear
+- Ask about current architectural challenges and things the team would like to improve
+- Make sure you understand what is in scope and out of scope
+
+Do multiple rounds of Q&A if you feel you still need to get more information.
+When you are ready, give the human a summary of the most important points you detected and ask for approval to proceed to phase 3.
+
+### Phase 3: Context Generation
+
+This repository root contains on folder for each project. You will identify the right folder and add your files to the $project_name/specs/technical folder.
+
+Follow the multi-file structure from the technical template:
+
+#### Create Index File (`index.md`)
+
+```markdown
+## Project Context Profile
+
+[Basic project information, technology stack, team structure, development constraints]
+
+## Layer 1: Core Project Context
+
+- [Project Charter](project_charter.md)
+- [Architecture Decision Records](adr/)
+
+## Layer 2: AI-Optimized Context Files
+
+- [AI Development Guide](CURSOR.meta.md)
+- [Codebase Navigation Guide](CODEBASE_GUIDE.md)
+
+## Layer 3: Domain-Specific Context
+
+- [Business Logic Documentation](BUSINESS_LOGIC.md)
+- [API Specifications](API_SPECIFICATION.md)
+
+## Layer 4: Development Workflow Context
+
+- [Development Workflow Guide](CONTRIBUTING.md)
+- [Troubleshooting Guide](TROUBLESHOOTING.md)
+```
+
+#### Generate Individual Files
+
+**1. `project_charter.md`**
+
+- Synthesize project vision from README, documentation, and code analysis
+- Define success criteria based on project goals and metrics
+- Establish scope boundaries from codebase analysis
+- Identify key stakeholders from contributor data
+- Document technical constraints from architecture analysis
+
+**2. `adr/` Directory**
+
+- Create ADRs for major architectural decisions discovered in codebase
+- Document technology choices, patterns, and trade-offs
+- Include database choices, framework selections, deployment strategies
+- Reference commit history and comments for decision context
+
+**3. `CURSOR.meta.md` (AI Development Guide)**
+
+- Extract code style patterns from existing codebase
+- Document testing approaches from test files and configurations
+- Identify common patterns from code analysis
+- List gotchas from comments, issues, and documentation
+- Include performance considerations and security patterns
+
+**4. `CODEBASE_GUIDE.md`**
+
+- Generate directory structure with purpose annotations
+- List key files and their roles in the system
+- Document data flow patterns from code analysis
+- Identify integration points and external dependencies
+- Describe deployment architecture from configurations
+
+**5. `BUSINESS_LOGIC.md`** (if complex domain logic exists)
+
+- Extract domain concepts from models, schemas, and business logic
+- Document business rules from validation logic and workflows
+- Identify edge cases from tests and error handling
+- Map workflow processes from state machines and business logic
+
+**6. `API_SPECIFICATION.md`** (if APIs exist)
+
+- Generate API documentation from routes, controllers, and schemas
+- Document authentication from middleware and security implementations
+- Extract data models from schemas and type definitions
+- Document error handling from exception handling code
+- Include rate limiting and performance characteristics
+
+**7. `CONTRIBUTING.md`**
+
+- Extract branch strategy from git history and configurations
+- Document code review process from PR templates and workflows
+- List testing requirements from test configurations
+- Document deployment process from CI/CD configurations
+- Include environment setup from README and development configurations
+
+**8. `TROUBLESHOOTING.md`**
+
+- Extract common issues from GitHub issues, comments, and documentation
+- Document debugging approaches from logging and monitoring setup
+- Include performance troubleshooting from profiling and optimization code
+- List integration issues from error handling and documentation
+
+**9. `ARCHITECTURE_CHALLENGES.md`**
+
+- Document architecture challenges and things the team would like to improve
+
+## Quality Assurance
+
+### Content Quality Checks
+
+- [ ] All generated content is accurate to the actual codebase
+- [ ] Examples are working and tested against the actual project
+- [ ] Architecture documentation matches implementation
+- [ ] Performance claims are backed by actual benchmarks or code analysis
+- [ ] All links between files work correctly
+
+### Completeness Validation
+
+- [ ] All layers of technical context are addressed
+- [ ] Files follow the established template structure
+- [ ] Content is specific to the project, not generic
+- [ ] AI optimization guidelines are practical and actionable
+- [ ] Development workflow matches actual project practices
+
+### AI Optimization
+
+- [ ] Content enables AI to understand project architecture
+- [ ] Code examples are copy-pasteable and functional
+- [ ] Technical constraints and trade-offs are clearly documented
+- [ ] Cross-references between files create comprehensive context
+- [ ] File naming follows established conventions
+
+## Execution Strategy
+
+1. **Deep Analysis First**: Spend significant time understanding the codebase before writing
+2. **Evidence-Based Documentation**: Every claim should be backed by code, configurations, or project artifacts
+3. **Multi-File Structure**: Always create separate files linked through the index
+4. **AI-Optimized Content**: Write for both human and AI consumption
+5. **Project-Specific Details**: Avoid generic advice; focus on actual project specifics
+6. **Cross-Reference Integration**: Ensure files reference each other appropriately
+
+## Output Success Criteria
+
+The generated technical documentation should enable:
+
+- **New developers** to understand and contribute to the project within hours
+- **AI systems** to provide accurate, contextual assistance with development tasks
+- **Technical decisions** to be made with full context of existing architecture
+- **Code reviews** to focus on logic rather than style or architectural questions
+- **Debugging and troubleshooting** to be systematic and efficient
+
+## Error Handling
+
+If certain information cannot be determined from the codebase:
+
+- Clearly mark sections as "TO BE COMPLETED" with specific instructions
+- Provide templates for missing information
+- Reference where the information should come from
+- Create issues or TODOs for follow-up documentation work
+
+Remember: The goal is to create living documentation that grows with the project and serves as the definitive technical context for both humans and AI systems.

package/framework/commands/docs/docs-health.md

@@ -0,0 +1,141 @@
+---
+name: docs-health
+description: |
+  Health check completo da documentação do projeto.
+  Use para diagnóstico de qualidade, gaps e recomendações.
+model: sonnet
+
+parameters:
+  - name: path
+    description: Caminho para analisar (default: docs/)
+    required: false
+    default: docs/
+
+category: docs
+tags:
+  - health-check
+  - documentation
+  - quality
+
+version: "3.0.0"
+updated: "2025-11-24"
+
+related_commands:
+  - /docs/validate-docs
+  - /docs/build-tech-docs
+
+related_agents:
+  - system-documentation-orchestrator
+---
+
+# 🏥 Docs Health Check
+
+Verificação abrangente de saúde da documentação.
+
+## 🎯 Objetivo
+
+Fornecer diagnóstico completo com score, gaps e recomendações.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Coletar Métricas
+
+```bash
+# Contar arquivos de docs
+TOTAL=$(find {{path}} -name "*.md" | wc -l)
+
+# Verificar estrutura
+ls -la {{path}}/
+
+# Arquivos grandes (>500 linhas)
+find {{path}} -name "*.md" -exec wc -l {} \; | sort -rn | head -10
+```
+
+### Passo 2: Analisar Estrutura
+
+#### Checklist de Estrutura
+
+- [ ] README.md existe
+- [ ] Índice/navegação presente
+- [ ] Pastas organizadas por categoria
+- [ ] Naming consistente (kebab-case)
+
+### Passo 3: Avaliar Qualidade
+
+#### Critérios de Qualidade
+
+| Critério     | Peso | Verificação         |
+| ------------ | ---- | ------------------- |
+| Completude   | 25%  | Seções obrigatórias |
+| Consistência | 20%  | Formatação uniforme |
+| Atualidade   | 20%  | Datas de update     |
+| Links        | 15%  | Links funcionais    |
+| Exemplos     | 10%  | Código de exemplo   |
+| TOC          | 10%  | Table of contents   |
+
+### Passo 4: Identificar Gaps
+
+```bash
+# Arquivos sem update recente (>90 dias)
+find {{path}} -name "*.md" -mtime +90
+
+# Arquivos pequenos (<50 linhas)
+find {{path}} -name "*.md" -exec wc -l {} \; | awk '$1<50'
+```
+
+### Passo 5: Calcular Score
+
+```
+Score = (Estrutura × 0.25) + (Qualidade × 0.25) +
+        (Cobertura × 0.25) + (Atualidade × 0.25)
+```
+
+| Score  | Status       |
+| ------ | ------------ |
+| 90-100 | 🟢 Excelente |
+| 70-89  | 🟡 Bom       |
+| 50-69  | 🟠 Regular   |
+| <50    | 🔴 Crítico   |
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🏥 DOCS HEALTH REPORT
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Score Geral: 78/100 🟡
+
+📈 Métricas:
+∟ Arquivos: 45
+∟ Linhas: 12,450
+∟ Cobertura: 72%
+
+✅ Pontos Fortes:
+∟ Estrutura organizada
+∟ README completo
+∟ Exemplos presentes
+
+⚠️ Gaps Identificados:
+∟ 5 arquivos sem atualização >90d
+∟ API docs incompleta
+∟ Falta troubleshooting
+
+💡 Recomendações:
+1. Atualizar docs de API
+2. Adicionar seção troubleshooting
+3. Revisar arquivos antigos
+
+🎯 Meta: 85/100 (próximo quarter)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Validação: /docs/validate-docs
+- Agente: @system-documentation-orchestrator
+
+## ⚠️ Notas
+
+- Executar mensalmente para tracking
+- Score histórico salvo em `.claude/metrics/`

package/framework/commands/docs/help.md

@@ -0,0 +1,278 @@
+---
+name: help
+description: Ajuda interativa para comandos de documentação Onion.
+model: sonnet
+category: docs
+tags: [help, documentation, guide]
+version: "3.0.0"
+updated: "2025-11-24"
+---
+
+# 📚 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 ""

package/framework/commands/docs/refine-vision.md

@@ -0,0 +1,25 @@
+---
+name: refine-vision
+description: Refinar visão e estratégia do produto/projeto.
+model: sonnet
+category: docs
+tags: [vision, strategy, refinement]
+version: "3.0.0"
+updated: "2025-11-24"
+---
+
+# Refinar Visão do Projeto
+
+Ajudar a refinar e documentar a visão estratégica do projeto.
+
+## 🎯 Objetivo
+
+Clarificar e documentar a visão, missão e objetivos estratégicos.
+
+## ⚡ Processo
+
+1. Revisar documentação existente de visão
+2. Fazer perguntas de esclarecimento
+3. Documentar insights e decisões
+4. Gerar documento de visão atualizado
+