GitHub — Convencoes

Repositorio

vendee-turborepo (privado) — hospedado na organizacao usevendee.

Branch Strategy

Branch	Uso
`main`	Branch de producao — sempre deployavel
`feat/<ISSUE-ID>-descricao`	Nova funcionalidade
`fix/<ISSUE-ID>-descricao`	Correcao de bug
`refactor/<ISSUE-ID>-descricao`	Refatoracao

Sem branch develop ou staging. O fluxo e direto: feature branch → PR → main.

Commit Messages

Formato convencional com ID da issue:

<prefixo>: descricao curta (ISSUE-ID)

Prefixos validos:

Prefixo	Uso
`feat`	Funcionalidade nova
`fix`	Correcao de bug
`refactor`	Refatoracao sem mudanca de comportamento
`chore`	Tarefas de infra, build, deps
`docs`	Alteracoes de documentacao
`style`	Formatacao, espacos, ponto-e-virgula
`test`	Adicionar ou corrigir testes

Exemplos:

feat: add activity status border to deal card (CRM-1)
fix: deal card badge not updating on stage change (CRM-2)
refactor: extract pipeline filters into hook (CRM-4)

PR Template

## What
Brief description of what was implemented.

## Issue
Closes CRM-XX

## How to test
Steps to verify the implementation manually.

Regras

Uma issue = um branch = um PR. Nunca misturar issues no mesmo branch.
PR sempre aponta para main
Incluir Closes <ISSUE-ID> na descricao para as automacoes do Linear funcionarem
Nunca fazer push direto na main
Antes de abrir PR, verificar:

bun run check-types      # TypeScript
bun run lint             # ESLint (zero warnings)
bun run build            # Build completo

O texto Closes CRM-XX na descricao do PR e o que aciona a automacao no Linear para mover a issue para Done quando o PR for mergeado.