vStack — Estrutura
Times, projetos, etiquetas e estados do board que a Vendee usa de verdade
O board da casa é o vStack, acessado pelo Claude Code via MCP (cockpit). É lá que todo trabalho novo nasce.
O Linear saiu. Ele segue conectado apenas para trabalho legado em finalização — nada novo é criado lá. Se você encontrar documentação, script ou hábito que aponte para o Linear, é resíduo.
Projetos
O recorte que importa no dia a dia:
| Projeto | O que carrega |
|---|---|
| V2 - CRM Core | o trabalho de produto do CRM — é o padrão para issue nova |
| Posthog | itens vindos de erro capturado em produção |
| 📥 Feedback Cliente | o que chega pelo widget de feedback dentro do app |
Etiquetas
Três, e uma issue leva pelo menos uma: bug, melhoria, posthog.
Pegadinha do MCP: label_ids substitui a lista inteira de etiquetas da issue. Omitir o campo mantém o que já estava; mandar uma lista parcial apaga o resto.
Estados do board
| Estado | Quando entra | Quem move |
|---|---|---|
| Todo | issue criada e priorizada, ou devolvida por estar bloqueada (com comentário dizendo o que trava) | quem cria / quem devolve |
| In Progress | alguém pegou para trabalhar — move ao pegar, não ao terminar | quem pega |
| In Review | PR aberto | quem abriu o PR |
| Done Dev | PR mergeado na develop e no ar em dev.vendee.com.br | quem mergeia |
| Done | promovido para main/produção; ou resolvido sem código (não-é-bug, só-Prod-manual) | o ritual de promoção |
As duas regras que já custaram board mentindo
1. O cartão nasce completo. Título + descrição + etiqueta + projeto + prioridade + responsável. Cartão só com título é bug de processo — o board é o status visual do Rodrigo, e cartão pela metade faz o board mentir.
2. Toda virada de estado leva comentário com a prova curta. O número do PR, o commit, o que foi verificado na tela. Sem isso, "Done Dev" é só uma palavra.
O board anda junto com o git
Atualizar o cartão faz parte do passo, não é tarefa separada. Os dois momentos mecânicos:
git push -uda branch → o cartão precisa estar em In Progressgh pr create→ mover para In Review e comentar o link do PR
O hook .claude/hooks/lembrete-board.cjs avisa nesses dois momentos, com o ID já extraído do nome da branch. Ele lembra; quem atualiza é você.