Fluxo de Desenvolvimento
Visao geral do ciclo integrado Linear, GitHub e Claude Code
O desenvolvimento da Vendee segue um fluxo integrado entre tres ferramentas:
- Linear — gestao de backlog e issues (fonte da verdade do que precisa ser feito)
- GitHub — repositorio de codigo 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 le via MCP]
B --> C[Implementa o codigo]
C --> D[Abre PR no GitHub]
D --> E[Linear atualiza status]Etapas
Escolher a proxima issue
No Linear, selecione a proxima issue por project e prioridade. Issues com status Todo estao prontas para desenvolvimento.
Abrir o Claude Code
No terminal, dentro do repositorio, abra o Claude Code e peca para implementar a issue:
Pega a issue CRM-12 e implementaLeitura da issue
O Claude Code le a issue completa via MCP — titulo, descricao e criterios de aceite. Se os criterios estiverem vagos, ele pergunta antes de codar.
Criar branch
Branch no formato padrao:
feat/<ISSUE-ID>-descricao-curtaExemplo: feat/CRM-12-custom-fields
Implementar
O Claude Code segue as convencoes definidas no CLAUDE.md: arquitetura de features, hooks, shadcn/ui, TanStack Query, etc.
Commit
Formato convencional com ID da issue:
feat|fix|refactor: descricao curta (ISSUE-ID)Exemplo: feat: add custom fields to deal form (CRM-12)
Abrir PR
Pull Request apontando para main com Closes ISSUE-ID na descricao para acionar as automacoes do Linear.
Automacao de status
O Linear move automaticamente conforme o estado do PR:
| Evento GitHub | Status Linear |
|---|---|
| PR aberto | In Progress |
| Review requested | In Review |
| PR mergeado | Done |
| PR revertido | Reabre a issue |
Para issues grandes (modulos inteiros), peca primeiro a proposta de arquitetura ao Claude Code, valide antes de codar, e implemente em etapas dentro do mesmo branch/PR.