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

package/templates/.onion/contexts/technical/commands/intermediate/validate-docs.md

@@ -0,0 +1,159 @@
+---
+name: validate-docs
+description: |
+  Validação de completude e consistência da documentação.
+  Use para verificar estrutura, links e padrões.
+model: sonnet
+
+parameters:
+  - name: path
+    description: Caminho para validar (default: docs/)
+    required: false
+    default: docs/
+  - name: fix
+    description: Corrigir problemas automaticamente
+    required: false
+    default: "false"
+
+category: docs
+tags:
+  - validation
+  - documentation
+  - quality
+
+version: "4.0.0"
+updated: "2025-12-20"
+
+related_commands:
+  - /docs/docs-health
+  - /docs/build-tech-docs
+
+related_agents:
+  - system-documentation-orchestrator
+level: intermediate
+context: technical
+---
+
+# ✅ Validar Documentação
+
+Validação abrangente de estrutura e qualidade de docs.
+
+## 🎯 Objetivo
+
+Verificar completude, consistência e padrões da documentação.
+
+## ⚡ Fluxo de Execução
+
+### Passo 1: Validar Estrutura
+
+```bash
+# Arquivos obrigatórios
+REQUIRED=(README.md CHANGELOG.md)
+for f in "${REQUIRED[@]}"; do
+  test -f "$f" && echo "✅ $f" || echo "❌ $f ausente"
+done
+
+# Hierarquia de diretórios
+ls -la {{path}}/
+```
+
+#### Checklist de Estrutura
+
+- [ ] `README.md` na raiz
+- [ ] `docs/` com índice
+- [ ] Naming em kebab-case
+- [ ] Extensão `.md`
+
+### Passo 2: Validar Conteúdo
+
+#### Verificações por Arquivo
+
+```bash
+for f in $(find {{path}} -name "*.md"); do
+  # Header presente
+  head -1 "$f" | grep -q "^#" || echo "⚠️ $f: sem header"
+  
+  # Linhas mínimas
+  [ $(wc -l < "$f") -lt 10 ] && echo "⚠️ $f: muito curto"
+done
+```
+
+#### Seções Obrigatórias
+
+| Tipo de Doc | Seções Requeridas |
+|-------------|-------------------|
+| README | Objetivo, Uso, Instalação |
+| API | Endpoints, Exemplos |
+| Guide | Pré-requisitos, Steps |
+| Spec | Objetivo, Requisitos |
+
+### Passo 3: Validar Links
+
+```bash
+# Links internos
+grep -roh '\[.*\](.*\.md)' {{path}}/ | \
+  sed 's/.*(\(.*\))/\1/' | \
+  while read link; do
+    test -f "$link" || echo "❌ Link quebrado: $link"
+  done
+```
+
+### Passo 4: Gerar Relatório
+
+## 📤 Output Esperado
+
+### Sem Erros
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ VALIDAÇÃO CONCLUÍDA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Resumo:
+∟ Arquivos: 45
+∟ Erros: 0
+∟ Avisos: 3
+
+✅ Estrutura: OK
+✅ Conteúdo: OK
+✅ Links: OK
+
+⚠️ Avisos:
+∟ 3 arquivos sem update >30d
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Com Erros
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+❌ ERROS ENCONTRADOS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Resumo:
+∟ Arquivos: 45
+∟ Erros: 5
+∟ Avisos: 8
+
+❌ Erros:
+∟ docs/api.md: link quebrado (line 45)
+∟ docs/guide.md: sem header
+∟ README.md: seção "Uso" ausente
+
+⚠️ Avisos:
+∟ 8 arquivos muito curtos (<50 linhas)
+
+💡 Para corrigir: /docs/validate-docs fix="true"
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🔗 Referências
+
+- Health check: /docs/docs-health
+- Agente: @system-documentation-orchestrator
+
+## ⚠️ Notas
+
+- Executar antes de releases
+- `fix="true"` corrige apenas formatação
+- Links quebrados requerem correção manual

package/templates/.onion/contexts/technical/commands/starter/docs.md

@@ -0,0 +1,39 @@
+---
+name: docs
+description: Invocar agente de documentação para branch atual.
+model: sonnet
+category: engineer
+tags: [documentation, branch]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: technical
+---
+
+Por favor, invoque o agente branch-documentation-writer
+
+---
+
+## 🚀 Próximos Passos
+
+Após gerar/atualizar documentação:
+
+1. **Validar consistência**:
+   ```bash
+   /technical/validate-docs
+   ```
+   Verifica links quebrados, seções faltando, etc.
+
+2. **Construir índice completo**:
+   ```bash
+   /technical/build-index
+   ```
+   Gera índice navegável de toda documentação técnica.
+
+3. **Verificar saúde da docs**:
+   ```bash
+   /technical/docs-health
+   ```
+   Analisa cobertura, atualização e qualidade geral.
+
+💡 **Dica**: Documente enquanto implementa, não depois! Contexto fresco = docs melhores.

package/templates/.onion/contexts/technical/commands/starter/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/.onion/contexts/technical/commands/starter/init.md

@@ -0,0 +1,139 @@
+---
+name: init
+description: Inicializar repositório com GitFlow e convenções padrão.
+model: sonnet
+category: git
+tags: [init, gitflow, setup]
+version: "4.0.0"
+updated: "2025-12-20"
+level: starter
+context: technical
+---
+
+# 🔧 Git Flow - Inicialização
+
+Configurar repositório Git com GitFlow seguindo as melhores práticas. Detectar automaticamente se deve usar `main` ou `master` como branch principal e configurar todas as branches e convenções necessárias.
+
+## 🎯 Funcionalidades
+
+### Detecção Automática Inteligente
+- Verificar se Git Flow já está inicializado  
+- Detectar branch principal existente (main/master) automaticamente
+- Configurar develop branch baseado na convenção detectada
+- Validar se repositório está em estado adequado para inicialização
+
+### Setup Seguro e Educativo
+- Configuração automática de prefixos GitFlow padrão (feature/, release/, hotfix/)
+- Verificações de integridade do repositório antes da inicialização
+- Criação da branch develop se não existir
+- Integração com @gitflow-specialist para guidance personalizada
+
+## 🚀 Como Usar
+
+```bash
+/git/init                    # Inicialização completa automática
+```
+
+## 🤖 Integração com @gitflow-specialist
+
+Para cada inicialização:
+
+1. **Consultar @gitflow-specialist** para análise do repositório atual
+2. **Receber estratégia** de inicialização baseada no contexto
+3. **Executar setup** seguindo as recomendações do especialista
+4. **Validar configuração** final e fornecer próximos passos
+
+## 📋 Processo de Inicialização
+
+### Verificações Pré-Inicialização
+- **Repository check**: Verificar se estamos em um repositório Git válido
+- **Status check**: Garantir que não há mudanças não commitadas
+- **Remote check**: Verificar configuração de repositório remoto
+- **GitFlow check**: Detectar se já está inicializado
+
+### Configuração Automática
+- **Branch detection**: Identificar main/master existente
+- **Develop setup**: Criar develop branch baseada na principal  
+- **Prefix configuration**: Configurar prefixos padrão GitFlow
+- **Validation**: Verificar configuração final
+
+## ⚙️ Configurações Aplicadas
+
+### Branches Principais
+```
+main/master  (produção) ← detectado automaticamente
+develop      (desenvolvimento) ← criado se não existir
+```
+
+### Prefixos de Branch
+```
+feature/     (novas funcionalidades)
+release/     (preparação de releases)
+hotfix/      (correções urgentes)
+```
+
+## ✅ Resultado da Inicialização
+
+Após execução bem-sucedida:
+
+- ✅ **Git Flow configurado** com branches apropriadas
+- ✅ **Branch develop criada** e configurada como development branch  
+- ✅ **Prefixos definidos** para todos os tipos de branch
+- ✅ **Configuração validada** e testada
+- ✅ **Próximos passos** fornecidos baseados no contexto
+
+## 🔄 Próximos Passos Sugeridos
+
+Após inicialização, o sistema recomendará:
+
+- **Primeira feature**: `/git/feature/start "nome-da-funcionalidade"`
+- **Sincronização**: `/git/sync` se houver repositório remoto
+- **Ajuda contextual**: `/git/help` para entender os workflows disponíveis
+
+## ⚠️ Tratamento de Problemas
+
+### Repository não é Git
+**Problema**: Pasta atual não é um repositório Git  
+**Solução**: Execute `git init` primeiro, depois `/git/init`
+
+### GitFlow já inicializado  
+**Problema**: GitFlow já está configurado
+**Resultado**: Mostra configuração atual e próximos passos sugeridos
+
+### Branch develop conflitante
+**Problema**: Já existe branch develop com conteúdo divergente
+**Solução**: @gitflow-specialist fornecerá estratégia de resolução
+
+### Repositório remoto não configurado
+**Problema**: Não há origin configurado
+**Resultado**: Configuração local apenas, com sugestão de setup remoto
+
+---
+
+*Este comando sempre consulta @gitflow-specialist para garantir inicialização otimizada para seu contexto específico.*
+
+---
+
+## 🚀 Próximos Passos
+
+Após inicializar o repositório:
+
+1. **Preparar primeiro commit**:
+   ```bash
+   /technical/fast-commit
+   ```
+   Cria commit inicial seguindo conventional commits.
+
+2. **Configurar documentação**:
+   ```bash
+   /technical/docs
+   ```
+   Gera README e docs técnicos iniciais.
+
+3. **Começar primeira feature**:
+   ```bash
+   /technical/start "setup-inicial"
+   ```
+   Inicia desenvolvimento estruturado desde o início.
+
+💡 **Dica**: Gitflow é recomendado para projetos colaborativos. Para solo dev, trunk-based pode ser mais simples.