Integrar um agente ao trabalho em equipe

Até aqui, todo este curso dizia respeito a você sozinho diante da sua máquina. A passagem para a equipe muda três coisas ao mesmo tempo, e é aí que a maioria das adoções se deteriora: o volume de código proposto aumenta sem que a capacidade de revisão se mova, as convenções do projeto deixam de estar em uma única cabeça, e a questão de quem responde pelo código entregue deixa de ser teórica.

O sintoma é reconhecível. Três meses depois da chegada da ferramenta, a equipe produz mais pull requests, elas são maiores, a revisão vira um carimbo e os incidentes em produção aumentam sem que ninguém saiba atribuir quais a quê. Nenhuma dessas três evoluções é causada pelo agente: elas vêm do fato de o processo não ter sido ajustado a uma vazão de produção multiplicada.

O arquivo de convenções é um artefato de equipe

Você usou o CLAUDE.md como um caderno pessoal. Em equipe, ele muda de natureza: torna-se o único lugar em que as convenções implícitas do projeto estão escritas, e é versionado junto com o código.

Essa mudança tem um efeito colateral muitas vezes mais valioso que o ganho de produtividade. Escrever uma convenção para uma máquina obriga a formulá-la sem ambiguidade, algo que a transmissão oral entre desenvolvedores permite evitar durante anos. A primeira redação séria desse arquivo costuma revelar dois ou três desacordos cuja existência a equipe ignorava.