Fluxo de Desenvolvimento

O desenvolvimento da Vendee segue um fluxo integrado entre três ferramentas:

Linear — gestão de backlog e issues (fonte da verdade do que precisa ser feito)
GitHub — repositório de código e pull requests
Claude Code — assistente de desenvolvimento com IA, conectado ao Linear via MCP

Diagrama do Fluxo

graph LR
    A[Issue no Linear] --> B[Claude Code lê via MCP]
    B --> C[Implementa o código]
    C --> D[Abre PR no GitHub]
    D --> E[Linear atualiza status]

Etapas

Escolher a próxima issue

No Linear, selecione a próxima issue por project e prioridade. Issues com status Todo estão prontas para desenvolvimento.

Abrir o Claude Code

No terminal, dentro do repositório, abra o Claude Code e peça para implementar a issue:

Pega a issue CRM-12 e implementa

Leitura da issue

O Claude Code lê a issue completa via MCP — título, descrição e critérios de aceite. Se os critérios estiverem vagos, ele pergunta antes de codar.

Implementar

O Claude Code segue as convenções definidas no CLAUDE.md: arquitetura de features, hooks, shadcn/ui, TanStack Query, etc.

Commit

Formato convencional com ID da issue:

feat|fix|refactor: descrição curta (ISSUE-ID)

Exemplo: feat: add custom fields to deal form (CRM-12)

Pull Request apontando para main. No corpo do PR, use Ref CRM-XX (não Closes) para vincular a issue. O Linear acompanha o status do PR via integração com GitHub, mas a issue só vai para Done quando alguém testa e aprova manualmente.

Status do Linear

A integração GitHub → Linear move a issue conforme os eventos do PR:

Evento	Status
Branch criada	In Progress
PR aberto	In Progress
PR mergeado	In Review
Rodrigo testa e aprova	Done (manual)

O merge sozinho não fecha a issue. O responsável precisa testar na Vercel preview (ou local) e mover para Done à mão.

Nunca empurrar direto na main. Sempre branch + PR. Uma issue = uma branch = um PR.

Para issues grandes (módulos inteiros), peça primeiro a proposta de arquitetura ao Claude Code, valide antes de codar, e implemente em etapas dentro do mesmo branch/PR.