Protocolo de Versionamento Pedagógico
Um protocolo aberto para tratar planos de aula como artefatos pedagógicos versionados.
O PVP define um fluxo mínimo para que o professor numere versões, registre mudanças e preserve o histórico, o contexto e a proveniência de cada plano. Cada melhoria incorporada gera uma nova versão rastreável.
- Versão atual
- Core 1.0
- Status
- Versão publicada
- Data
- 4 de março de 2026
- Licença
- CC BY 4.0
Exemplo de uso
Como uma aula acumula versões.
O protocolo mantém a mudança e seu contexto legíveis. Este quadro é ilustrativo e não representa resultado de pesquisa.
Aplicar este fluxo com o Kit Inicial →Exemplo ilustrativo
PAV / Plano de aula
Equação do 2º grau
Histórico de versões
- v1.0.0E0Plano inicial, nunca aplicado
- v1.1.0E1Redistribuiu o tempo da exposição
- v1.2.0E1Trocou o exemplo de abertura
- v1.3.0E2Exemplo-ponte antes do problemaVersão atual
- O que mudou
- Inseriu exemplo de ligação entre Bhaskara mecânico e problema contextualizado.
- Por que mudou
- A transição direta pulava uma etapa cognitiva.
- Sinal de sala
- Registro ilustrativo: “70% travaram na transição”.
Os números deste exemplo não representam resultado de pesquisa nem demonstram aprendizagem.
Todo professor sai da aula sabendo o que faria diferente.
Esse pensamento dura segundos e desaparece. Sem registro, todo ano recomeça do zero.
Conhecimento prático é volátil
O professor trabalha ~9,3 horas por semana em planejamento (OECD TALIS, 2024), mas as melhorias descobertas em sala ficam tácitas e somem com a rotatividade, a aposentadoria ou a troca de escola.
O software resolveu isso em 2005
O controle de versão transformou o código de arquivo sobrescrito em artefato com memória. O PVP transpõe essa ideia ao plano de aula: mínimo, semântico e acumulável.
Cinco regras. Três entidades. Um registro breve.
Um protocolo, não metodologia, framework ou sistema. Seguiu as cinco regras, está usando o PVP.
Versão explícita
Todo plano de aula carrega um número de versão no formato X.Y.Z ou X.Y.
Mudança registrada
Toda melhoria vira um Registro de Melhoria: o que mudou, por que, e qual sinal de sala motivou.
Contexto declarado
O plano declara série, tempo de aula, recursos e perfil da turma.
Registro mínimo
Cada mudança preserva ao menos um sinal de sala observado, em vez de uma justificativa apenas teórica.
Proveniência preservada
Histórico e autoria permanecem rastreáveis. Versões antigas são substituídas, nunca apagadas.
Plano de Aula Versionado
Registro de Melhoria
Variação Contextual
O artefato, a mudança, a variação.
Versionamento semântico pedagógico
XMajor- Reestruturação significativaabordagem, público-alvo ou sequência
YMinor- Evolução dentro da mesma estruturaatividade, exemplo ou tempo
ZPatch- Refinamento localizadolink, instrução ou enunciado
Ao incrementar X, Y e Z voltam a zero; ao incrementar Y, Z volta a zero. O formato X.Y também é aceito.
No nome do arquivo
A versão também pode ficar visível no próprio artefato:
plano-equacao-2grau-v1.3.0.pdfConvenção opcional: o nome identifica a versão; o RM registra o que mudou, por que mudou e o sinal de sala.
Maturidade de uso documentado
- E0 Rascunho - sem aplicação documentada
- E1 Aplicado uma vez - uma aplicação documentada
- E2 Aplicado 2+ vezes - duas ou mais aplicações documentadas
- E3 Multicontexto - variação contextual documentada
A notação segue a versão: v3.2.1 - E3. E0-E3 descreve maturidade de uso documentado, não qualidade, eficácia ou aprendizagem.
Melhoria puxada pela sala, não empurrada por uma plataforma.
- 1
Sinal de sala
Você observa algo real, por exemplo: “70% travaram na questão 3” ou “o fundo da sala engajou quando troquei por um exemplo concreto”. São exemplos ilustrativos, não resultados de pesquisa.
- 2
Registro de Melhoria
Você escreve o que mudou, por quê e qual sinal motivou. A referência de 90 segundos é uma estimativa de desenho ainda não validada, não um resultado medido.
- 3
Nova versão
O plano é versionado: v1.2.0 → v1.3.0. Seu registro de uso pode ser atualizado quando aplicável e as versões anteriores permanecem rastreáveis.
Quatro camadas. Cada uma funciona sozinha.
A camada 1 é suficiente. Comece com caneta e caderno; escale só se quiser.
Essencial
Preencha um Registro de Melhoria com 3 campos após a aula. A referência de 90 segundos é uma estimativa de desenho ainda não validada.
Caneta e cadernoEstruturado
Canvas PVP, organização em planilha, histórico formal.
Canvas impresso ou planilhaColaborativo
Compartilhamento institucional, contribuições entre pares, curadoria.
Repositório compartilhadoPlataforma
Sistema digital com automações, busca e análise de dados.
Plataforma web/appGit → PVP
O protocolo transpõe as ideias centrais do controle de versão para a realidade do planejamento. Ver os oito mapeamentos →
| Git | PVP | Função |
|---|---|---|
| Repository | PAV | Artefato versionado |
| Commit | RM | Registro atômico de mudança |
| Branch | VC | Variação para outro contexto |
| Semantic Versioning | Versionamento Pedagógico | Convenção X.Y.Z |
| Pull Request | Contribuição | Proposta de melhoria (curadoria humana) |
| Automated tests | Sinais de sala | Uso documentado, não teste de eficácia |
O que diverge: o PVP exige um sinal de sala, funciona sem tecnologia, aceita linguagem natural e integra apenas por curadoria humana.
Uma especificação formal com agenda de pesquisa.
Cite a Core 1.0
O Core possui depósito aberto com DOI e registro na OSF. O acervo local documenta obra depositada e taxa paga na Biblioteca Nacional; o deferimento final permanece pendente de confirmação.
Protocolo, não plataforma. Gizhub é uma futura implementação digital em desenvolvimento. O PVP também pode ser usado com papel, planilhas, documentos ou outras plataformas.