---
name: excalidraw-imperatriz
description: Fabrica de diagramas premium no Excalidraw aplicando sistema de design Imperatriz (paleta dourado+esmeralda+marfim+carvao, tipografia Helvetica/Virgil/Cascadia, grid 20px, sombras, conectores elbow). Gera .excalidraw e .excalidrawlib prontos pra excalidraw.com ou plugin Obsidian. 6 templates (funil, matriz 2x2, jornada, hub-spoke, timeline, mapa mental) + 3 receitas Imperatriz (Travessia, Olimpo, funil HT) + 4 paletas (imperatriz, mckinsey, dark, notion). 4 modos- criar (entrevista+template), aplicar-tema (estiliza .excalidraw existente), library (gera .excalidrawlib), auditar (nota 0-100 em 12 criterios). Use quando pedir diagrama no Excalidraw, visual premium, fazer mapa, exportar pra Excalidraw, library Imperatriz, auditar diagrama, framework visual, esquema da Travessia, visual do Olimpo, ou quando mapa-mental-imperatriz/texto-em-visual/mecanismo-unico precisar de artefato Excalidraw. Metodo Imperatriz de Diagrama Premium — propriedade Tata Goncalves.
---

# Excalidraw Imperatriz — fabrica de diagramas premium

Voce e a skill que transforma briefing em diagrama Excalidraw nota 1000 aplicando o sistema de design Imperatriz: paleta limitada, tipografia hierarquica, grid, sombras, bordas duplas, conectores premium. Outputs sao JSON validos que abrem direto em excalidraw.com OU como nota nativa no Obsidian vault da Tata.

## 4 modos da skill

| Modo | Quando usar | Script principal |
|---|---|---|
| **criar** | Construir diagrama do zero a partir de briefing | `gerar_diagrama.py` |
| **aplicar-tema** | Receber .excalidraw feio e estilizar | `aplicar_tema.py` |
| **library** | Gerar/atualizar .excalidrawlib pra arrastar shapes | `gerar_library.py` |
| **auditar** | Avaliar diagrama existente e dar nota | `auditar.py` |

## Workflow padrao — MODO CRIAR

1. **Entrevista curta** com o usuario (3-5 perguntas, NUNCA todas de uma vez):
   - Que conceito/processo voce quer visualizar? (1 frase)
   - Eh sequencia, comparacao, ramificacao, ou tempo?
   - Quantos elementos no total? (3-12 ideal)
   - Paleta: imperatriz (default), mckinsey, dark_premium, ou notion_minimal?
   - Salvar no vault como `09 - Mapas Mentais/` (se mapa mental) ou `03 - Projetos/` (se framework de projeto)?

2. **Mapeia briefing → template** usando `references/templates.md`:
   - sequencia conversao → `funil`
   - comparacao 2 dimensoes → `matriz_2x2`
   - processo sequencial → `jornada`
   - centro+derivados → `hub_spoke`
   - evolucao temporal → `timeline`
   - brainstorm/hierarquia → `mapa_mental`

3. **Monta JSON de dados** conforme schema do template (ver templates.md). NUNCA mais de 12 elementos por template — se exceder, divide em 2 frames.

4. **Roda gerador**:
   ```bash
   python3 ~/.claude/skills/excalidraw-imperatriz/scripts/gerar_diagrama.py \
     --template <funil|matriz_2x2|jornada|hub_spoke|timeline|mapa_mental> \
     --dados <dados.json> \
     --paleta <imperatriz|mckinsey|dark_premium|notion_minimal> \
     --saida <caminho.excalidraw> \
     --obsidian
   ```
   `--obsidian` gera tambem `.excalidraw.md` pro plugin Obsidian da Tata.

5. **Audita** com `auditar.py` e ajusta se nota < 75.

6. **Salva no vault**:
   - Mapa mental, brainstorm → `~/Documents/Obsidian Vault/09 - Mapas Mentais/`
   - Framework de projeto, metodologia → `~/Documents/Obsidian Vault/03 - Projetos/<nome>/`
   - Library/recursos → `~/Documents/Obsidian Vault/08 - Recursos/`

7. **Mostra ao usuario** o caminho final + comandos pra abrir/editar:
   - "Abre no excalidraw.com arrastando o arquivo"
   - "Ou abre direto no Obsidian se foi gerado o .excalidraw.md"

## Workflow — MODO APLICAR-TEMA

Quando o usuario manda um .excalidraw feio/desorganizado:

```bash
python3 ~/.claude/skills/excalidraw-imperatriz/scripts/aplicar_tema.py \
  --entrada <diagrama-feio.excalidraw> \
  --saida <diagrama-premium.excalidraw> \
  --paleta imperatriz
```

O script:
- Mapeia cores antigas → paleta Imperatriz (por luminosidade)
- Padroniza fontes (Helvetica/Virgil/Cascadia conforme tamanho)
- Forca roughness architect uniforme
- Stroke width minimo 2px
- Setas viram elbow automaticamente
- Background marfim/carvao conforme paleta
- NAO move elementos (layout preservado)

Depois, audita.

## Workflow — MODO LIBRARY

Pra Tata ter biblioteca pessoal pra arrastar no Excalidraw:

```bash
python3 ~/.claude/skills/excalidraw-imperatriz/scripts/gerar_library.py \
  --saida ~/Documents/Obsidian\ Vault/08\ -\ Recursos/library-imperatriz.excalidrawlib \
  --paleta imperatriz
```

Gera 12 shapes premium: card premium, card destaque, card accent, hub central, frame de secao, conector elbow, post-it, card metrica KPI, breadcrumb de fases, mini matriz 2x2, trio de funil, highlighter+texto.

A Tata importa no Excalidraw: Library Panel > "..." > Open library file.

3 paletas disponiveis (ja existem em `assets/`):
- `library-imperatriz.excalidrawlib` (default)
- `library-mckinsey.excalidrawlib`
- `library-dark.excalidrawlib`

## Workflow — MODO AUDITAR

Pra avaliar nivel premium de um diagrama:

```bash
python3 ~/.claude/skills/excalidraw-imperatriz/scripts/auditar.py \
  --entrada <diagrama.excalidraw>
```

Avalia 12 criterios (paleta limitada, tipografia consistente, roughness uniforme, stroke uniforme, alinhamento grid, espacamento minimo, tem titulo, background estilizado, frames organizam, conectores premium, shapes arredondados, annotations humanas) e gera:
- Nota 0-100
- Nivel (Premium ≥90, Bom ≥75, Medio ≥60, Rascunho <60)
- Lista de recomendacoes especificas pra subir o nivel

## Receitas Imperatriz prontas (assets/receitas/)

Quando o usuario pedir um destes, USE O ASSET PRONTO em vez de gerar do zero:

- **Travessia 26 Portas** → `assets/receitas/travessia-26-portas.excalidraw`
- **Metodo Olimpo (12 deuses)** → `assets/receitas/metodo-olimpo.excalidraw`
- **Funil High-Ticket** → `assets/receitas/funil-high-ticket.excalidraw`

Copia o asset pro destino do usuario e fala "ja temos esse pronto — abre direto".

Detalhes em `references/receitas-imperatriz.md` (8 receitas mapeadas: 3 ja prontas + 5 pra construir).

## Integracao com outras skills do ecossistema

| Skill | Como integrar |
|---|---|
| `/mapa-mental-imperatriz` | Quando essa skill terminar mapa Mermaid/Markmap, oferece gerar versao Excalidraw editavel chamando esta skill modo `criar --template mapa_mental` |
| `/texto-em-visual` | Quando o usuario pedir "visualizar minha copy" e o tipo for diagrama (Dan Roam), passa pra esta skill |
| `/mecanismo-unico` | Apos gerar mecanismo, oferece diagrama hub_spoke com o mecanismo no centro |
| `/processo-imperatriz` | Cada framework filho (PDCA, SWOT, etc) pode gerar seu diagrama via esta skill |

## Regras criticas de qualidade

1. **Maximo 12 elementos por template** — diagrama com 30 shapes vira poluicao. Quebra em frames.
2. **Sempre roda auditar.py antes de entregar** — nota minima aceitavel: 75
3. **Sempre oferece `--obsidian`** se o destino eh o vault da Tata (default)
4. **Background NUNCA branco puro** — auditor rejeita
5. **Roughness uniforme** — escolhe UMA (architect default) pra todo o diagrama
6. **Maximo 5 cores no diagrama** — auditor rejeita acima de 6
7. **Annotation Virgil em pelo menos 1 lugar** — diferencia diagrama premium de PowerPoint
8. **NAO desenha icones** — recomenda importar library Lucide/Carbon de excalidraw.com/libraries

## Localizacao dos arquivos

```
~/.claude/skills/excalidraw-imperatriz/
├── SKILL.md (este arquivo)
├── scripts/
│   ├── gerar_diagrama.py (modo criar)
│   ├── aplicar_tema.py (modo aplicar-tema)
│   ├── gerar_library.py (modo library)
│   ├── auditar.py (modo auditar)
│   └── helpers/
│       ├── paleta.py (4 paletas + constantes)
│       └── excalidraw.py (builders de elementos)
├── references/
│   ├── sistema-design.md (paleta, tipografia, truques, anti-patterns)
│   ├── templates.md (6 templates + dados esperados)
│   ├── receitas-imperatriz.md (8 receitas do universo Tata)
│   └── formato-excalidraw.md (esquema JSON detalhado)
└── assets/
    ├── library-imperatriz.excalidrawlib (12 shapes prontos)
    ├── library-mckinsey.excalidrawlib
    ├── library-dark.excalidrawlib
    ├── templates/ (6 templates de exemplo)
    └── receitas/ (3 receitas Imperatriz prontas)
```

## Quando carregar references

- **sistema-design.md** — sempre que gerar/editar/auditar (e o canon visual)
- **templates.md** — quando escolher qual template aplicar
- **receitas-imperatriz.md** — quando o usuario mencionar Travessia, Olimpo, funil HT, ou qualquer conceito proprietario da Tata
- **formato-excalidraw.md** — quando precisar editar JSON manualmente ou debugar saida

## Auditoria pos-geracao — quando ajustar manualmente

Apos `auditar.py`, se a nota for < 90, sugere ao usuario:
- "Falta frame organizando" → "Abre no Excalidraw, seleciona todos, pressiona `F` pra criar frame"
- "Setas retas" → "Seleciona seta, no painel direito troca pra Elbow"
- "Background branco" → "Settings > Canvas background pra `#FAF8F3`"
- "Sem annotation Virgil" → "Adiciona 2-3 textos em fonte Virgil pra dar voz manuscrita"

NUNCA reescreve o diagrama todo automaticamente — sugere edicao manual no Excalidraw web (mais rapido).

## Quando o Excalidraw NAO eh o certo

- Apresentacao cinematografica → recomenda Keynote/Figma
- 50+ nodes → recomenda Whimsical/Lucidchart
- Dashboard de dados ao vivo → recomenda Notion/Tableau
- Infografico com fotos → recomenda Canva/Figma

Excalidraw brilha em: frameworks conceituais, mapas mentais, fluxos de processo, wireframes, storyboard, didatica visual em mentoria.
