| name | mira-animated-metaphor |
| description | Transforma a animação de um slide (ou de todos) numa METÁFORA visual animada. A partir do conceito do slide, o agente cria uma analogia concreta do cotidiano e a anima no padrão do mira-animator (loop interno obrigatório). Substitui a animação no lugar, mantendo título, subtítulo e pílulas. Use SEMPRE que o usuário disser "/mira-animated-metaphor", "metáfora animada", "transforma em metáfora", "cria uma analogia", "anima como analogia", "transforma os slides em metáforas", "vira metáfora", "quero uma metáfora pra esse conceito", "anima essa ideia como analogia", "metáfora visual", ou pedir para reexpressar um conceito como comparação animada, no deck inteiro ou num slide específico. |
Skill: Metáfora Animada
Pega o conceito de um slide e o reexpressa como uma analogia concreta do cotidiano, animada. Não é uma animação literal do conceito, é a metáfora dele em movimento. Ex.: "débito técnico" vira "juros que crescem sozinhos numa torre"; "orquestração de agentes" vira "maestro regendo os naipes em uníssono".
Relação com o mira-animator
Esta skill é o mira-animator com uma etapa a mais na frente: gerar a metáfora. Toda a parte técnica é a mesma e deve ser seguida à risca:
- Estrutura do card, título sem ícone com no máximo 6 palavras, margem do título ao topo, cores do tema.
- Loop interno obrigatório (regra-mãe): nenhuma animação é estática, ela entra com coreografia e segue em movimento perpétuo.
- Padrão anti-vazamento de loop (
window.__slugGen), trigger em setupAnimationTriggers(), botão Replay.
viewBox="0 0 1280 720", canvas no padrão .anim-stage.- Diretrizes D3 em
agents/mira-animator/references/.
Leia agents/mira-animator/SKILL.md antes de animar. Esta skill foca no que é exclusivo dela: a metáfora.
REGRA DE IDIOMA
Siga agents/_shared/idioma.md. Português correto. Proibido travessão (—): use vírgula ou dois-pontos.
O que esta skill faz e o que NÃO faz
- Substitui a animação no lugar: o slide continua na mesma posição, com o mesmo título, subtítulo e pílulas. Só o desenho do palco muda, virando a metáfora. No máximo, um ajuste leve no subtítulo para amarrar a analogia (opcional, só se ficar melhor).
- Não reescreve o título, as pílulas, as cores nem reordena o deck.
- Não cria slide novo: transforma o existente.
- Como é uma animação nova, reinicie o marcador para
<!-- @MIRA:SIZE 3/10 --> naquele palco.
Método para criar a metáfora
- Destile o conceito a uma dinâmica. Pergunte: o que muda, qual a relação, qual a tensão, qual o movimento central? Escreva em uma frase. Ex.: débito técnico = custo que cresce sozinho com o tempo se você não paga.
- Ache um sistema do cotidiano com a MESMA dinâmica. Concreto, físico, familiar. Ex.: juros compostos, bola de neve descendo a ladeira, goteira que vira inundação.
- Mapeie 1 para 1. Liste cada parte do conceito e o seu correspondente visual na metáfora. Se sobrar parte do conceito sem correspondente, ou correspondente sem parte, a metáfora está fraca ou misturada. Troque.
- Garanta o loop. A metáfora precisa de um movimento perpétuo óbvio. Descreva o loop em uma frase ANTES de codar ("a torre de juros ganha um anel novo a cada batida e fica mais alta"). Se não der para descrever o loop, a metáfora não serve.
- Teste a obviedade. A metáfora tem que ser entendida sem legenda. Se precisar explicar, está fraca.
- Anime seguindo o mira-animator.
Exemplos de mapeamento (conceito → metáfora → loop)
- Orquestração de agentes → maestro e naipes da orquestra. Loop: a batuta marca o tempo no centro e as seções pulsam em uníssono a cada compasso.
- Débito técnico → torre de juros. Loop: a cada ciclo a torre ganha um bloco sozinha e inclina mais, até alguém "pagar" e ela baixar, e recomeça.
- Pipeline de dados → esteira de linha de montagem. Loop: uma peça crua entra numa ponta, passa pelas estações e sai montada na outra, repetindo.
- Janela de contexto do LLM → mesa de trabalho lotada. Loop: um papel novo entra de um lado e empurra o mais antigo para fora do outro, sem parar.
- Cache → despensa ao lado vs mercado longe. Loop: idas curtas e rápidas à despensa, e de vez em quando uma viagem longa ao mercado.
Workflow de Execução
- Resolver o escopo.
- Slide específico (número do card, título ou id do stage) → só aquele.
- Sem slide indicado → todos os slides animados do deck.
- Se o usuário passar o conceito direto no comando, use esse texto como fonte; senão, leia o conceito do próprio slide.
- Entender o conceito de cada slide alvo: título, subtítulo, texto, pílulas e a intenção da animação atual. Se útil para entender a fundo, consulte as referências do tema em
slides/<tema>/references/.
- Gerar a metáfora pelo método acima. Em uma frase, fixe: conceito, metáfora, loop.
- Substituir a animação no lugar. Localize o palco do slide (
#st-XXXX / #sv-XXXX) e a função de animação dele no <script>. Reescreva essa função para desenhar a metáfora, mantendo o mesmo id do stage, o registro no trigger e o Replay. Mantenha título, subtítulo e pílulas.
- Aplicar o padrão mira-animator: entrada coreografada, loop interno perpétuo, anti-vazamento (
window.__slugGen), viewBox 1280 720, reset do marcador para @MIRA:SIZE 3/10.
- Reportar slide a slide:
conceito → metáfora (loop em uma frase).
Anti-padrões (NÃO FAÇA)
- ❌ Metáfora clichê que não acrescenta entendimento (ex.: "engrenagens girando" para qualquer coisa).
- ❌ Metáfora que precisa de legenda para ser entendida.
- ❌ Misturar duas metáforas no mesmo slide.
- ❌ Animação literal do conceito (um diagrama do próprio conceito não é metáfora).
- ❌ Metáfora sem loop interno.
- ❌ Reescrever o título ou trocar as cores do tema.
Checklist
