Yapay Zeka Destekli Kod İçin Açık Kaynak Kuralları
Açık kaynak projeleri yapay zeka destekli kod konusunda aynı kuralları uygulamaz. Pull request açmadan önce politikayı bulun, commit trailer içinde kullanımı açıklayın.
Yapay zeka destekli kodu upstream göndermeden önce yapılması gerekenler
Açık kaynak projeleri artık yapay zeka destekli kod kullanımıyla ilgili politikalar yayınlamaktadır ve bu politikalar birbirleriyle uyumlu değildir. Bu nedenle alışkanlık basittir: yamayı yazmadan önce politikayı bulun ve gönderim yaparken durumu doğru bir şekilde beyan edin. Her iki durumda da geçerli olan tek bir kural vardır: inceleme sırasında açıklayamayacağınız tek bir satırı bile göndermeyin.
Proje üretilmiş kodu yasaklıyorsa veya kodun kaynağını gizlediyseniz, doğru bir yama bile reddedilir. Bunun maliyeti sizin adınıza yansır ve orada kalır; çünkü eksikliği daha sonra fark eden bir maintainer, geçmişinizin geri kalanına güvenmek için hiçbir nedene sahip olmayacaktır. Politikalar bu terimleri kullandığı için öncelikle bazı tanımlar gereklidir. Bir LLM (large language model), kodlama aracınızın arkasındaki modeldir. GitHub üzerindeki bir PR (pull request), GitLab üzerinde bir MR (merge request) ile aynıdır ve aşağıdakilerin tümü her ikisi için de geçerlidir. DCO (developer certificate of origin), commit mesajının altındaki onay satırıdır ve tüm tartışmanın merkezinde yer aldığı ortaya çıkmıştır.
Yapay zekâ koduna ilişkin açık kaynak politikaları nereye vardı
Projeler dört gruba ayrılmış durumda. Aşağıdaki tüm örneklerde tarih belirtilmiştir; çünkü bu metinler değişmektedir.
Yasak. Gentoo konseyi, 14 Nisan 2024 tarihinde “Natural Language Processing artificial intelligence tools yardımıyla oluşturulmuş hiçbir içeriğin Gentoo'ya katkıda bulunulmasının açıkça yasak olduğuna” karar verdi. NetBSD commit yönergelerinde bir LLM çıktısı, “core tarafından önceden yazılı onay alınmadan commit edilmemesi gereken” “tainted code” olarak tanımlanıyor. QEMU'nun 12 Ekim 2026 tarihli kod kökeni belgesinde hâlâ projenin “AI generated content içerdiğine veya bundan türediğine inanılan tüm katkıları REDDEDECEĞİ” belirtiliyor.
Yalnızca analiz. Yasakların çoğu başlıktakinden daha dar kapsamlıdır. QEMU'nun belgesinde, çıktının katkılara dahil edilmemesi koşuluyla politikanın “API veya algoritma araştırma, static analysis veya debugging gibi diğer AI kullanımlarını kapsamadığı” belirtiliyor. Agent kullanılarak kod okunabilir. Agent'ın yazdığı kod gönderilemez. Kısıtlayıcı projelerin çoğunda uygulanan sınır budur ve genellikle gözden kaçırılan ayrım da budur.
Açıklama zorunlu. Fedora konseyi, AI-assisted contributions politikasını Ekim 2025'te onayladı. Araçların kullanımına izin veriliyor ve sorumluluk kişiye yükleniyor: Katkıyı yapan kişi yazardır, katkının tamamından bütünüyle sorumludur ve katkının önemli bir bölümü bir araçtan değişiklik yapılmadan geldiyse bunu açıklamak zorundadır. Linux kernel, Ocak 2026'da süreç belgelerine coding assistants sayfası ekledi. Bu sayfada kullanılan aracın kaydedilmesi için bir trailer ve sign-off yetkisine ilişkin kesin bir kural yer alıyor.
Yazılı bir düzenleme yok. Hâlâ en yaygın durum budur. Mayıs 2026 tarihli bir preprint, popüler 1,000 GitHub repository üzerinde inceleme yaptı ve bunların yalnızca 118 tanesinde yazılı bir AI policy bulunduğunu tespit etti. Sessizlik izin anlamına gelmez. Patch'i yazmadan önce issue tracker üzerinde tek cümleyle sorun. Böylece verilen yanıt, daha sonra başvurulabilecek herkese açık bir kayıt haline gelir.
Bakımcılar bu kuralları neden yazdı
İlk neden inceleme yüküdür ve hesap tek yönde işler. Bir aracı, bir dakika içinde makul görünen 400 satırlık bir birleştirme isteği oluşturabilir. Bu isteği gerektiği gibi incelemek bir bakımcının bütün öğleden sonrasına mal olur ve bakımcıların çoğu gönüllüdür. Gönderim maliyeti neredeyse sıfıra indi. İnceleme maliyeti ise hiç değişmedi.
curl, bu eğrinin diğer ucunu gösterir. Daniel Stenberg, 2025 yılının ortalarında, projenin hata ödül programı üzerinden ulaşan güvenlik bildirimlerinin yaklaşık beşte birinin kendi ifadesiyle AI slop olduğunu bildirdi: Gerçek işlevleri ve gerçek kod yollarını adlandıran, makul bir saldırıyı açıklayan ancak içeriğinde hiçbir şey bulunmayan raporlar. Proje, bu akışı finanse etmeyi sürdürmek yerine 2026 yılının başında ödül programını sonlandırdı. Bunlar yama değil rapordu, ancak bakımcının pull request'inizi zaten yorgun biçimde açmasına neden olan mekanizma aynıdır.
GNOME Calendar bu sorunu bir etiket olarak tanımladı. Proje, Haziran 2026'da kod üretmek için "yapay zekâya" "büyük ölçüde veya tamamen dayanıldığını" gösteren birleştirme istekleri için "Probabilistically Automated" etiketini kullanmaya başladı. 12 Ekim 2026 itibarıyla etiketin kapsamı, kod veya hata raporu üretmek için "'AI' / LLM'lere / stokastik papağanlara büyük ölçüde veya tamamen dayanmayı" içeriyor ve belirtiyi tam olarak şöyle adlandırıyor: "Genellikle uygun testlerin yapılmaması ve raporların yazılması ya da yamaların, kodun doğruluğu yerine kulağa makul gelen amaçlanan davranış temel alınarak son hâline getirilmesi eşlik eder." Son ifadeyi iki kez okuyun. Kod çalışması gerektiği izlenimini verir. Gerçekte çalışıp çalışmadığını kimse kontrol etmemiştir.
İkinci neden, kodun kaynağı ve hangi lisans kapsamında üretildiği anlamına gelen provenance'tır. QEMU bu çelişkiyi açıkça ifade eder: sign-off işlemi, katkıda bulunduğunuz "içeriğin telif hakkı ve lisans durumunu tamamen anladığınızı" beyan eder ve model çıktısının telif hakkı durumu kesinleşmiş değildir. Gentoo konseyi de kalite ve etikle birlikte aynı nedeni belirtti. Hukuki yorumu kabul etmek zorunda değilsiniz. Ancak bu kararın size değil, bakımcıya ait olduğunu fark etmek zorundasınız.
Bir projenin yapay zeka politikasını nasıl bulabilirim?
Sırasıyla şu yerlere bakın.
- Depo kök dizinindeki
CONTRIBUTING.md, ardından.github/CONTRIBUTING.mdve sonrasında yanındaki herhangi birDCOdosyası. - Geliştirici belgeleri. QEMU kurallarını
docs/devel/code-provenance.rstiçinde tutar. Çekirdek (kernel) ise kendi kurallarınıDocumentation/process/coding-assistants.rstiçinde barındırır. - Proje web sitesi veya wiki sayfası. Gentoo'nun politikası konseyin wiki sayfasında, NetBSD'ninki ise commit kılavuzlarında yer alır.
- Hata takip sistemi (issue tracker) ve e-posta listesi arşivi. Bir politika genellikle depoya yazılmadan aylar önce buralarda tartışılır.
Bir çalışma kopyasının (checkout) içinden, tek bir grep komutu çoğu durumu kapsar:
grep -rniE '(llm|copilot|chatgpt|generative|ai-generated|ai-assisted)' CONTRIBUTING.md docs/ .github/ 2>/dev/null | head -20Ardından projenin kendi geçmişini inceleyin, çünkü commit edilmiş gelenekler her türlü özetin üzerindedir:
git log --format='%(trailers:key=Assisted-by,valueonly)' | grep . | sort | uniq -c
git log --format='%(trailers:key=AI-used-for,valueonly)' | grep . | sort | uniq -cBir trailer değerinin yanındaki sayı, projenin fiilen kullandığı biçimi gösterir. Boş bir sonuç, burada kimsenin bu biçimde beyanda bulunmadığı anlamına gelir ki bu da başlı başına bir bilgidir. Proje GitHub üzerinde barındırılıyorsa ve iş akışı size yeniyse, GitHub üzerinde pull request ve fork işlemleri nasıl çalışır bölümü, bu kısmın varsaydığı mekanizmaları açıklar.
Commit trailer'ında belirtin, yorum satırında değil
Trailer, commit mesajının son paragrafındaki Key: value satırıdır. Git bu biçimi Signed-off-by: ve Co-authored-by: için zaten kullanır ve araçlar bu biçimi ayrıştırır. Bu nedenle kodla birlikte ağaç içine taşınan tek bildirim budur.
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>Kernel bu biçimi Assisted-by: LLM [TOOL1] [TOOL2] olarak belgeler. Buradaki isteğe bağlı araç adları coccinelle, sparse, smatch veya clang-tidy gibi özel analiz araçlarıdır; git, gcc veya kullandığınız editör değildir. Ağustos 2026'da kernel, sayfanın istenmesini önerdiği agent ve model adını kaldırdı. Gerekçe, model adının "özel mülk yazılım şirketlerine ücretsiz reklam sağlaması ve yararlı bilgi eklememesi veya çok az yararlı bilgi eklemesi" idi. Sayfa, bu satırın sınırını da açıkça belirtir: "AI agent'ları Signed-off-by etiketleri EKLEMEMELİDİR. Developer Certificate of Origin'i (DCO) yalnızca insanlar yasal olarak onaylayabilir." Bildirim Assisted-by ile devam eder. Adınız Signed-off-by üzerine yazılır. İkinci satırı hiçbir aracın yazmasına izin vermeyin ve hiçbir aracın kimseye ait olmayan bir Co-authored-by adresi oluşturmasına izin vermeyin.
Adlandırmalar değişebilir. Kendi adınızı oluşturmak yerine yerel biçimi kopyalayın. Mayıs 2026'da QEMU listesine gönderilen bir patch, mekanik değişiklikler, testler, dokümantasyon ve yirmi satır veya daha kısa hata düzeltmeleri için bu projenin yasağının gevşetilmesini önerdi. Değişiklik, AI-used-for: tests, docs gibi bir trailer ile kaydedilecekti. 12 Ekim 2026 itibarıyla bu patch merge edilmemiştir. Aynı yazarın Eylül 2026 tarihli RFC'si, aynı trailer temelinde daha kapsamlı bir yeniden yazım önerir. Commit edilmiş doküman ise hâlâ üretilmiş içeriği kabul etmez. Bir proje 2023 ile 2026 arasında tutumunu iki kez değiştirdi. Bir sonraki değişiklik sizi beklemeyecektir. Bu nedenle yöntem, listeden daha önemlidir.
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 için Git 2.32 veya daha yeni bir sürüm gerekir. İkinci komut, değeri doğrudan ekrana yazdırmalıdır. Boş satır, git'in trailer'ı ayrıştıramadığı anlamına gelir. Bunun nedeni neredeyse her zaman mesajın altındaki trailer bloğunda boş bir satırın veya normal bir cümlenin bulunmasıdır. Daha önce yazdığınız bir seri için git rebase --signoff origin/main her commit'e sign-off ekler; git interpret-trailers --in-place --trailer "Assisted-by: LLM" msg.txt ise bir mesaj dosyasını düzenler.
İki hata durumu önceden planlanmalıdır. Squash merge, commit mesajını yeniden yazar. Squash kullanan bir projede bildirimi maintainer'ın göreceği PR açıklamasında da tekrarlayın. Review yorumu ise kayıt değildir. Yorumlar düzenlenebilir ve git geçmişine hiç yazılmayabilir.
Doğruluk her iki yönde de önemlidir. Elle yazdığınız bir commit'te Assisted-by gürültü oluşturur ve gerçek bildirimlerinizin değerini azaltır. Agent'ın yazdığı bir commit'te bunu atlamak ise ilişkinin sona ermesine neden olur.
Signed-off-by ifadesi gerçekte neyi tasdik eder?
DCO, developercertificate.org adresinde yayımlanan ve çekirdek (kernel), QEMU ve daha pek çok proje tarafından kullanılan 1.1 sürümü numaralı kısa bir metindir. Signed-off-by: Your Name <you@example.com> eklemek, bu metni onayladığınızı beyan ettiğiniz anlamına gelir. Neyi onayladığınızı okuyun; çünkü çoğu kişi bunu hiç okumadan imzalar.
(a) maddesi, katkının "tamamının veya bir kısmının tarafımca oluşturulduğunu ve dosyada belirtilen açık kaynak lisansı altında sunma hakkına sahip olduğumu" belirtir. (b) maddesi, üzerinde değişiklik yapma hakkına sahip olduğunuz önceki açık kaynak kodlarına dayanan çalışmaları kapsar. (c) maddesi, aynı şeyi tasdik etmiş birinden size teslim edilen kodları kapsar. (d) maddesi ise katkının ve imzanızdaki kişisel bilgilerin herkese açık olduğunu ve süresiz olarak saklandığını anladığınızı ifade eder.
Neyin eksik olduğuna dikkat edin. DCO, her karakteri sizin yazdığınızı iddia etmez. Kodu bu lisans altında sunma hakkına sahip olduğunuzu söyler. Üretilmiş kodun (generated code) burada sorunlu durmasının nedeni budur: mesele yazarlık değil, kökeni açıklayıp açıklayamayacağınızdır. İmza gerektiren çoğu proje gerçek isim de talep eder, bu nedenle takma isimler kontrolü geçemez. Satırı git commit -s ile ekleyin; bu komut git yapılandırmanızdan user.name ve user.email değerlerini okur. Bir DCO botu PR isteğinizi reddettiğinde ve eksik satırın bulunduğu commit'i belirttiğinde, git rebase --signoff origin/main komutu ve ardından dalınıza yapacağınız bir force push sorunu çözecektir.
Commit imzalamak ile sign-off yapmak aynı şey değildir
git commit -s bir metin satırı ekler. git commit -S ise GPG veya SSH anahtarınızı kullanarak commit nesnesi üzerinde kriptografik bir imza oluşturur. Bu iki işlem farklı sorulara yanıt verir. İmza, commit'in ilgili anahtarın sahibi tarafından oluşturulduğunu ve o andan itibaren değiştirilmediğini doğrular. İçerikteki kodun kaynağı hakkında herhangi bir bilgi vermez; dolayısıyla, açıklanmamış üretilmiş kodlarla dolu imzalı bir commit, teknik olarak imzalı olsa da yine de bir politika ihlali teşkil edebilir. Sign-off, köken ile ilgili bir beyandır. İmza ise kimlik ile ilgili bir beyandır. Her ikisini de talep eden projeler, her iki işlemi de ayrı ayrı isteyecektir.
Açıklayamadığınız kodu incelemeye göndermeyin
Bu bir testtir ve konu dürüstlükten ziyade yetkinliktir. Her satır için şu soruları sorun: Bu ne işe yarıyor ve bu satır olmazsa ne bozulur? Bu sorulardan herhangi birinin cevabı eksikse yama hazır değildir; çünkü inceleme yorumu geldiğinde vereceğiniz cevap, sürecin bir tur daha uzamasına neden olacaktır. İncelemeyi yapanlar bunu anlar. İşte bir katkı sağlayıcının projeye yük olmaya başladığı an budur. Aynı soruları uç durumlar, boş girdi, hata yolu ve ikinci çağırıcı için de sorun.
Kodu çalıştırın. Derleyin, projenin test paketini çalıştırın ve düzeltmeyi iddia ettiğiniz hata için bir yeniden üretim (reproducer) senaryosu yazın. Çekirdek belgeleri, dürüst bir geri çekilme yöntemini açıkça belirtir: "Eğer düzeltme derlenemiyor veya test edilemiyorsa ya da bir yeniden üretim senaryosu oluşturulamıyorsa, bunu açıkça belirtin: sürdürücüler şu anda doğrulanmamış raporları ve test edilmemiş düzeltmeleri analiz ederek çok fazla zaman kaybediyor." "Bunu gerçek donanım üzerinde test edemedim" diye yazmanın size bir maliyeti yoktur. Test ettiğinizi ima etmek ise projeden dışlanmanıza neden olur.
İnceleme yorumlarını kendi kelimelerinizle ve kendi zamanınızda bizzat yanıtlayın. Yorumdan otuz saniye sonra gelen ve yorumu beş paragrafta tekrar eden bir yanıt, sürdürücüye tam olarak ne olduğunu anlatır. Ayrıca diff dosyasını küçük tutun. Tamamen anladığınız kırk satırlık bir kod, denetlediğiniz dört yüz satırlık bir yeniden düzenlemeden (refactor) bir proje için daha değerlidir. Eğer yapay zeka aracınız sizden istediğinizden fazlasını vermeye devam ediyorsa, onu çalışan en küçük değişikliğe zorlayan bir beceri, yamayı satır satır savunabileceğiniz bir seviyede tutmanın bir yoludur.
Ajan talimatlarını depoda tutun
Ajanınıza verdiğiniz talimatlar araç zincirinizin bir parçasıdır; bu nedenle bunlara kod gibi yaklaşılmalıdır. Genellikle AGENTS.md konumunda bulunan repository kökündeki bir dosyada build komutu, test komutu, commit message formatı, sign-off gereksinimi ve projenin daha önce belgelediği style kuralları yer alır. Bu dosya version control altında tutulur ve incelenebilir. Ayrıca bugün olduğu gibi yarın da aynıdır. Her oturumda bellekten yeniden yazılan talimatlar, her oturumda farklı bir patch üretilmesine neden olur. Hangi oturumun reddedilen patch'i oluşturduğunu da bilemezsiniz. Hem bir ajan hem de insan tarafından okunabilen AGENTS.md yazımı dosyanın kendisini açıklar. Bir ajanın yazmadığınız bir codebase'de eksik olan bilgilerinin yalnızca yarısını conventions oluşturur. Repository yapısının sorgulanabilir bir haritası ise ajana üzerinde çalışabileceği gerçek call graph'ı sağlar. Böylece üretilen çıktı, codebase hakkında bir tahmin gibi değil, çevresindeki koda benzer bir yapıda olur.
Başkalarının depoları hakkında bir uyarı: İlk katkınızı, bakımını yapmadığınız bir projeye ajan talimat dosyası ekleyen bir PR (çekme isteği) olarak yapmayın. Bu, projenin araç politikasını dışarıdan belirleme girişimi olarak algılanır ve hesabınızın, bakımcıların zaten bıkkın olduğu bir konuyla ilişkilendirilmesinin hızlı bir yoludur. Birisi sizden isteyene kadar dosyayı kendi fork'unuzda tutun.
Ajanı nerede çalıştırdığınız da aynı nedenle önemlidir. Projeyi derleyebilen ve testlerini kontrolünüz altındaki bir sandbox içinde çalıştırabilen bir ajan, size gerçekten doğrulanmış bir yama sunar; bu, yardım aldığınızı açıklamak ile bir tahminde bulunduğunuzu açıklamak arasındaki farktır. Kendi VPS'nizde bir kodlama ajanı çalıştırmak bu kurulumu, Claude Code, Cursor, Codex ve Copilot arasındaki pratik farklar ise bu araçların günlük kullanımda nasıl farklılaştığını ele almaktadır.
Politika değişikliği sonrası izlenecek yöntem
- Herhangi bir şey yazmadan önce belirtilen politikayı bulun: depo, geliştirici dokümanları, web sitesi veya takip sistemi.
- Eğer bir politika yoksa, ilgili issue içerisinde tek bir cümleyle soru sorun ve gelen yanıtı saklayın.
- Projenin kullandığı formata uygun şekilde açıklama yapın, bunu commit trailer kısmına ekleyin ve proje commitleri birleştiriyorsa (squash) PR gövdesinde tekrarlayın.
- Kodun gönderilme hakkına sahip olduğunuzu beyan eden satırın sorumluluğunu alarak gerçek adınızla imzalayın (sign-off).
- Kendi yamanızı, sanki onu bir yabancı yazmış gibi inceleyin; çünkü aslında öyle olmuştur.
Bu sayfada adı geçen her proje, siz okuduğunuz sırada yer değiştirmiş olacaktır. Ancak bu beş adım değişmez.
FAQ
Bir AI kodlama aracısı kullandığımı açıklamak zorunda mıyım?
Yanıt yerel kurallara göre belirlendiğinden projeyi kontrol edin. Fedora, katkının önemli bir bölümü değişiklik yapılmadan bir araçtan geldiyse bunun açıklanmasını zorunlu tutar. Linux kernel, bir Assisted-by trailer'ı ister. Gentoo ve QEMU, 12 October 2026 itibarıyla katkının tamamını kabul etmez. Yazılı bir kural bulunmuyorsa yine de açıklamayı commit trailer'ında yapın. Bir maintainer bunu sonradan fark ederse araca değil, açıklamanın yapılmamış olmasına tepki verir. Bu tepki, gönderdiğiniz diğer tüm katkılara da yansır.
Hangi open source projeleri AI tarafından üretilen kodu yasaklıyor?
12 October 2026 tarihinde kontrol edilen duruma göre: April 2024 tarihinden beri Gentoo, LLM çıktısını core onayı gerektiren tainted code olarak değerlendiren NetBSD, generated content kaynaklı katkıları kabul etmeyen QEMU ve Loupe ile Calendar dahil olmak üzere çeşitli GNOME uygulamaları. Bu liste zamanla güncelliğini yitireceğinden her projenin kendi metnini okuyun. Çoğunun paylaştığı istisnaya dikkat edin: Bir modelin API araştırması yapmak, static analysis çalıştırmak veya debugging işlemine yardımcı olmak için kullanılması genellikle kabul edilir. Bunun koşulu, model çıktısının patch içinde yer almamasıdır.
Signed-off-by ile signed commit arasındaki fark nedir?
Signed-off-by, git commit -s tarafından eklenen düz metin satırıdır. Bu satır, developer certificate of origin belgesini onaylar. Başka bir deyişle, bu kodu projenin lisansı kapsamında gönderme hakkınız olduğunu belirtir. git commit -S ile oluşturulan signed commit, GPG veya SSH key'inizle commit object üzerine uygulanan cryptographic signature içerir. Commit'in key'inizden geldiğini ve değiştirilmediğini kanıtlar. Origin ve identity ayrı beyanlardır. Bu nedenle signed commit, bir AI policy'sini yine de ihlal edebilir.
Açıklamayı commit message yerine pull request açıklamasına ekleyebilir miyim?
Açıklamayı commit message içine ekleyin. Çünkü git history'ye giren ve repository'yi daha sonra clone eden herkese kodla birlikte ulaşan kayıt budur. Pull request açıklaması daha sonra düzenlenebilir ve hosting platformunda tutulur. Proje squash merge kullanıyorsa açıklamayı PR body'ye de ekleyin. Çünkü squash, commit message'ı yeniden yazarak trailer'ı kaldırabilir.
Pull request'im AI tarafından üretildiği için kapatıldı. Şimdi ne yapmalıyım?
Thread içinde policy'yi tartışmayın. Çünkü kapatan kişi kuralı tek başına yazmamıştır ve kuralın değiştirileceği yer thread değildir. Policy metnini okuyun ve ardından kurala uyup uyamayacağınıza karar verin. Proje generated patch'leri yasaklıyorsa reproducer içeren ve patch içermeyen açık bir bug report yine kabul edilebilir. Bu çoğu zaman daha yararlı bir katkıdır. Kodla geri dönecekseniz, satır satır savunabileceğiniz küçük bir değişiklikle dönün.