Fluxo de contribuição

Este repositório favorece pull requests estreitos e revisáveis em vez de grandes reescritas de plataforma.

Fluxo padrão

Abra ou confirme uma issue primeiro se a mudança afetar comportamento, arquitetura ou política de contribuidores.
Crie uma branch ou worktree focada.
Implemente a menor fatia completa que possa ser revisada isoladamente.
Atualize a documentação em apps/docs para mudanças de comportamento visíveis ao usuário ou ao contribuidor.
Atualize as notas de nível de repositório em docs/*.md quando a mudança afetar arquitetura, CI/CD, migration ou postura operacional.
Execute o conjunto de verificação local antes de pedir review.

pnpm lint
pnpm docs:lint
pnpm typecheck
pnpm test
pnpm build

Use execuções direcionadas ao restringir falhas:

pnpm --filter app test
pnpm --filter api test
pnpm --filter control-plane test
pnpm --filter worker test

Quando uma branch vai durar mais do que uma correção rápida, prefira um worktree separado. Veja Worktrees.

misturar refatorações não relacionadas em um PR de funcionalidade
mudar contratos de rota sem atualizar a documentação
publicar na documentação afirmações de arquitetura que o código ainda não cumpre
combinar mudanças amplas de dependências com mudanças de comportamento de produto