# 6 Templates Base — escolha o certo

Use este guia pra decidir QUAL template aplicar conforme a intencao do diagrama.

## Mapa de decisao

| Intencao | Template | Quando usar |
|---|---|---|
| Mostrar conversao em etapas | `funil` | Funil de vendas, funil de eventos, pipeline |
| Comparar duas dimensoes | `matriz_2x2` | Esforco x Impacto, ICE, RICE, prioridade |
| Narrar processo sequencial | `jornada` | Customer journey, processo, onboarding |
| Mostrar conceito central com derivados | `hub_spoke` | Metodo, ecossistema, arquitetura |
| Mostrar evolucao no tempo | `timeline` | Roadmap, historico, milestones |
| Brainstorm ou estrutura hierarquica | `mapa_mental` | Brainstorm, livro, framework |

## 1. FUNIL VERTICAL (`funil`)

5 trapezios sobrepostos (decrescentes) com gradiente em camadas + esquerda volume Cascadia + direita skill responsavel em Virgil.

**Dados esperados** (JSON):
```json
{
  "titulo": "Funil Imperatriz",
  "etapas": [
    {"nome": "Trafego", "volume": "10.000", "skill": "ads-meta"},
    {"nome": "Captura", "volume": "2.500", "skill": "form-cro"},
    {"nome": "Qualificacao", "volume": "800", "skill": "imperatriz-bot"},
    {"nome": "Reuniao", "volume": "120", "skill": "imperatriz-das-vendas"},
    {"nome": "Cliente", "volume": "24", "skill": "stack-closer"}
  ]
}
```

**Recomendacoes pos-geracao**:
- Adiciona icones (importar Lucide library)
- Adiciona setas decrescentes laterais com taxa de conversao
- Frame externo: nome do funil em CAPS

## 2. MATRIZ 2x2 (`matriz_2x2`)

4 quadrantes coloridos (accent, dominante, neutro, destaque_quente) + setas dos eixos saindo do centro + labels rotacionados.

**Dados esperados**:
```json
{
  "titulo": "Esforco x Impacto",
  "eixo_x": "Esforco",
  "eixo_y": "Impacto",
  "quadrantes": {
    "alto_alto": "Faca agora",
    "alto_baixo": "Planeje",
    "baixo_alto": "Quick wins",
    "baixo_baixo": "Esqueca"
  }
}
```

**Recomendacoes**:
- Plota pontos (elipses pequenas) com label de iniciativa
- Adicione legenda com tamanho do circulo = volume ou prioridade

## 3. JORNADA HORIZONTAL (`jornada`)

5-7 Frames lado a lado + fio condutor (linha horizontal accent atravessando) + marcador circular em cada fase + bullets em Virgil dentro do Frame.

**Dados esperados**:
```json
{
  "titulo": "Jornada do Cliente",
  "fases": [
    {"nome": "Descoberta", "bullets": ["Ve anuncio", "Curioso"], "icone": "👁"},
    {"nome": "Pesquisa", "bullets": ["Compara opcoes", "Busca prova"], "icone": "🔍"},
    {"nome": "Decisao", "bullets": ["Aprova", "Compra"], "icone": "✓"}
  ]
}
```

**Recomendacoes**:
- Acima do fio condutor: emocao/sentimento (em curva)
- Abaixo: touchpoints/canais
- Icone pode ser substituido por ilustracao importada

## 4. HUB & SPOKE (`hub_spoke`)

Circulo central grande (cor dominante) + 6-8 cards menores ao redor + anel decorativo tracejado + conectores radiais.

**Dados esperados**:
```json
{
  "titulo": "Metodo Olimpo",
  "centro": "OLIMPO",
  "raios": ["Zeus", "Hera", "Atena", "Apolo", "Artemis", "Ares", "Hermes", "Hefesto"]
}
```

**Recomendacoes**:
- Anel externo: descricao curta da metodologia (texto curvo manual)
- Cada raio com icone Lucide consistente

## 5. TIMELINE HORIZONTAL (`timeline`)

Linha horizontal 2px grossa + marcadores circulares accent + texto alternando cima/baixo (zig-zag) + datas em Cascadia mono.

**Dados esperados**:
```json
{
  "titulo": "Roadmap 2026",
  "eventos": [
    {"data": "Jan", "nome": "Diagnostico", "descricao": "..."},
    {"data": "Mar", "nome": "Eixo definido"},
    {"data": "Jun", "nome": "Primeira mentorada"},
    {"data": "Dez", "nome": "Lancamento perpetuo"}
  ]
}
```

**Recomendacoes**:
- Marcadores especiais (estrela em vez de circulo) pra milestones criticos
- Color-code eventos por tipo (verde=conquista, vermelho=risco)

## 6. MAPA MENTAL (`mapa_mental`)

No central retangular (fill dominante) + 6-8 ramos como cards + sub-ramos como bullets Virgil + conectores curvos.

**Dados esperados**:
```json
{
  "centro": "Travessia Imperatriz",
  "ramos": [
    {"nome": "Diagnostico", "sub": ["7 pilares", "Eixo", "Mecanismo"]},
    {"nome": "Construcao", "sub": ["Rotina", "Skills"]},
    {"nome": "Escala", "sub": ["1a venda", "10 vendas", "Time"]}
  ]
}
```

**Recomendacoes**:
- Coloriza ramos por categoria (cada categoria 1 tom)
- Linhas mais grossas pros ramos principais, finas pros sub

## Mistura de templates

Templates podem ser combinados num mesmo canvas usando Frames:

- Frame 1: matriz 2x2 (estrategia)
- Frame 2: funil (execucao)
- Frame 3: timeline (cronograma)

Cria narrativa visual em "slides" navegaveis.

## Quando NAO usar nenhum template

- **Diagrama unico personalizado** — desenha do zero usando helpers.excalidraw direto
- **Sketch livre de ideacao** — abre Excalidraw web em branco e usa /mapa-mental-imperatriz pra extrair estrutura depois
- **Mais de 8 niveis hierarquicos** — usa Whimsical ou Lucidchart, Excalidraw nao escala
