Esconda suas descrições de relações públicas por trás

Esconda suas descrições de relações públicas por trás

9 de novembro de 2026

A maioria das mudanças que faço em meus projetos atualmente vêm na forma de PRs abertos para mim por Claude Code ou Codex. O PR é minha unidade de trabalho – eu os uso para agrupar commits, iterá-los até que um recurso seja concluído, documentar decisões e depois mesclar o resultado final. Os agentes de codificação de hoje são ótimos para escrever descrições de relações públicas.

Eles são muito bons em descrever o trabalho

O problema é que eles são também bom. Uma descrição de RP escrita pelo agente é precisa e abrangente. Descreve o problema, a solução detalhada e as etapas executadas para verificá-lo. É muita informação para absorver.

Não é necessariamente um desleixo, mas lê como lixo!

É muito fácil identificar um PR escrito por IA e, como acontece com outras formas de escrita por IA, minha reação instantânea é melhor resumida como “Não estou lendo tudo isso”. Não importa quão precisa ou útil seja a informação, fico instantaneamente desanimado com o pensamento de que levarei mais tempo para ler do que o autor condutor para escrever… mesmo quando esse autor condutor sou eu!

Quero julgamento editorial humano. Quero que alguém tenha pensado o suficiente sobre o PR para me dar uma introdução aprovada por humanos que me ajude a entender, em alto nível, para que serve o PR e se ele merece mais da minha atenção.

Acho que encontrei uma maneira fácil de fazer isso que parece certa.

Oculte a maior parte em detalhes/resumo

O HTML

os elementos são renderizados como um título recolhido (o resumo) que pode ser expandido para visualizar um pedaço maior de texto. O código fica assim:

details>
  summary>Claude Opus 5.5summary>
  h2>The hookh2>
  Plugins implement code>register_agent_reference_types(datasette)code>...
details>

Quando renderizado, fica assim:

Crucialmente,

é compatível com GitHub Markdown. Você pode colocar essas tags diretamente em um comentário de problema ou descrição de PR e o GitHub ocultará os detalhes e exibirá apenas o resumo mais uma seta de expansão.

Comecei a usar isso para minhas solicitações pull geradas por IA.

O parágrafo inicial dos meus PRs será cuidadosamente selecionado para funcionar como uma explicação de alto nível do que está acontecendo – o texto mais curto que um ser humano pode ler e que o ajudará a se atualizar.

Às vezes, também coloco uma captura de tela, já que as imagens costumam ser a melhor maneira de ilustrar rapidamente um novo recurso.

O ensaio completo escrito pelo agente segue em um

. Eu uso o nome do modelo e muitas vezes o nível de esforço como resumo, para deixar bem claro o que está acontecendo – “Claude Opus 5.5 Médio”, por exemplo.

Meus PRs não parecem tão desleixados agora! As informações ainda estão lá, mas o leitor pode dar uma olhada nelas e obter as principais informações com curadoria humana, sem que seus olhos fiquem vidrados em vários parágrafos de detalhes escritos pelo agente.

Nem sempre eu mesmo escrevo a introdução – às vezes o agente já me deu o que eu precisava, escondido na avalanche de outros textos. Minha promessa ao leitor é que a abertura curta representará meu julgamento humano sobre o que definitivamente vale seu tempo.

Aqui estão alguns exemplos recentes onde usei esse padrão, incluindo o abridor que usei:

O mnemônico

Eu costumava ter problemas para lembrar a ordem das tags – é

ou

?

Aqui estão dois truques que me ajudaram.

Primeiro, e mais obviamente, o