steffen74/to-slides

Para slides

Constrói os slides de uma unidade. Leia COURSE-CANVAS.md, RESOURCES.md, DECISIONS.md, a seção ## Agentic course creation de AGENTS.md, e o plano de sessão aprovado da unidade e a página do participante. Os slides são construídos a partir do plano, nunca o contrário: se o plano de sessão ainda não estiver aprovado, pare e sugira /draft-unit.

1. Definir o formato de uma vez

O formato normalmente é definido em /setup-course. Se AGENTS.md não tiver uma linha Slides:, pergunte, liderando com uma recomendação baseada no que já existe (decks anteriores, as ferramentas no bloco 5):

• Formato e ferramenta: por exemplo, um artifact Slides do claude.ai, .pptx, Google Slides, Markdown slides (Marp, reveal.js).

• Onde os decks ficam e quem os vê: mostrados apenas em aula, ou publicados para os participantes depois. Decks publicados são material do participante.

• Template: um deck existente ou sistema de design cujo visual deve ser seguido.

• Onde os outlines ficam: recomende uma pasta privada ao lado dos planos de sessão (por exemplo slides/<unit>-outline.md), já que outlines contêm respostas de exemplo.

Escreva a resposta como - Slides: <formato>, <localização do deck>, <localização do outline>, <publicado para participantes: sim|não>, template <link> em AGENTS.md e registre em DECISIONS.md.

2. Outline a partir do plano

Escreva o outline em seu arquivo antes de qualquer slide: uma tabela de tempos (minutos do plano, slides e minutos por slide para cada bloco), depois uma entrada por bloco do plano de sessão, em sua ordem:

• Abertura: um slide de capa e um slide de agenda com os blocos e minutos do plano, mesmo que o plano não os liste.

• Bloco de input: uma seção dimensionada aos seus minutos (como regra, um slide de conteúdo a cada dois a três minutos). Liste as afirmações que cada slide faz e de onde vêm: o plano de sessão, suas respostas de exemplo, o canvas, a página do participante. Números vêm das respostas de exemplo do plano ou são calculados novamente; nunca inventados. Quando o plano dá apenas uma palavra-chave ("tipos de escala"), não a preencha com seu próprio conhecimento: marque o slide como conteúdo faltando no plano e transforme em decisão.

• Trabalho em grupo: um slide de tarefa com a tarefa na mesma redação da página do participante, o tempo limite, o resultado esperado, onde trabalhar (repositório, dados, notebook inicial) e onde postar ou entregar. Carregue learner-instructions. Se a página do participante não contiver a tarefa (tarefas durante a sessão muitas vezes vivem apenas no plano de sessão), use a redação do plano e sinalize: o slide é então o único lugar onde os aprendizes veem a tarefa, e é material do participante independentemente de o deck ser publicado. Sinalize toda tarefa com mais de uma leitura razoável (por exemplo "média" por dias ou por linhas) como decisão.

• Plenária: um slide com a pergunta ou os critérios para feedback. Conteúdo produzido na sala (respostas dos grupos, gráficos) ganha um quadro vazio para preencher ao vivo.

• Verificação de vídeo: o link do quiz de RESOURCES.md (e um QR code onde o formato permitir), não as perguntas; respostas e explicações apenas nas notas do palestrante. Se a unidade ainda não tem quiz, sugira /to-quiz primeiro.

• Intervalo, perspectivas: um slide cada; as perspectivas repetem o dever de casa na redação da página do participante.

Marque todo slide que revelaria uma resposta de exemplo antes de os aprendizes terem trabalhado nela. Esses vão após o slide de tarefa, como slides ocultos ou de backup, ou são deixados de fora do deck publicado.

Termine o outline com as decisões de que ele precisa (blocos sobrecarregados, conteúdo faltando, tarefas ambíguas, se o deck é publicado), cada uma com opções e uma recomendação, e o resultado das verificações de slides de course-checks que já podem ser executadas em um outline. Mostre e aguarde o instrutor. Este é o ponto de parada; edições no conteúdo vão primeiro para o plano de sessão, depois para o outline.

3. Construir

Construa o deck no formato e template definidos:

• Um título em cada slide que declare seu ponto ("A maioria dos erros de previsão recai em feriados públicos"), não um tópico ("Resultados").
• Pouco texto; o que o instrutor diz vai nas notas do palestrante, extraídas do plano de sessão.
• Cada link, nome de repositório, comando e prazo exatamente como em sua fonte de verdade em RESOURCES.md.
• Demonstrações ao vivo ganham um slide de fallback (uma captura de tela ou a saída esperada) caso a demonstração falhe.

4. Verificar e entregar

Execute as verificações de slides de course-checks (consistência com plano e página do participante, tempo, sem respostas de exemplo antecipadas, links). Corrija o que falhar, depois mostre o deck com uma lista dos slides sobre os quais você não tinha certeza.

Decks são espelhos: repetem fatos do plano de sessão e da página do participante, incluindo suas lacunas. Adicione cada deck aos espelhos desses fatos em RESOURCES.md, para que uma correção em uma página também alcance os decks que a repetem.

Se os decks forem publicados para participantes, publique o deck aprovado no handbook: exporte como PDF (quando a ferramenta de slides só puder ser exportada manualmente, peça ao instrutor para exportá-lo e diga exatamente onde salvar), nomeie de acordo com a unidade (por exemplo week-02-slides.pdf), coloque no caminho de assets do handbook a partir de AGENTS.md, remova notas do palestrante e slides de resposta ocultos da exportação, e vincule-o da página do participante da unidade sob seus materiais. Uma alteração posterior no deck significa uma nova exportação; o PDF no handbook é um espelho do deck.

Concluído quando o instrutor tiver aprovado o deck, RESOURCES.md o listar para a unidade com status rascunho, sua localização estiver vinculada a partir do plano de sessão, e, se publicado, o PDF estiver vinculado a partir da página do participante da unidade. Se o deck for publicado para participantes, sugira /walk-through <unit> em seguida; caso contrário, /review-unit <unit>.