Qu Wenruo propõe regras para patches de humanos e agentes de IA no Btrfs
Proposta de arquivo AGENTS.md orienta contribuições ao Btrfs, mas segue em revisão e ainda não foi integrada ao kernel Linux.
Manual específico para o Btrfs
Qu Wenruo, desenvolvedor ligado à SUSE, propôs em 17 de novembro de 2026 criar o arquivo fs/btrfs/AGENTS.md, com regras para contribuições ao subsistema Btrfs do kernel Linux. O documento tem 136 linhas e se dirige a agentes de programação por inteligência artificial e a novos colaboradores.
A proposta não proíbe o uso de IA: busca reduzir envios de baixo valor que consomem o tempo de revisão dos mantenedores. Apresentado como pedido de comentários, o patch segue em análise pela comunidade e ainda não foi integrado ao código principal do kernel.
Regras para mensagens e comentários
O kernel já tem diretrizes gerais para assistentes de programação, incluindo documentação sobre o processo de contribuição e um AGENTS.md de nível superior. O arquivo proposto complementaria essas regras com orientações específicas para o Btrfs sobre comentários, mensagens de commit, recursos visuais, histórico de versões, revisão por IA e testes.
Para mensagens de commit, a proposta prioriza a leitura humana: recomenda frases curtas, uma ideia por frase e uma explicação clara do problema e da solução. Também orienta a remover texto irrelevante e a não usar as marcações [BUG], [CAUSE] e [FIX] em problemas simples só para preencher um modelo.
Contexto útil em comentários, diagramas e testes
O manual recomenda que comentários expliquem por que o código funciona de determinada maneira, como regras de bloqueio ou condições de corrida, em vez de descrever o que já está evidente. Para explicar concorrência, Qu Wenruo prefere diagramas ASCII que mostrem a sequência de operações entre CPU0 e CPU1.
As orientações pedem que esses diagramas omitam caminhos de arquivos e números de linha sem relevância. Para testes, a proposta diferencia correções simples de bugs complexos: instruções longas de reprodução e registros detalhados são úteis quando esclarecem o impacto ou ajudam a analisar o problema.
Revisão automatizada e responsabilidade humana
O arquivo incentiva autores a consultar o Sashiko, sistema que publica revisões automatizadas por IA de patches enviados às listas do kernel. Se a revisão apontar um problema válido, o autor deve corrigi-lo em uma nova versão; se o apontamento for um falso positivo, pode ignorá-lo.
A proposta recomenda responder à lista apenas quando o caso for complexo e a razão do falso positivo não for óbvia. Leon Romanovsky, outro desenvolvedor do kernel, observou que as regras parecem aplicáveis a outros subsistemas, mas o patch ainda busca comentários antes de qualquer adoção mais ampla.
A responsabilidade formal pela contribuição permanece com quem envia o patch: somente uma pessoa pode certificar o Developer Certificate of Origin (DCO) e responder pelo código. A proposta não altera essa exigência e ainda está em discussão pela comunidade.
Informações deste conteúdo
Tecnologias: Agentes de IA, Btrfs, Desenvolvimento de Software, LLMs, Linux
Carreiras: Desenvolvedor de Software
Idiomas: Português
Tags: btrfs, codigoaberto, coding, desenvolvimento, ia, linux, llm, programacao, revisaodecodigo, software, teste