mira-references

# Skill: Referências por Tema ## O que esta skill faz Cada tema de slides tem a sua própria pasta de referências, dentro da pasta do tema: ``` slides/ └── <tema>/ ├── index.html (o deck do tema, criado pelas outras skills) └── references/ (o material-fonte SÓ deste tema) ├── livro-cap.pdf ├── diagrama.png └── notas.md ``` A referência de um slide vive ao lado do slide, dentro de `references/`. Você adiciona o material aqui, por tema, e as skills de criação (mira-extract, mira-builder, mira-animator) leem daqui. ## Regra de Inclusão Automática Se a pasta `decks/<tema>/references/` já tiver arquivos, eles JÁ SÃO as referências do tema. Inclua-os sem perguntar de novo. Só pergunte material novo se a pasta estiver vazia ou se o usuário quiser acrescentar algo. ## Passos quando a skill é acionada 1. **Descobrir o tema.** Se o usuário não disser, pergunte um nome curto de tema. Gere um slug em kebab-case, minúsculo, sem acento (ex.: "Spec Driven Development" vira `spec-driven`). 2. **Garantir a estrutura.** Crie, se não existir, `decks/<tema>/` e dentro dela `decks/<tema>/references/`. 3. **Listar o que já existe.** Liste os arquivos de `decks/<tema>/references/`. Se houver, informe que serão usados como fonte deste tema. 4. **Receber o material novo (se houver).** - Caminho de arquivo ou pasta que o usuário passar: COPIE para `decks/<tema>/references/` (copiar, nunca mover nem editar o original). - Texto colado: salve como `.md` dentro de `references/`. - Link: salve como `.url` ou registre em um `fontes.md` dentro de `references/`. 5. **Confirmar o destino.** Mostre o caminho `decks/<tema>/references/` e diga ao usuário que basta soltar mais arquivos ali a qualquer momento. 6. **Encerrar apontando o próximo passo:** para gerar os slides do tema, as skills de criação devem ler TUDO que estiver em `decks/<tema>/references/`. ## Tipos de Referência Aceitos - PDF (livro, capítulo, artigo, slides antigos) - Imagens e diagramas (`.png`, `.jpg`, `.svg`, prints) - Texto e markdown (`.md`, `.txt`) - LaTeX (`.tex`) - Código ou dados que embasem um slide - Links salvos em `fontes.md` ## Regras Inegociáveis - Uma pasta por tema. A referência mora dentro da pasta do tema, em `references/`. - Nunca leia, edite ou apague nada fora de `decks/<tema>/references/`. Ao copiar de um caminho externo, o original fica intacto. - A fonte de conteúdo nunca é perguntada na instalação. É sempre adicionada aqui, por tema. - Se as referências já existem, inclua-as automaticamente. - Texto visível em português brasileiro com acentuação correta. Proibido travessão (—); use vírgula ou dois-pontos. ## Integração com o Pipeline Quando o usuário pedir um slide ou deck sobre um tema, antes de criar verifique se `decks/<tema>/references/` existe e tem conteúdo. Se não existir, acione esta skill primeiro. As referências encontradas aqui são a fonte de verdade para mira-extract (briefing), mira-builder (montagem) e mira-animator (animações).