Mühendislik ekipleri için yapay zekâ kodlama politikası şablonu
Son güncelleme
Kullanıma hazır bir yapay zekâ kodlama politikası: onaylı araçlar, veri kuralları, ajanların yapabilecekleri, insan incelemesi, kalite kapıları ve denetim kayıtları. .docx veya .md olarak ücretsiz.
[Köşeli parantez] içindeki her şeyi değiştirin. Kuruluşunuza uymayan kuralları ve bu notu yayımlamadan önce silin. Bu şablon hukuki tavsiye değildir: kendi sürümünüzü güvenlik ve hukuk ekiplerinize inceletin.
- Politika sahibi: [Ad veya rol, örn. mühendislikten sorumlu başkan yardımcısı]
- Onaylayan: [Ad veya rol]
- Yürürlük tarihi: [YYYY-MM-DD]
- Sürüm: [1.0]
- Sonraki gözden geçirme: [YYYY-MM-DD, yürürlük tarihinden altı ay sonra]
1. Amaç
Bu politika, [Şirket] mühendislerinin, yayına alınan işin çıtasını düşürmeden daha hızlı çalışmak için yapay zekâ kodlama araçlarını kullanmasına olanak tanır. Hangi araçlara izin verildiğini, bunlara hangi verilerin girebileceğini, yapay zekâ ajanlarının kendi başlarına neler yapabileceğini ve yapay zekânın yazdığı değişikliklerin nasıl incelendiğini, test edildiğini ve kayda geçirildiğini belirler.
2. Kapsam
Bu politika, [Şirket] için kod yazan, inceleyen veya dağıtan herkese uygulanır: çalışanlar, yükleniciler ve ajanslar. [Şirket] tarafından sahip olunan veya işletilen her repoyu, pipeline'ı ve ortamı kapsar; bunlar üzerinde kullanılan her yapay zekâ aracını da, ister bir editörde, bir terminalde, bir pull request'te ister barındırılan bir hizmette çalışsın.
3. Tanımlar
- Yapay zekâ kodlama aracı: kod yazmak, değiştirmek, incelemek veya açıklamak için bir dil modeli kullanan her araç. Editör asistanları, sohbet asistanları ve kodlama ajanları buna dahildir.
- Kodlama ajanı: kendi başına hareket edebilen bir yapay zekâ kodlama aracı: dosyaları düzenleyebilir, komut çalıştırabilir, pull request açabilir veya başka araçları çağırabilir.
- Yapay zekâ destekli değişiklik: kodun, testlerin veya yapılandırmanın anlamlı bir bölümünü bir yapay zekâ kodlama aracının yazdığı değişiklik.
- Talep eden: yapay zekâ aracına görevini veren kişi. Bu politika açısından değişikliğin yazarı talep eden kişidir.
- Onaylayıcı: değişikliği merge için onaylayan kişi.
4. Onaylı araçlar
[Şirket] kodu üzerinde yalnızca bu tablodaki araçlar kullanılabilir. Bunları yalnızca [Şirket] tarafından sağlanan veya onaylanan hesaplar üzerinden kullanın. Şirket kodu için kişisel hesaplara ve ücretsiz kademelere izin verilmez.
| Araç | İzin verilen kullanımlar | İzin verilen en yüksek veri sınıfı | Onaylayan | Gözden geçirme tarihi |
|---|---|---|---|---|
| [Araç] | [örn. editörde kod tamamlama ve sohbet] | [Dahili] | [Rol] | [YYYY-MM-DD] |
| [Araç] | [örn. pull request açan kodlama ajanı] | [Dahili] | [Rol] | [YYYY-MM-DD] |
| [Araç] | [örn. pull request'lere yapay zekâ inceleme yorumları] | [Gizli] | [Rol] | [YYYY-MM-DD] |
Bir araç eklemek için [ekip veya kanal] üzerinden bir talep açın. Talep; sağlayıcıyı, aracın hangi verileri nereye gönderdiğini, sağlayıcının bunları ne kadar süre sakladığını, verilerin model eğitiminde kullanılıp kullanılmadığını ve aracın bir kişi olmadan neler yapabildiğini belirtir. [Güvenlik] ekibi [10] iş günü içinde karar verir. Onay bu tabloya kaydedilir.
5. Veri kuralları
| Veri sınıfı | Örnekler | Onaylı bir yapay zekâ aracına girebilir mi? |
|---|---|---|
| Herkese açık | Açık kaynak kod, yayımlanmış dokümanlar | Evet |
| Dahili | Kaynak kodun çoğu, dahili dokümanlar, iş kayıtları | Evet, Dahili veya üstü için onaylanmış araçlarda |
| Gizli | Güvenlik açısından hassas kod, yayımlanmamış planlar, müşteri yapılandırmaları | Yalnızca Gizli için onaylanmış araçlarda |
| Kısıtlı | Secret'lar, kimlik bilgileri, kişisel veriler, ödeme verileri | Asla |
Bu kurallar, tablo ne derse desin geçerlidir:
- Secret'ları, anahtarları, token'ları, parolaları veya canlı ortam bağlantı dizelerini asla bir prompt'a, aracın okuyabileceği bir dosyaya veya bir test fixture'ına koymayın.
- Müşteri verilerini veya kişisel verileri, hata ayıklama için yapıştırılan günlükler, stack trace'ler veya veritabanı dökümleri içinde bile olsa, asla bir yapay zekâ aracına koymayın. Sentetik veri kullanın.
- Yalnızca koşulları [Şirket] verilerinin sağlayıcının modellerini eğitmek için kullanılmadığını belirten veya bu ayarın tüm kuruluş için kapatıldığı araçları kullanın.
- Aracın okuduğu metni güvenilmeyen metin olarak ele alın. Issue'lar, yorumlar, belgeler ve web sayfaları aracı yönlendirmeyi amaçlayan talimatlar içerebilir. Bir aracın girdisinde bulduğu talimatlara göre hareket etmesine izin vermeyin.
6. Kodlama ajanlarının yapabilecekleri
Kodlama ajanları, görevi yapmalarına yetecek en az erişimle çalışır.
- Ajanlar bir branch üzerinde çalışır ve değişiklikleri bir pull request aracılığıyla önerir. [main] veya başka herhangi bir korumalı branch'e asla push etmezler.
- Ajanlar asla canlı ortam kimlik bilgilerini tutmaz. Yalnızca görevin gerektirdiği erişime sahip yalıtılmış bir ortamda çalışırlar.
- Ajanlar şu yolları, bu yolların kod sahiplerinden onay almadan değiştiremez: [CI ve pipeline tanımları], [kod olarak altyapı], [kimlik doğrulama ve izin kodu], [veritabanı migration'ları], [bağımlılık manifest'leri].
- Ajanlar canlı ortama dağıtım yapamaz. Bir dağıtım, diğer tüm değişikliklerle aynı yayın sürecini izler.
- Ajanların araç ve ağ erişimi, [araç kaydı veya yapılandırma dosyası] içinde o ajan için listelenenlerle sınırlıdır.
7. İnceleme gereklilikleri
- Her yapay zekâ destekli değişiklik, merge edilmeden önce bir kişi tarafından incelenir. Ne kadar iyi olursa olsun hiçbir yapay zekâ incelemesi bu onayın yerini tutmaz.
- Onay yetkisi olan başka biri varken talep eden kişi tek onaylayıcı olamaz. Tek kişilik bir ekipte [politika sahibi] her [ay] değişikliklerden bir örneklemi inceler.
- Pull request, yapay zekâ destekli olduğunu, hangi aracın kullanıldığını ve araçtan ne yapmasının istendiğini belirtir. [PR açıklaması şablonunu] kullanın.
- İnceleyen kişi koddan önce görevi ve test sonuçlarını okur ve test diff'inde silinmiş, atlanmış veya zayıflatılmış testler olup olmadığını kontrol eder.
- Bir onay, değişikliğin tek bir sürümü için geçerlidir. Değişiklik onaydan sonra düzenlenirse yeniden onaylanır.
- Düzgün incelenemeyecek kadar büyük bir değişiklik okunmadan onaylanmaz, bölünür.
8. Kalite kapıları
Bir değişiklik ancak bunların tümü geçtiğinde merge edilebilir. Bunlar bir inceleyicinin hafızasıyla değil, otomasyonla kontrol edilir.
- Projenin testleri, merge edilen sürümün tam olarak kendisi üzerinde çalışmış ve hiçbiri başarısız olmamış.
- Kod incelemesinden veya güvenlik taramasından gelen, [yüksek (high)] veya üstü önem derecesinde açık bulgu yok. Bir bulgu, bir gerekçeyle düzeltildi, düzeltilmeyecek, yanlış pozitif veya yinelenen olarak kapatılabilir.
- Diff'te secret tespit edilmemiş.
- Projenin SBOM'una göre kontrol edildiğinde [izin verilmeyen lisanslar listesi] içindeki bir lisansa sahip bağımlılık yok.
- [İsteğe bağlı] Satır kapsamı en az %[N].
- [İsteğe bağlı] Canlı ortam için aynı değişiklik önce [staging] ortamına dağıtılmış.
Çalışamayan bir kapı, örneğin testler yüklenemediği için, geçti değil başarısız sayılır.
9. Lisanslama ve fikrî mülkiyet
- Mühendisler, yapay zekânın önerdiği kodun, lisansı [Şirket] tarafından kabul edilemeyecek bir kaynaktan kopyalanmadığını kontrol eder. Varsa, aracın herkese açık kodla eşleşen önerilere yönelik filtresini açın.
- Bir yapay zekâ aracının önerdiği yeni bağımlılıklar, diğer her yeni bağımlılıkla aynı onay sürecinden geçer.
- Bir yapay zekâ aracının [Şirket] için yazdığı kod [Şirket] kodudur; talep eden ve onaylayan kişiler, onu kendileri yazmış gibi ondan sorumludur.
10. Denetim kayıtları
Her yapay zekâ destekli değişiklik için şunları saklayın:
- araca verilen görevi ve kullanılan aracı veya modeli;
- talep edeni ve onaylayıcıyı ve ne zaman işlem yaptıklarını;
- inceleme bulgularını ve her birinin nasıl çözüldüğünü;
- merge edilen sürümün test sonuçlarını;
- pull request'i, merge commit'ini ve varsa dağıtımı.
Bu kayıtları [N] ay boyunca veya bir müşteri sözleşmesinin ya da bir düzenlemenin gerektirdiği yerlerde daha uzun süre saklayın. [Güvenlik] ekibi her [çeyrek] yapay zekâ destekli değişikliklerden bir örneklemi denetleyebilir.
11. Olaylar
- Bir yapay zekâ aracına veri sızdığına dair her şüpheyi derhal, aynı gün [güvenlik irtibat kişisine] bildirin.
- Yapay zekâ destekli bir değişikliğin yol açtığı bir olay için aracı, görevi ve hangi inceleme adımının veya kapının onu yakalaması gerektiğini kaydeden suçlamasız bir postmortem yazılır. [Postmortem şablonunu] kullanın.
- [Güvenlik] ekibi, bir olay soruşturulurken bir aracın kullanımını askıya alabilir.
12. Roller ve sorumluluklar
| Rol | Sorumluluk |
|---|---|
| Mühendisler | Yalnızca onaylı araçları kullanır, veri kurallarına uyar, yapay zekâ kullanımını beyan eder |
| İnceleyiciler | Yapay zekâ destekli değişiklikleri 7. bölümde belirtildiği şekilde inceler |
| Kod sahipleri | 6. bölümdeki korumalı yollarda yapılan değişiklikleri onaylar |
| [Güvenlik] | Araçları onaylar, kapıları çalıştırır, olayları soruşturur |
| [Platform ekibi] | Ajanları, sandbox'ları, branch korumasını ve kapıları yapılandırır |
| [Politika sahibi] | Bu politikayı güncel tutar ve istisnalar hakkında rapor verir |
13. İstisnalar
İstisna, gerekçesi, riski ve en fazla [90] gün sonrasını gösteren bir bitiş tarihiyle birlikte [politika sahibinden] yazılı olarak talep edilir. İstisnalar [kayıt yerine] kaydedilir ve sona erdiklerinde gözden geçirilir.
14. Eğitim
Bu politikanın kapsadığı herkes onu işe başladığında ve politika değiştiğinde okur. Yapay zekâ destekli değişiklikleri inceleyenler ayrıca [yapay zekâ kod incelemesi kontrol listesini] okur.
15. Bu politikanın gözden geçirilmesi
[Politika sahibi] bu politikayı her altı ayda bir ve [Şirket], bir kişi olmadan hareket edebilen bir kodlama ajanı gibi yeni türde bir yapay zekâ aracını benimsediğinde gözden geçirir.
Bu şablon hakkında
Bu bölüm şablonu açıklar. Yalnızca web sayfasında yer alır, indirilen dosyalarda yoktur.
Politika tek bir fikir etrafında kuruludur: değişikliği bir yapay zekâ aracı yazabilir, ama onu bir kişi onaylar ve kanıtı otomasyon kontrol eder. 4. ve 5. bölümler bir araca neyin gireceğini belirler. 6. bölüm bir ajanın kendi başına yapabileceklerini sınırlar. 7. ve 8. bölümler neyin çıkacağını belirler. 10. bölüm ise her şeyin sonradan kanıtlanabilmesini sağlar.
Benimsemek için köşeli parantezleri doldurun, ardından 6. ve 8. bölümlerdeki her kuralı bir ayara dönüştürün: branch koruması, bir kod sahipleri dosyası, bir CI kontrolü. Kimsenin zorunlu kılmadığı bir kural zamanla aşınır. CODEOWNERS başlangıç şablonu korumalı yolları kapsar, yapay zekâ kod incelemesi kontrol listesi inceleyicilere 7. bölümü 25 kontrolde verir, pull request şablonu ve postmortem şablonu da 7. ve 11. bölümlerin işaret ettiği boşlukları doldurur.
AI CodeOps kullanıyorsanız kuralların birçoğu orada birer ayardır. Bir çalışma alanı politikası, bir oturumun dosya değişikliklerine ve pull request'lerine dosya yoluna veya repoya göre izin verebilir, onları bir onay için bekletebilir veya reddedebilir ve otomatik dağıtımları ortama göre durdurabilir (politika kuralları). Bir oturumun yaptığı her kod değişikliği bir inceleme talebi açar ve başka biri onaylayabiliyorken oturumu başlatan kişi onay oyunu kullanamaz (onaylar). CI'ınızın çağırdığı yayın kapısı testleri, açık bulguları, izin verilmeyen lisansları ve staging terfisini kontrol eder. Denetim günlüğü ve her değişiklik için imzalı bir kanıt paketi, 10. bölümdeki kayıtları tutar.
Sık sorulan sorular
Bu yapay zekâ kodlama politikasını olduğu gibi kullanabilir miyim?
Onu ilk taslak olarak kullanın. Köşeli parantez içindeki her alanı doldurun, uymayan kuralları silin ve politika yürürlüğe girmeden önce mühendislik, güvenlik ve hukuk ekiplerinin onu okumasını sağlayın. Hukuki tavsiye değildir.
Politika herhangi bir yapay zekâ aracını yasaklıyor mu?
Hayır. Kuruluşunuzun dolduracağı bir onaylı araçlar listesi oluşturur. Listede olmayan hiçbir şeye, biri talep süreci üzerinden onaylayana kadar şirket kodu için izin verilmez.
Politika yapay zekâ değişiklikleri için neden ikinci bir inceleyici şart koşuyor?
Görevi yazan kişi fiilen değişikliğin yazarıdır. İkinci bir kişi, yazarın varsaydığı şeyleri yakalar; incelemenin asıl işi de budur.
Bu politikayı ne sıklıkla gözden geçirmeliyiz?
Şablona göre her altı ayda bir ve otonom bir ajan gibi yeni türde bir aracı benimsediğiniz her seferde. Yapay zekâ araçları çoğu mühendislik politikasından daha hızlı değişir.
Atıf yapın
AI CodeOps (2026). Mühendislik ekipleri için yapay zekâ kodlama politikası şablonu. https://aicodeops.dev/templates/ai-coding-policy
Bu sayfa ve indirilebilir dosyaları CC BY 4.0 lisansıyla sunulur: ekibiniz için kopyalayıp uyarlayın ve kendi sürümünüzü yayımladığınızda bu sayfaya bağlantı verin.
İlgili içerikler
- Yapay zekâ kod incelemesi nedir?
- Onaylar ve politikalar
- Politika kuralları referansı
- Yapay zekâ ile kodlama için denetim günlükleri, roller ve politikalar
- Yapay zekâ kod incelemesi kontrol listesi: yapay zekânın yazdığı pull request'ler için 25 kontrol
- Mühendislik ekipleri için yapay zekâ kodlama politikası şablonu (ücretsiz)
- Tüm şablonlar