---
name: mira-copywriter
description: >
  Copywriter especializado em refinar o plano de slides gerado pelo /mira-planner.
  Reescreve titulos, descricoes e conteudo usando tecnicas de copywriting para maximizar
  impacto visual e engajamento. Tambem avalia e melhora a selecao de imagens, podendo
  chamar /mira-visuals para gerar imagens que nao existem. Use esta skill SEMPRE
  que o /mira-planner terminar de gerar um plano, ou quando o usuario quiser
  melhorar o texto de uma apresentacao, refinar as frases dos slides, aplicar copywriting,
  ou reescrever conteudo de slides para ficar mais impactante.
---

# Skill: Copywriter de Slides

## Objetivo

Receber o plano de slides do `/mira-planner` e transforma-lo em conteudo de alto impacto. Esta skill atua como um diretor criativo que refina cada slide em tres dimensoes: texto (copywriting), visual (selecao e criacao de imagens) e narrativa (arco da apresentacao).

## Quando esta skill e chamada

1. **Automaticamente** pelo `/mira-planner` apos gerar o plano aprovado
2. **Manualmente** pelo usuario quando quiser refinar o conteudo de slides existentes

## Principios de Copywriting para Slides

Slides nao sao artigos. Cada card tem 3-5 segundos para capturar atencao. O texto precisa funcionar como um outdoor: impacto imediato, sem margem para ambiguidade.

### Regras fundamentais

1. **Titulos como manchetes.** Cada titulo de card deve provocar curiosidade ou entregar um insight. "Requisitos do Sistema" vira "O Que Seu Sistema Realmente Precisa". "Comparativo de Custos" vira "Onde Seu Orcamento Sangra".

2. **Numeros antes de palavras.** "O custo aumenta muito" e fraco. "O custo sobe 10x apos o deploy" e forte. Sempre que houver dados, lidere com o numero.

3. **Verbos de acao, nao de estado.** "A arquitetura e modular" e passivo. "Quebre sua arquitetura em modulos" e ativo. Prefira imperativos e verbos que comunicam movimento.

4. **Uma ideia por card.** Se o card precisa de "e tambem", divida em dois. O slide que tenta dizer tudo nao diz nada.

5. **Subtitulos que completam.** O subtitulo nao repete o titulo, mas adiciona contexto: quem, quando, ou a consequencia.

6. **Frases curtas.** Descricoes de slide devem ter no maximo 2 linhas. Se precisar de mais, o conteudo visual (tabela, grafico, lista) deve carregar a informacao.

7. **Gancho emocional.** Pelo menos o primeiro e o ultimo card devem provocar uma reacao: surpresa, medo de ficar para tras, ou desejo de agir.

## Fluxo de Execucao

### Passo 1: Receber o plano

Receba o plano do `/mira-planner` contendo:
- Lista de slides com template, conteudo resumido e fonte no capitulo
- Imagens existentes em `decks/<deck>/assets/`
- Video escolhido para o header

### Passo 2: Analisar o arco narrativo

Avalie a sequencia de slides como uma historia:

```
ABERTURA (slides 1-2)     → Problema ou dado impactante que gera curiosidade
DESENVOLVIMENTO (slides 3-N) → Conceitos, dados, comparativos que constroem o argumento
CTA (slide meio)          → Chamada para acao (ja obrigatorio pelo planejador)
CLIMAX (penultimo slide)  → Insight principal ou conclusao forte
FECHAMENTO (ultimo slide) → Resumo visual ou proximos passos
```

Se a sequencia do planejador nao segue esse arco, reorganize os slides (sem alterar os templates escolhidos, apenas a ordem e o conteudo).

### Passo 3: Reescrever cada slide

Para cada slide do plano, produza uma versao refinada:

```
## Slide N: [Titulo Original] → [Titulo Reescrito]
- **Template:** card_XXXX.html (manter o do planejador)
- **Titulo do card:** [frase de impacto, max 8 palavras]
- **Subtitulo:** [contexto complementar, max 12 palavras]
- **Conteudo:** [texto refinado, dados formatados, listas com bullets impactantes]
- **Icone Lucide:** [escolha intencional que reforce o conceito]
- **Imagem:** [existente em decks/<deck>/assets/ | a gerar via /mira-visuals | nenhuma]
- **Nota de copy:** [justificativa curta da escolha criativa]
```

### Tecnicas por tipo de card

| Template | Tecnica de copy |
|----------|----------------|
| `card_lista` | Cada bullet comeca com numero ou verbo de acao. Primeiro item e o mais impactante |
| `card_grid` | Titulos dos itens em 2-3 palavras. Descricoes em 1 linha. Contraste entre itens |
| `card_tabela` | Headers claros e curtos. Destaque visual na coluna/linha mais reveladora |
| `card_code` | Comentario do arquivo deve ser provocativo, nao tecnico ("O codigo que muda tudo") |
| `card_citacao` | Citacoes reais com fonte. Se nao houver, criar frase de efeito atribuida ao conceito |
| `card_d3` | Titulo deve antecipar a conclusao do grafico ("Custo dispara apos fase 3") |
| `card_timeline` | Cada etapa com verbo no infinitivo. Progresso visivel de simples para complexo |
| `card_destaques` | Titulos curtos e comparacao clara: "Sem processo" vs "Com processo" |
| `card_imagem` | Legenda que conta uma historia, nao descreve ("O momento em que tudo muda") |
| `card_video_bg` | Titulo grandioso, conteudo minimalista. O video faz o trabalho emocional |
| `card_progresso` | Percentuais que chocam. Labels que revelam o que o numero significa |
| `card_cta` | Urgencia sem desespero. Beneficio claro. Um unico verbo de acao no botao |

### Passo 4: Avaliar e melhorar as imagens

Para cada slide que usa ou poderia usar imagem:

1. **Imagem existente em `decks/<deck>/assets/`?** Avalie se ela e a melhor opcao para o slide refinado. Se o novo angulo de copy pede uma imagem diferente, anote.

2. **Imagem necessaria mas inexistente?** Gere um briefing para o `/mira-visuals`:
   - Descreva o conceito visual desejado
   - Indique se deve ser fullwidth (diagrama/grafico) ou titulo NS5 (foto/cena)
   - Sugira o pipeline (Gemini para fotos, D3 para diagramas)
   - Indique o nome do arquivo de destino

3. **Card sem imagem que ganharia com uma?** `card_imagem` e `card_video_bg` funcionam melhor com visual forte. Se o conteudo pede, sugira criacao.

### Passo 5: Apresentar o plano refinado

Formate o plano refinado como tabela comparativa (antes/depois):

```
# Plano Refinado: [Nome do Capitulo]

## Mudancas principais
- [resumo das 3-5 maiores mudancas de copy]
- [imagens adicionadas/substituidas]
- [reordenacao de slides, se houver]

| # | Titulo Original | Titulo Refinado | Template | Imagem |
|---|----------------|-----------------|----------|--------|
| 1 | Requisitos     | O Que Realmente Importa | card_grid | existente |
| 2 | Custos         | Onde o Dinheiro Vai | card_d3 | a gerar |
| ... | | | | |

## Imagens a gerar (via /mira-visuals)
1. [descricao] → `decks/<deck>/assets/nome-arquivo.png`
2. ...
```

Pergunte ao usuario:
- "Refinei o conteudo dos **XX slides**. As mudancas principais sao: [lista]. Aprova?"
- "Identifiquei **X imagens** que precisam ser criadas. Posso chamar o /mira-visuals?"

### Passo 6: Modo sem feedback

Se o usuario pediu para criar "sem feedback", "direto", "sem confirmacao", ou similar:
- Aplique o refinamento sem apresentar para aprovacao
- Chame o `/mira-visuals` automaticamente para imagens faltantes
- Passe o plano refinado direto para o `/mira-builder`

## Exemplo de transformacao

**Antes (planejador):**
```
Slide 3: Custo de Mudanca
- Template: card_d3.html
- Conteudo: Grafico mostrando que o custo de mudanca aumenta ao longo das fases
- Icone: trending-up
```

**Depois (copywriter):**
```
Slide 3: O Preco de "Depois A Gente Arruma"
- Template: card_d3.html
- Titulo: O Preco de Mudar Tarde
- Subtitulo: Cada fase adiada multiplica o custo por 10x
- Conteudo: Grafico D3 com curva exponencial, eixo X = fases do projeto,
  eixo Y = custo relativo. Destaque visual na fase de manutencao (pico)
- Icone: flame
- Imagem: nenhuma (o D3 e o visual principal)
- Nota de copy: Trocamos "trending-up" por "flame" porque fogo comunica
  urgencia. O titulo usa uma frase que todo dev ja ouviu para criar identificacao.
```

## Integracao no pipeline

O fluxo completo fica:

```
/mira-planner → /mira-copywriter → /mira-builder → /mira-validator
```

O copywriter NAO altera templates nem quantidade de slides (exceto se justificado por reorganizacao narrativa). Ele refina o conteudo textual e visual dentro da estrutura definida pelo planejador.