| name | create-complete-lesson |
| description | Criar, completar, revisar e validar aulas deste curso, incluindo slides HTML interativos, material wiki, navegação offline, coerência com o cronograma e testes de conformidade. Usar ao implementar uma aula real, transformar placeholders em conteúdo completo ou auditar o padrão de uma aula existente. |
Criar uma aula completa
Fluxo obrigatório
- Ler
index.html e localizar no array aulas o número, data, tema e tag.
- Ler integralmente
../design_system/SKILL.md, ../generate_slide_placeholder/SKILL.md e ../generate_material_placeholder/SKILL.md.
- Ler references/lesson-standard.md e planejar objetivos, sequência, prática e evidências de aprendizagem antes de editar.
- Atualizar
slides/aula-XX.html e materiais/aula-XX/index.html como um par coerente. Não deixar placeholders, marcadores TODO nem links para diretórios.
- Executar
python3 .agents/skills/create-complete-lesson/scripts/validate_lesson.py --lesson XX --complete.
- Executar
python3 -m unittest discover -s tests -v.
- Executar
npm run test:e2e para validar no Chromium as páginas inicial, slides e material em desktop e mobile. Percorrer os slides por botões e teclado, verificar links, overflow e erros de console.
- Ler e aplicar
../update-course-index/SKILL.md para atualizar e validar index.json somente depois que a aula passar nas validações anteriores.
- Ler e aplicar
../trunk-based-git/SKILL.md: commitar a aula direto em main, em commits pequenos e descritivos, e publicar com git push origin main. Não criar branch para a aula.
Regras de autoria
- Escrever em português do Brasil, com exemplos aplicados a Administração e decisões de negócio.
- Assumir GitHub Codespaces + Jupyter como ambiente do estudante, com dependências já instaladas por
requirements.txt. Não instruir Google Colab, Google Drive nem instalação manual de Python.
- Tratar
git commit e git push como a forma oficial de entregar e persistir o trabalho do estudante.
- Preferir cases do domínio de saúde e gestão hospitalar quando o tema permitir, mantendo dados sintéticos e cuidado com privacidade.
- Tratar slides como apoio visual: uma ideia principal por tela, texto escaneável e código legível.
- Tratar o material como referência autônoma: aprofundar conceitos, explicar código e incluir boas práticas.
- Manter os mesmos título, objetivos, conceitos e atividade nas duas superfícies.
- Incluir na aula completa: objetivos observáveis, agenda, contexto, conceitos, prática guiada, desafio/entrega, síntese e próximos passos.
- Preservar navegação
file:// com caminhos terminados em .html.
Validação
Usar o validador incluído para verificações estruturais e de completude. Sem --complete, ele aceita placeholders estruturalmente íntegros; com --complete, exige o ciclo didático integral descrito na referência. Corrigir todas as falhas antes de concluir.