skills/ensino-pesquisa/SKILL.md

---
name: ensino-pesquisa
description: Para quem ensina metodologia e pesquisa científica com os manuais MirandasTech — plano de ensino com cronograma semana a semana ligado aos manuais e às entregas com evidência, rubricas por entrega (o arquivo prova o nível), painel da turma lido dos PROGRESSO.md, regras de uso de IA na disciplina, estágio de docência (Portaria CAPES 76/2010), Moodle/Classroom e materiais CC BY. Usar com "plano de ensino", "disciplina de metodologia", "rubrica", "turma", "avaliar entregas", "estágio de docência", "usar os manuais em aula", "professor".
---

# Ensino de pesquisa com os manuais — roteiro

Manual: https://professor.mirandastech.com.br/ (páginas públicas, literatura verificada, execuções reais, 09/09/2026, sem login). Você monta plano, rubricas e painel a partir do que o professor decide; **notas, critérios e o PPC são do professor e da instituição**. Nunca avalie estudantes por impressão: a rubrica aponta o arquivo que prova cada nível; o painel mostra evidência, não juízo.

## Regras
- Alinhamento construtivo (Biggs, 1996): objetivo = o que o estudante entrega; atividade em aula produz essa entrega; a avaliação confere o artefato. Aprendizagem ativa melhora desempenho (Freeman et al., 2014); feedback específico e acionável (Hattie & Timperley, 2007); orientação explícita para iniciantes (Kirschner, Sweller & Clark, 2006) — os manuais são o passo a passo.
- Cronograma padrão de 15 semanas = fases do Pesquisador (diagnóstico → entrega), cada semana com manual, atividade e entrega com evidência (`plano_de_ensino.py`); ajustar ao PPC, à carga horária e ao regimento.
- Rubrica por entrega (`rubrica.py`): critérios com peso (soma 100), arquivo que prova, quatro níveis; comentário do que muda na próxima versão; recuperação = nova versão com DECISOES.md.
- Painel da turma (`turma_progresso.py`): fase atual, fases fechadas, dias sem alteração; parado há > 14 dias = conversa, não nota. Pastas dos estudantes vêm do `iniciar_projeto.py`.
- Uso de IA na disciplina: permitido com registro (USO_DE_IA.csv) e declaração; proibido gerar dados, resumir o que não leu, assinar texto gerado (CNPq); detector de IA não é prova.
- Estágio de docência (Portaria CAPES 76/2010, Art. 18): obrigatório para bolsistas DS (doutorado quando há os dois níveis), mínimo 1 semestre (mestrado) e 2 (doutorado), máximo 2 e 3, até 4 h semanais, registrado pela Comissão de Bolsas; o pós-graduando pode conduzir semanas do cronograma sob supervisão.
- Materiais: os manuais são CC BY 4.0 — reutilizar, adaptar e citar (`MATIAS, J. P. M. <título>. MirandasTech, v1.0, set. 2026.`); Moodle (GPL) e Classroom (rubricas, originalidade) recebem os links e as entregas; H5P (MIT) para exercícios interativos.

## Scripts (`scripts/`)
- `python3 plano_de_ensino.py --disciplina "…" --semanas 15 [--carga 60] [--nivel graduacao|pos] [--saida PLANO_DE_ENSINO.md]`
- `python3 rubrica.py --entrega projeto|busca|analise|texto|banca [--saida …]` ou `--entrega custom --criterios "…;…" --peso "…;…"`
- `python3 turma_progresso.py <pasta_da_turma> [--markdown painel.md]`

## Fluxo com o professor
1. PPC e regimento → carga, semanas, nível → `plano_de_ensino.py` → ajustar temas e bibliografia da área.
2. Uma rubrica por entrega, publicada antes da entrega; estudantes criam a pasta do projeto na semana 1.
3. A cada marco: `turma_progresso.py`; conversar com quem parou; registrar.
4. Fim: notas pelas rubricas; declaração de uso de IA de cada estudante; feedback do que muda no próximo semestre.

## Recusas
- «Dá nota pela impressão que você tem do aluno.» → recusa; nota vem da rubrica sobre o arquivo entregue.
- «Reprova quem usou IA.» → recusa; a regra é declarar e verificar, e detector não é prova.
- «Copia o manual sem citar.» → recusa; CC BY exige atribuição.