Mühendislik ekipleri için yapay zekâ kodlama politikası şablonu (ücretsiz)
Matt · · Son güncelleme · 7 dk okuma · Kılavuzlar
Ücretsiz yapay zekâ kodlama politikası şablonu: önemli 8 bölüm, her kuralın neden orada olduğu, kuralların nasıl uygulanacağı ve hayata geçirileceği. .docx veya .md olarak indirin.
Bu sayfada
Bir yapay zekâ kodlama politikası, şirket koduna hangi yapay zekâ araçlarının dokunabileceğini, bu araçların hangi verileri görebileceğini, değişikliklerini kimin incelediğini ve bir merge'ten önce nelerin geçmesi gerektiğini söyler. Bu ücretsiz şablon bunları asıl işi gören sekiz bölümde ele alıyor; bu yazı da her kuralı ve onu bir ayara nasıl dönüştüreceğinizi açıklıyor, böylece kural kimsenin hatırlamadığı gün de geçerli kalır. Bu bir başlangıç şablonudur, hukuki tavsiye değildir.
Neden bir politikaya ihtiyacınız var
Çoğu mühendislik ekibi zaten yapay zekâ kodlama araçları kullanıyor. Bu araçların kurallarını yazıya dökenler ise daha az. Olağan durum bir karmaşadır: bazıları şirketin asistanını kullanır, bazıları kişisel bir hesabı; bir kodlama ajanını bir ekip tek bir repo için kurmuştur ve müşteri verilerinin bir sohbet penceresine hiç yapıştırılıp yapıştırılmadığından kimse emin değildir.
Politika bunu düzeltir, ama yalnızca okunacak kadar kısa ve uygulanacak kadar somutsa. Yapay zekâ kodlama politikası şablonu ikisini birden olmaya çalışıyor. On beş kısa bölümü var: aşağıdaki sekiz bölüm ve her politikanın ihtiyaç duyduğu çerçeve (amaç, kapsam, tanımlar, roller, eğitim ve politikanın ne zaman gözden geçirileceği). Tanımlardan biri çok iş görür: talep eden, yani araca görevini veren kişi, değişikliğin yazarıdır. Böylece "bunu yapay zekâ yazdı" cevabı, "bundan kim sorumlu?" sorusunun yanıtı hiçbir zaman olamaz.
Politikanın 8 bölümü
1. Onaylı araçlar
Şablonun 4. bölümü bir tablodur: şirket kodunda izin verilen araçlar, her birinin ne için kullanılabileceği ve her birinin görebileceği en hassas veri. Hiçbir aracı yasaklamaz. Listede olmayan hiçbir araç, biri onaylayana kadar şirket kodunda kullanılamaz. Bir yasak listesi yazıldıktan bir hafta sonra güncelliğini yitirir; onaylı liste ise hata durumunda güvenli tarafta kalır.
Talep süreci, bir yapay zekâ aracı için önemli olan soruları sorar: hangi veriyi nereye gönderdiği, satıcının bu veriyi ne kadar süre sakladığı, bu veriyle model eğitip eğitmediği ve aracın bir insan olmadan neler yapabildiği. Daha derine inmeniz gerekirse satıcı güvenlik anketi şablonunda, iyi bir yanıtın neye benzediğine dair notlarla birlikte otuz soru var. Her satırın bir sorumlusu vardır, çünkü sorumlusu olmayan bir kural hiç güncellenmez.
2. Veriler ve secret'lar
Şablonun 5. bölümü, herkese açıktan kısıtlıya kadar dört veri sınıfı tanımlar ve hangisinin hangi araca girebileceğini belirler. Secret'lar ve kişisel veriler hiçbir araca girmez. İnsanların kazara çiğnediği bölüm budur; bu yüzden onu CI'da bir secret taramasıyla ve aracın kendi veri kontrolleriyle destekleyin.
3. İnceleme gereksinimleri
Şablonun 7. bölümüne göre yapay zekâ destekli her değişikliği bir insan inceler, başka biri inceleyebiliyorsa talep eden kişi tek onaylayıcı olamaz ve bir onay tek bir sürüm için geçerlidir: bir düzenleme yeniden onay gerektirir. Ajanlarla birlikte bu son kural eskisinden daha önemli hâle geliyor, çünkü takip niteliğindeki "küçük bir düzeltme" göründüğünden büyük olabilir. Bir insanın nerede döngüde kalması gerektiğini insan onayları rehberi anlatıyor. GitHub'da inceleme kuralları branch korumasına karşılık gelir. main için bir branch koruması kuralında şunları açın:
| Ayar | Politika kuralı |
|---|---|
| Require a pull request before merging | 6.1: ajanlar asla main'e push etmez |
| Require approvals | 7.1: her değişikliği bir insan inceler |
| Dismiss stale pull request approvals when new commits are pushed | 7.5: bir onay tek bir sürüm içindir |
| Require approval of the most recent reviewable push | 7.2: onayı başka biri verir |
| Require review from Code Owners | 6.3: korumalı yollar bir sahip gerektirir |
| Require status checks to pass before merging | 8: kalite kapıları |
| Do not allow bypassing the above settings | İstisnalar 13. bölümden geçer |
Sonuncusu göründüğünden daha önemlidir. O olmadan bir Admin'in merge işlemi yukarıdaki her kuralı atlar ve ajanları kuranlar da çoğu zaman Admin'lerdir.
4. Kapılar
Şablonun 8. bölümü, bir merge'ten önce otomasyonla kontrol edilip geçilmesi gerekenleri listeler: tam o sürüm üzerinde çalışan testler, yüksek veya daha üst önem derecesinde açık bulgu olmaması, secret olmaması, izin verilmeyen lisans olmaması ve isteğe bağlı olarak bir kapsam alt sınırı ile bir staging dağıtımı. Bölüm, gözden kaçması kolay bir cümleyle biter: çalışamayan bir kapı geçmiş değil, başarısız sayılır. Bunun alternatifi, tam da en az kontrol ettiği anda yeşil yanan bir pipeline'dır.
AI CodeOps kullanıyorsanız yayın kapısı 8. bölümün çoğunu CI'dan tek bir çağrıyla kontrol eder ve yanıt izin vermedikçe adım başarısız olur:
curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
-H "Authorization: Bearer $WORKSPACE_API_KEY" \
-H "Content-Type: application/json" \
-d "{
\"pullRequestURL\": \"$PR_URL\",
\"blockingSeverity\": \"high\",
\"minCoveragePct\": 80,
\"disallowedLicenses\": [\"AGPL-3.0\"],
\"requireDeployedTo\": \"staging\"
}" \
| jq -e '.allowed == true'
Her alan 8. bölümün bir satırıdır: blockingSeverity 2. kural, disallowedLicenses 4. kural, minCoveragePct isteğe bağlı 5. kural ve requireDeployedTo 6. kuraldır. Başarısız testler varsayılan olarak engeller; bu da 1. kuraldır. 80 değeri ve lisans listesi örnektir: kendi değerlerinizi kullanın. Secret taraması, yani 3. kural, pipeline'ınızda ayrı bir adım olarak kalır.
5. Lisanslama
Şablonun 9. bölümü mühendislerden, yapay zekânın önerdiği kodun lisansını kabul edemeyeceğiniz bir kaynaktan kopyalanmadığını kontrol etmelerini ve araçta böyle bir özellik varsa herkese açık kodla eşleşen önerileri filtreleme özelliğini açmalarını ister. Bir yapay zekâ aracının önerdiği yeni bağımlılıklar da diğer bağımlılıklarla aynı onay sürecinden geçer. Bir yapay zekâ aracının şirket için yazdığı kod şirket kodudur ve ondan talep eden ile onaylayan sorumludur. Bu kuralın bir kontrole dönüştüğü yer, 8. bölümdeki izin verilmeyen lisanslar listesidir.
6. Güvenlik
Şablonun 6. bölümü, kodlama ajanlarının yapabileceklerini sınırlar. Ajanlar branch'lerde çalışır ve main branch'ine asla push etmez, canlı ortam kimlik bilgilerini asla tutmaz, canlı ortama dağıtım yapamaz ve önemli yolları değiştirmek için bir kod sahibinin onayına ihtiyaç duyar. 11. bölüm olayları ele alır: bir araca veri sızdığından şüpheleniliyorsa bu aynı gün bildirilir, yapay zekâ destekli bir değişikliğin yol açtığı bir olay için de suçlamasız bir postmortem yapılır.
6.3. bölüm, ajanların sahiplerinin onayı olmadan değiştiremeyeceği yolları listeler. Buna karşılık gelen CODEOWNERS dosyası şöyle görünür:
# Policy 6.3: paths a coding agent must not change alone.
* @your-org/maintainers
/.github/workflows/ @your-org/platform
/infra/ @your-org/platform
/src/auth/ @your-org/security
/migrations/ @your-org/data
package.json @your-org/platform
/.github/CODEOWNERS @your-org/maintainers
Sıra önemlidir: GitHub'ın kod sahipleri dokümantasyonu “son eşleşen desen en yüksek önceliğe sahiptir” der (24 Ekim 2026'da kontrol edildi); bu yüzden her şeyi yakalayan satır en başa gelir. Son satır dosyanın kendisini korur; böylece bir pull request kendi inceleyicilerini kaldıramaz. Yorumlarla zenginleştirilmiş daha uzun bir sürüm CODEOWNERS başlangıç şablonunda bulunuyor.
AI CodeOps'ta aynı sınırlar bir çalışma alanı politikasıdır: bir eyleme izin veren, onu bir kişinin onayına kadar bekleten ya da reddeden kurallar. 6.3 ve 6.4. bölümler şuna dönüşür:
[
{ "id": "policy-6-3-ci", "action": "diff.apply", "resource": ".github/workflows/**", "decision": "ask" },
{ "id": "policy-6-3-infra", "action": "diff.apply", "resource": "infra/**", "decision": "ask" },
{ "id": "policy-6-3-migrations", "action": "diff.apply", "resource": "migrations/**", "decision": "ask" },
{ "id": "policy-6-4-no-prod", "action": "release.deploy", "resource": "production", "decision": "deny" }
]
Eşleşen kurallardan en katı olanı kazanır; bu yüzden bir kural eklemek başka bir kuralı asla gevşetemez. Her eylemi ve neyle eşleştiğini politika kuralları referansı listeliyor. İşe log-only modunda başlayın: her karar kaydedilir ama hiçbir şey engellenmez; böylece kuralları uygulamaya koymadan önce neleri durduracaklarını görebilirsiniz.
7. Denetim
Şablonun 10. bölümü, her değişiklik için görevi, aracı, talep edeni ve onaylayanı, bulguları, test sonuçlarını ve dağıtımı saklamanızı ister. Çoğu ekipte bunlar beş ayrı sisteme dağılmış durumdadır. AI CodeOps'ta bunlar denetim günlüğünde ve her değişiklik için, herkesin hesap açmadan doğrulayabileceği imzalı bir kanıt paketinde bulunur. İkisini de denetim ve erişim sayfası anlatıyor; regülasyona tabi sektörlerdeki ekipler için ikisinin nasıl bir araya geldiğini ise regülasyona tabi ekipler sayfası ele alıyor.
8. İstisnalar
Şablonun 13. bölümüne göre bir istisna yazılı olarak, gerekçesi, riski ve bir bitiş tarihiyle (şablon 90 günü geçmemesini öneriyor) talep edilir, kayda geçirilir ve sona erdiğinde gözden geçirilir. Bu bölümü gerçek kılan, branch korumasındaki "Do not allow bypassing the above settings" ayarıdır: o olmadan bir Admin'in merge işlemi kayda geçmemiş bir istisnadır.
Şablonun dışarıda bıraktıkları
Şablon araç adı vermez: hangi asistanın veya ajanın doğru olduğu teknoloji yığınınıza, sözleşmelerinize ve verilerinize bağlıdır. Bir kapsam değeri ya da önem derecesi eşiği belirlemez, çünkü bir ödeme servisine uyan alt sınır bir prototip için yanlıştır. Eksiksiz bir yapay zekâ yönetişim çerçevesi olmaya çalışmaz; model riski ve ürününüzün içindeki yapay zekâ, kendi sorumluları olan ayrı konulardır. Ve hukuki tavsiye değildir. Sözleşmeler, regülasyon ve fikri mülkiyet, sizin sürümünüzü yürürlüğe girmeden önce okuması gereken hukuk ekibinizin işidir.
Nasıl hayata geçirilir
Sürpriz olarak gelen bir politika görmezden gelinir. Şu sıra daha iyi işler:
- Önce araç tablosunu doldurun. İnsanların zaten kullandıklarını listeleyin ve onaylayabildiklerinizi onaylayın. Gerçek durumdan yola çıkmak geri kalanını inandırıcı kılar.
- Taslağı araçları en çok kullanan mühendislerle paylaşın. Hangi kuralların gerçek işi engelleyeceğini ve hangilerine seve seve uyacaklarını onlar bilir.
- Mümkün olan yerlerde ayarları log-only veya tavsiye modunda açın. Nelerin engelleneceğine bakın. Yanlış olan kuralları düzeltin.
- Politikayı yayımlayın ve ayarları aynı gün uygulamaya koyun. Belge nedenini söyler; ayarlar onu gerçeğe dönüştürür.
- Gözden geçirme tarihini takvime koyun. Şablona göre bu, altı ayda bir ve yeni türde bir araç benimsediğiniz her seferde yapılır.
Politika her değişikliğin bir insan incelemesinden geçeceğini söylediğinde, inceleyenlerin neye bakacaklarını da bilmeleri gerekir. Yapay zekâ kod incelemesi kontrol listesi ajanın yazdığı kod için 25 kontrol içeriyor; kapı tarafını da kalite kapıları rehberi açıklıyor.
Şablonu indirin
Yapay zekâ kodlama politikası şablonu ücretsizdir ve CC BY 4.0 ile lisanslanmıştır: kopyalayın, değiştirin ve kullanın. Sayfadan .docx veya .md olarak indirin. Sürümünüzü hukuk ekibinizin yanı sıra güvenlik ekibinize de okutun. Bu bir başlangıç şablonudur, hukuki tavsiye değildir.
Önemli çıkarımlar
- Bir yapay zekâ kodlama politikası ancak her kural bir ayara dönüştüğünde işe yarar: branch koruması, kod sahipleri, CI kapıları ve ajan izinleri.
- Araçları yasak listesiyle değil, onaylı listeyle yönetin; böylece yeni bir araç politikanın dışında başlar.
- Görevi yazan kişi değişikliğin yazarıdır ve onun tek onaylayıcısı olamaz.
- Çalışamayan bir kapı başarısızlıktır ve bir onay tek bir sürüm içindir.
- Her kurala bir sorumlu ve bir gözden geçirme tarihi verin; ayarları uygulamaya koymadan önce log-only modunda başlatın.
Sık sorulan sorular
Bir yapay zekâ kodlama politikası neleri içermelidir?
En azından onaylı araçları, veri ve secret kurallarını, inceleme gereksinimlerini, kalite kapılarını, lisanslamayı, kodlama ajanları için güvenlik sınırlarını, denetim kayıtlarını ve bir istisna sürecini. Şablon bunları ve ek olarak kapsamı, rolleri, olayları ve eğitimi ele alır.
Bir yapay zekâ kodlama politikası araçları yasaklamalı mı?
Onaylı bir liste, yasak listesinden daha iyi işler. Listede olmayan hiçbir şey, biri onaylayana kadar şirket kodunda kullanılamaz; böylece yeni bir araç gözden kaçıp içeri sızmak yerine politikanın dışında başlar.
Bu yapay zekâ kodlama politikası şablonu hukuki tavsiye midir?
Hayır. Bir başlangıç şablonudur, hukuki tavsiye değildir. Sizin sürümünüz yürürlüğe girmeden önce onu hukuk ve güvenlik ekiplerinize okutun.
İlgili içerikler
- Mühendislik ekipleri için yapay zekâ kodlama politikası şablonu
- Bir yapay zekâ kodlama iş akışında insan onayları nereye konmalı
- Regülasyona tabi ekipler için AI CodeOps
- Politika kuralları referansı
- Yapay zekâ kodlama ajanlarıyla çalışan repolar için CODEOWNERS başlangıç dosyası
- Yapay zekâ ile kodlama için denetim günlükleri, roller ve politikalar
- Tüm blog yazıları