aiox-core 5.0.2 → 5.0.4

package/pro/squads/squad-creator-pro/docs/TUTORIAL-COMPLETO.md

@@ -0,0 +1,458 @@
+# Tutorial Completo: Criando um Squad do Zero
+
+> **Objetivo:** Acompanhe passo a passo a criação de um squad real, vendo exatamente o que acontece em cada etapa.
+
+> **Nota:** Este tutorial usa copywriting como exemplo ilustrativo. Substitua pelo seu domínio de interesse (marketing, vendas, legal, finanças, etc.). Os experts encontrados serão específicos do domínio escolhido.
+
+---
+
+## O Cenário
+
+Vamos criar um **squad de copywriting** usando o modo **YOLO** (sem materiais).
+
+> **[Exemplo: Copywriting]** - O mesmo processo funciona para qualquer domínio.
+
+**Por que YOLO?**
+- É mais rápido para aprender
+- Não precisa ter livros/PDFs
+- Você pode melhorar depois
+
+---
+
+## Passo 1: Ativar o Squad Creator
+
+**O que você digita:**
+```
+@squad-creator
+```
+
+**O que você vê:**
+```
+🎨 Squad Architect ativado!
+
+Sou especialista em criar squads de agentes baseados em elite minds reais.
+
+Comandos disponíveis:
+• *create-squad - Criar novo squad
+• *clone-mind {name} - Clonar expert específico
+• *validate-squad {name} - Validar squad existente
+• *help - Ver todos os comandos
+
+Como posso ajudar?
+```
+
+---
+
+## Passo 2: Solicitar o Squad
+
+**O que você digita:**
+```
+Quero um squad de copywriting
+```
+
+**O que acontece:**
+
+O Squad Architect identifica o domínio e faz uma pergunta inicial:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ PRE-FLIGHT: CRIAÇÃO DE SQUAD                                    │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│ Vou criar um squad de COPYWRITING.                              │
+│                                                                 │
+│ Para máxima qualidade, você teria:                              │
+│ • Livros dos experts (PDFs, ebooks)                             │
+│ • Transcrições de cursos                                        │
+│ • Entrevistas/podcasts                                          │
+│                                                                 │
+│ Como quer executar?                                             │
+│                                                                 │
+│ 🚀 YOLO    - Não tenho materiais (60-75% fidelidade)           │
+│ 💎 QUALITY - Tenho livros/PDFs (85-95% fidelidade)             │
+│ 🔀 HYBRID  - Tenho materiais de alguns experts                  │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+**O que você responde:**
+```
+YOLO
+```
+
+---
+
+## Passo 3: Pesquisa de Elite Minds
+
+**O que acontece:**
+
+O sistema pesquisa automaticamente os melhores experts do domínio:
+
+```
+🔍 Pesquisando elite minds em copywriting...
+
+Iteração 1/3: Buscando experts reconhecidos...
+  ✓ Gary Halbert - "The Boron Letters", A-pile method
+  ✓ Eugene Schwartz - "Breakthrough Advertising", awareness levels
+  ✓ Dan Kennedy - "No B.S. Direct Marketing"
+
+Iteração 2/3: Devil's advocate - questionando seleção...
+  ✓ Claude Hopkins incluído - "Scientific Advertising" (fundamental)
+  ✓ David Ogilvy incluído - "Ogilvy on Advertising" (branding + DR)
+
+Iteração 3/3: Validando frameworks documentados...
+  ✓ Todos têm frameworks próprios documentados
+  ✓ Todos têm skin in the game (resultados reais)
+
+🎯 5 elite minds encontrados
+```
+
+**O que você vê:**
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ ELITE MINDS ENCONTRADOS                                         │
+├──────────────────┬──────────┬───────────────────────────────────┤
+│ Mind             │ Tier     │ Framework Principal               │
+├──────────────────┼──────────┼───────────────────────────────────┤
+│ Eugene Schwartz  │ Tier 0   │ 5 Levels of Awareness             │
+│ Gary Halbert     │ Tier 1   │ A-Pile Method                     │
+│ Dan Kennedy      │ Tier 1   │ No B.S. Direct Marketing          │
+│ Claude Hopkins   │ Tier 1   │ Scientific Advertising            │
+│ David Ogilvy     │ Tier 1   │ Ogilvy on Advertising             │
+└──────────────────┴──────────┴───────────────────────────────────┘
+
+Criar agents baseados nestes minds? [sim/não/ajustar]
+```
+
+**Por que Tier 0 e Tier 1?**
+- **Eugene Schwartz é Tier 0** porque seu framework (awareness levels) serve para DIAGNOSTICAR antes de escrever
+- **Os outros são Tier 1** porque são executores - escrevem copy diretamente
+
+**O que você responde:**
+```
+sim
+```
+
+---
+
+## Passo 4: Coleta de Fontes (Automática)
+
+**O que acontece:**
+
+Para cada mind, o sistema coleta fontes automaticamente:
+
+```
+📚 Coletando fontes para Gary Halbert...
+
+Buscando fontes primárias (Tier 1):
+  ✓ "The Boron Letters" - livro completo
+  ✓ Entrevista com John Carlton (2h)
+  ✓ "The Gary Halbert Letter" - newsletters
+  ✓ Seminário "Hurricane Marketing" - transcrição
+
+Buscando fontes secundárias (Tier 2):
+  ✓ "The Halbert Copywriting Method" - análise
+  ✓ Bond Halbert podcast sobre o pai
+
+📊 Resultado: 12 fontes (6 Tier 1, 4 Tier 2, 2 Tier 3)
+✅ SOURCE_QUALITY: PASS (12/10 fontes, 6/5 Tier 1)
+
+[Repetindo para cada mind...]
+```
+
+**Se falhar:**
+```
+⚠️ Eugene Schwartz: Apenas 4 fontes encontradas
+   Mínimo necessário: 10
+
+   Opções:
+   1. Prosseguir com qualidade reduzida (não recomendado)
+   2. Fornecer materiais próprios
+   3. Remover este mind do squad
+
+   Sua escolha: ___
+```
+
+---
+
+## Passo 5: Extração de DNA (Automática)
+
+**O que acontece:**
+
+Para cada mind, o sistema extrai Voice DNA e Thinking DNA:
+
+```
+🧬 Extraindo DNA de Gary Halbert...
+
+Voice DNA:
+  ✓ Power words: "pile of money", "starving crowd", "A-pile"
+  ✓ Signature phrases: "The answer is in the market"
+  ✓ Tom: Casual (20/100), Direto (90/100)
+  ✓ Anti-patterns: Nunca usa jargão corporativo
+
+Thinking DNA:
+  ✓ Framework: A-Pile Method (4 steps)
+  ✓ Heurísticas: "Market > Copy", "When in doubt, test"
+  ✓ Red flags: "No proven market", "Complicated offer"
+
+📊 Voice Score: 8.5/10
+📊 Thinking Score: 8.2/10
+
+✅ DNA extraction completa
+```
+
+---
+
+## Passo 6: Smoke Tests (Automático)
+
+**O que acontece:**
+
+O sistema testa se o agent realmente se comporta como o expert:
+
+```
+🧪 Rodando Smoke Tests para {agent-1}...
+
+> **Nota:** Este exemplo usa copywriting como domínio. Substitua pelos nomes de agents do seu domínio.
+
+TEST 1: Conhecimento do Domínio
+  Prompt: "Explique o A-Pile Method"
+  ✓ Usou "starving crowd" (power word)
+  ✓ Usou "pile of money" (power word)
+  ✓ Explicou os 4 steps do método
+  ✓ Tom casual e direto
+  ✓ Sem jargão corporativo
+  → PASS (5/5)
+
+TEST 2: Tomada de Decisão
+  Prompt: "Devo vender para público geral ou nicho específico?"
+  ✓ Aplicou heurística "starving crowd first"
+  ✓ Citou importância do mercado
+  ✓ Deu resposta definitiva (não "depende")
+  ✓ Justificou com experiência
+  → PASS (4/5)
+
+TEST 3: Resposta a Objeção
+  Prompt: "Copywriting é manipulação"
+  ✓ Manteve convicção
+  ✓ Respondeu com perspectiva própria
+  ✓ Não cedeu à objeção
+  ✓ Pareceu autêntico
+  → PASS (4/5)
+
+✅ SMOKE_TEST: PASS (3/3 tests)
+```
+
+**Se falhar:**
+```
+❌ TEST 2: Tomada de Decisão - FAIL (2/5)
+
+   Problemas detectados:
+   - Respondeu "depende" (anti-pattern)
+   - Não citou framework específico
+
+   Ação: Re-trabalhando DNA...
+   [Sistema ajusta automaticamente e re-testa]
+```
+
+---
+
+## Passo 7: Montagem do Squad
+
+**O que acontece:**
+
+O sistema cria a estrutura completa:
+
+```
+🏗️ Montando squad copy...
+
+Criando agents:
+  ✓ {agent-1}.md (Tier 0 - diagnóstico)
+  ✓ {agent-2}.md (Tier 1 - especialista)
+  ✓ {agent-3}.md (Tier 1 - especialista)
+  ✓ {agent-4}.md (Tier 1 - especialista)
+  ✓ {agent-5}.md (Tier 1 - especialista)
+  ✓ {squad-name}-chief.md (Orchestrator)
+
+Criando estrutura:
+  ✓ config.yaml
+  ✓ README.md
+  ✓ tasks/write-sales-page.md
+  ✓ tasks/write-headline.md
+  ✓ templates/sales-page-tmpl.md
+
+Testando integração:
+  ✓ Orchestrator roteia corretamente
+  ✓ Handoffs funcionando
+  ✓ Todos os agents respondem
+```
+
+---
+
+## Passo 8: Aprovação Final
+
+**O que você vê:**
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ ✅ SQUAD PRONTO: copy                                           │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│ │ Agent           │ Status │ Quality │ Fidelity │              │
+│ │─────────────────│────────│─────────│──────────│              │
+│ │ {agent-1}       │ ✅     │ 8.5/10  │ 72%      │              │
+│ │ {agent-2}       │ ✅     │ 8.2/10  │ 75%      │              │
+│ │ {agent-3}       │ ✅     │ 7.8/10  │ 68%      │              │
+│ │ {agent-4}       │ ✅     │ 8.0/10  │ 70%      │              │
+│ │ {agent-5}       │ ✅     │ 7.5/10  │ 65%      │              │
+│ │ {squad}-chief   │ ✅     │ 8.0/10  │ N/A      │              │
+│                                                                 │
+│ Squad Score: 8.0/10                                             │
+│ Fidelity Média: 70%                                             │
+│                                                                 │
+│ Ativação: @{squad-name}                                         │
+│ Dashboard: squads/{squad-name}/docs/quality-dashboard.md        │
+│                                                                 │
+│ [✅ DEPLOY] [🔄 AJUSTAR] [❌ CANCELAR]                          │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+**O que você responde:**
+```
+DEPLOY
+```
+
+---
+
+## Passo 9: Usando o Squad
+
+**Ativar o squad:**
+```
+@{squad-name}  # e.g., @copy
+```
+
+**Resposta:**
+```
+🎯 Copy Squad ativado!
+
+Tenho 5 experts de copywriting prontos para ajudar:
+• Eugene Schwartz - Diagnóstico de awareness
+• Gary Halbert - Sales letters e A-pile
+• Dan Kennedy - Direct response
+• Claude Hopkins - Abordagem científica
+• David Ogilvy - Brand + direct response
+
+Como posso ajudar com seu copy?
+```
+
+**Pedir uma task:**
+```
+Preciso escrever uma sales page para um curso de produtividade
+```
+
+**O que acontece:**
+```
+📋 Analisando request...
+
+→ Eugene Schwartz (Tier 0): Vou diagnosticar primeiro.
+
+Qual o nível de awareness do seu público?
+1. Unaware - Não sabe que tem problema
+2. Problem-aware - Sabe o problema, não a solução
+3. Solution-aware - Conhece soluções, não seu produto
+4. Product-aware - Conhece seu produto, não decidiu
+5. Most-aware - Pronto para comprar
+
+Sua resposta: ___
+```
+
+Após responder:
+```
+✅ Classificado: Problem-aware
+
+→ Roteando para Gary Halbert (Tier 1)
+
+Gary vai usar o A-Pile Method:
+1. Identificar a "starving crowd" no mercado
+2. Encontrar o que já estão comprando
+3. Criar oferta irresistível
+4. Escrever copy que converte
+
+Vamos começar. Me conte sobre seu público...
+```
+
+---
+
+## Resumo do Fluxo
+
+```
+Tempo total: ~20 minutos
+
+Suas interações:
+1. @squad-creator ───────── Ativar
+2. "Quero squad de {domain}" ── Solicitar
+3. "YOLO" ─────────────────  Escolher modo
+4. "sim" ──────────────────  Aprovar minds
+5. "DEPLOY" ───────────────  Aprovar final
+6. @{squad-name} ──────────  Usar!
+
+Tudo mais foi automático.
+```
+
+---
+
+## Dicas para Sua Primeira Vez
+
+### Antes de começar
+- [ ] Claude Code está funcionando?
+- [ ] Você está no diretório do projeto AIOS?
+- [ ] Sabe o domínio que quer criar?
+
+### Durante a criação
+- [ ] YOLO é mais fácil para começar
+- [ ] Aceite as sugestões de minds (são boas)
+- [ ] Não se preocupe com fidelidade baixa - pode melhorar depois
+
+### Após a criação
+- [ ] Teste o squad com requests reais
+- [ ] Se algo parecer errado, use `*validate-squad`
+- [ ] Para melhorar fidelidade, forneça materiais com `*update-mind`
+
+---
+
+## Próximos Passos
+
+1. **Crie seu primeiro squad** seguindo este tutorial
+2. **Explore os comandos:** [COMMANDS.md](./COMMANDS.md)
+3. **Entenda os conceitos:** [CONCEPTS.md](./CONCEPTS.md)
+4. **Problemas?** [TROUBLESHOOTING.md](./TROUBLESHOOTING.md)
+
+---
+
+## Checklist de Sucesso
+
+Após seguir este tutorial, você deve conseguir:
+
+- [ ] Ativar o Squad Creator
+- [ ] Escolher entre YOLO/QUALITY/HYBRID
+- [ ] Aprovar elite minds sugeridos
+- [ ] Entender o que são smoke tests
+- [ ] Usar o squad criado
+- [ ] Saber onde encontrar ajuda
+
+---
+
+---
+
+## Navegação
+
+| Anterior | Atual | Próximo |
+|----------|-------|---------|
+| [POR-ONDE-COMECAR](./POR-ONDE-COMECAR.md) | **TUTORIAL-COMPLETO** | [COMMANDS](./COMMANDS.md) |
+
+**Dúvidas?** [FAQ.md](./FAQ.md) | **Erro?** [TROUBLESHOOTING.md](./TROUBLESHOOTING.md)
+
+---
+
+**Squad Creator | Tutorial Completo v1.0**
+*"Da primeira vez ao squad funcionando."*