aiox-core 5.0.3 → 5.0.5

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

@@ -1,458 +0,0 @@
-# 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."*