mira-new

Skill: Novo Deck (Mira)

Objetivo

Porta de entrada de uma nova apresentação. Numa conversa curta, colete o que o Mira precisa para montar a pasta do tema e deixe tudo pronto para o pipeline (/mira-extract → /mira-planner → /mira-builder → ...).

• FAZ: cria decks/<tema>/ a partir de um template, aplica o tema base, opcionalmente sobrescreve a cor principal, prepara decks/<tema>/references/ e registra o deck no mira.config.json.
• NÃO FAZ: não escreve conteúdo de slide, não extrai briefing, não anima. A skill para no setup e oferece o próximo passo.

Regra de ouro

Tudo o que esta skill cria ou edita vive dentro de decks/<tema>/. Nunca toque em arquivos fora de decks/, com a única exceção de registrar o deck no mira.config.json da raiz.

Fluxo de Execução

Passo 1: Coletar os requisitos (conversacional)

Pergunte de forma objetiva, com os defaults entre parênteses. Se o usuário já adiantou uma resposta, não pergunte de novo.

1. Nome do tema. Texto livre. Gere um slug em kebab-case, minúsculo, sem acento (ex.: "Spec Driven Development" → spec-driven-development). Confirme se houver ambiguidade.
2. Template do deck (esqueleto). Liste dinamicamente varrendo mira-templates/decks/ (cada subpasta com index.html é um template). Built-in: aula-capitulo (default), pitch-projeto, demo-tecnica, sandeco-just-animation-template e mira-perfect; templates do /mira-image-template aparecem aqui automaticamente. Mostre todos e deixe o usuário escolher.
3. Tema base (identidade visual). Liste dinamicamente varrendo mira-templates/themes/ (cada .css, exceto base.css, é um tema). Built-in: mira-dark (default, laranja), light-minimal, corporate-blue e neon-emerald; temas do /mira-image-template aparecem aqui também. Se o template escolhido tiver um tema de mesmo nome (templates derivados de imagem), use-o como padrão desse template, pois é a identidade que veio da imagem; o usuário ainda pode escolher outro.
4. Cor principal (opcional). Sem pedido, use a cor do tema base. Se pedir uma cor (hex #RRGGBB ou nome como "roxo"), converta para hex e trate como override no Passo 3. Confirme a cor.
5. Descrição do tema. Uma ou duas frases: do que trata, para quem, qual o objetivo. Vira a semente do briefing.
6. Referências. Pergunte se já tem material-fonte (PDF, livro, artigo, imagens, prints, links, código). Trate no Passo 4.

Se decks/<slug>/ já existir, avise e pergunte se é para usar outro nome.

Passo 2: Montar o deck

Para os templates built-in (aula-capitulo, pitch-projeto, demo-tecnica, sandeco-just-animation-template, mira-perfect) com um tema built-in, use o comando canônico do Mira, que copia o esqueleto, injeta o CSS do tema e registra no config:

npx mira-animator new <slug> --deck=<template> --theme=<tema-base>

Isso cria decks/<slug>/index.html com o tema base embutido (entre /* @MIRA:THEME:START */ e /* @MIRA:THEME:END */). O comando já deixa o deck offline por padrão: copia as libs vendoradas (Tailwind, AOS, Lucide, D3, fonte Inter, embarcadas na instalação) para decks/<slug>/assets/vendor/ e aponta o <head> para elas. O deck abre por file:// sem internet e passa em firewall corporativo. Nada é baixado.

Caso especial, sandeco-just-animation-template: deck de animação pura, multi-slide (cada <section> é uma animação de tela cheia, sem títulos nem texto sobreposto), multicor e theme-agnóstico. Por isso o new ignora o --theme e mantém o bloco @MIRA:THEME neutro do próprio template; a cor vive numa paleta livre (nenhuma predominante), não na cor única do tema. Não aplique override de cor aqui. O preenchimento segue a seção "Variante: sandeco-just-animation-template" do mira-animator.

Caso especial, mira-perfect: deck de animação de tela cheia com título e header sobrepostos (design do lançamento do MIRA: capa com título gigante em gradiente, scrim no topo dos slides de conteúdo, camada cinematográfica de brasas + vinheta). Também é theme-agnóstico: o new ignora o --theme e mantém o bloco @MIRA:THEME próprio do template. Diferente do animation-pure, ele tem uma cor de marca única (default laranja MIRA): para trocar, edite --mira-primary, --mira-primary-deep e --mira-accent-2 no bloco @MIRA:THEME; o CSS e a paleta do JS leem essas variáveis. O preenchimento segue a seção "Variante: mira-perfect" do mira-animator.

Para templates ou temas do /mira-image-template (e como fallback sem npx em qualquer caso): monte na mão a partir da cópia local. Copie mira-templates/decks/<template>/index.html para decks/<slug>/index.html, substitua o bloco entre os marcadores @MIRA:THEME pelo CSS de mira-templates/themes/<tema>.css seguido de mira-templates/themes/base.css, e adicione o deck em mira.config.json (decks[]). O CLI só conhece decks e temas built-in, então templates/temas derivados de imagem precisam desta montagem local. Depois, rode node mira-templates/vendor/apply-offline.mjs decks/<slug> para deixar esse deck offline (a montagem manual não passa pelo CLI, então não recebe o offline automático). Por fim, instale as ferramentas de autoria — a montagem manual não copia os módulos de edição/pintura. Rode npx mira-animator edit decks/<slug>; sem npx, copie mira-edit.js, mira-edit-free.js e mira-draw.js de mira-templates/authoring/ para decks/<slug>/mira/ e injete antes do </body> as três tags <script defer src="mira/..."> (com mira-edit-free.js depois de mira-edit.js).

Passo 3: Aplicar a cor principal custom (só se houver override)

Se o usuário escolheu cor diferente da do tema base, edite o :root dentro dos marcadores @MIRA:THEME de decks/<slug>/index.html. A partir do hex #RRGGBB (componentes R, G, B em decimal), substitua somente estas variáveis derivadas da primária:

Para --mira-accent-2, clareie a primária misturando ~35% de branco: para cada componente, novo = round(C + (255 - C) * 0.35), e escreva em hex.

Não altere as demais variáveis (--mira-bg, --mira-text, --mira-text-soft, --mira-card-bg, --mira-card-border, --mira-pill-*). Elas pertencem ao tema base e garantem o contraste. Assim o override de cor compõe com qualquer tema base.

Passo 4: Preparar as referências

A pasta de referências é decks/<slug>/references/. Garanta que exista. A intake segue as regras do /mira-references (copiar, nunca mover nem editar o original), aplicadas dentro de decks/:

• Caminho de arquivo/pasta: copie para decks/<slug>/references/.
• Texto colado: salve como .md em references/.
• Link: registre em decks/<slug>/references/fontes.md.
• Descrição do tema (Passo 1.5): salve como decks/<slug>/references/_tema.md (semente do briefing que o /mira-extract vai ler).

Se ainda não há material, tudo bem: diga que ele pode soltar arquivos em decks/<slug>/references/ a qualquer momento. Para coletas maiores ou posteriores, acione o /mira-references.

Passo 5: Resumo e próximo passo

Mostre um resumo curto:

Deck criado: decks/<slug>/
Template: <template> | Tema: <tema-base> | Cor principal: <hex>
Referências: <n> arquivo(s) em decks/<slug>/references/

Depois ofereça o próximo passo (não execute sem confirmar):

"Pronto. Quer que eu acione o /mira-extract agora para gerar o briefing a partir das referências?"

Regras Inegociáveis

• A skill para no setup. Só siga para o pipeline após o usuário confirmar.
• Escreva apenas dentro de decks/<slug>/ (mais o registro em mira.config.json). Nunca edite o original de uma referência.
• O tema base deve ser um dos quatro válidos; a cor custom é aplicada por cima dele, só nas variáveis derivadas da primária.
• Texto visível em português brasileiro com acentuação correta. Proibido travessão (—); use vírgula ou dois-pontos.