Git e commits

Git e commits

Fluxo de branches

O Manifesto usa um fluxo leve: a develop é a branch de trabalho.

• develop é onde se trabalha no dia a dia. Pode commitar direto na develop — não há PR obrigatório.
• Pull Requests são opcionais: use quando quiser revisão ou ao integrar trabalho de mais de uma pessoa. Não são exigência.
• main (quando existir) guarda releases estáveis. Promover develop → main é decisão por projeto, não um portão fixo.

Commits

• Conventional Commits obrigatório (feat:, fix:, docs:, refactor:, …).
• O código é guiado pela ADR; referenciar a ADR no commit é opcional.
• Commits que alteram a documentação de uma ADR podem usar o prefixo adr/.
• Commit seletivo: prefira não usar git add . quando houver arquivos fora do escopo.

Regras duras de git

Poucas, e só as que evitam estrago:

• Não usar git reset --hard nem git push --force sobre trabalho compartilhado.
• Não usar --no-verify para furar hooks de qualidade.

Recomendações

• 1 task = 1 commit (pode conter várias subtarefas) — recomendação que mantém o histórico limpo e rastreável, não regra dura.
• SemVer + tags nas releases: decisão por projeto.
• Hooks de pré-commit (husky/lefthook) e CI: opcionais, nascem em ADR quando úteis.