Um Conto de Duas Perguntas sobre o Claude Code

Duas perguntas sobre a mesma ferramenta cruzaram-se comigo há pouco no Stack Overflow, e não podiam ter tido fins mais diferentes. "How do you index a codebase in Claude Code?" (como se indexa uma base de código no Claude Code?) estava a menos oito, fechada, lá em baixo na companhia de trabalhos de casa despejados sem cerimónia e de um pedido de ajuda para quebrar uma palavra-passe. Entretanto, uma resposta a "Is reviewing only by sight a good use of Claude Code to write code?" (será que rever só de vista é um bom uso do Claude Code para escrever código?) somava 13 pontos, o que no Stack Overflow de hoje é ar rarefeito, a liga de uma explicação belíssima da aritmética de CRC e de uma pilha de burocratês da norma de C++.

A mesma ferramenta. O mesmo site. A mesma comunidade a votar. Veredictos opostos. Li ambas as perguntas mais vezes do que elas merecem, porque acho que o fosso entre as duas não é ruído, e também não é hostilidade à IA. A comunidade está a fazer uma triagem, e assim que vês a regra da triagem, podes usá-la.

A que morreu

Comecemos pelo cadáver. "How do you index a codebase in Claude Code?" é uma frase que soa razoável. É também, e digo-o com simpatia, três erros distintos a partilhar um único ponto de interrogação.

Primeiro, assenta numa premissa que a ferramenta não tem. O Claude Code não constrói um índice da tua base de código. Pesquisa a pedido, como tu farias com grep, e todo o design aposta que a pesquisa rápida vence um índice desatualizado. Perguntar como se configura o índice é perguntar como se põe uma sela num carro. Não há resposta para a pergunta tal como foi feita, apenas uma correção dela, e perguntas que só podem ser respondidas desmontando a sua premissa dão-se mal em todo o lado, não só no Stack Overflow.

Segundo, é uma pergunta de suporte. Não uma pergunta menor, mas um género diferente: a sua verdadeira resposta vive na documentação do fornecedor e muda com as notas de lançamento do fornecedor. O Stack Overflow fecha perguntas de suporte a ferramentas desde muito antes de esta ferramenta existir, porque o formato do site assume uma resposta que valha a pena arquivar durante uma década, e as respostas de suporte apodrecem num trimestre. Quando o prazo de validade de uma pergunta é mais curto do que a sua fila de revisão, fechá-la não é gatekeeping. É gestão de inventário.

Terceiro, e este é o erro que realmente me interessa, pergunta pela ferramenta e não pelo trabalho. Que é exatamente a armadilha sobre a qual escrevi no ensaio sobre andar atrás de ferramentas: a ferramenta é a parte que podes trocar num dia, e a parte por baixo, a parte que levou anos, é onde vivem as perguntas duradouras.

A que sobreviveu

Agora a sobrevivente. "Is reviewing only by sight a good use of Claude Code to write code?" não tem premissa para desmontar, porque não afirma nada sobre o funcionamento da ferramenta. Não tem problema de prazo de validade, porque continuará a ser uma pergunta viva daqui a três ferramentas e cinco versões; troca o nome do produto e era uma pergunta viva na era do outsourcing, e da revisão de código em geral. E não é uma pergunta de suporte, porque nenhuma documentação de fornecedor a pode resolver. É uma pergunta de discernimento. A única resposta honesta é experiência: alguém que reviu só de vista, pôs o resultado em produção e descobriu o que isso custa.

A resposta que somou 13 pontos vale alguma coisa precisamente porque não pode ser gerada a pedido. Um modelo produz de bom grado um ensaio sobre práticas de revisão, e será fluente e genérico. O que os votantes recompensaram foi outra coisa: uma pessoa a tomar posição a partir das suas próprias cicatrizes, numa pergunta em que posições são tudo o que há.

Revelação completa: esta também encontrou em mim um alvo fácil. Publiquei um ensaio exatamente sobre esta pergunta cerca de uma semana antes de os votantes do site elevarem aquela resposta ao ar rarefeito, a defender que ler um diff é revisão a sério para um tipo de alteração e uma história reconfortante para outro. Não sei quem fez a pergunta nem quem a respondeu, e não estou a afirmar que o ensaio tenha causado o que quer que seja. O que afirmo é mais pequeno e mais interessante: a pergunta está no ar. Quando o mesmo tema aparece de forma independente num weblog pessoal e no Stack Overflow nas mesmas poucas semanas, é este o aspeto de uma pergunta viva vista de dois pontos de observação.

A regra da triagem

Põe as duas perguntas lado a lado e a regra quase se enuncia sozinha.

Pergunta-te se o próximo lançamento pode esvaziar a tua pergunta de sentido. Se o fornecedor lançar uma funcionalidade amanhã, ou mudar o nome de uma, e a tua pergunta se evaporar, é uma pergunta de suporte, e a multidão de desconhecidos num site de perguntas e respostas é o público errado para ela. O público certo é a documentação, o changelog, os canais do próprio fornecedor, ou dez minutos com a própria ferramenta, que demonstrará o seu comportamento real mais depressa do que um fórum o consegue descrever. Nada de vergonhoso na categoria. É apenas perecível, e os arquivos são para bens duradouros.

Mas se a tua pergunta sobrevivesse ao desaparecimento da ferramenta, se pudesses riscar o nome do produto, escrever o de um concorrente no lugar dele e continuar a precisar da resposta, então não estás a perguntar pela ferramenta de todo. Estás a perguntar pelo trabalho: o que delegar, o que verificar, o que custa uma prática, onde o discernimento tem de continuar humano. Essas perguntas não têm prazo de validade, não têm documentação para onde ser redirecionadas e não têm premissa para colapsar. São também, e não por coincidência, as perguntas a que a IA responde pior, porque a resposta não é retrieval. É testemunho.

A votação da comunidade foi dura de um lado dessa linha e generosa do outro, e acho que a dureza e a generosidade são o mesmo sinal lido duas vezes. Um site que arquiva respostas durante décadas tem todas as razões para rejeitar o que apodrece e açambarcar o que se conserva. A IA não criou essa lógica. Apenas moveu a linha, ao fazer com que tudo o que é recuperável apodreça mais depressa.

Perguntar em público

Se há um conselho nisto, não é «evita perguntar sobre ferramentas de IA em público». É: antes de perguntares, descobre qual das duas perguntas tens na mão. A pergunta de suporte merece dez minutos com a documentação, e honestamente, o próprio modelo responde-lhe melhor do que um fórum, já que descrever o seu próprio comportamento é o único tema em que ele é a fonte primária. A pergunta de discernimento merece o tratamento oposto. Leva-a às pessoas, e veste-a como deve ser: nomeia o que está em jogo, diz o que tentaste, arrisca a tua própria posição provisória para que o testemunho tenha algo contra que empurrar.

As duas perguntas foram feitas por dois desconhecidos que nunca saberão que formaram um par combinado. Entre as duas, mapearam o território inteiro: o que não levar às outras pessoas, e aquilo para que as outras pessoas ainda servem, insubstituivelmente. Menos oito e mais treze não é uma contradição no estado de espírito da comunidade em relação à IA. É a formulação mais precisa dele que vi este ano.