Fluxo de Git e release

Branches (Git Flow)

Branch	Uso
main	Produção
develop	Integração
feature/<nome>	Funcionalidades, a partir de develop
release/<versão>	Preparação de versão
hotfix/<versão>	Correção urgente, a partir de main

Commits

Use Conventional Commits: feat:, fix:, docs:, refactor:, test:, chore:, com escopo opcional (feat(studio): …).

Pull requests

Há templates em .github/PULL_REQUEST_TEMPLATE/ (padrão, simples e hotfix). Checklist mínimo:

• Testes passando.
• Documentação atualizada em apps/docs quando o comportamento mudar.
• Novo ADR quando uma decisão de arquitetura mudar.

Versão

O monorepo tem uma versão só para a raiz e todos os apps e pacotes (ADR-0016).

1. pnpm release:bump-version lê a última mensagem de commit e calcula o incremento: !/BREAKING CHANGE → major; feat/chore → minor; fix, docs, style, refactor → patch.
2. O script aplica a versão a todos os package.json (scripts/sync-versions.mjs), cria o commit chore(release): X.Y.Z e a tag vX.Y.Z.
3. Registre a versão no Changelog da documentação (uma página por versão) e no CHANGELOG.md da raiz, e retire do backlog e da limpeza técnica o que foi concluído.

pnpm versions:check confere se todos os workspaces estão na mesma versão. Para definir uma versão manualmente: node scripts/sync-versions.mjs 2.3.0.