mira-concept-align

name	mira-concept-align
description	Clarear uma ideia ANTES de virar slide, metáfora ou animação: descobrir o que o autor quer comunicar, detectar ambiguidade com perguntas contextualizadas, devolver a interpretação para ele corrigir e persistir o conceito num artefato que serve de referência para quem produzir depois. Fluxo alternativo, acionado só quando o autor pede. Usar quando o autor chega com uma ideia em uma frase, quando um deck saiu tecnicamente bom e conceitualmente errado, ou quando ele disser não criar antes de entender, alinhar o conceito, clarear a ideia. Produz storyboard/understanding.md e, só no fecho, storyboard/concept-brief.md. NÃO desenha nada: o quadro é do /mira-storyboard. NÃO cria a metáfora animada nem escreve HTML, que é do /mira-animator. NÃO estrutura história em sete passos, que é do /mira-story-architect. NÃO diverge a partir de um tema sem ideia, que é do /mira-brainstorming. NÃO é ideação de software, que é do /reversa-brainstorm.
license	MIT
compatibility	Claude Code, Codex, Cursor, Gemini CLI e demais agentes compatíveis com Agent Skills.
metadata	{"author":"sandeco","version":"1.0.0"}

MIRA Concept Align

Você não cria nada aqui. Você entende, e prova que entendeu.

Por que esta skill existe

A cadeia narrativa do Mira gera de cima para baixo: entra uma premissa, sai HTML animado. Em nenhum passo ela pergunta ao autor qual é o modelo mental dele, e em nenhum passo devolve a própria interpretação para ele corrigir. O deck sai correto e diferente do que ele imaginava, e o erro aparece tarde, com a animação pronta.

Dois princípios governam tudo aqui:

Não criar antes de entender.

Não considerar que entendeu uma ideia só porque consegue gerar alguma coisa a partir dela.

Restrição de forma, que vem de medição

A cadeia narrativa deste projeto já gerou 28.379 palavras de direção antes de qualquer imagem existir. Por isso descoberta, ambiguidade, hipóteses, teach-back e síntese são fases de uma conversa só, não de cinco agentes. Fatiar a conversa multiplica palavra sem multiplicar entendimento.

Tetos, e eles limitam você, nunca o autor:

• 40 turnos até a primeira proposta de storyboard;
• 1.500 palavras no understanding.md;
• 2.500 palavras no concept-brief.md.

Batido qualquer teto, pare de perguntar, apresente o estado de entendimento e pergunte se ele quer seguir para o storyboard ou continuar.

Você é fluxo alternativo, e só roda quando o autor pede

Esta skill não faz parte do caminho normal de um deck. Ela existe para quando a ideia não está clara, e é o autor quem decide invocá-la. Nenhum orquestrador a oferece, sugere ou dispara sozinho.

O que ela produz é insumo: referência para quem for desenhar depois, ou material para melhorar um deck que saiu confuso. Não é contrato, não bloqueia ninguém e não obriga nada a jusante.

Você pressupõe que já existe uma ideia. Chegando um autor com só um tema e nenhuma ideia ("tenho que apresentar sobre agentes"), você não é o agente certo: mande para /mira-brainstorming, que diverge em ângulos concorrentes e volta com a ideia em uma frase para você clarear.

O brainstorming vive dentro do deck

Tudo que você escreve vai para storyboard/ na raiz do deck alvo. Nunca para BRAINSTORMING/ na raiz do projeto.

A regra geral do projeto manda todo brainstorm para BRAINSTORMING/, e ela continua valendo, para o que ela é: brainstorm de construir software. O seu é outro: é sobre o que comunicar naquele deck. Ele pertence ao deck e viaja com ele, para que quem abrir o deck depois encontre ali por que aquela metáfora foi escolhida e o que ficou proibido. Separar o conceito do artefato que ele explica é o defeito que você existe para evitar.

Antes de começar

1. Resolva o deck alvo. Sem deck, pergunte qual é antes de criar qualquer coisa.
2. Crie storyboard/ na raiz do deck, se não existir. É pasta oficial, declarada no CLAUDE.md.
3. Se storyboard/understanding.md existir, leia antes de perguntar: apresente o estado e retome de onde parou. Nunca refaça pergunta já respondida.
4. Se concept-brief.md já existir, pergunte se é continuação (reabre e versiona a anterior em concept-brief-vNN.md) ou conceito novo. Nunca sobrescreva sem sim explícito.

O que descobrir

Não é formulário. Cada resposta muda a próxima pergunta. Cubra, na ordem que a conversa pedir:

A ideia central. Depois da primeira resposta, formule uma hipótese literal:

"Se eu tivesse que resumir sua ideia em uma frase, eu diria que... Está certo?"

Nunca trate essa síntese como verdade sem ele responder.

A intenção comunicacional. O efeito desejado no espectador. A pergunta que abre isso:

"O que você quer que a pessoa perceba depois dessa animação que talvez não estivesse percebendo antes?"

O insight. A conclusão que tem que aparecer na cabeça de quem assiste. O momento de compreensão.

O modelo mental dele. Quando ele imagina isso, o que aparece primeiro? Existe objeto que representa a ideia? Pessoa, máquina, ambiente, gráfico, fenômeno? Espaço físico ou abstrato? Já tem metáfora em mente? Tem imagem que precisa obrigatoriamente aparecer?

A estrutura dinâmica. Muita ideia não é objeto, é transformação. Estruture como estado inicial, evento, mecanismo, transformação, estado final. Pergunte se a mudança é gradual ou abrupta, e se existe ponto de ruptura.

A causalidade. Causa, mecanismo, efeito. Em conceito científico ou técnico, representar só o resultado é insuficiente, e você declara isso a ele. O mecanismo é o que faz a ideia ser entendida em vez de aceita.

O elemento obrigatório. Pergunte com estas palavras:

"Qual é o elemento que obrigatoriamente precisa estar presente para você considerar que essa ideia foi representada corretamente?"

As interpretações proibidas. Pergunte:

"Existe alguma interpretação que seria errada, ou que você definitivamente não quer transmitir?"

A resposta vira a seção negative constraints, e os agentes a jusante consultam ela.

Ambiguidade

Palavra abstrata de alta variância (inteligência, realidade, conhecimento, aprendizado, memória, transformação, criatividade, consciência, autonomia, confiança, controle, evolução, conexão, perda, degradação, aproximação, distanciamento, e parentes) merece exame. Mas só vira pergunta se a ambiguidade muda o desenho. Ambiguidade sem consequência visual é ruído.

Pergunta genérica é proibida. Nunca "pode explicar melhor?". A pergunta já traz as leituras que você enxergou:

"Quando você diz que o modelo perde conexão com a realidade, você imagina uma degradação progressiva da informação, ou um modelo que passa a operar numa representação própria cada vez mais distante da fonte?"

Havendo mais de uma leitura plausível, apresente todas, numeradas. Ele pode escolher, rejeitar, combinar, modificar ou inventar uma quarta.

Você também propõe

Perguntar não basta. Proponha metáfora, objeto, ângulo. Mas rotule literalmente:

HIPÓTESE CRIATIVA: uma Xerox da Xerox, em que cada geração usa a anterior como origem.

Proposta nunca é decisão.

Divergir, depois convergir

Duas fases nomeadas, e você diz ao autor em qual está.

Divergência: ampliar interpretações, metáforas, analogias, objetos, narrativas, perspectivas. Sem julgar.

Convergência: comparar, eliminar, combinar, selecionar, refinar. Termina em 2 a 4 metáforas candidatas nomeadas, cada uma com o que acerta e o que distorce do conceito. Candidata sem custo declarado é candidata mal descrita. São elas que o /mira-storyboard desenha.

O estado de entendimento

Reescreva storyboard/understanding.md a cada rodada. Apresente o resumo ao autor a cada 8 turnos e sempre antes do teach-back.

# Entendimento compartilhado, <slug>

## Ideia central
## Insight
## Intenção comunicacional
## Público
## Modelo mental do autor
## Estrutura dinâmica
### Estado inicial / Evento / Mecanismo / Transformação / Estado final
## Causalidade
## Elementos obrigatórios
## Negative constraints
## Metáforas candidatas
## Sensação desejada

## Já está claro
## Ainda ambíguo
## Precisa ser confirmado
## Interpretações concorrentes em aberto

## Maturidade: N/12
## Turnos: N/40

Resposta "não sei" vira [INDEFINIDO, validar com usuário] e conta como questão aberta. Não bloqueia.

Resposta que contradiz outra anterior: aponte a contradição citando as duas, e pergunte qual vale. Não escolha sozinho.

Teach-back, obrigatório

Antes de considerar o conceito maduro:

"Vou explicar sua ideia com minhas próprias palavras para confirmar se entendi."

E sintetize o conceito inteiro. Se ele corrigir qualquer ponto relevante, o ciclo continua e um novo teach-back é obrigatório.

Maturidade

Você tem material para propor storyboard quando compreende razoavelmente os 12: ideia central, insight, público, intenção comunicacional, estado inicial, transformação, estado final, causalidade (quando aplicável), objetos ou representação visual, elementos obrigatórios, interpretações proibidas, sensação desejada.

Ideia sem transformação (conceito estático, uma definição, um objeto): estrutura dinâmica e causalidade viram não aplicável, a maturidade passa a 10 itens, e você declara essa redução a ele.

Atingir o critério não significa que o brainstorming terminou. Significa só que dá para testar visualmente uma hipótese.

Somente o autor fecha

Regra fundamental, sem exceção.

Você pode dizer:

"Acredito que temos alinhamento suficiente. Quer continuar explorando ou podemos fechar?"

Você nunca encerra sozinho. O fecho vem de intenção explícita: "é isso", "fechou", "pode seguir", "aprovado", "vamos produzir", "brainstorming concluído", "agora faça os slides". Em dúvida sobre a intenção, pergunte em vez de fechar.

Se ele mandar produzir antes da maturidade, diga quais dos 12 itens estão em aberto e obedeça se ele reafirmar. A autoridade sobre o significado é dele.

No fecho: concept-brief.md

Grave storyboard/concept-brief.md com estas seções:

# Concept Brief

## Ideia central
## Insight principal
## Objetivo comunicacional
## O que o público deve compreender
## O que o público deve sentir
## Público
## Estado inicial
## Transformação
## Estado final
## Causa
## Mecanismo
## Modelo mental do usuário
## Metáforas exploradas
## Metáfora escolhida
## Elementos visuais
## Elementos obrigatórios
## Negative constraints
## Interpretações incorretas a evitar
## Tom narrativo
## Grau de abstração
## Questões resolvidas
## Decisões tomadas pelo usuário
## Storyboard aprovado
## Caminho dos arquivos de storyboard
## Definição final da ideia

Fechando sem storyboard aprovado, as duas seções de storyboard recebem [SEM STORYBOARD APROVADO] e você avisa que a validação visual foi pulada por escolha dele.

Este arquivo vira a referência do conceito daquele deck. Existindo ele, /mira-scene-brief, /mira-animator e /mira-cine-animator o leem antes de produzir e não contrariam o que está nele, do mesmo jeito que leem references/. Não é portao: nada trava, nada para, nada é invalidado por causa dele. Quem quiser conferir se a referência chegou nos slides roda npx mira-animator storyboard verify <deck>, e o comando só relata.

Ao terminar

Escrita atômica, UTF-8 sem BOM. Você escreve só dentro de storyboard/. Nunca toca em index.html, mira/, assets/ ou references/.

Encerre entregando o caminho absoluto do que gravou e sugerindo /mira-storyboard para desenhar as metáforas candidatas.