mira-fast

Cria um deck Mira completo em uma chamada, com uma folha por slide executada em paralelo por um workflow do Claude Code. Use quando o usuário pedir /mira-fast, deck rápido, modo turbo, deck inteiro de

SKILL.md

GitHub

Mira Fast

Um tema entra; um deck Mira completo sai. A qualidade deve ser equivalente à cadeia normal, sem gates humanos intermediários. O workflow decide e paraleliza; o script Node monta.

Motor obrigatório

ORDEM ABSOLUTA: a primeira ação do /mira-fast é criar, de uma vez, a pasta do deck e toda a árvore interna. Antes de mensagem intermediária, validação de fonte, leitura, memória, planejamento, pergunta ou workflow, resolva deck_id = YYYY-MM-DD <slug> e crie decks/<deck_id>/, references/, assets/, assets/vendor/, mira/ e mira/fast/. Nenhuma pasta fica para depois.

No Claude Code 2.1.154 ou superior, esta skill é a interface. O motor é o workflow de projeto .claude/workflows/mira-fast-engine.js; Dynamic workflows deve estar habilitado em /config.

  1. Ao receber /mira-fast ..., execute a Fase 0 na sessão principal (resolver o slug e criar a estrutura do deck) e em seguida invoque mira-fast-engine pela ferramenta Workflow, passando os argumentos originais mais o slug e o deck_dir já resolvidos. O plano tem que usar esse slug, senão a Fase 1 abre uma segunda pasta e deixa órfão o material colocado em references/.
  2. Não emule o workflow dentro da conversa.
  3. Se o workflow ou a ferramenta Workflow não estiver disponível, encerre com MIRA_FAST_PARALLELISM_UNAVAILABLE e indique npx mira-animator update.
  4. Nunca degrade para geração sequencial.

O workflow faz fan-out com pipeline(plan.slides, ...): uma folha por slide, até o limite de concorrência do Claude Code. Acima do limite, o runtime enfileira o excedente automaticamente.

A skill não faz perguntas sobre conteúdo, formato, tema ou continuidade. A Fase 0 não abre exceção: ela cria pastas e informa um caminho, sem perguntar nada nem esperar resposta. Fonte apontada e ausente falha, não vira pergunta. Uma solicitação de permissão exibida pelo Claude Code pertence ao ambiente e não pode ser contornada.

Invocação

/mira-fast <tema ou caminho>                 -> mira 16:9
/mira-fast /mira-studio <tema ou caminho>    -> Studio 9:16
/mira-fast /mira-studio-full <tema ou caminho> -> Studio Full 16:9
/mira-fast /mira-vertical <tema ou caminho>  -> vertical 9:16

Se o primeiro token começar por /mira- e não for um desses formatos, falhe sem criar o deck. Nunca infira o formato pelo tema.

Formato Saída Regras adicionais
mira index.html mira-default: título no topo e palco amplo, sem card
mira-studio index.html capa, camera, split, full; gera roteiro.md
mira-studio-full index-16x9.html camera, thirds, full; gera roteiro.md
mira-vertical index-9x16.html palco com eixo vertical dominante

Consulte a skill do formato apenas na Fase 1, para criar o esqueleto completo. O esqueleto nasce pelo caminho canônico npx mira-animator new <slug> --deck=<template> --theme=<tema>, nos quatro formatos: é ele que injeta o bloco @MIRA:THEME e, via ensureResponsive, o @MIRA:RESPONSIVE, os dois exigidos pelo validador da Fase 3. No formato mira o template é sempre mira-default; não pergunte por template. Cada folha lê somente contrato-base.md, o contrato do seu modo e o contrato do seu formato; a montagem Node não consulta skills.

Entrada existente no disco é fonte; pasta agrega os textos legíveis; tema descrito em linguagem natural é tema livre e segue direto.

Fonte apontada e não encontrada é falha, nunca tema livre. Se a invocação aponta um arquivo ou pasta (extensão, separador de caminho, ou frase do tipo "a partir de", "use o documento", "com base no livro") e esse caminho não existe no disco, encerre com MIRA_FAST_FONTE_NAO_ENCONTRADA, informe o caminho absoluto de decks/<deck_id>/references/ criado na Fase 0 e diga que basta colocar o material lá e chamar de novo. O mesmo vale para /mira-fast sem argumento nenhum. Caminho digitado errado não pode virar um deck inventado do começo ao fim.

O slug é kebab-case e o nome da pasta é sempre YYYY-MM-DD <slug>. Deck já construído é o que tem index*.html ou mira/fast/plano.json; nesse caso use -2, -3 etc. no slug, sem perguntar. Pasta que só tem o esqueleto da Fase 0, com ou sem arquivos em references/, não é colisão: é o deck desta execução, reaproveite. Bumpar para -2 ali abandonaria o material que o usuário acabou de colocar.

Invariantes

  • O plano contém N slides e o workflow dispara N folhas.
  • Cada folha escreve somente mira/fast/slide-NN.html e seu result-NN.json.
  • Toda folha tem modo_folha: estatica | animada.
  • Capa, card, CTA, encerramento e layout camera são estáticos.
  • Slides de metáfora são animados.
  • Plano, fragmentos e arquivo final têm escritores exclusivos.
  • A estrutura de pastas do deck tem um único escritor, a Fase 0.
  • A ordem final é slides[].n, nunca a ordem de término.
  • Cada folha valida o próprio fragmento e recebe no máximo duas tentativas sequenciais.
  • Nenhum fragmento inválido é omitido silenciosamente: a montagem falha e registra o motivo.

Estado no deck

decks/<deck_id>/
├── index*.html
├── roteiro.md                 # Studio e Studio Full
├── mira/
│   ├── mira-edit.js
│   ├── mira-edit-free.js
│   ├── mira-draw.js
│   └── fast/
│       ├── plano.json
│       ├── esqueleto.html
│       ├── slide-01.html
│       ├── result-01.json
│       ├── ...
│       └── montagem.log
├── assets/
└── references/
    ├── quadro-metaforas.md     # artefato do plano
    └── ...                     # material do usuário, preservado

As pastas references/, assets/ e mira/ existem desde a Fase 0. Nunca apague mira/fast/. Nunca apague nem sobrescreva material do usuário em references/: o único arquivo que o Mira escreve lá é o quadro-metaforas.md. Não coloque JS de apoio na raiz.

Fase 0: estrutura do deck

Resolvido o slug e antes de invocar o workflow, a sessão principal cria a estrutura no disco:

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

Depois informe em uma linha o caminho absoluto de decks/<deck_id>/references/ e que material colocado lá é lido pelo plano. Caminho relativo não serve: quem vai arrastar um PDF precisa do caminho que abre no explorador.

Isso não é uma parada. A Fase 0 não pergunta nada e o workflow começa em seguida, no mesmo turno. Ela existe porque a pasta precisa estar no disco desde o primeiro segundo: sem ela, quem tem o material na mão não tem onde colocar, e é justamente esse o caso em que o /mira-fast mais rende.

Só a Fase 0 cria essa estrutura. A Fase 1 a herda e nunca recria (invariante de escritor exclusivo). Nada dentro de references/ é apagado ou sobrescrito aqui.

Fase 1: plano

Um agente central resolve somente decisões globais:

  1. Consulta a memória de preferências e embute o resultado no plano, para que os agentes do fan-out recebam a mesma orientação (eles não consultam de novo, um por um):
npx mira-animator memoria consolidar
npx mira-animator memoria lembrancas --papel capa --formato <formato>
npx mira-animator memoria lembrancas --papel conteudo --formato <formato>

O texto que voltar entra em plano.json no campo lembrancas e é repassado no prompt de cada agente de slide. Lembrança é orientação, não ordem; a marca manda acima dela; nota candidata não é aplicada. Comando que falha não interrompe nada: siga sem memória.

  1. Lê a fonte e escolhe arco, quantidade, tipos e ordem.
  2. Define paleta, tom, títulos e layouts.
  3. Para cada slide animado, define frase causal, família, metáfora e seis eixos.
  4. Elimina colisões pelo ledger descrito em references/quadro-metaforas.md.
  5. Atribui slug_stage único a todos e js_id seguro somente aos animados.
  6. Cria mira/fast/esqueleto.html e os artefatos de referência, dentro da estrutura que a Fase 0 já deixou pronta. Não recria as pastas do deck e não toca no que houver em references/, além de gravar seus próprios artefatos. O esqueleto vem do caminho canônico npx mira-animator new <slug> --deck=<template> --theme=<tema>. Copiar o arquivo do template direto pula a injeção do @MIRA:RESPONSIVE e produz esqueleto que a Fase 3 reprova; a cópia manual é fallback de 01#R7, e nela os dois blocos ficam por sua conta. Para mira o template é mira-default: preserva o marcador MIRA-DEFAULT, o runtime e o CSS .slide-main/.slide-centro. Em todos os formatos, remove os slides de exemplo e abre os seis slots.
  7. Grava mira/fast/plano.json conforme references/plano-schema.md e references/quadro-metaforas.md.

O esqueleto preserva o runtime completo do formato, mas não contém nenhuma <section>. Ele inclui exatamente uma vez:

<!-- @MIRA:FAST:CSS:START -->
<!-- @MIRA:FAST:CSS:END -->
<!-- @MIRA:FAST:SLIDES:START -->
<!-- @MIRA:FAST:SLIDES:END -->
<!-- @MIRA:FAST:JS:START -->
<!-- @MIRA:FAST:JS:END -->

O slot CSS fica em <head>. Os slots de slides e JS ficam nessa ordem em <body>; o JS vem depois do builder do roteiro nos formatos Studio. O plano é retornado de forma estruturada ao workflow. Não gera slides.

Fase 2: fan-out

pipeline() recebe plan.slides. Cada item abre um agente independente com:

  • os campos globais do plano;
  • exatamente um objeto de slide;
  • references/contrato-base.md;
  • references/contrato-estatico.md ou references/contrato-animado.md;
  • references/formato-<formato>.md. A folha não lê plano completo, deck final, vizinhos ou outras folhas. Na segunda tentativa, pode ler somente seu próprio fragmento anterior. Folha animada aplica o método de metáfora e movimento. Folha estática implementa somente o layout determinado.

Depois de escrever, a folha roda o validador com --slide N e grava result-NN.json com tentativa e resultado. Resultado inválido ou erro de agente dispara uma segunda e última tentativa para o mesmo slide, nunca em paralelo com a primeira.

Fase 3: fan-in

Depois que o workflow devolver todas as folhas, a sessão principal executa, sem abrir outro agente:

node .claude/skills/mira-fast/scripts/assemble-run.mjs "<deck_dir>"

O script valida plano, fragmentos e esqueleto; extrai HTML/CSS/JS; ordena por slides[].n; gera somente os triggers animados; instala os módulos; gera roteiro.md nos formatos Studio; grava atomicamente o HTML final e sempre atualiza mira/fast/montagem.log.

Se falhar, não publique nem abra um deck parcial. Se passar, abra o HTML final. A sessão principal não reescreve a saída do script.

Os módulos abaixo são obrigatórios, nesta ordem:

<script defer src="mira/mira-edit.js"></script>
<script defer src="mira/mira-edit-free.js"></script>
<script defer src="mira/mira-draw.js"></script>

Studio também instala os módulos de câmera/gravação exigidos por sua skill. Studio Full instala mira-record-16x9.js.

A capa deve conter:

body > section:first-of-type h1,
body > section:first-of-type h2 { text-wrap: balance; }

A raiz do deck contém somente o HTML final, launchers aplicáveis, roteiro.md nos formatos de gravação e a pasta obrigatória references/. Bibliotecas e imagens ficam em assets/; JS de apoio em mira/.

Portões de saída

  • estrutura do deck criada na Fase 0, com o caminho absoluto de references/ informado;
  • material do usuário em references/ intacto;
  • workflow usado, não emulado;
  • N slides = N folhas válidas, considerando retries sequenciais por slide;
  • nenhum escritor compartilhado;
  • nenhum agente de montagem depois do pipeline();
  • validação determinística aprovada;
  • arquivo final na geometria correta;
  • modos E e P presentes;
  • capa balanceada;
  • raiz limpa;
  • deck aberto no navegador.