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

package/templates/.cursor/commands/docs/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.

package/templates/.cursor/commands/docs/refine-vision.md

@@ -0,0 +1,27 @@
+---
+name: refine-vision
+description: Refinar visão e estratégia do produto/projeto.
+model: sonnet
+category: docs
+tags: [vision, strategy, refinement]
+version: "4.0.0"
+updated: "2025-12-20"
+level: advanced
+context: technical
+---
+
+# 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
+

package/templates/.cursor/commands/docs/reverse-consolidate.md

@@ -0,0 +1,160 @@
+---
+name: reverse-consolidate
+description: |
+  Engenharia reversa de projetos para gerar documentação consolidada.
+  Use como pré-processador para /docs/build-tech-docs.
+model: sonnet
+
+parameters:
+  - name: project_path
+    description: Caminho para o projeto a ser analisado
+    required: true
+  - name: output_path
+    description: Onde salvar documentação (default: docs/reverse/)
+    required: false
+
+category: docs
+tags:
+  - reverse-engineering
+  - documentation
+  - analysis
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /docs/build-tech-docs
+  - /docs/build-business-docs
+
+related_agents:
+  - docs-reverse-engineer
+  - system-documentation-orchestrator
+level: advanced
+context: technical
+---
+
+# 🔍 Engenharia Reversa de Projetos
+
+Orquestrador de engenharia reversa para gerar documentação consolidada.
+
+## 🎯 Objetivo
+
+Analisar qualquer projeto e gerar documento consolidado para `/docs/build-tech-docs`.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Validar Input
+
+```bash
+# Verificar path existe
+test -d "{{project_path}}" || { echo "❌ Path não existe"; exit 1; }
+
+# Verificar é projeto de software
+ls "{{project_path}}"/*.json "{{project_path}}"/*.yaml 2>/dev/null || \
+  echo "⚠️ Arquivos de config não detectados"
+```
+
+### Passo 2: Detectar Stack
+
+```bash
+# Package managers
+test -f package.json && STACK="javascript"
+test -f requirements.txt && STACK="python"
+test -f Cargo.toml && STACK="rust"
+test -f go.mod && STACK="go"
+
+# Frameworks
+grep -q "react" package.json && FRAMEWORK="react"
+grep -q "fastify" package.json && FRAMEWORK="fastify"
+grep -q "nx" package.json && MONOREPO="nx"
+```
+
+### Passo 3: Analisar Estrutura
+
+Delegar para @docs-reverse-engineer:
+
+1. **Directory Scan**
+   - Estrutura de pastas
+   - Padrões de arquivos
+   - Convenções de naming
+
+2. **Dependency Analysis**
+   - Dependências principais
+   - DevDependencies
+   - Peer dependencies
+
+3. **Architecture Detection**
+   - Padrões (MVC, DDD, Clean)
+   - Camadas identificadas
+   - Pontos de integração
+
+### Passo 4: Gerar Documento
+
+Criar `{{output_path}}/consolidated.md`:
+
+```markdown
+# Documentação Consolidada: [Nome do Projeto]
+
+## 📊 Metadados
+- Stack: [stack detectado]
+- Framework: [framework]
+- Monorepo: [sim/não]
+- Tamanho: [arquivos/linhas]
+
+## 🏗️ Arquitetura
+[Descrição da arquitetura detectada]
+
+## 📁 Estrutura
+[Árvore de diretórios comentada]
+
+## 🔧 Componentes Principais
+[Lista de módulos/componentes]
+
+## 🔗 Integrações
+[APIs, databases, serviços externos]
+
+## 📋 Recomendações
+[Sugestões para documentação adicional]
+```
+
+### Passo 5: Finalizar
+
+## 📤 Output Esperado
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ ANÁLISE CONCLUÍDA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Projeto: {{project_path}}
+
+🔍 Stack Detectado:
+∟ Linguagem: TypeScript
+∟ Framework: React + Fastify
+∟ Monorepo: NX
+∟ Arquitetura: Clean Architecture
+
+📁 Arquivos Gerados:
+∟ docs/reverse/consolidated.md
+∟ docs/reverse/structure.json
+∟ docs/reverse/dependencies.json
+
+📈 Métricas:
+∟ Arquivos analisados: 245
+∟ Linhas de código: 12,450
+∟ Módulos: 18
+
+🚀 Próximo: /docs/build-tech-docs
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Agente: @docs-reverse-engineer
+- Próximo passo: /docs/build-tech-docs
+
+## ⚠️ Notas
+
+- Tempo médio: 2-5 minutos dependendo do tamanho
+- Funciona com JavaScript, Python, Rust, Go
+- Output otimizado para consumo por IA