iron-edge 1.2.0 → 2.0.0

package/squads/squad-courses/tasks/create-quiz-questions.md

@@ -17,30 +17,55 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada questão está amarrada a um outcome declarado da lição/módulo"
+  - "[ ] Pelo menos 50% das questões estão em Apply ou acima na Taxonomia de Bloom"
+  - "[ ] Todo distrator é um erro plausível, não um absurdo ou giveaway gramatical"
+  - "[ ] Toda alternativa (certa e erradas) tem feedback explicativo"
 ---
 
 # Task: create-quiz-questions
 
-## Metadata
-- **Agent:** assessment-creator (Gauge)
-- **Squad:** squad-courses
-- **Complexity:** STANDARD
-
 ## Objetivo
-Criar questoes de quiz
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Escrever o quiz formativo de uma lição ou módulo — questões que testam se o aluno consegue aplicar o que aprendeu, cada uma amarrada a um learning outcome específico.
+
+## A regra que governa
+**Questão sem outcome declarado é decoração.** Toda questão nasce do objetivo de aprendizagem que ela testa — nunca do conteúdo que sobrou depois de escrever a lição.
+
+## Passos
+
+1. **Levantar o outcome antes de escrever qualquer pergunta.** Pegue o(s) learning outcome(s) da lição ou módulo (vêm do curriculum-designer, no `context` de entrada). Sem outcome declarado, não existe quiz — pare e sinalize a lacuna ao pipeline em vez de inventar um outcome pra justificar a questão.
+
+2. **Definir quantidade e mix.** 3–5 questões por lição (formativa), segundo `assessment-design-guide.md`. Mapeie cada questão a um nível de Bloom e garanta que pelo menos 50% fiquem em Apply ou acima — nunca uma bateria inteira de "lembrar".
+   ⚠️ Isso "parece" rigoroso porque tem número redondo de questões, mas se todas forem Remember, o quiz mede lembrança de trecho de vídeo, não aprendizado.
+
+3. **Escrever a questão no tipo certo pro nível.** Use a tabela Bloom's → tipo de questão do `assessment-design-guide.md` (Remember → múltipla escolha/V-F; Apply → cenário/estudo de caso; Analyze → comparação; etc.). Escrever pergunta de cenário e chamar de "aplicação" quando na verdade só pede definição não conta.
+
+4. **Construir os distratores.** 1 resposta correta, alternativas erradas plausíveis — erros comuns reais que alguém cometeria por raciocínio incompleto, não frases absurdas ou com erro gramatical que entregam a resposta.
+
+5. **Escrever feedback pra cada alternativa.** Por que a certa está certa, por que cada errada está errada. Sem isso a questão vira nota, não aprendizado — é o que separa formativo de prova seca.
+
+## Formato da saída
+
+Uma lista de questões em Markdown, uma por bloco:
+
+```
+### Questão 1
+**Outcome:** [outcome que esta questão testa]
+**Nível de Bloom:** Apply
+**Pergunta:** Dado [cenário], qual é a ação correta?
+- A) [opção] — ❌ Feedback: [por que está errada]
+- B) [opção] — ✅ Feedback: [por que está certa]
+- C) [opção] — ❌ Feedback: [por que está errada]
+```
+
+## O que não vale
+- Quiz escrito antes do outcome existir, ou com outcome inventado pra encaixar a questão.
+- Bateria inteira em Remember — abaixo do mínimo de 50% em Apply+.
+- Distrator absurdo, fora de tom, ou que se entrega pela gramática ("as opções acima" quando as outras têm o mesmo tempo verbal errado).
+- Alternativa sem feedback — o aluno erra e não aprende por quê.
+- Pergunta "pega-rato" que testa atenção na leitura, não o conteúdo ensinado.
+
+## Fontes no squad
+- `knowledge-base/assessment-design-guide.md` — Question Types Mapped to Bloom's Levels, Quiz Design Rules, Assessment Anti-Patterns
+- `knowledge-base/curriculum-mapping-guide.md` — Step 4 (Mapear Assessments) e Alignment Validation Checklist
+- `knowledge-base/instructional-design-frameworks.md` — tabela de Bloom's Taxonomy revisada

package/squads/squad-courses/tasks/create-sales-page-brief.md

@@ -17,10 +17,11 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Header preenchido com preço e urgência já decididos nas tasks anteriores"
+  - "[ ] Headline e problema na linguagem do público, sem número não comprovado"
+  - "[ ] Testemunhos reais ou marcados como pendentes, nunca inventados"
+  - "[ ] Garantia e FAQ endereçam objeções reais do curso"
+  - "[ ] Nenhum [PLACEHOLDER] restante no brief entregue"
 ---
 
 # Task: create-sales-page-brief
@@ -31,16 +32,34 @@ Checklist:
 - **Complexity:** STANDARD
 
 ## Objetivo
-Criar brief de pagina de vendas
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Preencher o brief de página de vendas completo, pronto para virar copy — nunca a copy em si.
+
+## A regra que governa
+**O brief é insumo verificável para quem escreve, não a página pronta.** Todo espaço do template recebe fato ou decisão, nunca um placeholder deixado ou um número inventado.
+
+## Passos
+
+1. **Copiar a estrutura de `sales-page-brief-template.md` inteira** — as 10 seções, na ordem: headline, problema, solução, módulos, instrutor, testemunhos, pricing, garantia, FAQ, CTA.
+
+2. **Preencher o header** (curso, público, preço, mecanismo de urgência) com o que já foi decidido em `design-pricing-model` e `plan-launch-sequence` — não decida preço nem urgência de novo aqui, importe a decisão.
+
+3. **Escrever headline e problema na linguagem do público**, usando os estágios de "Content Pillars for Course Creators" (Awareness/Consideration/Decision) de `course-launch-strategy.md` — não no jargão do curso.
+   ⚠️ **A promessa da headline e da seção de solução nunca vira número de resultado não comprovado** ("dobre sua renda", "garanta aprovação"). Fica em transformação qualitativa, ou em dado já comprovado com fonte — depoimento real, taxa medida em turma anterior.
+
+4. **Preencher testemunhos com pessoa real e resultado real.** Se ainda não existem os 3 mínimos, marque explicitamente "sem testemunho ainda" e use a alternativa do próprio template (beta reader, contagem de alunos, menção de imprensa).
+   ⚠️ Nunca inventar nome, resultado ou citação de aluno pra preencher a tabela vazia.
+
+5. **Preencher garantia e FAQ com as objeções reais** já levantadas no squad (curriculum, precificação, formato) — não com objeções genéricas de mercado.
+
+6. **Marcar tom, palavras a usar/evitar e páginas de concorrentes de referência**, se houver.
+
+## Formato da saída
+O arquivo `sales-page-brief-template.md` preenchido, sem nenhum `[PLACEHOLDER]` restante. Onde faltar dado real, escrever `[A CONFIRMAR: o quê e com quem]` em vez de inventar.
+
+## O que não vale
+- Deixar `[PLACEHOLDER]` no brief entregue — quem escreve a copy não vai adivinhar.
+- Inventar testemunho, número ou credencial pra preencher espaço vazio.
+- Escrever a copy final dentro do brief — o brief decide o quê dizer, não o "como" frase por frase.
+
+## Fontes no squad
+`templates/sales-page-brief-template.md`, `knowledge-base/course-launch-strategy.md`.

package/squads/squad-courses/tasks/create-self-evaluation.md

@@ -17,30 +17,49 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] As perguntas citam a skill/outcome específico do módulo, não são genéricas"
+  - "[ ] Inclui pergunta de confiança (1–5), pergunta de incerteza e pergunta de aplicação"
+  - "[ ] Inclui pergunta de transferência (o que o aluno vai fazer com isto nos próximos dias)"
+  - "[ ] Não tem nota, peso ou julgamento do instrutor associado"
 ---
 
 # Task: create-self-evaluation
 
-## Metadata
-- **Agent:** assessment-creator (Gauge)
-- **Squad:** squad-courses
-- **Complexity:** STANDARD
-
 ## Objetivo
-Criar auto-avaliacao
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Criar a autoavaliação de fim de módulo — as perguntas que fazem o aluno parar e checar se ele conseguiu o outcome do módulo, não se ele "gostou" do conteúdo.
+
+## A regra que governa
+**Autoavaliação pergunta sobre o outcome declarado do módulo, não sobre a experiência genérica do curso.** Se a pergunta funcionaria igual em qualquer módulo de qualquer curso, ela não é autoavaliação — é pesquisa de satisfação disfarçada.
+
+## Passos
+
+1. **Puxar o outcome do módulo.** Sem ele, a autoavaliação vira "você gostou da aula?" — que mede satisfação, não aprendizado. O outcome vem do `context` de entrada (curriculum-designer).
+
+2. **Escrever as 3 perguntas-base, reescritas pro skill específico.** Modelo do `assessment-design-guide.md`: confiança ("Numa escala de 1–5, quão confiante você está em [skill exata do módulo]?"), incerteza ("O que ainda está incerto sobre [skill exata]?"), aplicação ("O que você vai aplicar primeiro?"). Trocar "[skill exata]" por texto genérico tipo "o conteúdo deste módulo" é o erro mais comum — anula o propósito.
+
+3. **Adicionar a pergunta de transferência.** `adult-learning-principles.md` (Transfer of Learning): "Como você vai usar isso nos próximos 7 dias?" Fecha o ciclo entre aprender e aplicar — sem ela a autoavaliação para no reconhecimento, não chega na ação.
+   ⚠️ Não confundir com retrieval practice (perguntas de conteúdo pra reforçar memória) — autoavaliação é sobre a relação do aluno com o próprio aprendizado, não um segundo quiz disfarçado.
+
+4. **Manter curto e sem nota.** 3–5 perguntas, sem peso na avaliação formal do aluno. Autoavaliação existe pra metacognição e pra sinalizar ao próprio aluno o que revisar — vira outra coisa (e perde a franqueza da resposta) se carregar nota.
+
+## Formato da saída
+
+```
+## Autoavaliação — Módulo [nome]
+Outcome do módulo: [outcome declarado]
+
+1. Numa escala de 1–5, quão confiante você está em [skill do módulo]?
+2. O que ainda está incerto sobre [skill do módulo]?
+3. O que você vai aplicar primeiro?
+4. Como você vai usar isso nos próximos 7 dias?
+```
+
+## O que não vale
+- Pergunta genérica de satisfação ("Você gostou do módulo?") disfarçada de autoavaliação.
+- Autoavaliação com nota atribuída pelo instrutor — quebra o propósito de metacognição honesta.
+- Pergunta que não cita o skill/outcome específico do módulo.
+- Autoavaliação copiada de um módulo pro outro sem trocar o conteúdo das perguntas.
+
+## Fontes no squad
+- `knowledge-base/assessment-design-guide.md` — Self-Evaluation
+- `knowledge-base/adult-learning-principles.md` — Transfer of Learning, Retrieval Practice, Self-Determination Theory (Motivação Deeper Dive)

package/squads/squad-courses/tasks/create-shot-list.md

@@ -6,41 +6,54 @@ atomic_layer: Task
 elicit: false
 
 Entrada:
-  - campo: context
-    tipo: object
-    origem: "pipeline or manual"
+  - campo: script_roteiro
+    tipo: document
+    origem: "write-video-script"
     obrigatorio: true
 
 Saida:
-  - campo: resultado
+  - campo: shot_list
     tipo: document
-    destino: "next phase"
+    destino: "plan-recording-session"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Toda marcacao do roteiro virou uma linha na lista"
+  - "[ ] Cada shot tem duracao estimada, nao aproximada"
+  - "[ ] Shots do mesmo setup estao agrupados pra ordem de gravacao"
+  - "[ ] Nenhum shot orfao (sem correspondencia no roteiro)"
 ---
 
-# Task: create-shot-list
-
-## Metadata
-- **Agent:** production-director (Lens)
-- **Squad:** squad-courses
-- **Complexity:** STANDARD
+# Task: Criar lista de shots
 
 ## Objetivo
-Criar lista de shots
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Transformar as marcações do roteiro numa lista de shots com duração e setup, para que a câmera nunca precise ser decidida durante a gravação.
+
+## A regra que governa
+Toda troca de plano no roteiro vira uma linha na shot list, com duração — antes de gravar, não durante.
+
+## Passos
+
+1. **Percorrer o roteiro marcação por marcação.** Cada `[CAMERA]`, `[SLIDE]`, `[SCREEN]` ou `[B-ROLL]` vira um shot na lista, na ordem em que aparece no texto.
+
+2. **Usar como referência a composição padrão de uma aula de 8–12 minutos:** abertura talking-head (30–45s) → slide de conceito (1–3min) → demo de tela (3–5min) → bridge talking-head (1–2min) → slide de resumo (45s) → fechamento talking-head (20–30s). São 6 shots quando a aula segue esse padrão.
+   ⚠️ **Contagem fixa não é regra — é referência.** Se o roteiro tem mais blocos de conteúdo ou nenhum screen recording, a lista segue o roteiro real. A lista nunca corta o roteiro pra caber em 6 linhas.
+
+3. **Para cada shot, registrar o setup:** enquadramento (cabeça + ombros, 20% de espaço acima da cabeça, olhos na linha do terço superior) e o que precisa estar pronto antes — slide renderizado, app aberto na tela certa, dado de exemplo carregado.
+
+4. **Marcar as trocas de setup físico.** Câmera → tela → câmera é onde o take quebra. Agrupe shots do mesmo setup (todos os talking-head juntos, por exemplo) quando a ordem de gravação permitir — não é preciso gravar na ordem do roteiro, só entregar na ordem do roteiro depois de editado.
+
+5. **Conferir contra o roteiro.** Toda marcação virou shot, nenhum shot ficou sem descrição do que precisa estar preparado.
+
+## Formato da saída
+Tabela com colunas: `Shot #` | `Tipo` (CAMERA/SLIDE/SCREEN/B-ROLL) | `Descrição` | `Duração estimada` | `Setup necessário` | `Ordem de gravação sugerida`.
+
+Exemplo de linha: `3 | SCREEN | Demo de cadastro no painel | 3min | app aberto na tela de cadastro, conta de teste logada | grupo 2 — depois dos outros SCREEN`.
+
+## O que não vale
+- Lista que segue a ordem do roteiro por padrão, sem considerar agrupar shots do mesmo setup — cada troca desnecessária de câmera/luz custa tempo real de sessão.
+- Duração como "aproximadamente" — cada shot leva um número, mesmo que estimado.
+- Shot sem nota do que precisa estar pronto antes (o motivo de existir a lista é justamente evitar descobrir isso na hora).
+- Forçar a contagem de 6 shots num roteiro que tem estrutura diferente.
+
+## Fontes no squad
+`video-production-guide.md` (tabela de shot list padrão e setup de câmera).

package/squads/squad-courses/tasks/create-speaker-notes.md

@@ -17,30 +17,50 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Notas escritas em frases completas, não palavras-chave"
+  - "[ ] Cada bloco marcado com [STORY], [STAT] ou [DEMO] quando aplicável"
+  - "[ ] Transição para o próximo slide escrita, não implícita"
+  - "[ ] Nenhuma nota repete o texto do slide"
 ---
 
-# Task: create-speaker-notes
-
-## Metadata
-- **Agent:** slide-designer (Deck)
-- **Squad:** squad-courses
-- **Complexity:** STANDARD
+# Task: Criar as notas do apresentador
 
 ## Objetivo
-Criar notas do apresentador
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Escrever, para cada slide, a nota de apoio que orienta quem apresenta — o que dizer, quando pausar, como conectar com o próximo slide.
+
+## A regra que governa
+**A nota é roteiro para quem fala, não legenda para quem lê.** O slide carrega o resumo (`write-slide-content`); a nota carrega a explicação completa. Se as duas dizem a mesma coisa, uma das duas está sobrando.
+
+## Passos
+
+1. **Frases completas, não palavras-chave.** `presentation-design-principles.md` ("Speaker Notes Best Practices"): a nota é para ser lida e falada com naturalidade, não decifrada em cima da hora. "Explicar que preço baixo mata margem antes de matar venda, usando o exemplo do slide anterior" — não "preço baixo → margem".
+
+2. **Marcar o tipo de conteúdo.** Prefixar cada bloco com [STORY], [STAT] ou [DEMO] conforme o que ele carrega — permite que quem apresenta veja de relance se está prestes a contar um caso, citar um número ou rodar uma demonstração.
+
+3. **Incluir deixa de tempo onde há pausa intencional.** "Pausa aqui — ~1 min, deixar a pergunta ecoar" ou "Rodar o cronômetro do exercício agora". Sem a deixa, quem apresenta perde o ritmo planejado no outline.
+
+4. **Escrever a transição, não deixar implícita.** "Isso conecta com o próximo slide porque..." — a transição faz parte da nota, não é algo que quem apresenta improvisa na hora. `presentation-design-principles.md` lista isso como item próprio, separado do conteúdo.
+
+5. **Nunca duplicar o texto do slide, verbatim.** ⚠️ **A nota que só reescreve o bullet do slide com "e" no meio é preguiça, não instrução.** Se o slide diz "Cliente nunca questiona o valor", a nota explica o mecanismo por trás — por que isso acontece, o que fazer quando não acontece — não repete a frase.
+
+6. **Diferenciar por formato.** Workshop precisa de nota de facilitação: o que observar enquanto o grupo trabalha, quando encerrar, o que fazer se ninguém falar no debrief. Lecture (mentoria/gravado) precisa de nota de conteúdo: o que dizer, palavra a palavra, nos pontos onde a precisão importa. A distinção está na tabela "Workshop Slides vs Lecture Slides" (`presentation-design-principles.md`, linha "Speaker notes").
+
+## Formato da saída
+Bloco por slide, no template de `templates/presentation-template.md`:
+```
+Slide 6
+> [STAT] O dado de que 70% dos alunos abandonam por overwhelm no Módulo 1
+> vem do padrão de dropout do squad — usar para justificar por que
+> este framework existe. Pausa de ~10s depois de dizer o número.
+> Conecta com o próximo slide: "e é exatamente esse ponto que o
+> framework resolve."
+```
+
+## O que não vale
+- Nota igual ao slide, só com "e" a mais.
+- Nota telegráfica, tipo lembrete pessoal, sem frase completa.
+- Nota sem indicar a transição para o slide seguinte.
+- Mesma nota de conteúdo usada para slide de workshop, sem cue de facilitação.
+
+## Fontes no squad
+`knowledge-base/presentation-design-principles.md`, `templates/presentation-template.md`.

package/squads/squad-courses/tasks/create-syllabus-document.md

@@ -17,30 +17,42 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Todo placeholder [ENTRE_COLCHETES] preenchido, nenhum sobrou"
+  - "[ ] Outcomes, modulos e licoes batem exatamente com as tasks anteriores"
+  - "[ ] Numero de licoes no Module Overview bate com o Detailed Lesson List"
+  - "[ ] 'This course is NOT for' preenchido, nao deixado vazio"
+  - "[ ] Sequence rationale e Gaps acknowledged escritos, sem promessa vaga"
 ---
 
-# Task: create-syllabus-document
-
-## Metadata
-- **Agent:** curriculum-designer (Compass)
-- **Squad:** squad-courses
-- **Complexity:** STANDARD
+# Task: Criar o documento de syllabus
 
 ## Objetivo
-Criar documento de syllabus
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Consolidar tudo que já foi decidido — outcomes, jornada, módulos, lições, pré-requisitos — em um único documento de syllabus, pronto para virar o contrato do aluno e a fonte única para a próxima fase (`lesson-architect`).
+
+## A regra que governa
+**O syllabus é o contrato com o aluno — não é o lugar para decidir coisa nova.** Esta task consolida o que `define-learning-outcomes`, `design-learning-path`, `structure-module-sequence` e `map-prerequisite-chain` já produziram. Se uma informação não veio de uma task anterior, ela não entra aqui — volta e se decide na task certa primeiro.
+
+## Passos
+
+1. **Preencha `templates/course-outline-template.md` inteiro**, seção por seção: Course Identity, Target Audience, Prerequisites, Course Outcomes, Module Overview, Detailed Lesson List (por módulo), Bonuses and Resources, Curriculum Notes.
+
+2. **Puxe cada seção da task correspondente, sem redigir do zero.** Outcomes vêm de `define-learning-outcomes`; Prerequisites vêm de `map-prerequisite-chain` (a lista externa que o aluno vê, não a cadeia interna completa); Module Overview e Detailed Lesson List vêm de `structure-module-sequence`; a lógica de trilhas obrigatória/opcional de `design-learning-path` aparece na seção Curriculum Notes.
+
+3. **Escreva "Sequence rationale" e "Gaps acknowledged" com honestidade.** Sequence rationale é a versão consolidada das notas "por que esta ordem" de cada módulo. Gaps acknowledged nomeia o que ficou de fora e por quê — isso é transparência de proposta pedagógica, não é peça de venda.
+
+4. **Preencha "This course is NOT for".** Quem não deveria se matricular. Sem essa seção, aluno errado compra, se frustra e pede reembolso — o custo cai na equipe de suporte, não na de currículo.
+
+5. **Congele a versão.** Marque Version 1.0 e Last Updated com a data. A partir daqui, este documento é a fonte única — `lesson-architect` (Scribe) trabalha em cima dele, não reabre decisão de outcome ou de sequência.
+   ⚠️ **Placeholder esquecido é o defeito mais comum e mais fácil de pegar.** Antes de entregar, procure literalmente por colchetes `[` no arquivo final — se sobrou um, o documento não está pronto.
+
+## Formato da saída
+O arquivo `templates/course-outline-template.md` preenchido de ponta a ponta, sem nenhum placeholder remanescente, com os números do Module Overview batendo exatamente com os números do Detailed Lesson List (mesma contagem de módulos, mesma contagem de lições por módulo).
+
+## O que não vale
+- Outcome, módulo ou prazo novo aparecendo no syllabus sem ter passado por uma task anterior.
+- Module Overview com 5 módulos e Detailed Lesson List documentando só 4 — divergência que confunde quem recebe o documento depois.
+- Duração "arredondada para ficar bonita" em vez da duração real estimada em `structure-module-sequence`.
+- "This course is NOT for" deixado em branco ou genérico demais para orientar alguém.
+
+## Fontes no squad
+`templates/course-outline-template.md` (estrutura completa do documento a preencher).

package/squads/squad-courses/tasks/create-teleprompter-script.md

@@ -6,41 +6,55 @@ atomic_layer: Task
 elicit: false
 
 Entrada:
-  - campo: context
-    tipo: object
-    origem: "pipeline or manual"
+  - campo: script_roteiro
+    tipo: document
+    origem: "write-video-script"
     obrigatorio: true
 
 Saida:
-  - campo: resultado
+  - campo: teleprompter_script
     tipo: document
-    destino: "next phase"
+    destino: "sessao de gravacao"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Frase nao quebra no meio de numero, nome proprio ou termo tecnico"
+  - "[ ] Marcacoes de producao ([CAMERA], [SLIDE]) removidas do texto de leitura"
+  - "[ ] Tempo estimado de leitura confere com a duracao do roteiro original"
+  - "[ ] Enfase e pausa marcadas onde o roteiro original pedia"
 ---
 
-# Task: create-teleprompter-script
-
-## Metadata
-- **Agent:** production-director (Lens)
-- **Squad:** squad-courses
-- **Complexity:** STANDARD
+# Task: Criar script de teleprompter
 
 ## Objetivo
-Criar script de teleprompter
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Reformatar o roteiro aprovado em texto pronto para leitura em teleprompter, mantendo contato visual sem soar robótico.
+
+## A regra que governa
+Frase que não cabe numa respiração vira frase quebrada no teleprompter — a quebra é decisão do roteiro escrito, não de quem está lendo ao vivo.
+
+## Passos
+
+1. **Partir do roteiro já aprovado.** Esta task não reescreve conteúdo — ela reformata para leitura. Se o conteúdo precisa mudar, a correção volta pra `write-video-script`.
+
+2. **Quebrar cada frase em linhas curtas**, cortando nas pausas naturais de respiração — no máximo 10–12 palavras por linha.
+   ⚠️ **Nunca quebrar no meio de um número, nome próprio ou termo técnico.** Isso força soletração truncada e é o erro mais comum de teleprompter mal formatado.
+
+3. **Marcar ênfase e pausa.** Onde o roteiro original tinha `[PAUSE]` ou pedia destaque numa palavra, marque explicitamente no texto de leitura — quem lê não decide isso na hora, decide antes.
+
+4. **Remover as marcações de produção do texto de leitura.** `[CAMERA]`, `[SLIDE: título]`, `[SCREEN: app]` saem do que aparece na tela do teleprompter — quem lê só precisa da fala. Mantenha essas marcações numa nota lateral, para quem opera a gravação, não para quem lê.
+
+5. **Calcular o tempo de leitura.** 130–150 palavras por minuto é o ritmo de fala pausada e natural — mais lento que leitura silenciosa. Use esse número para conferir se o tempo de leitura bate com a duração do roteiro original.
+   ⚠️ **Se não bater, o problema é do roteiro, não da velocidade de leitura.** Nunca ajuste pedindo pra ler mais rápido — isso é o mesmo erro que o roteiro tenta evitar. A frase longa demais volta pra `write-video-script` pra ser cortada.
+
+6. **Formatar como texto pronto para qualquer software de teleprompter** — físico, aplicativo de celular, ou plugin de gravação. Tamanho de fonte e velocidade de rolagem ficam a critério da ferramenta escolhida por quem grava; esta task entrega o texto, não a configuração do aparelho.
+
+## Formato da saída
+Documento com o texto do roteiro quebrado em linhas curtas, marcações de ênfase (negrito) e pausa (`[PAUSA]`) explícitas, sem marcações de produção, com contagem de palavras e tempo estimado de leitura por seção.
+
+## O que não vale
+- Colar o roteiro inteiro sem quebra de linha — quem lê perde o lugar no meio da frase.
+- Manter `[CAMERA]` / `[SLIDE]` no texto que aparece na tela de leitura.
+- Quebrar linha no meio de um dado, nome ou termo técnico.
+- Resolver descompasso de tempo pedindo leitura mais rápida em vez de cortar o roteiro.
+
+## Fontes no squad
+`video-script-template.md` (formato base do roteiro), `video-production-guide.md` (regra de ritmo — falar 15–20% mais devagar do que parece necessário).

package/squads/squad-courses/tasks/create-workshop-materials.md

@@ -17,30 +17,47 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Nenhum bloco de conteúdo passa de 30 min sem interação"
+  - "[ ] Deck, handout e lista de exercícios entregues juntos, não só o deck"
+  - "[ ] Handout segue a ordem do deck, seção por seção"
+  - "[ ] Handout tem pré-avaliação e espaço físico de escrita, não só teoria"
 ---
 
-# Task: create-workshop-materials
-
-## Metadata
-- **Agent:** slide-designer (Deck)
-- **Squad:** squad-courses
-- **Complexity:** STANDARD
+# Task: Criar materiais de workshop
 
 ## Objetivo
-Criar materiais de workshop
-
-## Steps
-1. Receber inputs e contexto do curso
-2. Executar operacao principal
-3. Validar output contra criterios pedagogicos
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Alinhado aos learning outcomes
-- Nivel adequado para audiencia
-- Formato consistente com tipo de curso
-- Pronto para proxima fase
+Montar o pacote completo de um módulo de workshop — deck de slides, handout do aluno e lista de exercícios com tempo — como um único material coerente, não um deck avulso.
+
+## A regra que governa
+**Bloco de conteúdo sem interação a cada 30 minutos não é workshop, é palestra com nome errado.** `knowledge-base/course-format-patterns.md` fixa essa régua ("Workshop" — Timing rule: "No content block longer than 30 minutes without interaction"). O material do workshop existe para forçar esse ritmo.
+
+## Passos
+
+1. **Checar a régua de 30 min contra o outline recebido.** Se o outline de `create-presentation-outline` tem uma seção maior que 30 min sem um slide de exercício no meio, o problema se resolve aqui, quebrando o bloco — não avançando com ele intacto.
+
+2. **Kit de 3 peças por módulo, não 1.** Deck de slides + handout do aluno + lista de exercícios com tempo e formato de entrega. Um deck de workshop sozinho, sem handout, é material de mentoria — a interação física com papel é o que diferencia o formato.
+
+3. **Handout a partir de `templates/workbook-template.md`.** Pré-avaliação no início do módulo (aluno se autoavalia de 1 a 5 antes de começar), espaço físico para as respostas de reflexão (5-8 linhas por prompt, conforme o template), e um "fill in the blanks" do framework central da seção.
+
+4. **Slide de exercício aponta para a página do handout.** "Handout, página 4" no próprio slide — sem esse ponteiro, o aluno perde o material físico no meio do exercício e a pausa de 30 min vira busca de página, não prática.
+
+5. **Debrief sempre em slide próprio**, nunca fundido com o slide do exercício — mesma regra de `design-interactive-elements`, reforçada aqui porque workshop tem debrief ao vivo com grupo, e precisa de espaço visual para isso.
+
+6. **Listar as ferramentas de facilitação quando o workshop é remoto.** `knowledge-base/course-format-patterns.md` cita Miro/Figma board, breakout rooms e polls como parte do kit — não esconder isso no material impresso, porque quem facilita remoto depende dessa lista tanto quanto do deck.
+
+## Formato da saída
+Pacote nomeado com 3 componentes:
+```
+Deck: [arquivo/link do deck de slides]
+Handout: [arquivo/link do handout, a partir do workbook-template]
+Exercícios: lista com tempo e entrega de cada um, na mesma ordem do deck
+```
+
+## O que não vale
+- Workshop entregue só com o deck, sem handout.
+- Bloco de 45+ min sem pausa para exercício.
+- Handout numa ordem diferente da do deck — força quem facilita a traduzir na hora.
+- Handout que é só teoria, sem espaço para o aluno escrever.
+
+## Fontes no squad
+`knowledge-base/course-format-patterns.md`, `templates/workbook-template.md`, `templates/presentation-template.md`.