# Mira Cinema Deck

> Orquestrar o deck cinematográfico de ponta a ponta: a cadeia narrativa do Story Team decide a história, o deck nasce com o modo cinema instalado e o mira-animator implementa a partitura com câmera, profundidade e grade de cor. Usar quando o usuário pedir deck cinematográfico, deck com história, deck com câmera, usar o Story Team, ou a sequência inteira da premissa até o HTML animado. Não usar para slide avulso, que é do mira-animator, nem para deck rápido, que é do mira-fast e não tem cinema.

- Skill: `sandeco/mira-cinema-deck` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sandeco/mira-cinema-deck`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sandeco/mira-cinema-deck/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: sandeco (https://skillmd.com/u/sandeco)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/sandeco/mira-cinema-deck

---


# MIRA Cinema Deck

Um tema entra; sai um deck com história, encenação e câmera. Esta skill **não escreve HTML nem
inventa metáfora**: ela conduz a ordem, instala o que precisa existir e passa o bastão. Quem
escreve a animação é o **`/mira-cine-animator`**, o irmão cinematográfico que herda o método
inteiro do `/mira-animator` por referência. Num deck que existe para ser cinema, rotear para o
irmão comum entrega um deck comum, e foi exatamente o defeito do deck de 2026-08-07.

## Por que ela existe

A cadeia narrativa e o modo cinema já existiam separados, e não se encontravam sozinhos:

- o `/mira-direct-cinematic-motion` escreve partitura de câmera, mas se o deck não tiver o
  `mira-cinema.js` ele é obrigado a produzir direção **sem** câmera, grade nem planos;
- o `mira-cinema.js` é opt-in e não entra em deck nenhum por padrão;
- sem alguém instalar o módulo **antes** da direção, a cadeia inteira degrada em silêncio e o
  usuário recebe um deck comum achando que pediu cinema.

Esta skill é o que fecha esse laço, e a ordem abaixo é o motivo dela.

## Pré-condições, checadas antes de qualquer coisa

1. **Story Team instalado.** Confira se `/mira-premise-forge` existe. O Story Team é obrigatório e
   chega em toda instalação; se mesmo assim não existir, pare e diga:
   > "O Story Team não está instalado. Rode `npx mira-animator update` para trazê-lo."

   Não emule os agentes narrativos dentro desta skill. Um orquestrador que finge ser a cadeia
   entrega texto sem o método dela.
2. **Fonte ou tema.** Sem material nenhum, pergunte de onde vem a história antes de começar.

## A ordem, e por que é essa

> **Alinhamento conceitual não entra aqui.** O `/mira-concept-align` e o `/mira-storyboard` são
> **fluxo alternativo, acionado só quando o autor pede**, para quando a ideia não está clara. Você
> não oferece, não sugere e não roda. Se o deck já tiver `storyboard/concept-brief.md`, os agentes da
> cadeia leem como referência, do mesmo jeito que leem `references/`.

### Fase 0, o deck nasce com cinema

**ANTES da direção, não depois.** É a única ordem que funciona:

```bash
npx mira-animator new <slug> --cinema
```

Isso instala quatro coisas, e as quatro são necessárias:

| Arquivo | Para quê |
|---|---|
| `mira/mira-cinema.js` + `assets/vendor/gsap.min.js` | a câmera, os planos, a grade e o ritmo |
| `mira/mira-foco.js` | o modo câmera da **tecla C**, onde o autor ajusta os cues na tela |
| `servidor.bat` na raiz do deck | `http://localhost`, sem o qual o `Ctrl+S` do modo câmera não grava direto no arquivo |

As tags entram na ordem certa (GSAP, depois o cinema, depois o foco, e os três antes dos módulos de
autoria). A instalação é do CLI, e não sua: copiar biblioteca e injetar tag é passo determinístico, e
é onde um agente falha em silêncio.

Confira que `decks/<slug>/mira/mira-cinema.js`, `decks/<slug>/mira/mira-foco.js` e
`decks/<slug>/servidor.bat` existem antes de seguir. Faltando o primeiro, pare: toda a direção de
câmera das fases seguintes seria descartada. Faltando os outros dois, o deck sai certo e o autor não
consegue ajustar nada nele, que foi o que já aconteceu: a tecla C não fazia nada porque o
`mira-foco.js` não era instalado por ninguém. Se faltar, rode `npx mira-animator update`.

Coloque o material-fonte em `decks/<slug>/references/` agora.

**Se o autor pediu "só prepare", pare aqui, e pare dizendo como voltar.** Encerre com a frase
literal:

> Deck preparado em `<caminho absoluto>`. Coloque o material em `references/` e volte com
> **`/mira-cinema-deck continuar`**. Sem esse comando a cadeia narrativa não roda, e o deck sai
> sem encenação nem partitura.

É a falha que já aconteceu: o autor preparou o deck, colocou o material e retomou com um comando
genérico de execução. A fase 1 inteira foi pulada em silêncio, o `/mira-animator` recebeu o
storyboard cru no lugar de um briefing por cena, e o deck saiu com desenho feito à mão sem
encenação. **Qualquer retomada tem que voltar por esta skill.** Ao receber `continuar`, leia o que
já existe em `references/`, diga em que etapa está entrando e por quê, e siga da fase 1.

### Fase 1, a história (Story Team)

Na ordem, um de cada vez, com o resultado de cada um alimentando o seguinte:

| # | Agente | Entrega |
|---|---|---|
| 1 | `/mira-premise-forge` | Premise Brief |
| 2 | `/mira-concept-storyteller` | Concept Contract |
| 3 | `/mira-story-architect` | Story Bible |
| 4 | `/mira-design-audience-journey` | Audience Journey Map |
| 5 | `/mira-direct-slide-sequence` | MIRA Slide Score, uma cena por slide |
| 6 | `/mira-direct-scene` | encenação: composição, planos com oclusão, enquadramento, grade do deck |
| 7 | `/mira-direct-cinematic-motion` | MIRA Motion Score: temperamento, beats, câmera, easing, loop |
| 7b | `/mira-scene-brief` | destila tudo em um briefing autossuficiente por slide, com a âncora que liga um ao outro e o campo **Cinema**, que carrega a câmera, os planos e a atmosfera daquele slide |
| 7c | `/mira-asset-scout` | decide a origem de cada ator: desenhar, buscar SVG de fonte aberta ou pedir ao autor |

**Dá para entrar no meio.** Se a premissa já existe, comece na 2; se a Story Bible está de pé, use
as três últimas. Diga ao usuário em qual etapa você entrou e por quê.

**Pare entre as etapas** e mostre a entrega. É deck que precisa convencer: vetar uma premissa custa
uma mensagem, vetar um deck pronto custa a geração inteira.

Grave cada entrega em `decks/<slug>/references/`, senão a etapa seguinte reconstrói de memória.

### Fase 2, o deck

| # | Agente | Papel |
|---|---|---|
| 8 | `/mira-builder` | monta o HTML a partir do Slide Score |
| 9 | `/mira-cine-animator` | **implementa** a partitura: metáfora, câmera, planos e grade, com a nota avaliada com o cinema ligado |
| 10 | `/mira-validator` | relatório de conformidade |

**O passo 8 monta DENTRO do deck que a fase 0 criou**, nunca num arquivo novo: o `index.html` de lá
já carrega as tags do GSAP, do `mira-cinema.js`, do `mira-foco.js` e dos módulos de autoria, na
ordem certa. Remover ou reordenar essas tags ao montar os slides desfaz a fase 0 em silêncio, e o
sintoma só aparece no passo 9, quando a câmera não tem motor. Depois do builder, confira que as tags
continuam lá.

Entre a fase 1 e o passo 9 entra o **`/mira-scene-brief`**, e ele muda o que o passo 9 recebe.

A cadeia produz cerca de 28 mil palavras antes de existir imagem. Quem desenhava o slide chegava
lendo 13 mil palavras acumuladas, e o resultado medido não era um slide melhor, era um slide
genérico: ninguém decide bem com 13 mil palavras na frente. O `/mira-scene-brief` destila tudo em um
briefing autossuficiente por slide, cerca de 180 palavras.

**A cadeia continua inteira. Ela só para de ser lida.**

Consequência para este orquestrador, e é a regra que mais muda:

- **entregue ao `/mira-cine-animator` um briefing por vez**, o daquele slide, e nada mais. Nem o Motion
  Score, nem o Slide Score, nem os briefings dos vizinhos. A única coisa que viaja junto é a tabela
  de origem do `/mira-asset-scout` daquele slide, que cabe em três linhas e evita que ele desenhe à
  mão o que não sabe desenhar;
- **confira que cada briefing tem o campo Cinema preenchido** (cues com alvo, beat, duração e razão,
  planos com oclusão). É por ele, e só por ele, que a câmera do Motion Score chega no implementador:
  briefing de deck cinematográfico sem esse campo volta para o `/mira-scene-brief` antes de qualquer
  código;
- se um slide sair errado, o defeito está **no briefing**, não no implementador. Corrija o briefing e
  gere de novo, em vez de mandar mais contexto junto. Mandar mais contexto desfaz o método.

O `/mira-cine-animator` já conhece a API (`MiraCinema.palco`, `Cam.*`, `Prof.*`, `Grade.*`) e os
tetos, herdados do método do `/mira-animator`, e não precisa da cadeia para isso.

**Exceção:** deck de um slide só não tem âncora entre cenas, e aí a destilação não paga o passo.
Nesse caso o Motion Score vai direto para o passo 9.

## Depois de pronto: a câmera se ajusta na tela, não no código

O deck sai com a câmera que o Motion Score pediu, e ela quase nunca fica certa de primeira, porque
enquadramento é decisão de olho. O ajuste fino é do autor, no navegador, com a **tecla C**, o modo
câmera do `mira/mira-foco.js` (a **tecla A** é outra coisa, a barra de ritmo do `mira-cinema.js`):

- quatro pistas, uma por efeito (zoom, travelling, tremor, tensão), para efeitos **sobrepostos** no
  tempo, que é o normal e não a exceção;
- a agulha da régua percorre a cena quadro a quadro, para achar o instante exato de um cue;
- intensidade e duração dos abalos em slider, com prévia ao vivo;
- uma quinta pista, a dos **pontos de execução**: onde a cena para enquanto você apresenta;
- `Ctrl+S` grava tudo como comentários `@MIRA:FOCO`, `@MIRA:CICLO`, `@MIRA:LOOP`, `@MIRA:VOLTA` e
  `@MIRA:PASSOS` dentro da `<section>`, no arquivo. Sobrevive ao F5 e ao próximo agente que abrir
  o deck.

**Ponto de execução não é cue de câmera, e por isso é lista à parte.** `@MIRA:PASSOS 1.85 7.37 9.80`
(segundos, ordem crescente) diz onde a cena **espera por você**. Não existe botão de ligar: a lista
é a declaração. Sem ponto nenhum a cena roda solta como qualquer slide; com pontos ela corre e para
no primeiro, e cada seta a leva até o próximo. Depois do último, a seta **leva a cena até o fim** (a
Regra Zero vale aqui: cena não congela), e só a próxima troca de slide. A seta para cima volta um
ponto, cancela um avanço em curso e recaptura a cena solta no último ponto. Cria-se pelo ícone da
última pista, no ponto da agulha, arrasta para mover e duplo clique remove.

**E é por isso que deck cinematográfico se edita pelo `servidor.bat`, não por `file://`.** Em
`http://localhost` o `Ctrl+S` lê e reescreve o `index.html` direto, sem diálogo. Em `file://` ele
depende do seletor de arquivo do Chrome, pede permissão a cada sessão e falha em qualquer outro
navegador. O `npx mira-animator new <slug> --cinema` já deixa o `servidor.bat` na raiz do deck:
**mande o autor abrir por ele**, e diga isso na entrega. O deck continua abrindo por `file://` para
apresentar, o servidor é para autorar.

Não reescreva no código cue que o autor ajustou na tela. Os marcadores são a fonte da verdade da
câmera **desde o nascimento**: o implementador escreve a direção de câmera como `@MIRA:FOCO` dentro
da `<section>`, nunca como `Cam.*` inline na timeline (contrato no `/mira-animator`, seção do modo
cinema). Cue inline é invisível para a tecla C, e um deck com câmera que o autor não consegue
ajustar é um deck com câmera errada para sempre. O código do slide conta a história, os marcadores
enquadram.

## Regras que valem sobre tudo

- **A grade de cor é do DECK, uma só.** Quem decide é o `/mira-direct-scene`, na fase 1, e todos os
  slides herdam. Grade escolhida slide a slide vira ruído, e é assim que um deck vira dez filmes.
- **Temperamento `sereno` é o padrão.** `tenso` só quando a cena pede tensão. Pedido implícito não
  conta.
- **A nota de corte (85, sem veto) é avaliada com o cinema LIGADO**, porque quem implementa aqui é
  o `/mira-cine-animator` e essa é a inversão que o define. O teste que continua valendo: tirando o
  cinema, sobrar **menos história** é legítimo; sobrar **história nenhuma** reprova nos dois irmãos,
  porque aí não havia cena, havia efeito.
- **Nenhum agente da fase 1 escreve HTML.** Se algum entregar código, descarte e peça direção.
- **`file://`, offline e ausência de build são premissa.** O deck tem que abrir com duplo clique.

## Quando NÃO usar esta skill

| Caso | Use |
|---|---|
| Um slide avulso | `/mira-animator` |
| Deck rápido, sem história | `/mira-fast` ou `/mira-ultrafast`, que não têm cinema de propósito |
| Deck de gravação com teleprompter | `/mira-studio` ou `/mira-studio-full` |
| Trocar a animação de um slide existente | `/mira-animator` no modo substituir |

## Entrega

Ao terminar, diga:

1. o caminho do deck e quantos slides tem;
2. a grade escolhida e o temperamento dominante;
3. quantos cues de câmera entraram, e em quais slides;
4. o que o usuário deve **olhar** para aprovar: a história aparece com o título escondido? o corte
   do loop aparece? o Replay deixa dois atores rodando? a câmera tem razão narrativa em cada cue?
5. o que ficou de fora, se ficou.

A conferência no navegador é do usuário. Não afirme que assistiu à animação.