mira-copywriter

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.