Entregas versionadas

Cada entrega do hackathon é uma tag anotada no git, com o prefixo da equipe (token-economy/) porque o repositório oficial da OAB/PR é compartilhado entre equipes. Docs, arquitetura, prompts e código de cada entrega ficam congelados na tag; o trabalho continua em main. A evidência de cada entrega vai na pasta correspondente em evidence/, com um MANIFEST.md que aponta a tag e o commit.

Como fechar uma entrega

# 1. tudo commitado em main (Conventional Commits, inglês)
# 2. preencher a seção da versão em CHANGELOG.md (o script cria o esqueleto a partir dos commits)
scripts/tag-delivery.sh token-economy/v0.2.0 "Entrega 2: V1 com testes internos"
# 3. escrever evidence/0N-.../MANIFEST.md com tag, commit, hora e lista dos arquivos de evidência
# 4. push no repositório oficial (a pasta da equipe já é o lugar do trabalho)

Como consultar

git tag -n9                          # lista as entregas com a mensagem
git checkout token-economy/v0.2.0    # estado exato da entrega 2
git diff token-economy/v0.1.0..token-economy/v0.2.0 --stat   # o que mudou entre a 1 e a 2
git diff token-economy/v0.1.0..token-economy/v0.2.0 -- docs/ # só a documentação
git log token-economy/v0.1.0..token-economy/v0.2.0 --oneline # commits da entrega 2

Versão nos documentos

Os documentos não carregam número de versão no texto: a versão é a tag. Um documento alterado depois de uma entrega aparece no git diff entre tags. CHANGELOG.md resume, por entrega, o que mudou em docs, arquitetura, prompts e código.