Mira Storyboard

MIRA Storyboard

O quadro existe para o autor poder discordar barato.

Fluxo alternativo, acionado só quando o autor pede. Não faz parte do caminho normal de um deck: existe para quando a ideia não está clara. O que sai daqui é insumo, referência para quem desenhar depois ou material para melhorar um deck que saiu confuso. Não é contrato e não obriga nada a jusante.

Por que esta skill existe

Hoje o custo do erro é a animação pronta. É muito melhor ele rejeitar um esboço de caixas e setas do que rejeitar um deck implementado.

Mas gerar cedo não basta, e isso já foi medido. Num deck real havia um storyboard de 16 quadros em disco uma hora e meia antes de a cadeia rodar, e ele foi citado zero vezes na única peça que chega em quem anima. Por isso o storyboard aprovado vira storyboard/approved/, e o npx mira-animator storyboard verify <deck> confere se ele atravessou.

O Production Storyboard não nasce aqui: ele já existe, repartido entre /mira-direct-slide-sequence, /mira-direct-scene e /mira-direct-cinematic-motion. Você entrega a etapa que faltava, o Concept Storyboard, e estabelece a fronteira: Production só nasce com Concept aprovado.

Regra que não se afrouxa: você não desenha SVG à mão

Você escreve o que a cena significa, em JSON. Quem desenha é o renderizador.

Agente que escreve SVG em prosa livre entrega boneco de trapézio com cabeça de círculo, defeito que o /mira-asset-scout já documenta. Pior: a qualidade oscila de quadro para quadro, e o autor passa a julgar o traço em vez da ideia.

npx mira-animator storyboard render <deck>/storyboard

Isso lê todo .json, escreve .svg e .png ao lado de cada um, e regera a folha de contato storyboard/index.html.

Na folha, cada opção é um bloco separado, empilhado, com um "OU" entre elas, e ao lado de cada quadro vai um texto curto: o número, a intenção da cena em uma linha e a rastreabilidade em nota miúda. As opções já foram lado a lado em colunas, e ler na horizontal fundia as duas histórias numa só.

A cena semântica

{
  "slide": 3,
  "concept_reference": { "transformation": "progressive-loss-of-original-information" },
  "visual_intent": "mostrar que a distância para a fonte original está aumentando",
  "composition": {
    "left":   { "object": "photo", "label": "cópia 2", "state": { "degraded": 0.5 } },
    "center": { "object": "copier", "label": "o modelo" },
    "right":  { "object": "photo", "label": "cópia 3", "state": { "degraded": 0.7 } }
  },
  "actions": [
    { "arrow": { "from": "left", "to": "center" } },
    { "arrow": { "from": "center", "to": "right" } }
  ],
  "annotation": ["A cópia anterior agora alimenta a próxima geração."]
}

O que precisa estar certo, e por quê:

• concept_reference e visual_intent são obrigatórios. Quadro sem os dois não é gerado. São eles que dizem a quem desenha por que aquele elemento existe.
• As setas apontam para a POSIÇÃO (left, center), não para o nome do objeto. Nome de objeto só vale quando aparece uma vez na cena. Duas fotos e uma seta from: photo é recusada, porque apontaria para a errada em silêncio.
• Posições disponíveis: left, center, right, top, bottom, top-left, top-right, bottom-left, bottom-right. Nunca coordenada: a geometria é do renderizador, e a grade colapsa para as faixas ocupadas, então cena de 2 objetos preenche o quadro em vez de encostar num canto.
• A progressão é state, não objeto novo. { "degraded": 0.7 } faz a mesma primitiva desenhar o estágio. Assim o que muda entre quadros é um valor, e a diferença vira informação.
• Primitivas disponíveis: person, photo, copier, box, circle. Objeto sem primitiva vira caixa tracejada com o nome dentro, e o relatório lista os faltantes. Isso é resposta correta: melhor dizer "não sei desenhar isto" do que desenhar mal.

O fluxo

1. Leia storyboard/understanding.md. Ausente, avise que o alinhamento não foi feito e ofereça: rodar /mira-concept-align antes, ou seguir com o que o autor descrever agora. Não bloqueie, mas registre no índice que nasceu sem alinhamento.

2. As metáforas candidatas do understanding.md viram as opções concorrentes.

3. Havendo ambiguidade criativa, gere 2 a 3 opções, nunca escolha uma em silêncio. Cada uma numa pasta: storyboard/concept-v01/option-<letra>-<slug>/. Sem ambiguidade (o autor já decidiu), gere uma só e diga por que não abriu concorrência.

4. Escreva um option.json na pasta de cada opção. É ele que dá o cabeçalho da opção na folha de contato, e é onde o RF-04 vira arquivo em vez de promessa:

   {
     "titulo": "Xerox da Xerox",
     "metafora": "uma copiadora que passa a copiar a própria cópia",
     "representa": "a perda como degradação física e acumulada do sinal",
     "distorce": "sugere um aparelho único e um operador consciente"
   }

   O campo distorce é o que faz a opção ser escolhível. Sem ele o autor compara desenhos; com ele compara trocas. Opção sem custo declarado é opção mal descrita.

5. 3 a 8 quadros por opção. Menos de 3 não mostra progressão; mais de 8 é produção disfarçada de esboço. O Concept Storyboard representa o conceito, não o deck: ele não precisa de um quadro por slide.

6. Rode o render.

7. Entregue o caminho absoluto da folha de contato e pare. Quem olha é o autor.