Como um Desenvolvedor Usou o Claude Code com Linear e Discord para uma Construção Solo de 30 Dias

O Projeto e a Stack

Um desenvolvedor criou o VGC Team Report (pokemonvgcteamreport.com), um construtor de relatórios de times para Pokémon competitivo (VGC) que gera análises detalhadas com planos de confrontos, cálculos de dano, tiers de velocidade e relatórios compartilháveis. O projeto foi construído em 30 dias de noites e finais de semana com 274 commits, ~42.000 linhas de TypeScript, 25 funcionalidades entregues via Linear, 66 componentes React, 41 rotas de API e 22 hooks personalizados. A stack incluiu Next.js 16 (App Router), React 19, TypeScript (modo estrito), Tailwind CSS v4, Clerk para autenticação, Neon para Postgres serverless e Vercel para hospedagem e implantações.

O Fluxo de Trabalho: Linear → Claude → Discord → Vercel

O desenvolvedor conectou o Claude Code ao Linear para rastreamento de tickets e ao Discord para notificações de builds, criando um pipeline de desenvolvimento automatizado. Uma sessão típica seguia esta sequência:

1. Claude executa linear_get_in_progress para verificar o quadro do Linear em busca de tickets
2. Seleciona o ticket de maior prioridade (bugs primeiro)
3. Lê os arquivos relevantes e implementa a funcionalidade ou correção
4. Executa tsc --noEmit && npm run build — se falhar, Claude corrige os erros
5. Faz commit com o formato de ID do ticket: VGC-42: Adicionar gráfico de tier de velocidade
6. Faz push para a main
7. Posta um comentário no ticket do Linear via GraphQL com URL do commit e arquivos alterados
8. Move o ticket para Em Revisão
9. Chama discord_notify_build — posta um embed no Discord #builds com commit, lista de arquivos alterados e status de implantação
10. Vercel implanta automaticamente a partir da main
11. Passa para o próximo ticket

Isso foi implementado através de um script bash linear.sh com funções que Claude chama diretamente: linear_get_in_progress (consulta o GraphQL do Linear por tickets Em Progresso), linear_move_issue (move um ticket para um novo estado), linear_comment_with_changes (postar um comentário com link do commit e arquivos alterados) e discord_notify_build (envia um embed do Discord com informações do commit e status de implantação).

O Manual de Operação CLAUDE.md

Um arquivo CLAUDE.md na raiz do repositório fornece contexto para cada sessão do Claude. As seções principais incluem:

• Estratégia Git: Desenvolvimento baseado em tronco com pushes diretos para main para trabalho rotineiro, branches de funcionalidade apenas para mudanças grandes ou arriscadas, e npx tsc --noEmit && npm run build antes de cada push como não negociável
• Fluxo de trabalho Linear: IDs exatos de estado para "Em Progresso" e "Em Revisão", como consultar e implementar tickets, commit com prefixo VGC-XX, postar comentários de commit, mover estados de tickets, com tickets de bug sempre trabalhados primeiro
• Notificações Discord: Formato da função discord_notify_build com embeds diferentes para pushes diretos para main vs fluxos de PR
• Tratamento de falhas: Build falha → corrigir e tentar novamente, nunca fazer push de código quebrado; API do Linear falha → ainda fazer commit e push, notificar falha ao usuário; Produção quebra → git revert, push para main, notificar Discord, mover ticket de volta
• Convenções de código: Seguir padrões existentes, sem refatorações aleatórias, mensagens de commit: VGC-XX: descrição para trabalho rastreado

Monitoramento Automatizado

Dois cron jobs do Vercel foram configurados: uma verificação diária às 9h para saúde do site, varredura de tickets estagnados, auditoria de SEO e saúde do banco de dados (postar alertas no Discord apenas se algo estiver errado), e um resumo semanal na sexta-feira às 17h para progresso no Linear, crescimento de usuários e atualizações de dependências (sempre posta um resumo no Discord). O monitoramento de tempo de atividade em tempo real usou UptimeRobot com pings de 5 minutos.

O Que Funcionou

O desenvolvedor destacou várias práticas eficazes: desenvolvimento baseado em tronco com verificações de tipos (tsc --noEmit && npm run build) garantindo que cada push para main implante automaticamente no Vercel com um ciclo de feedback de minutos; rastreabilidade de tickets do Linear com cada commit vinculado de volta a um ticket e cada ticket tendo um comentário com URL do commit e arquivos alterados; Discord como trilha de auditoria com cada build postando em #builds; e o arquivo CLAUDE.md como o componente mais valioso do projeto para manter contexto consistente entre sessões.