Protocolo de Versionamento PedagógicoProtocolo aberto / Core 1.0
Menu
ComeçarProtocoloCore 1.0CitarLicençaSobreEnglish

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.

Começar a usar o PVPLer a especificação
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

  1. v1.0.0E0Plano inicial, nunca aplicado
  2. v1.1.0E1Redistribuiu o tempo da exposição
  3. v1.2.0E1Trocou o exemplo de abertura
  4. v1.3.0E2Exemplo-ponte antes do problemaVersão atual
Registro de Melhoriav1.2.0 → v1.3.0
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.

Por que versionar

Quando um plano muda, o arquivo não pode apagar sua história.

Planos mudam por causa da turma, do tempo, dos recursos e do que se observa em sala. Sem uma versão explícita, fica difícil saber qual arquivo foi aplicado, o que mudou e por que aquela decisão fazia sentido.

Exemplo ilustrativoO mesmo plano de aula em dois estados documentais. Os nomes, a turma e as mudanças abaixo servem apenas para demonstrar a leitura.

Sem rastreamento

O conteúdo existe, mas sua história depende do nome do arquivo.

Registro disponível?

Plano de aula

Equação do 2º grau

Turma
2º ano
Duração
50 min
Modalidade
Presencial
Arquivo presumido como atualplano-final-agora-vai.docx
Versão
Não indicada
Plano anterior
Não identificado
Mudança
Não registrada
Aplicação
Não se sabe qual cópia foi usada
Cópias encontradas
  1. plano-final.docx
  2. plano-final-corrigido.docx
  3. plano-final-agora-vai.docx

Com PVP

Estado, mudança, contexto e origem ficam legíveis.

Plano de Aula Versionado (PAV)v1.1.0E1

Plano de aula

Equação do 2º grau

Turma
2º ano
Duração
50 min
Modalidade
Presencial
Arquivo identificadoplano-equacao-2grau-v1.1.0.docxOrigem: PAV v1.0.0
RM 001
O que mudou
O exemplo abstrato inicial foi substituído por uma situação concreta.
Por que mudou
Facilitar a entrada da turma na atividade.
Sinal de sala
Parte da turma interrompeu a atividade na abertura abstrata.
Históricov1.0.0 → RM 001 → v1.1.0

Versionar não é criar cópias sem fim. É conseguir localizar um estado, explicar a mudança e preservar a continuidade do trabalho.

O que é um PAV? É o Plano de Aula Versionado: o próprio plano, em papel ou arquivo, identificado por uma versão e ligado ao seu histórico de mudanças. No Core 1.0, é o PAV — e não cada material relacionado — que recebe a versão. Slides, fichas e outros arquivos podem indicar a versão do PAV a que pertencem; versões PVP independentes para cada material ainda não são uma regra do Core.

Cinco regras. Três entidades. Um registro breve.

Um protocolo, não uma metodologia, framework ou sistema. Seguiu as cinco regras, está usando o PVP.

  1. Regra 01

    Versão explícita

    Todo plano de aula carrega um número de versão no formato X.Y.Z ou X.Y.

  2. Regra 02

    Mudança registrada

    Toda melhoria vira um Registro de Melhoria: o que mudou, por que mudou e qual sinal de sala motivou.

  3. Regra 03

    Contexto declarado

    O plano declara série, tempo de aula, recursos e perfil da turma.

  4. Regra 04

    Evidência mínima

    Cada mudança preserva ao menos um sinal de sala observado, em vez de uma justificativa apenas teórica.

  5. Regra 05

    Proveniência preservada

    Histórico e autoria permanecem rastreáveis. Versões antigas são substituídas, nunca apagadas.

Entidades do protocolo

PAVPlano de Aula Versionado
O plano com versão explícita, contexto e histórico.
RMRegistro de Melhoria
O registro do que mudou, por que mudou e qual sinal motivou.
VCVariação Contextual
A adaptação para outro contexto, ligada de forma rastreável ao plano-base.
Ficha de notação

Como ler v3.2.1 · E3

A versão e o nível E aparecem juntos, mas respondem a perguntas diferentes.

Versão pedagógica

Qual estado do plano é este?

X.Y.Z

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.pdf

Convenção opcional: o nome identifica a versão; o RM registra o que mudou, por que mudou e o sinal de sala.

Uso documentado

Quanto do uso do plano foi documentado?

  • E0Rascunhosem aplicação documentada
  • E1Aplicado uma vezuma aplicação documentada
  • E2Aplicado 2+ vezesduas ou mais aplicações documentadas
  • E3Multicontextovariação contextual documentada
Exemplo de leiturav3.2.1 · E3

Versão 3.2.1 do plano, com uso multicontexto documentado.

A versão descreve o estado e o tipo de mudança. E0–E3 descreve uso documentado. Nenhuma das duas notações é nota de qualidade ou comprovação de aprendizagem.

Melhoria puxada pela sala, não empurrada por uma plataforma.

  1. 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. 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. 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.

Camada 1

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 caderno
Camada 2

Estruturado

Canvas PVP, organização em planilha, histórico formal.

Canvas impresso ou planilha
Camada 3

Colaborativo

Compartilhamento institucional, contribuições entre pares, curadoria.

Repositório compartilhado
Camada 4

Plataforma

Sistema digital com automações, busca e análise de dados.

Plataforma web/app
A origem da transposição

Do controle de versão ao planejamento pedagógico.

O PVP se inspira em um princípio usado no desenvolvimento de software: identificar estados, explicar mudanças e preservar o histórico de um trabalho que evolui.

Na tecnologia

O que o Git ajuda a resolver

Git é um sistema de controle de versão: uma memória organizada de um projeto. Em vez de depender de nomes como “final-2”, ele permite localizar estados sucessivos, comparar alterações e recuperar uma referência anterior.

Estado identificado
cada referência do projeto pode ser localizada e comparada
Mudança registrada
a alteração fica relacionada a um registro legível
Histórico recuperável
o estado atual não apaga os estados anteriores
Na transposição pedagógica

O que o PVP adapta

O PVP transpõe essa lógica, não os comandos. O plano torna-se um PAV com versão, contexto e histórico; a melhoria recebe um RM; e uma adaptação para outro contexto pode ser registrada como VC.

PAV
mantém o estado do plano, seu contexto e sua linha de versões
RM
explica o que mudou, por que mudou e qual sinal motivou a decisão
VC
preserva o vínculo entre uma adaptação e o plano que lhe deu origem

Correspondências essenciais

A tabela resume a inspiração conceitual. O professor não precisa reproduzir a infraestrutura do desenvolvimento de software.

Ver o mapeamento formal completo no Core 1.0 →

Deslize horizontalmente para ver todas as colunas.

Controle de versãoPVPO que se preserva
RepositoryPAVO artefato e seu histórico
CommitRMA mudança concreta e sua justificativa
BranchVCA adaptação ligada a um plano-base
Semantic VersioningVersionamento PedagógicoO estado e o tipo de mudança
ChangelogHistórico de versõesA sequência cronológica de alterações
PesquisaPágina em preparação

Uma especificação formal com agenda de pesquisa.

O PVP Core 1.0 é uma especificação de protocolo. Está prevista uma revisão de escopo para mapear conceitos, métodos, protocolos e sistemas relacionados ao versionamento, à adaptação e à proveniência no planejamento pedagógico. Essa revisão mapeia antecedentes; não valida empiricamente o PVP. Qualquer estudo empírico posterior será declarado separadamente.

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.

10.5281/zenodo.18874305Formatos de citação →