Políticas de IA para código em projetos open source
Projetos open source divergem sobre código assistido por IA. Consulte a política antes do PR e informe a origem no trailer de commit, sem ocultar detalhes.
O que fazer antes de enviar código assistido por IA para um projeto
Os projetos de código aberto publicam atualmente políticas sobre código assistido por IA, e essas políticas não são uniformes. Portanto, adote uma prática simples: procure a política antes de escrever o patch e divulgue as informações com exatidão ao enviá-lo. Há uma regra comum a todas elas: nunca envie uma linha que não consiga explicar durante a revisão.
Mesmo um patch correto pode ser encerrado se o projeto proibir código gerado ou se tiver ocultado a origem do código. O impacto fica associado ao seu nome, porque um maintainer que descubra a omissão mais tarde não terá motivos para confiar no restante do seu histórico. Primeiro, algumas definições, porque as políticas usam estes termos. Um LLM (large language model) é o modelo por trás do seu coding agent. Um PR (pull request) no GitHub corresponde a um MR (merge request) no GitLab, e tudo o que segue aplica-se aos dois. O DCO (developer certificate of origin) é a linha de sign-off no fim da mensagem de um commit e acaba por ser o centro de toda a discussão.
Onde as políticas de código aberto sobre código gerado por IA chegaram
Os projetos estabeleceram quatro grupos. Todos os exemplos abaixo têm data, porque estes textos mudam.
Proibido. O conselho do Gentoo votou em 14 April 2024 que é "expressamente proibido contribuir para o Gentoo com qualquer conteúdo criado com a assistência de ferramentas de inteligência artificial de Processamento de Linguagem Natural". As diretrizes de commit do NetBSD classificam a saída de um LLM como "código contaminado" que "não deve ser enviado sem aprovação prévia por escrito do núcleo". O documento de proveniência de código do QEMU, em 12 October 2026, ainda afirma que o projeto irá "RECUSAR quaisquer contribuições que se considere incluírem ou derivarem de conteúdo gerado por IA".
Apenas para análise. A maioria das proibições é mais restrita do que o título sugere. O documento do QEMU afirma que a política "não se aplica a outras utilizações de IA, como pesquisar APIs ou algoritmos, análise estática ou depuração, desde que a saída não seja incluída nas contribuições". Pode usar o agente para ler o código. Não pode enviar o que ele escreveu. Essa distinção é a regra prática dentro da maioria dos projetos restritivos, e é o ponto que as pessoas não percebem.
É necessário declarar. O conselho do Fedora aprovou uma política sobre contribuições assistidas por IA em October 2025. A política permite as ferramentas e atribui a responsabilidade à pessoa: o contribuidor é o autor, responde integralmente por toda a contribuição e deve declarar quando uma parte significativa dela tiver vindo de uma ferramenta sem alterações. O kernel Linux adicionou uma página sobre assistentes de programação à documentação do processo em January 2026, com um trailer para registar a ferramenta e uma regra rigorosa sobre quem pode aprovar.
Nada escrito. Este continua a ser o caso mais comum. Um preprint de May 2026 analisou 1,000 repositórios populares do GitHub e encontrou 118 com alguma política de IA escrita. O silêncio não é permissão. Faça uma pergunta numa frase no issue tracker antes de escrever o patch, e a resposta torna-se um registo público ao qual poderá fazer referência mais tarde.
Por que os maintainers criaram estas regras
O primeiro motivo é a carga de revisão, e a aritmética só funciona num sentido. Um agente produz um merge request plausível com 400 linhas num minuto. Rever esse pedido corretamente custa uma tarde a um maintainer, e a maioria dos maintainers trabalha como voluntário. O custo de submeter caiu para quase zero. O custo de rever não mudou.
O curl mostra o extremo oposto dessa curva. Em meados de 2025, Daniel Stenberg informou que cerca de um quinto dos relatórios de segurança recebidos através do bug bounty do projeto eram o que ele chama de AI slop: relatórios que citam funções reais e caminhos de código reais, descrevem um ataque plausível e não contêm nada de útil. O projeto encerrou o programa de bounty no início de 2026, em vez de continuar a financiar essa inundação. Eram relatórios, não patches, mas o mecanismo é o mesmo que faz um maintainer abrir o seu PR já cansado.
O GNOME Calendar registou o problema como um rótulo. Em junho de 2026, o projeto introduziu "Probabilistically Automated" para merge requests que mostram "dependência significativa ou total de 'inteligência' artificial para gerar código". Em 12 de outubro de 2026, o próprio rótulo abrangia "dependência significativa ou total de 'AI' / LLMs / stochastic parrots para gerar código ou relatórios de bugs" e descrevia exatamente o sintoma: "Normalmente acompanhado pela ausência de testes adequados e pela redação de relatórios ou finalização de patches com base num comportamento pretendido plausível, em vez da correção do código". Leia essa última frase duas vezes. O código parece funcionar. Ninguém verificou se funciona.
O segundo motivo é a proveniência, ou seja, de onde veio o código e sob que licença. O QEMU declara o conflito de forma clara: assinar o sign-off confirma que você "compreende totalmente o estado dos direitos de autor e da licença do conteúdo" que contribui, e o estado dos direitos de autor do output de modelos ainda não está definido. O conselho do Gentoo apresentou o mesmo motivo, além de questões de qualidade e ética. Não precisa concordar com a interpretação jurídica. Precisa reconhecer que essa decisão cabe ao maintainer, não a você.
Como encontro a política de IA de um projeto?
Procure nestes locais, pela ordem indicada.
CONTRIBUTING.mdna raiz do repositório, depois.github/CONTRIBUTING.mde, em seguida, qualquer ficheiroDCOjunto desses ficheiros.- A documentação para programadores. O QEMU mantém a sua regra em
docs/devel/code-provenance.rst. O kernel mantém a sua emDocumentation/process/coding-assistants.rst. - O site ou wiki do projeto. A política do Gentoo está na página do wiki do council, e a do NetBSD está nas diretrizes para commits.
- O sistema de acompanhamento de issues e o arquivo da lista de discussão. Normalmente, uma política existe nesses locais durante meses antes de alguém a escrever no repositório.
A partir de um checkout, um grep cobre a maior parte dos casos:
grep -rniE '(llm|copilot|chatgpt|generative|ai-generated|ai-assisted)' CONTRIBUTING.md docs/ .github/ 2>/dev/null | head -20Depois, consulte o próprio histórico do projeto, porque a convenção registada no repositório prevalece sobre qualquer resumo dessa convenção:
git log --format='%(trailers:key=Assisted-by,valueonly)' | grep . | sort | uniq -c
git log --format='%(trailers:key=AI-used-for,valueonly)' | grep . | sort | uniq -cUma contagem junto de um valor de trailer mostra o formato que o projeto realmente utiliza. Um resultado vazio significa que ninguém declarou nada nesse formato neste local, o que também é informação. Se o projeto estiver no GitHub e o fluxo de trabalho for novo para si, como funcionam os pull requests e os forks no GitHub explica os mecanismos assumidos nesta secção.
Divulgue no trailer do commit, não num comentário
Um trailer é uma linha Key: value no último parágrafo da mensagem de commit. O Git já usa este formato para Signed-off-by: e Co-authored-by:, e as ferramentas analisam-no. Por isso, é a única divulgação que acompanha o código até à árvore.
net: release the buffer on the error path
The error path returned before releasing the buffer, so every failed
setup leaked one page.
Assisted-by: LLM coccinelle sparse
Signed-off-by: Your Real Name <you@example.com>O kernel documenta esse formato como Assisted-by: LLM [TOOL1] [TOOL2]. Os nomes de ferramentas opcionais referem-se a ferramentas especializadas de análise, como coccinelle, sparse, smatch ou clang-tidy, nunca git, gcc ou o seu editor. Em agosto de 2026, o kernel removeu o nome do agente e do modelo que a página pedia, porque indicar o modelo "provides free advertising to proprietary software companies while adding little or no useful information". A página também é explícita quanto ao limite da linha: "AI agents MUST NOT add Signed-off-by tags. Only humans can legally certify the Developer Certificate of Origin (DCO)." A divulgação continua em Assisted-by. O seu nome aparece em Signed-off-by. Nunca permita que uma ferramenta escreva o segundo campo e nunca a deixe inventar um endereço Co-authored-by que não pertença a ninguém.
Os nomes variam. Por isso, copie o nome usado localmente em vez de inventar um. Um patch enviado para a lista do QEMU em maio de 2026 propôs flexibilizar a proibição desse projeto para alterações mecânicas, testes, documentação e correções de erros com vinte linhas ou menos, registadas com um trailer como AI-used-for: tests, docs. Em 12 de outubro de 2026, esse patch ainda não tinha sido integrado. Um RFC de setembro de 2026 do mesmo autor propõe uma reescrita mais abrangente baseada no mesmo trailer, e o documento integrado continua a rejeitar conteúdo gerado. Um projeto mudou de posição duas vezes entre 2023 e 2026. A próxima alteração não vai esperar por si. Por isso, o método é mais importante do que a lista.
git commit -s --trailer "Assisted-by: LLM" -m "net: release the buffer on the error path"
git log -1 --format='%(trailers:key=Assisted-by,valueonly)'--trailer requer Git 2.32 ou posterior. O segundo comando deve mostrar o valor diretamente. Uma linha vazia significa que o git não analisou o trailer. Quase sempre isso acontece porque existe uma linha em branco ou uma frase normal dentro do bloco de trailers, no fim da mensagem. Numa série que já tenha escrito, git rebase --signoff origin/main adiciona a assinatura a todos os commits e git interpret-trailers --in-place --trailer "Assisted-by: LLM" msg.txt edita um ficheiro de mensagem.
Vale a pena planear dois modos de falha. Um squash merge reescreve a mensagem de commit. Por isso, num projeto que faz squash, repita a divulgação na descrição do PR, onde o maintainer a lê. Um comentário numa revisão também não é um registo, porque os comentários podem ser editados e nunca ficam no histórico do git.
A precisão funciona nos dois sentidos. Assisted-by num commit que escreveu manualmente é ruído e reduz o valor das suas divulgações reais. Deixar essa indicação de fora de um commit escrito pelo agente é o que põe fim à relação.
O que o Signed-off-by atesta?
O DCO é um texto curto, na versão 1.1, publicado em developercertificate.org e utilizado pelo kernel, pelo QEMU e por muitos outros projetos. Adicionar Signed-off-by: Your Name <you@example.com> significa que você declara estar de acordo com ele. Leia o que está a declarar, porque muitas pessoas adicionam essa linha sem nunca ler o texto.
A cláusula (a) afirma que a contribuição "foi criada total ou parcialmente por mim e que tenho o direito de a submeter sob a licença open source indicada no ficheiro". A cláusula (b) abrange trabalho baseado em código open source anterior que você tem o direito de transmitir com modificações. A cláusula (c) abrange código que lhe foi entregue por alguém que certificou a mesma coisa. A cláusula (d) afirma que você compreende que a contribuição e as informações pessoais incluídas no seu sign-off são públicas e são conservadas indefinidamente.
Observe o que não está incluído. O DCO nunca afirma que você escreveu todos os caracteres. Afirma que você tem o direito de submeter o código sob esta licença. É por isso que o código gerado se enquadra aqui de forma pouco clara: a questão não é a autoria, mas sim se você consegue indicar a origem. A maioria dos projetos que exigem sign-off também exige um nome real, portanto um pseudónimo falha nessa verificação. Adicione a linha com git commit -s, que lê user.name e user.email da sua configuração do git. Quando um bot de DCO rejeitar o seu PR e indicar o commit que não contém a linha, git rebase --signoff origin/main e um force push para a sua branch resolvem o problema.
Assinar um commit não é o mesmo que dar sign-off
git commit -s adiciona uma linha de texto. git commit -S cria uma assinatura criptográfica sobre o objeto do commit usando a sua chave GPG ou SSH. Cada um responde a uma pergunta diferente. A assinatura atesta que este commit veio do titular dessa chave e não foi alterado desde então. Não informa a origem do código contido no commit. Por isso, um commit assinado que contenha muito código gerado não declarado continua a ser uma violação da política. O sign-off é a declaração sobre a origem. A assinatura é a declaração sobre a identidade. Os projetos que exigem ambos pedirão ambos.
Nunca envie código que não consiga explicar numa revisão
Este é o teste, e não é realmente sobre honestidade. Para cada linha, responda: para que serve e o que deixa de funcionar sem ela? Se faltar uma das respostas, o patch não está pronto, porque o comentário da revisão vai chegar e a sua resposta resultará noutra ronda de geração. Os revisores percebem. É nesse momento que um contribuinte passa a ser um custo. Faça a mesma pergunta sobre os casos-limite, a entrada vazia, o caminho de falha e o segundo chamador.
Execute o código. Compile-o, execute a suíte de testes do projeto e escreva um reproduzidor para o bug que afirma corrigir. A documentação do kernel apresenta a alternativa correta em termos claros: "Se a correção não pôde ser compilada ou testada, ou se não foi possível produzir um reproduzidor, diga isso explicitamente: atualmente, os mantenedores perdem demasiado tempo a analisar relatórios não verificados e correções não testadas." Escrever "Não consegui testar isto em hardware real" não lhe custa nada. Dar a entender que testou custa o projeto.
Responda aos comentários da revisão pessoalmente, com as suas próprias palavras e no seu próprio ritmo. Uma resposta publicada trinta segundos depois do comentário e que o repete em cinco parágrafos diz exatamente ao mantenedor o que aconteceu. Mantenha também o diff pequeno. Quarenta linhas que compreende completamente valem mais para um projeto do que uma refatoração de quatrocentas linhas que apenas supervisionou. Se o seu agente continuar a devolver mais do que pediu, uma competência que o obriga a fazer apenas a menor alteração funcional é uma forma de manter o patch suficientemente pequeno para que ainda consiga defendê-lo linha a linha.
Mantenha as instruções do agente no repositório
As instruções fornecidas ao agente fazem parte da sua cadeia de ferramentas, por isso devem ser tratadas como código. Um ficheiro na raiz do repositório, normalmente `AGENTS.md`, contém o comando de compilação, o comando de teste, o formato das mensagens de commit, o requisito de sign-off e as regras de estilo já documentadas pelo projeto. Esse ficheiro é versionado e pode ser revisto. Amanhã, as instruções serão as mesmas de hoje. As instruções reescritas de memória em cada sessão produzem um patch diferente em cada sessão, e não saberá qual sessão produziu o patch que foi rejeitado. Como escrever um AGENTS.md que um agente e uma pessoa consigam ler aborda o próprio ficheiro. As convenções são apenas metade do que falta a um agente num código-base que não foi escrito por si, e um mapa consultável da estrutura do repositório fornece o grafo de chamadas real a partir do qual pode trabalhar. Assim, o resultado segue o formato do código envolvente em vez de se basear numa suposição.
Tenha cuidado com os repositórios de outras pessoas. Não faça da sua primeira contribuição um PR que adiciona um ficheiro de instruções do agente a um projeto que não mantém. Isso parece uma tentativa de definir de fora a política de ferramentas do projeto e é uma forma rápida de associar a sua conta àquilo de que os responsáveis pela manutenção já estão fartos. Mantenha o ficheiro no seu fork até alguém o solicitar.
O local onde executa o agente é importante pelo mesmo motivo. Um agente que consegue compilar o projeto e executar os testes dentro de uma sandbox que controla fornece um patch que verificou efetivamente. Essa é a diferença entre declarar a assistência e declarar um palpite. Executar um agente de programação no seu próprio VPS aborda essa configuração, e Diferenças práticas entre Claude Code, Cursor, Codex e Copilot explica como as ferramentas diferem no dia a dia.
O método, depois de alterar a política
- Localize a política indicada antes de escrever qualquer coisa: repositório, documentação do projeto, site ou sistema de acompanhamento.
- Se não existir uma política, faça a pergunta no issue numa única frase e guarde a resposta.
- Faça a divulgação no formato usado pelo projeto, no trailer do commit, e repita-a no corpo do PR se o projeto fizer squash dos commits.
- Assine com o seu nome verdadeiro, sabendo que essa linha declara que tem o direito de submeter o código.
- Reveja o seu próprio patch como se tivesse sido escrito por outra pessoa, porque foi.
Todos os projetos mencionados nesta página terão mudado quando a ler. Os cinco passos não mudam.
FAQ
Tenho de declarar que usei um agente de programação com IA?
Consulte o projeto, porque a resposta é definida localmente. O Fedora exige uma declaração quando uma parte significativa da contribuição veio de uma ferramenta sem alterações. O kernel Linux exige um trailer Assisted-by. O Gentoo e o QEMU, em 12 October 2026, não aceitam de todo a contribuição. Quando não existe nada escrito, faça a declaração mesmo assim num trailer do commit. Um maintainer que descubra isso mais tarde reage à omissão, não à ferramenta, e essa reação fica associada a tudo o que enviou.
Que projetos open source proíbem código gerado por IA?
Segundo uma verificação feita em 12 October 2026: o Gentoo desde April 2024, o NetBSD, que trata o resultado de LLM como código contaminado que precisa de aprovação do core, o QEMU, que rejeita contribuições derivadas de conteúdo gerado, e várias aplicações do GNOME, incluindo Loupe e Calendar. Leia o texto do próprio projeto em vez desta lista, porque ela ficará desatualizada. Tenha em atenção a exceção partilhada pela maioria: usar um modelo para pesquisar uma API, executar análise estática ou ajudar na depuração normalmente é aceitável, desde que o resultado não esteja no patch.
Qual é a diferença entre Signed-off-by e um commit assinado?
Signed-off-by é uma linha de texto simples adicionada por git commit -s. Certifica o developer certificate of origin, o que significa que tem o direito de submeter este código sob a licença do projeto. Um commit assinado, criado com git commit -S, é uma assinatura criptográfica sobre o objeto do commit, feita com a sua chave GPG ou SSH. Prova que o commit veio da sua chave e não foi alterado. A origem e a identidade são declarações separadas, por isso um commit assinado ainda pode violar uma política sobre IA.
Posso colocar a declaração na descrição do pull request em vez da mensagem do commit?
Coloque-a na mensagem do commit, porque esse é o registo que fica no histórico do git e acompanha o código para qualquer pessoa que clone o repositório mais tarde. A descrição de um pull request pode ser editada posteriormente e fica na plataforma de alojamento. Adicione-a também ao corpo do PR quando o projeto fizer squash merge, porque um squash reescreve a mensagem do commit e pode remover o trailer.
O meu pull request foi fechado por ter sido gerado por IA. E agora?
Não discuta a política na thread, porque a pessoa que o fechou não definiu a regra sozinha e a thread não é o local onde ela é alterada. Leia o texto da política e decida se consegue cumpri-la. Quando o projeto proíbe patches gerados, um relatório de bug claro, com um reproducer e sem patch, continua a ser bem-vindo e muitas vezes é a contribuição mais útil. Se voltar com código, faça uma alteração pequena que consiga defender linha a linha.