# HEURISTICA — conteudo → tipo de slide

Como mapear cada bloco de conteudo da aula no tipo de slide correto. Use isso quando construir a **arquitetura** que Tata vai aprovar.

**Heurística depende do MODO:**
- Modo `--aula` → usa decision tree dos tipos 01-12 abaixo + frameworks educacionais
- Modo `--cpl1/2/3` → usa estrutura fixa dos atos (ver `CPL1/2/3-ESTRUTURA.md`), heurística só aplica DENTRO dos atos pra escolher tipo de slide específico

---

## DECISION TREE (top-down)

```
Inicio da aula?
├── SIM → Tipo 01 (Titulo)
└── NAO ↓

Final da aula / call-to-action?
├── SIM → Tipo 12 (Fechamento)
└── NAO ↓

Bloco apresenta NOVO conceito + tem exemplos concretos?
├── SIM → Tipo 02 (Definicao + exemplos)
└── NAO ↓

Bloco compara DUAS coisas distintas?
├── SIM → Tipo 03 (Comparacao A vs B)
└── NAO ↓

Bloco mostra COMANDO/CODIGO concreto?
├── SIM → Tipo 04 (Comando)
└── NAO ↓

Bloco explica ANATOMIA de estrutura com 5 partes nomeaveis?
├── SIM → Tipo 05 (Breakdown visual)
└── NAO ↓

Bloco e LISTA de 3-5 items NOMAVEIS curtos?
├── SIM → Tipo 06 (Cards numerados)
└── NAO ↓

Bloco e LISTA de 4-7 items com EXPLICACAO de cada?
├── SIM → Tipo 07 (Lista numerada)
└── NAO ↓

Bloco compara "FAZ X / NAO FAZ Y" (lados opostos)?
├── SIM → Tipo 08 (Yes/No)
└── NAO ↓

Bloco e WARNING / LIMITACAO / GOTCHAS?
├── SIM → Tipo 09 (Limitacoes)
└── NAO ↓

Bloco e NUMERO de impacto / frase ancora unica?
├── SIM → Tipo 10 (Quote/Stat)
└── NAO ↓

Bloco e PROCESSO sequencial 3-5 passos?
├── SIM → Tipo 11 (Timeline)
└── NAO ↓

Nenhum encaixou direto?
└── Default: tipo 02 (Definicao) ou 06 (Cards) dependendo do volume
```

---

## SINAIS NO TEXTO QUE INDICAM TIPO

### → Tipo 02 (Definicao + exemplos)
Sinais:
- "O que e..."
- "X significa..."
- "Pra entender..."
- "Antes de continuar..."
- Tem 4 exemplos curtos identificaveis no texto

### → Tipo 03 (Comparacao A vs B)
Sinais:
- "X vs Y"
- "diferente de"
- "Y nao e a mesma coisa que X"
- "enquanto Y faz isso, X faz aquilo"
- "antes era assim, agora e assado"
- "muita gente confunde X com Y"

### → Tipo 04 (Comando/codigo)
Sinais:
- Tem barra `/comando` no texto
- "execute isso"
- "rode esse comando"
- "exemplo de codigo:"
- "sintaxe:"
- Bloco de codigo (markdown fence)

### → Tipo 05 (Breakdown visual)
Sinais:
- "Tem 5 partes:"
- "Cada campo significa:"
- "A estrutura e:"
- "Anatomia de X:"
- Numero exato de campos/partes (idealmente 5, aceita 4-6)
- Partes tem nome individual (minuto, hora, mes, dia-mes, dia-sem)

### → Tipo 06 (Cards numerados 1-N)
Sinais:
- "As 5 operacoes:"
- "Os 3 pilares:"
- "4 passos:"
- N esta entre 3-5
- Cada item e nomeavel em 1-2 palavras
- Cada item tem descricao curta (max 15 palavras)

### → Tipo 07 (Lista numerada vertical)
Sinais:
- "Boas praticas:"
- "Regras de ouro:"
- "Principios:"
- "Lembrar de:"
- "Checklist:"
- N esta entre 4-7
- Cada item precisa de mais explicacao (frase explicativa de 10-25 palavras)

### → Tipo 08 (Yes/No dois paineis)
Sinais:
- "Funciona em A, nao funciona em B"
- "Use pra X, nao use pra Y"
- "Brilha aqui, nao serve aqui"
- "Faz / Nao faz"
- "Compre / Nao compre"
- "Pra quem e / Pra quem nao e"

### → Tipo 09 (Limitacoes/Warning)
Sinais:
- "Atencao com..."
- "Cuidado:"
- "Limitacoes:"
- "Importante saber:"
- "Pontos negativos:"
- "O que NAO funciona:"
- 4+ pontos de alerta

### → Tipo 10 (Quote/Stat gigante)
Sinais:
- Numero percentual ou estatistico de impacto (97%, 3x, R$ 1M)
- Frase ancora memoravel ("velocidade vence perfeicao")
- Citacao de autoridade ("Steve Jobs disse...")
- Ponto unico de impacto que merece slide proprio

### → Tipo 11 (Timeline horizontal)
Sinais:
- "Como funciona em N passos:"
- "Fluxo:"
- "Etapas:"
- "Processo:"
- "Primeiro X, depois Y, dai Z"
- Sequencia temporal explicita
- 3-5 passos

---

## EXEMPLOS DE MAPEAMENTO REAL

### Exemplo 1: aula "Rotinas no Claude Code"

Conteudo bruto (resumido):
> "Hoje vou explicar o que e uma rotina, que e um agente que roda sozinho no servidor da Anthropic em horario fixo. E diferente do /loop, que roda na sua sessao. Pra criar voce usa /schedule de forma natural. A sintaxe cron tem 5 campos: minuto, hora, dia-mes, mes, dia-semana. O /schedule faz 5 operacoes: criar, listar, atualizar, rodar-agora e deletar. Tem limitacoes — nao acessa arquivos locais, MCPs locais nao funcionam. Brilha em monitoramento de APIs remotas, nao serve pra editar Obsidian. Boas praticas: comece simples, prompt explicito, timezone Brasil, output estruturado, frequencia baixa. Comece com uma rotina hoje."

Arquitetura mapeada:
| # | Tipo | Justificativa |
|---|------|---------------|
| 01 | Titulo | sempre |
| 02 | Definicao+4 exemplos | "o que e uma rotina + 4 exemplos cron" |
| 03 | Comparacao A vs B | "/schedule vs /loop" |
| 04 | Comando | "/schedule de forma natural" |
| 05 | Breakdown visual | "5 campos do cron" |
| 06 | Cards 1-5 | "5 operacoes" |
| 09 | Limitacoes | "tem limitacoes" |
| 08 | Yes/No | "brilha aqui / nao serve aqui" |
| 07 | Lista numerada | "5 boas praticas" |
| 12 | Fechamento | sempre |

→ 10 slides ✅

### Exemplo 2: aula "Persona Profunda" (hipotetica)

Conteudo bruto (resumido):
> "Persona e o cliente ideal mapeado em 30 dimensoes psicologicas. Difere de ICP (mais demografico) e Avatar (mais superficial). Os 5 pilares sao: dores, desejos, objecoes, linguagem, sonhos. 3 niveis de persona: superficial, comportamental, psicologica. 80% das mentoradas falha por persona vaga. Pra construir uma boa: 6 passos — coleta de transcricoes, mapeamento de dores, deep market research, mapa de empatia, anti-persona, validacao. Erros comuns: persona generica, sem dor real, copiada de concorrente. Comece com 1 persona, depois expande."

Arquitetura mapeada:
| # | Tipo | Justificativa |
|---|------|---------------|
| 01 | Titulo | sempre |
| 02 | Definicao | "o que e persona profunda" |
| 03 | Comparacao | "persona vs ICP vs avatar" |
| 06 | Cards 1-5 | "5 pilares" |
| 11 | Timeline 6 passos | "como construir em 6 passos" |
| 10 | Stat | "80% falha por persona vaga" |
| 07 | Lista numerada | "erros comuns a evitar" (4-5 items) |
| 12 | Fechamento | sempre |

→ 8 slides ✅

---

## REGRAS DE MAPEAMENTO MULTI-BLOCO

### Quando um bloco parece encaixar em DOIS tipos:

| Conflito | Decisao |
|---|---|
| 02 vs 06 (definicao com lista) | Se a lista E central → 06. Se a lista E suporte → 02 |
| 03 vs 08 (comparacao vs yes/no) | Se compara PROPRIEDADES (especificacoes) → 03. Se compara USOS (fazer/nao fazer) → 08 |
| 06 vs 07 (cards vs lista) | N=3-5 e descricao curta → 06. N=4-7 e descricao media → 07 |
| 06 vs 11 (cards vs timeline) | Items independentes → 06. Items sequenciais → 11 |
| 09 vs 07 (limitacoes vs lista) | Conteudo e WARNING → 09. Conteudo e RECOMENDACAO → 07 |
| 04 vs 05 (comando vs breakdown) | Tem comando completo → 04. So estrutura sem comando → 05 |

### Quando dividir 1 bloco em 2 slides:

Bloco grande demais quando:
- Lista tem 8+ items → divide em 2 (4+4 ou 3+5)
- 1 bloco tenta cobrir 3 ideias diferentes → 3 slides
- h2 + texto explicativo + 5 cards + 3 ex-cards → 2 slides (1 conceito + 1 cards)

### Quando consolidar 2 blocos em 1 slide:

- 2 listas curtas (3+3) que se relacionam → tipo 08 (yes/no se opostas) ou 06 (se complementares)
- 1 definicao curta + 1 exemplo → tipo 02 (com exemplos no card direito)

---

## HEURISTICA DE ALTERNANCIA DE BG

Ordem de cores ideal pra 10 slides:

```
01 navy        ← titulo
02 navy        ← definicao
03 paper       ← respiro
04 navy        ← comando
05 paper       ← respiro (cron)
06 navy        ← cards
07 dark        ← warning (unico dark do deck)
08 paper       ← respiro
09 navy        ← boas praticas
10 navy        ← fechamento
```

**Regras:**
- Nunca 4 navy consecutivos sem respiro paper
- Dark aparece no maximo 1x e geralmente no meio (slide 5-8)
- Paper "respira" entre blocos navy intensos
- Slide 01 e ultimo SEMPRE navy

---

## HEURISTICA DOS 4 TIPOS NOVOS DE VENDAS (13-16)

Estes tipos só aparecem em modos CPL. Não confundir com tipos base.

### → Tipo 13 (Prova Social Cascata) — usar quando:
- Modo `--cpl1`: slide 02 (depois do hook)
- Modo `--cpl2`: slide 02 (testimonials abertura) + slide 17 (loop sanduíche)
- Modo `--cpl3`: slide 09 (avalanche de cases)
- Tem 4+ testimonials disponíveis com nome+nicho+número

### → Tipo 14 (Projeção 5 Anos) — usar quando:
- Modo `--cpl1`: slide 14 (antes do Da Vinci closer)
- Avatar é empreendedor que vai escalar
- Tem ticket-base definido pra calcular projeção
- NUNCA em modo --aula (vira propaganda)

### → Tipo 15 (Soft Pitch) — usar quando:
- Modo `--cpl2`: slide 14 (ventilada 3 oficial)
- Programa já tem nome
- NÃO tem preço pra revelar (preço só CPL3)
- Tem 5 entregas definidas + 3 perfis de "pra quem é/não é"

### → Tipo 16 (Demolição Objeção) — usar quando:
- Modo `--cpl2`: slide 05 (objeção mestre)
- Modo `--cpl3`: slide 04 (objeção "é caro")
- Tem objeção LITERAL conhecida do avatar
- Tem case REAL pra contraprova

---

## DECISION TREE PRIMARY — qual MODO usar

```
A aula vai VENDER produto/mentoria no final?
├── NAO → modo --aula
└── SIM ↓
    Faz parte de SÉRIE de 3 aulas (lançamento clássico)?
    ├── NAO → modo --aula com slide extra de pitch suave no fim
    └── SIM ↓
        Qual é a posição?
        ├── 1a → --cpl1
        ├── 2a → --cpl2
        └── 3a → --cpl3
```

---

## QUANDO PEDIR PRA TATA DECIDIR

A skill apresenta a arquitetura proposta como markdown table. Se houver:

- **Ambiguidade real** (bloco poderia ser 2 tipos diferentes) → marca com ⚠️ e pergunta
- **Conteudo borderline** (10+ items que nao cabem em nenhum tipo) → sugere 2 opcoes
- **Aula muito grande** (15+ topicos) → sugere quebrar em 2 decks

Formato da pergunta:

```markdown
## Arquitetura proposta — 10 slides

| # | Tipo | Titulo proposto | Justificativa |
|---|------|-----------------|---------------|
| 01 | Titulo | Rotinas | sempre |
| 02 | Definicao | O que e uma rotina | introduz conceito + 4 exemplos cron |
| ... |

⚠️ DECISOES BORDERLINE:
- Slide 05: bloco sobre "cron sintaxe" cabe em 04 (comando) OU 05 (breakdown). Sugiro 05 porque o foco e estrutura, nao comando. OK ou prefere 04?
- Slide 07: 5 limitacoes + 4 boas praticas. Sugiro 09 (limitacoes dark) + 07 (lista boas praticas) em slides separados. Tata aprova ou consolida em 1?

OK pra gerar HTML?
```
