# Mira New

> Porta de entrada para um novo deck do Mira: coleta requisitos conversacionalmente e monta a pasta em decks/ pronta para o pipeline. NÃO gera slides, só prepara o terreno. Use SEMPRE que o usuário disser /mira-new, novo deck, nova apresentação, criar deck, começar slides sobre, quero fazer slides de, novo tema de slides, iniciar uma apresentação, cria uma pasta de slides, ou pedir para começar uma apresentação do zero sobre algum assunto.

- Skill: `sandeco/mira-new` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sandeco/mira-new`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sandeco/mira-new/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: sandeco (https://skillmd.com/u/sandeco)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sandeco/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 a estrutura de `decks/<tema>/` (com `references/`) **na primeira ação**, para o usuário já ter onde soltar o material-fonte; depois monta o deck a partir de um template, aplica o tema base, opcionalmente sobrescreve a cor principal 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/<deck_id>/`**. 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: Criar a estrutura — primeira ação obrigatória

Esta é uma ordem operacional: **a primeira ação da skill é criar a pasta do deck e toda a árvore interna, de uma vez**. Antes disso, não faça pergunta, mensagem intermediária, leitura de referência, escolha de template, planejamento ou geração. `references/`, `assets/`, `assets/vendor/` e `mira/` não podem ser adiadas para outro passo.

Derive o slug diretamente do pedido em kebab-case, minúsculo e sem acento. Se o usuário chamou apenas `/mira-new`, use `novo-deck`; em colisão com deck já construído, use `novo-deck-2`, `novo-deck-3` etc. Defina **`deck_id = YYYY-MM-DD <slug>`**, usando a data local atual e exatamente um espaço. Exemplo: `2026-07-31 spec-driven-development`. Não pergunte o nome antes de criar. O nome pode ser refinado depois, mas a pasta precisa existir primeiro.

Crie imediatamente:

```
decks/<deck_id>/
decks/<deck_id>/references/
decks/<deck_id>/assets/
decks/<deck_id>/assets/vendor/
decks/<deck_id>/mira/
```

Isso não é detalhe de ordem, é o ponto da skill. Sem a pasta no disco, o usuário não tem onde soltar o PDF, o print ou o documento que ele já tem na mão, e a conversa trava. A pasta primeiro, as escolhas depois.

**Se `decks/<deck_id>/index.html` já existir**, aí sim é um deck montado de verdade: avise e pergunte se é para usar outro nome. **Se só a pasta existir, sem `index.html`**, é esqueleto de uma sessão anterior: **retome dentro dele**, liste o que já tem em `references/` e siga. Nunca peça outro nome nesse caso.

Com as pastas criadas, **pare** e ofereça os dois caminhos, sempre com o **caminho absoluto** da pasta de referências (caminho relativo não ajuda quem vai arrastar arquivo no explorador):

> "Criei a estrutura em `<caminho absoluto de decks/<deck_id>>`. A pasta de referências está pronta:
> `<caminho absoluto de decks/<deck_id>/references>`
>
> Como você prefere começar?
> **1.** Me contar aqui no chat do que trata a apresentação, e eu já registro.
> **2.** Colocar os arquivos (PDF, doc, prints, links) nessa pasta e me avisar quando terminar."

Trate a resposta assim, e nos dois casos o material **tem que acabar dentro de `references/`**:

- **Escolheu 1 (texto no chat):** ouça a descrição e salve **na hora** como `decks/<deck_id>/references/_tema.md`. Não deixe para depois.
- **Escolheu 2 (vai soltar arquivos):** espere o aviso. Quando ele disser que terminou, **liste o que você encontrou** em `references/` antes de continuar. Se estiver vazia, diga isso e pergunte se ele quer descrever por texto no lugar.
- **Os dois:** vale, salve o `_tema.md` e liste os arquivos.

Só depois de ter referência ou descrição registrada siga para o Passo 2.

### Passo 2: Coletar o resto dos 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. **Template do deck** (esqueleto). Liste **dinamicamente** varrendo `mira-templates/decks/` (cada subpasta com `index.html` é um template), incluindo os do `/mira-image-template`, que aparecem lá automaticamente.

   **`mira-default` vem SEMPRE em primeiro na lista, com o rótulo `(recomendado)` ao lado.** Os demais seguem em ordem alfabética. Mostre todos e deixe o usuário escolher: recomendado não é obrigatório. Se ele não escolher nenhum, use o `mira-default` sem perguntar de novo.

   ```text
   1. mira-default (recomendado) — título em cima, animação ocupando o slide inteiro
   2. aula-capitulo — aula ou palestra a partir de um capítulo
   3. demo-tecnica — demo técnica / walkthrough
   4. pitch-projeto — pitch de projeto
   5. sandeco-just-animation-template — palco preto, só animação, sem texto
   ```
2. **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.
3. **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 5. Confirme a cor.
4. **Descrição do tema**, só se ele escolheu o caminho 2 no Passo 1 e ainda não descreveu nada. Uma ou duas frases: do que trata, para quem, qual o objetivo. Salve como `references/_tema.md`. Se o `_tema.md` já existe, pule.

### Passo 3: Montar o deck

Para os **templates built-in** (`mira-default`, `aula-capitulo`, `pitch-projeto`, `demo-tecnica`, `sandeco-just-animation-template`) 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:

```bash
npx mira-animator new "<deck_id>" --deck=<template> --theme=<tema-base>
```

A pasta já existe desde o Passo 1, e isso não é problema: o CLI só recusa quando encontra um `index.html` montado, então ele escreve dentro do esqueleto e **preserva o que estiver em `references/`**.

Isso cria `decks/<deck_id>/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/<deck_id>/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`.

> **`mira-default` é o padrão.** Se o usuário não escolher template, é este: **um título em cima e a animação ocupando todo o resto do quadro 16:9**, sem card, sem pílulas, sem moldura. Quadro 16:9 fixo com faixa cinza nas sobras, navegação por seta, modos E e P. Ao contrário do animation-pure, ele **aceita `--theme` normalmente**. Não tem câmera nem terços: quem vai gravar com webcam usa `/mira-studio-full` (16:9) ou `/mira-studio` (9:16). O preenchimento segue a seção "Variante: mira-default" do `mira-animator`.
>
> Use `aula-capitulo` quando o deck for **denso de conteúdo** (tabela, código, timeline, comparativo): lá o slide é um card com texto ao redor da animação, que é outro trabalho.

> **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/<deck_id>/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/<deck_id>"`** 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/<deck_id>"`; sem npx, copie `mira-edit.js`, `mira-edit-free.js` e `mira-draw.js` de `mira-templates/authoring/` para `decks/<deck_id>/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 4.5: Lembranças do usuário (memória de preferências)

Com o deck montado e antes de preencher qualquer slide, consulte o que este usuário já corrigiu em decks anteriores:

```bash
npx mira-animator memoria consolidar
npx mira-animator memoria lembrancas --papel capa --formato 16x9
npx mira-animator memoria lembrancas --papel conteudo --formato 16x9
```

Uma consulta por papel de slide (nota de escopo só aparece quando o papel dela é informado). Ajuste `--formato` ao deck.

- Lembrança ativa é **orientação**, não ordem: aplique onde o slide se encaixa no escopo dela.
- A marca manda acima da memória: `#FF904D`, `text-wrap: balance` na capa e área segura continuam inegociáveis.
- Nota **candidata** não é aplicada. Se aparecer alguma, avise em uma linha e siga.
- Se o comando falhar por qualquer motivo, **gere normalmente e siga**. Memória nunca trava a criação.

### Passo 5: 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/<deck_id>/index.html`. A partir do hex `#RRGGBB` (componentes R, G, B em decimal), substitua **somente** estas variáveis derivadas da primária:

| Variável | Novo valor |
|---|---|
| `--mira-primary` | `#RRGGBB` |
| `--mira-glow-soft` | `rgba(R, G, B, 0.15)` |
| `--mira-glow-strong` | `rgba(R, G, B, 0.25)` |
| `--mira-icon-bg` | `rgba(R, G, B, 0.15)` |
| `--mira-icon-border` | `rgba(R, G, B, 0.30)` |
| `--mira-stage-glow` | `rgba(R, G, B, 0.06)` |
| `--mira-accent-2` | tom mais claro 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 6: Fechar a intake de referências

A pasta `decks/<deck_id>/references/` existe desde o Passo 1 e já pode ter material. Aqui você só absorve o que chegou depois. 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/<deck_id>/references/`.
- **Texto colado:** salve como `.md` em `references/`.
- **Link:** registre em `decks/<deck_id>/references/fontes.md`.
- **Descrição do tema:** salve como `decks/<deck_id>/references/_tema.md` (semente do briefing que o `/mira-extract` vai ler), se ainda não foi salva no Passo 1.

Se ainda não há material, tudo bem: repita o **caminho absoluto** da pasta e diga que ele pode soltar arquivos lá a qualquer momento. Para coletas maiores ou posteriores, acione o `/mira-references`.

### Passo 7: Resumo e próximo passo

Mostre um resumo curto:

```
Deck criado: decks/<deck_id>/
Template: <template> | Tema: <tema-base> | Cor principal: <hex>
Referências: <n> arquivo(s) em decks/<deck_id>/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 estrutura de pastas é literalmente a primeira ação.** Derive o slug do pedido (ou use `novo-deck`) e crie `decks/<deck_id>/` com `references/`, `assets/vendor/` e `mira/` antes de qualquer pergunta, leitura, escolha ou planejamento.
- **Há duas paradas obrigatórias.** A primeira logo depois de criar as pastas, para o usuário escolher entre descrever por texto ou soltar arquivos em `references/`, sempre com o **caminho absoluto** à mostra. A segunda no fim, antes do pipeline.
- **Pasta existente sem `index.html` é esqueleto, não conflito.** Retome dentro dela e liste o que há em `references/`. Só peça outro nome quando existir `decks/<deck_id>/index.html`.
- A skill **para no setup**. Só siga para o pipeline após o usuário confirmar.
- Escreva apenas dentro de `decks/<deck_id>/` (mais o registro em `mira.config.json`). Nunca edite o original de uma referência.
- O tema base deve ser um dos temas válidos (built-in ou derivado de imagem via `/mira-image-template`); 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.