Pular para o conteúdo
Notícias e tutoriais sobre Linux
Kernel Linux

Btrfs propõe manual para humanos e agentes de IA enviarem patches melhores ao Linux

Regras para máquinas não desperdiçarem o tempo dos humanos!

btrfs agents md regras ia patches linux

A inteligência artificial resolveu um problema histórico do desenvolvimento de software: produzir código rapidamente. No entanto, ela evidenciou outro gargalo no ecossistema de código aberto: alguém ainda precisa ler, compreender e revisar cada linha enviada. Para tentar reequilibrar essa conta, uma nova proposta quer ensinar ferramentas automatizadas e novos colaboradores a respeitarem o tempo dos mantenedores do kernel Linux.

Em 17 de novembro de 2026, Qu Wenruo, desenvolvedor ligado à SUSE, publicou um patch sugerindo a criação de um arquivo fs/btrfs/AGENTS.md. O documento de 136 linhas funciona como um manual de instruções focado em agentes de programação por IA e iniciantes, detalhando as regras, convenções e expectativas específicas do subsistema Btrfs.

A proposta não proíbe o uso de inteligência artificial. Na verdade, ela tenta lidar com uma consequência direta da popularização dos assistentes de código: o aumento de correções de baixo valor que, embora tecnicamente plausíveis, exigem tempo demasiado de revisão humana e entregam pouco benefício prático. A submissão ainda está em fase de revisão pela comunidade e não foi integrada ao código principal do kernel.

IA tornou patches baratos, mas revisão continua cara

Historicamente, criar uma correção para o kernel exigia compreender o código, investigar o problema, compilar, testar e preparar a mensagem de commit. Ferramentas modernas de IA reduzem drasticamente o custo e o esforço de várias dessas etapas. Isso cria uma assimetria: produzir propostas ficou muito fácil, mas validá-las continua exigindo a atenção de especialistas.

No desenvolvimento do Linux, um patch que apenas “parece correto” não é suficiente. Um revisor precisa avaliar a lógica, o comportamento em concorrência, o gerenciamento de locks, possíveis regressões e a interação com outros componentes.

No caso do Btrfs, esse rigor é ainda mais crítico. Trata-se de um sistema de arquivos avançado, responsável por gerenciar snapshots, subvolumes e a consistência dos dados no disco. Erros em código de filesystem podem corromper dados ou inviabilizar a recuperação de um sistema. Consequentemente, o tempo dos mantenedores é um recurso escasso e valioso.

Segundo Qu Wenruo, ferramentas de IA e colaboradores inexperientes frequentemente enviam patches com correções estéticas, parágrafos excessivamente longos e etapas de teste que não agregam valor. Cada uma dessas submissões exige leitura e contexto, consumindo um tempo de revisão que poderia ser dedicado a problemas estruturais reais.

Como o AGENTS.md se encaixa no kernel

O conceito de um arquivo AGENTS.md não é exclusivo do Btrfs. Ele atua como um documento que ferramentas de programação assistida podem consultar automaticamente antes de gerar código, entendendo as preferências do projeto.

O kernel Linux já possui regras estabelecidas para o uso de IA, documentadas no arquivo Documentation/process/coding-assistants.rst e em um AGENTS.md de nível superior. Essas diretrizes gerais determinam que a IA deve seguir o processo normal de desenvolvimento e que apenas humanos podem certificar o Developer Certificate of Origin (DCO).

A novidade da proposta atual é criar uma camada de regras específicas para um subsistema. O arquivo do Btrfs não substitui a documentação geral, mas a complementa com seis áreas principais de atenção: comentários no código, mensagens de commit, recursos visuais, histórico de versões, uso de IA para revisão e detalhamento de testes.

O manual para IA começa dizendo que humanos vêm primeiro

Uma das características mais notáveis de um arquivo criado para orientar máquinas é a sua regra de ouro para mensagens de commit: a legibilidade humana vem em primeiro lugar.

O documento orienta que as mensagens devem permitir ao revisor compreender rapidamente o problema, a causa e a solução. As recomendações incluem o uso de frases curtas, uma ideia por frase, a eliminação de texto irrelevante e a consulta ao histórico recente de commits do diretório fs/btrfs.

O projeto Btrfs possui uma prática conhecida de estruturar mensagens de correções complexas usando as marcações [BUG], [CAUSE] e [FIX]. No entanto, a nova proposta pede explicitamente que essa estrutura não seja usada para problemas simples. O motivo é prático: modelos de linguagem (LLMs) tendem a reproduzir templates mecanicamente, inflando o tamanho do texto sem necessidade, o que piora a contribuição em vez de melhorá-la.

Menos comentários óbvios e mais diagramas ASCII

Outro ponto de atrito abordado pelo patch é a geração de comentários desnecessários. LLMs frequentemente narram o que o código faz. O arquivo proposto estabelece que os comentários devem existir apenas quando o código não for suficientemente óbvio por si só, servindo para explicar o “porquê”, e não o “o quê”.

Exemplos de comentários úteis incluem a explicação de regras de locking, condições de corrida (race conditions) e a razão para implementações não triviais. Comentários como “fix for” ou “new helper to” são desencorajados quando o código já deixa isso claro.

Além disso, Qu Wenruo declara preferência por diagramas em formato ASCII em vez de longos parágrafos descritivos. Para explicar uma falha de concorrência, por exemplo, o documento sugere colocar duas CPUs lado a lado (CPU0 | CPU1). Isso permite ao revisor visualizar visualmente a ordem das operações e a janela exata onde a falha ocorre, algo que seria denso e confuso em texto corrido. O arquivo define até regras para esses diagramas, pedindo que omitam caminhos de arquivo e números de linha irrelevantes.

Testes: mais documentação nem sempre é melhor

A documentação aborda um aspecto contraintuitivo: bugs simples não precisam de longas etapas de teste nas mensagens de commit.

Se a correção afeta um caminho de erro altamente improvável ou um problema restrito a ferramentas de depuração, inserir dez passos de reprodução e logs extensos apenas aumenta o trabalho de leitura do mantenedor. Testes detalhados e passos de reprodução continuam sendo recomendados, mas apenas quando o bug é complexo, afeta o uso normal ou quando as instruções realmente ajudam o revisor a compreender o impacto.

Curiosamente, a proposta também manda ouvir uma IA

btrfs agents md regras ia patches linux 1
Btrfs propõe manual para humanos e agentes de IA enviarem patches melhores ao Linux 3

Longe de ser um bloqueio contra a inteligência artificial, o documento proposto dedica uma seção inteira ao Sashiko. O Sashiko é um sistema automatizado que publica revisões geradas por IA para os patches enviados às listas de discussão do kernel.

A proposta do Btrfs orienta os autores a consultarem a revisão feita pelo Sashiko. Se o relatório automatizado apontar um problema válido, o autor deve corrigi-lo em uma versão posterior do patch. Se o apontamento estiver incorreto, ele pode simplesmente ser ignorado. O arquivo orienta que os desenvolvedores só respondam à lista de discussão quando o caso for complexo e a razão do falso positivo não for óbvia.

Isso evidencia que o problema do subsistema não é a tecnologia em si, mas como o custo humano da revisão precisa ser otimizado.

Esse problema pode chegar a todo o software livre

O ecossistema open source historicamente depende de uma barreira relativamente baixa para atrair contribuições, sustentada por uma revisão altamente especializada. Com os assistentes de código, a barreira técnica para produzir remendos caiu ainda mais. Diversos projetos precisarão decidir como filtrar, orientar e responsabilizar humanos pelas submissões geradas de forma automatizada.

Leon Romanovsky, outro desenvolvedor do kernel, observou na thread pública que as descrições propostas para o Btrfs parecem bastante gerais e poderiam servir também a outros subsistemas. O próprio Qu Wenruo rotulou o envio como um pedido de comentários (RFC), admitindo que algumas práticas refletem preferências pessoais e buscando feedback da comunidade.

Ainda não é possível afirmar se o arquivo permanecerá específico do Btrfs, se será adotado por outros diretórios ou se suas regras serão fundidas à documentação geral do Linux.

A responsabilidade final continua inalterada. Apenas um humano pode certificar a linha Signed-off-by, que atesta a origem do código por meio do Developer Certificate of Origin. Se a IA cometer um erro grave, o desenvolvedor que submeteu o patch responde formalmente por ele.

Entenda sem termos técnicos

Imagine uma editora tradicional que conta com um único editor capaz de ler e corrigir dez textos por dia. Durante anos, isso funcionou bem, pois os escritores também levavam tempo para redigir os textos.

Então, chega uma ferramenta que permite a qualquer pessoa gerar mil textos por dia. Produzir os textos ficou praticamente gratuito e imediato. O problema é que a editora ainda tem o mesmo editor, e cada texto recebido ainda precisa ser lido, verificado e corrigido antes da publicação.

O arquivo AGENTS.md proposto pelo Btrfs seria como entregar a essa ferramenta de escrita um manual de regras claras: “Não mande textos enrolados, não explique o óbvio e estruture bem a ideia antes de colocar mais trabalho na mesa do nosso editor”. O objetivo não é proibir a chegada de novos textos, mas garantir que eles cheguem em um formato que o editor consiga avaliar sem desperdiçar seu tempo.

RECURSOS DO ARTIGO

Links e recursos

Materiais oficiais e referências técnicas relacionadas à matéria.
QUEM ESCREVE
Emanuel Negromonte

Sobre o autor

Emanuel Negromonte é Jornalista, Mestre em Tecnologia da Informação e atualmente cursa a segunda graduação em Engenharia de Software. Com 14 anos de experiência escrevendo sobre GNU/Linux, Software Livre e Código Aberto, dedica-se a descomplicar o universo tecnológico para entusiastas e profissionais. Seu foco é em notícias, tutoriais e análises aprofundadas, promovendo o conhecimento e a liberdade digital no Brasil.