failproofai 0.0.6-beta.2 → 0.0.6-beta.3

package/.next/standalone/docs/tr/built-in-policies.mdx

@@ -1,10 +1,10 @@
 ---
 title: Yerleşik İlkeler
-description: "Yaygın agent başarısızlık modlarını yakalayan 30 yerleşik ilke"
+description: "Yaygın aracı başarısızlık modlarını yakalayan 30 yerleşik ilke"
 icon: shield
 ---
 
-failproofai, yaygın agent başarısızlık modlarını yakalayan 30 yerleşik ilkeyle birlikte gelir. Her ilke belirli bir hook olay türü ve araç adında tetiklenir. Dokuz ilke, kod yazmadan davranışlarını ayarlamanıza olanak veren parametreleri kabul eder. Dört iş akışı ilkesi, Claude'un durmadan önce commit → push → PR → CI ardışık düzenini uygular.
+failproofai yaygın aracı başarısızlık modlarını yakalayan 30 yerleşik ilke ile birlikte gelir. Her ilke belirli bir kanca olay türü ve araç adında tetiklenir. Dokuz ilke, kod yazmadan davranışlarını ayarlaymanıza izin veren parametreleri kabul eder. Dört iş akışı ilkesi, Claude'un durması öncesinde commit → push → PR → CI boru hattını uygular.
 
 ---
 
@@ -12,10 +12,10 @@ failproofai, yaygın agent başarısızlık modlarını yakalayan 30 yerleşik i
 
 İlkeler kategorilere ayrılmıştır:
 
-| Kategori | İlkeler | Hook türü |
+| Kategori | İlkeler | Kanca türü |
 |----------|---------|-----------|
 | [Tehlikeli komutlar](#tehlikeli-komutlar) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
-| [Sırlar (sanitizers)](#sırlar-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [Gizlilikler (sanitizer'lar)](#gizlilikler-sanitizarlar) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
 | [Ortam](#ortam) | block-env-files, protect-env-vars | PreToolUse |
 | [Dosya erişimi](#dosya-erişimi) | block-read-outside-cwd, block-secrets-write | PreToolUse |
 | [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
@@ -24,35 +24,35 @@ failproofai, yaygın agent başarısızlık modlarını yakalayan 30 yerleşik i
 | [Paket yöneticileri](#paket-yöneticileri) | prefer-package-manager | PreToolUse |
 | [İş akışı](#iş-akışı) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
 
-- **`block-`** — agentin devam etmesini durdur.
-- **`warn-`** — agente kendi kendini düzeltebilmesi için ek bağlam ver.
-- **`sanitize-`** — agent tarafından görülmeden önce aracın çıktısından hassas verileri temizle.
-- **`require-`** — koşullar yerine getirilene kadar Stop olayını engelle.
+- **`block-`** — aracıyı devam etmesini durdur.
+- **`warn-`** — aracıya kendini düzeltmesi için ek bağlam sağla.
+- **`sanitize-`** — aracı görmeden önce araç çıktısından hassas verileri temizle.
+- **`require-`** — koşullar karşılanana kadar Stop olayını engelle.
 
 ---
 
 <Tip>
-Her ilke `policyParams` içinde isteğe bağlı bir `hint` alanını destekler. İpucu, deny veya instruct mesajına eklenir ve Claude tarafından görülür, ilke kodunu değiştirmeden işlem yapılabilir rehberlik sağlar. Yerleşik, özel ve kural ilkeleriyle çalışır. Ayrıntılar için bkz. [Yapılandırma → hint](/tr/configuration#hint-cross-cutting).
+Her ilke `policyParams` içinde isteğe bağlı bir `hint` alanını destekler. İpucu, Claude'un göreceği deny veya instruct mesajına eklenerek, ilke kodunu değiştirmeden işlem yapılabilir rehberlik sağlar. Yerleşik, özel ve konvansiyon ilkeleriyle çalışır. Ayrıntılar için [Konfigürasyon → hint](/tr/configuration#hint-cross-cutting) bölümüne bakın.
 </Tip>
 
 ---
 
 ## Tehlikeli komutlar
 
-Agentleri geri alınması zor olan veya ana bilgisayar sistemine zarar verebilecek işlemlerden koruyun.
+Aracıları geri almasi zor veya ana sisteme zarar verebilecek işlemleri çalıştırmaktan alıkoy.
 
 ### `block-sudo`
 
 **Olay:** PreToolUse (Bash)  
 **Varsayılan:** Tüm `sudo` komutlarını reddeder.
 
-`sudo` anahtar sözcüğünü içeren çağrıları engeller. Desen eşleştirmesi, kabuk operatör enjeksiyonu aracılığıyla bypass'i önlemek için ham dize yerine ayrıştırılmış komut belirteçleri üzerinde yapılır.
+`sudo` anahtar sözcüğünü içeren çağrıları engeller. Model eşleştirmesi kabuk operatör enjeksiyonu aracılığıyla atlatmayı önlemek için ham dizede değil, ayrıştırılmış komut tokenlerinde yapılır.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `allowPatterns` | `string[]` | `[]` | İzin verilen tam komut önekleri. Her giriş ayrıştırılmış argv belirteçlerine karşı eşleştirilir. |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `allowPatterns` | `string[]` | `[]` | İzin verilen tam komut önekleri. Her giriş, ayrıştırılmış argv tokenlerine göre eşleştirilir. |
 
 **Örnek:**
 
@@ -66,10 +66,10 @@ Agentleri geri alınması zor olan veya ana bilgisayar sistemine zarar verebilec
 }
 ```
 
-Bu yapılandırmayla, `sudo systemctl status nginx` izin verilir, ancak `sudo rm /etc/hosts` reddedilir.
+Bu konfigürasyon ile `sudo systemctl status nginx` izin verilir, ancak `sudo rm /etc/hosts` reddedilir.
 
 <Note>
-Desenler ham komut dizesi değil, ayrıştırılmış belirteçlere karşı eşleştirilir. Bu, eklenen kabuk operatörleri aracılığıyla bypass'i önler (örneğin `sudo systemctl status x; rm -rf /` `sudo systemctl status *` ile eşleşmez).
+Desenler ham komut dizesinde değil, ayrıştırılmış tokenler karşısında eşleştirilir. Bu, eklenen kabuk operatörleri aracılığıyla atlatmayı önler (örn. `sudo systemctl status x; rm -rf /` `sudo systemctl status *` ile eşleşmez).
 </Note>
 
 ---
@@ -77,13 +77,13 @@ Desenler ham komut dizesi değil, ayrıştırılmış belirteçlere karşı eşl
 ### `block-rm-rf`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** `rm -rf`, `rm -fr` ve benzeri özyinelemeli silme formlarını reddeder.
+**Varsayılan:** `rm -rf`, `rm -fr` ve benzeri özyinelemeli silme biçimlerini reddeder.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `allowPaths` | `string[]` | `[]` | Özyinelemeli olarak silinmesi güvenli olan yollar (örneğin `/tmp`). |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `allowPaths` | `string[]` | `[]` | Özyinelemeli silme işleminin güvenli olduğu yollar (örn. `/tmp`). |
 
 **Örnek:**
 
@@ -111,20 +111,20 @@ Parametre yok.
 ### `block-failproofai-commands`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** failproofai'yi kendisini kaldıracak veya devre dışı bırakacak komutları reddeder (örneğin `npm uninstall failproofai`, `failproofai policies --uninstall`).
+**Varsayılan:** failproofai'nı kendisini kaldıracak veya devre dışı bırakacak komutları reddeder (örn. `npm uninstall failproofai`, `failproofai policies --uninstall`).
 
 Parametre yok.
 
 ---
 
-## Sırlar (sanitizers)
+## Gizlilikler (sanitizer'lar)
 
-Agentlerin kimlik bilgilerini bağlamlarına veya çıktılarına sızdırmasını önleyin. Sanitizer ilkeleri **PostToolUse** olaylarında tetiklenir. Claude bir Bash komutu çalıştırdığında, bir dosya okuduğunda veya herhangi bir araç çağırdığında, bu ilkeler Claude'a döndürülmeden önce çıktıyı inceler. Bir sır deseni algılanırsa, ilke çıktının geri iletilmesini önleyen bir deny kararı döndürür.
+Aracıların kimlik bilgilerini bağlamlarına veya çıktılarına sızmasını engelle. Sanitizer ilkeleri **PostToolUse** olaylarında tetiklenir. Claude bir Bash komutu çalıştırdığında, bir dosya okuduğunda veya herhangi bir aracı çağırdığında, bu ilkeler Claude'a döndürülmeden önce çıktıyı inceler. Gizli bir desen algılanırsa, ilke çıktının geri geçmesini önleyen bir deny kararı döndürür.
 
 ### `sanitize-jwt`
 
 **Olay:** PostToolUse (tüm araçlar)  
-**Varsayılan:** JWT belirteçlerini gizler (`.` ile ayrılmış üç base64url segmenti).
+**Varsayılan:** JWT tokenlerini (nokta ile ayrılmış üç base64url segmenti) temizler.
 
 Parametre yok.
 
@@ -133,13 +133,13 @@ Parametre yok.
 ### `sanitize-api-keys`
 
 **Olay:** PostToolUse (tüm araçlar)  
-**Varsayılan:** Yaygın API anahtarı formatlarını gizler: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PATs (`ghp_`), AWS erişim anahtarları (`AKIA`), Stripe anahtarları (`sk_live_`, `sk_test_`) ve Google API anahtarları (`AIza`).
+**Varsayılan:** Yaygın API anahtarı biçimlerini temizler: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PAT'leri (`ghp_`), AWS erişim anahtarları (`AKIA`), Stripe anahtarları (`sk_live_`, `sk_test_`) ve Google API anahtarları (`AIza`).
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | Sır olarak değerlendirilecek ek regex desenleri. |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | Gizli olarak düşünülecek ek regex desenleri. |
 
 **Örnek:**
 
@@ -148,8 +148,8 @@ Parametre yok.
   "policyParams": {
     "sanitize-api-keys": {
       "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo iç API anahtarı" },
-        { "regex": "pat_[0-9a-f]{40}", "label": "İç PAT" }
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo internal API key" },
+        { "regex": "pat_[0-9a-f]{40}", "label": "Internal PAT" }
       ]
     }
   }
@@ -161,7 +161,7 @@ Parametre yok.
 ### `sanitize-connection-strings`
 
 **Olay:** PostToolUse (tüm araçlar)  
-**Varsayılan:** Gömülü kimlik bilgileri içeren veritabanı bağlantı dizelerini gizler (örneğin `postgresql://user:password@host/db`).
+**Varsayılan:** Gömülü kimlik bilgileri içeren veritabanı bağlantı dizelerini temizler (örn. `postgresql://user:password@host/db`).
 
 Parametre yok.
 
@@ -170,7 +170,7 @@ Parametre yok.
 ### `sanitize-private-key-content`
 
 **Olay:** PostToolUse (tüm araçlar)  
-**Varsayılan:** PEM bloklarını gizler (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, vb.).
+**Varsayılan:** PEM bloklarını temizler (`-----BEGIN PRIVATE KEY-----`, `-----BEGIN RSA PRIVATE KEY-----`, vb.).
 
 Parametre yok.
 
@@ -179,7 +179,7 @@ Parametre yok.
 ### `sanitize-bearer-tokens`
 
 **Olay:** PostToolUse (tüm araçlar)  
-**Varsayılan:** `Authorization: Bearer <token>` başlıklarını gizler; burada belirteç 20 veya daha fazla karakter içerir.
+**Varsayılan:** `Authorization: Bearer <token>` başlıklarını temizler; burada token 20 veya daha fazla karakterdir.
 
 Parametre yok.
 
@@ -187,14 +187,14 @@ Parametre yok.
 
 ## Ortam
 
-Hassas ortam yapılandırmasını agentler tarafından okunmaktan veya açığa çıkmaktan koruyun.
+Hassas ortam konfigürasyonunu aracılar tarafından okunmaktan veya ortaya çıkarılmaktan koru.
 
 ### `block-env-files`
 
 **Olay:** PreToolUse (Bash, Read)  
-**Varsayılan:** `cat .env`, dosya yolu olarak `.env` olan Read aracı çağrıları vb. aracılığıyla `.env` dosyalarını okumasını reddeder.
+**Varsayılan:** `.env` dosyalarının `cat .env`, dosya yolu olarak `.env` ile Read araç çağrıları vb. aracılığıyla okunmasını reddeder.
 
-`.envrc` veya diğer ortam-ilgili dosyaları engelleme — yalnızca `.env` adıyla tam olarak adlandırılan dosyaları engeller.
+`.envrc` veya diğer ortam-yakın dosyaları engellemez - yalnızca tam olarak `.env` adlı dosyaları engeller.
 
 Parametre yok.
 
@@ -203,7 +203,7 @@ Parametre yok.
 ### `protect-env-vars`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Ortam değişkenlerini yazdıran komutları reddeder: `printenv`, `env`, `echo $VAR`.
+**Varsayılan:** Ortam değişkenlerini yazdıracak komutları reddeder: `printenv`, `env`, `echo $VAR`.
 
 Parametre yok.
 
@@ -211,18 +211,18 @@ Parametre yok.
 
 ## Dosya erişimi
 
-Agentleri proje sınırlarının içinde ve hassas dosyalardan uzak tutun.
+Aracıları proje sınırları içinde tutun ve hassas dosyalardan uzak tut.
 
 ### `block-read-outside-cwd`
 
 **Olay:** PreToolUse (Read, Bash)  
-**Varsayılan:** Geçerli çalışma dizini (proje kökü) dışındaki dosyaları okumasını reddeder.
+**Varsayılan:** Geçerli çalışma dizini dışındaki dosyaları (proje kökü) okumayı reddeder.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `allowPaths` | `string[]` | `[]` | Cwd dışında olsa bile izin verilen mutlak yol önekleri. |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `allowPaths` | `string[]` | `[]` | cwd dışında olsa bile izin verilen mutlak yol ön ekleri. |
 
 **Örnek:**
 
@@ -241,13 +241,13 @@ Agentleri proje sınırlarının içinde ve hassas dosyalardan uzak tutun.
 ### `block-secrets-write`
 
 **Olay:** PreToolUse (Write, Edit)  
-**Varsayılan:** Özel anahtarlar ve sertifikalar için yaygın olarak kullanılan dosyalara yazmasını reddeder: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
+**Varsayılan:** Özel anahtarlar ve sertifikalar için yaygın olarak kullanılan dosyalara yazma işlemlerini reddeder: `id_rsa`, `id_ed25519`, `*.key`, `*.pem`, `*.p12`, `*.pfx`.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `additionalPatterns` | `string[]` | `[]` | Engellenmesi gereken ek dosya adı desenleri (glob stilinde). |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `additionalPatterns` | `string[]` | `[]` | Engellenecek ek dosya adı desenleri (glob tarzı). |
 
 **Örnek:**
 
@@ -265,7 +265,7 @@ Agentleri proje sınırlarının içinde ve hassas dosyalardan uzak tutun.
 
 ## Git
 
-Yanlışlıkla push, force-push ve geri alınması zor olan dal hatalarını önleyin.
+Yanlışlıkla yapılan push'ları, force-push'ları ve geri almasi zor olan dal hatalarını engelle.
 
 ### `block-push-master`
 
@@ -274,9 +274,9 @@ Yanlışlıkla push, force-push ve geri alınması zor olan dal hatalarını ön
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | Doğrudan push yapılamayan dal adları. |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Doğrudan push'a karşı korunan dal adları. |
 
 **Örnek:**
 
@@ -291,7 +291,7 @@ Yanlışlıkla push, force-push ve geri alınması zor olan dal hatalarını ön
 ```
 
 <Tip>
-Tüm dallara push yapmaya izin vermek için (bu ilkeyi `enabledPolicies` öğesinden kaldırmadan etkili bir şekilde devre dışı bırakmak), `protectedBranches: []` olarak ayarlayın.
+Tüm dallara push yapmaya izin vermek için (bu ilkeyi `enabledPolicies`'den kaldırmadan etkili bir şekilde devre dışı bırakmak için) `protectedBranches: []` olarak ayarlayın.
 </Tip>
 
 ---
@@ -299,13 +299,13 @@ Tüm dallara push yapmaya izin vermek için (bu ilkeyi `enabledPolicies` öğesi
 ### `block-work-on-main`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** `main` veya `master` dallarına doğrudan checkout yapmasını reddeder.
+**Varsayılan:** `main` veya `master` dallarının doğrudan kontrol edilmesini reddeder.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | Doğrudan checkout yapılamayan dal adları. |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `protectedBranches` | `string[]` | `["main", "master"]` | Doğrudan kontrol edilemeyecek dal adları. |
 
 ---
 
@@ -314,13 +314,13 @@ Tüm dallara push yapmaya izin vermek için (bu ilkeyi `enabledPolicies` öğesi
 **Olay:** PreToolUse (Bash)  
 **Varsayılan:** `git push --force` ve `git push -f` komutlarını reddeder.
 
-İlkeye özgü parametre yok. Alternatif önerisi için çapraz kesitli [`hint`](/tr/configuration#hint-cross-cutting) kullanın:
+İlkeye özel parametre yok. Alternatif önermeleri için çapraz kesim [`hint`](/tr/configuration#hint-cross-cutting) kullan:
 
 ```json
 {
   "policyParams": {
     "block-force-push": {
-      "hint": "Geçerli HEAD'inizden yeni bir dal oluşturun (örneğin `git checkout -b <new-branch>`) ve onun yerine o dalı push edin."
+      "hint": "Mevcut HEAD'nizden yeni bir dal oluşturun (örn. `git checkout -b <new-branch>`) ve bunun yerine bu dalı push edin."
     }
   }
 }
@@ -331,7 +331,7 @@ Tüm dallara push yapmaya izin vermek için (bu ilkeyi `enabledPolicies` öğesi
 ### `warn-git-amend`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `git commit --amend` çalıştırırken dikkatli olmaya talimat verir. Komutu engelleme.
+**Varsayılan:** Claude'a `git commit --amend` çalıştırırken dikkatli olmak üzere talimat verir. Komutu engellmez.
 
 Parametre yok.
 
@@ -340,7 +340,7 @@ Parametre yok.
 ### `warn-git-stash-drop`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `git stash drop` çalıştırmadan önce onaylamaya talimat verir. Komutu engelleme.
+**Varsayılan:** Claude'a `git stash drop` çalıştırmadan önce onaylaması gerektiğini talimat verir. Komutu engellmez.
 
 Parametre yok.
 
@@ -349,7 +349,7 @@ Parametre yok.
 ### `warn-all-files-staged`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `git add -A` veya `git add .` çalıştırdığında stage aldığı şeyleri incelemeye talimat verir. Komutu engelleme.
+**Varsayılan:** Claude'a `git add -A` veya `git add .` çalıştırdığında sahneye aldığı şeyi gözden geçirmesini talimat verir. Komutu engellmez.
 
 Parametre yok.
 
@@ -357,12 +357,12 @@ Parametre yok.
 
 ## Veritabanı
 
-Yıkıcı SQL işlemlerini veritabanınıza karşı yürütülmeden önce yakala.
+Veritabanınıza karşı yürütülmeden önce yıkıcı SQL işlemlerini yakala.
 
 ### `warn-destructive-sql`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `DROP TABLE`, `DROP DATABASE` veya `WHERE` yan tümcesi olmayan `DELETE` içeren SQL çalıştırmadan önce onaylamaya talimat verir.
+**Varsayılan:** Claude'a `DROP TABLE`, `DROP DATABASE` veya `WHERE` cümlesi olmayan `DELETE` içeren SQL'i çalıştırmadan önce onay alması talimatı verir.
 
 Parametre yok.
 
@@ -371,7 +371,7 @@ Parametre yok.
 ### `warn-schema-alteration`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `ALTER TABLE` ifadeleri çalıştırmadan önce onaylamaya talimat verir.
+**Varsayılan:** Claude'a `ALTER TABLE` deyimlerini çalıştırmadan önce onay alması talimatı verir.
 
 Parametre yok.
 
@@ -379,18 +379,18 @@ Parametre yok.
 
 ## Uyarılar
 
-Agentlere potansiyel olarak riskli ama yıkıcı olmayan işlemlerden önce ekstra bağlam verin.
+Aracılara potansiyel olarak riskli ancak yıkıcı olmayan işlemler öncesinde ekstra bağlam sağla.
 
 ### `warn-large-file-write`
 
 **Olay:** PreToolUse (Write)  
-**Varsayılan:** Claude'u 1024 KB'tan büyük dosyalar yazmadan önce onaylamaya talimat verir.
+**Varsayılan:** Claude'a 1024 KB'tan daha büyük dosya yazmadan önce onay alması talimatı verir.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `thresholdKb` | `number` | `1024` | Uyarı verilen dosya boyutu eşiği (kilobayt cinsinden). |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `thresholdKb` | `number` | `1024` | Dosya boyutu eşiği, kilobayt cinsinden; bu değerin üzerinde bir uyarı verilir. |
 
 **Örnek:**
 
@@ -405,7 +405,7 @@ Agentlere potansiyel olarak riskli ama yıkıcı olmayan işlemlerden önce ekst
 ```
 
 <Note>
-Hook işleyicisi yükleri için 1 MB stdin sınırını uygular. Bu ilkeyi küçük içerikle test etmek için `thresholdKb` değerini 1024'ün çok altında bir değere ayarlayın.
+Kanca işleyicisi yükümlülükler için 1 MB stdin sınırını uygular. Bu ilkeyi küçük içerikle test etmek için `thresholdKb`'yi 1024'ten çok daha düşük bir değere ayarlayın.
 </Note>
 
 ---
@@ -413,7 +413,7 @@ Hook işleyicisi yükleri için 1 MB stdin sınırını uygular. Bu ilkeyi küç
 ### `warn-package-publish`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `npm publish` çalıştırmadan önce onaylamaya talimat verir.
+**Varsayılan:** Claude'a `npm publish` çalıştırmadan önce onay alması talimatı verir.
 
 Parametre yok.
 
@@ -422,7 +422,7 @@ Parametre yok.
 ### `warn-background-process`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `nohup`, `&`, `disown` veya `screen` aracılığıyla arka plan işlemleri başlatırken dikkatli olmaya talimat verir.
+**Varsayılan:** Claude'a `nohup`, `&`, `disown` veya `screen` aracılığıyla arka plan işlemleri başlatırken dikkatli olmak talimatı verir.
 
 Parametre yok.
 
@@ -431,7 +431,7 @@ Parametre yok.
 ### `warn-global-package-install`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `npm install -g`, `yarn global add` veya sanal ortam olmadan `pip install` çalıştırmadan önce onaylamaya talimat verir.
+**Varsayılan:** Claude'a `npm install -g`, `yarn global add` veya sanal ortam olmayan `pip install` çalıştırmadan önce onay alması talimatı verir.
 
 Parametre yok.
 
@@ -439,23 +439,23 @@ Parametre yok.
 
 ## Paket yöneticileri
 
-Agentin hangi paket yöneticilerini kullanmasına izin verildiğini uygula.
+Aracının kullanmasına izin verilen paket yöneticilerini zorunlu kıl.
 
 ### `prefer-package-manager`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Devre dışı. Etkinleştirildiğinde, `allowed` listesinde olmayan herhangi bir paket yöneticisi komutunu engeller ve Claude'a komutu izin verilen bir yöneticiyi kullanarak yeniden yazmasını söyler.
+**Varsayılan:** Devre dışı. Etkinleştirildiğinde, `allowed` listesinde olmayan paket yöneticisi komutunu engeller ve Claude'a komutu izin verilen bir yöneticiyi kullanarak yeniden yazması talimatı verir.
 
 Algılar: pip, pip3, python -m pip, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo.
 
 | Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `allowed` | string[] | `[]` | İzin verilen paket yöneticisi adları. Bu listedeki olmayan algılanan herhangi bir yönetici engellenir. Boş olduğunda, ilke hiçbir işlev görmez. |
-| `blocked` | string[] | `[]` | Yerleşik listenin ötesinde engellenecek ek yönetici adları (örneğin `['pdm', 'pipx']`). |
+|-----------|-----|-----------|---------|
+| `allowed` | string[] | `[]` | İzin verilen paket yöneticisi adları. Bu listede olmayan herhangi bir algılanan yönetici engellenir. Boş olduğunda, ilke işlem yapmaz. |
+| `blocked` | string[] | `[]` | Yerleşik listenin ötesinde engellenecek ek yönetici adları (örn. `['pdm', 'pipx']`). |
 
-Yerleşik engel listesi şunları kapsar: pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo. Bu listedeki olmayan yöneticiler için `blocked` kullanın.
+Yerleşik engel listesi şunları kapsar: pip, pip3, npm, npx, yarn, pnpm, pnpx, bun, bunx, uv, poetry, pipenv, conda, cargo. Bu listede yer almayan yöneticileri eklemek için `blocked` kullan.
 
-**Örnek yapılandırma:**
+**Örnek konfigürasyon:**
 
 ```json
 {
@@ -469,18 +469,18 @@ Yerleşik engel listesi şunları kapsar: pip, pip3, npm, npx, yarn, pnpm, pnpx,
 }
 ```
 
-Bu yapılandırmayla, `pip install flask` ve `pdm install flask` her ikisi de reddedilir ve Claude'a bunun yerine `uv` veya `bun` kullanmasını söyleyen bir mesaj alırız. `uv pip install flask` gibi komutlar izin verilir çünkü `uv` allowlist'te ve ilk olarak kontrol edilir.
+Bu konfigürasyonda `pip install flask` ve `pdm install flask` her ikisi de Claude'a bunun yerine `uv` veya `bun` kullanması söyleyen bir mesajla reddedilir. `uv` izin listesinde olduğu ve ilk kontrol edilen olduğu için `uv pip install flask` gibi komutlar izin verilir.
 
 ---
 
 ## AI davranışı
 
-Agentlerin sıkışıp kalması veya beklenmedik şekilde davranması durumlarını tespit edin.
+Aracıların takılı kaldığını veya beklenmedik şekilde davrandığını algıla.
 
 ### `warn-repeated-tool-calls`
 
 **Olay:** PreToolUse (tüm araçlar)  
-**Varsayılan:** Aynı araç 3+ kez aynı parametrelerle çağrıldığında Claude'u yeniden düşünmeye talimat verir — agentin bir döngüye takılı olduğunun yaygın bir işareti.
+**Varsayılan:** Claude'a aynı aracı aynı parametrelerle 3 veya daha fazla kez çağırdığında - aracının bir döngüde takılı olduğunun yaygın işareti - düşünmesi gerektiğini talimat verir.
 
 Parametre yok.
 
@@ -488,14 +488,14 @@ Parametre yok.
 
 ## İş akışı
 
-Disiplinli bir oturum sonu iş akışını uygula. Bu ilkeler **Stop** olayında tetiklenir ve Claude'un her koşul yerine getirilene kadar duramadığını reddeder. Bunlar doğal bir bağımlılık zinciri izler: commit → push → PR → CI. Bir ilke reddederse, zincirdeki sonraki ilkeler atlanır (deny kısa devre yapılır).
+Disiplinli bir oturum sonu iş akışını zorunlu kıl. Bu ilkeler **Stop** olayında tetiklenir ve her koşul karşılanana kadar Claude'un durmasını engeller. Doğal bir bağımlılık zinciri izlerler: commit → push → PR → CI. Bir ilke reddederse, zincirdeki sonraki ilkeler atlanır (deny kısa devreler).
 
-Tüm iş akışı ilkeleri **fail-open** modundadır: gerekli araç mevcut değilse (örneğin `gh` yüklü değil, git remote yok), ilke denetimin neden atlandığını açıklayan bilgilendirici bir mesajla izin verir.
+Tüm iş akışı ilkeleri **başarısız-açık**: gerekli araç mevcut değilse (örn. `gh` kurulu değil, git remote yok), ilke neden kontrolün atlandığını açıklayan bir bilgilendirme mesajı ile izin verir.
 
 ### `require-commit-before-stop`
 
 **Olay:** Stop  
-**Varsayılan:** İşlenmemiş değişiklikler (değiştirilmiş, staged veya izlenmeyen dosyalar) olduğunda durmasını reddeder. Çalışma dizini temiz olduğunda bilgilendirici bir mesaj döndürür.
+**Varsayılan:** Taahhüt edilmemiş değişiklikler olduğunda (değiştirilen, sahneye alınan veya izlenmemiş dosyalar) durmasını engeller. Çalışma dizini temiz olduğunda bilgilendirici bir mesaj döndürür.
 
 Parametre yok.
 
@@ -504,13 +504,13 @@ Parametre yok.
 ### `require-push-before-stop`
 
 **Olay:** Stop  
-**Varsayılan:** Push yapılmamış taahhütler olduğunda veya geçerli dalın uzak izleme dalı olmadığında durmasını reddeder. Gerekirse izleme dalı oluşturmak için `git push -u` önerir. Hiçbir remote yapılandırılmadıysa fail-open olur.
+**Varsayılan:** Gönderilmemiş commits olduğunda veya mevcut dal hiçbir uzak izleme dalına sahip olmadığında durmasını engeller. Gerekirse izleme dalı oluşturmak için `git push -u` önerir. Hiçbir uzak yapılandırılmadıysa açık başarısız olur.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `remote` | `string` | `"origin"` | Push yapılacak remote adı. |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `remote` | `string` | `"origin"` | Push yapılacak uzak adı. |
 
 **Örnek:**
 
@@ -529,14 +529,14 @@ Parametre yok.
 ### `require-pr-before-stop`
 
 **Olay:** Stop  
-**Varsayılan:** Geçerli dal için pull request yoksa veya mevcut PR kapalı/merge edilmişse durmasını reddeder. Claude'a `gh pr create` ile PR oluşturmasını talimat verir.
+**Varsayılan:** Mevcut dal için hiçbir pull request yoksa veya mevcut PR kapalı/birleştirilmişse durmasını engeller. Claude'a `gh pr create` ile bir PR oluşturması talimatı verir.
 
 Parametre yok.
 
 <Note>
-Bu ilke [GitHub CLI](https://cli.github.com/) (`gh`) yüklü ve kimlik doğrulaması yapılmış olmasını gerektirir.
-`gh auth login` komutunu pull request'lere okuma erişimi için `repo` kapsamına sahip kişisel erişim belirteci ile çalıştırın.
-`gh` yüklü değilse veya kimlik doğrulaması yapılmadıysa, ilke fail-open olur ve nedeni Claude'a bildirir.
+Bu ilke, [GitHub CLI](https://cli.github.com/) (`gh`) kurulu ve kimlik doğrulamasından geçmiş olmasını gerektirir.
+`gh auth login` komutunu, pull request'leri okumak için `repo` kapsamı olan bir kişisel erişim tokeni ile çalıştırın.
+`gh` kurulu değilse veya kimlik doğrulaması yapılmamışsa, ilke açık başarısız olur ve nedeni Claude'a raporlar.
 </Note>
 
 ---
@@ -544,14 +544,14 @@ Bu ilke [GitHub CLI](https://cli.github.com/) (`gh`) yüklü ve kimlik doğrulam
 ### `require-ci-green-before-stop`
 
 **Olay:** Stop  
-**Varsayılan:** Geçerli dal üzerinde CI denetimi başarısız olduğunda veya çalışmaya devam ettiğinde durmasını reddeder. Hem GitHub Actions iş akışı çalıştırmalarını hem de üçüncü taraf bot denetimlerini kontrol eder (örneğin CodeRabbit, SonarCloud, Codecov). `skipped` sonuçlarını başarı olarak değerlendirir. Tüm denetimler geçtiğinde bilgilendirici bir mesaj döndürür.
+**Varsayılan:** Mevcut dal üzerinde CI kontrolleri başarısız olduğunda veya hâlâ çalışırken durmasını engeller. GitHub Actions iş akışı çalıştırmaları ve üçüncü taraf bot kontrolleri (örn. CodeRabbit, SonarCloud, Codecov) ikisini de kontrol eder. `skipped` ve `cancelled` sonuçlarını başarı olarak değerlendirir. Tüm kontroller geçtiğinde bilgilendirici bir mesaj döndürür.
 
 Parametre yok.
 
 <Note>
-Bu ilke [GitHub CLI](https://cli.github.com/) (`gh`) yüklü ve kimlik doğrulaması yapılmış olmasını gerektirir.
-`gh auth login` komutunu Actions iş akışı çalıştırmalarına ve Checks API'ye okuma erişimi için `repo` kapsamına sahip kişisel erişim belirteci ile çalıştırın.
-`gh` yüklü değilse veya kimlik doğrulaması yapılmadıysa, ilke fail-open olur ve nedeni Claude'a bildirir.
+Bu ilke, [GitHub CLI](https://cli.github.com/) (`gh`) kurulu ve kimlik doğrulamasından geçmiş olmasını gerektirir.
+`gh auth login` komutunu, Actions iş akışı çalıştırmalarına ve Checks API'sine okuma erişimi için `repo` kapsamı olan bir kişisel erişim tokeni ile çalıştırın.
+`gh` kurulu değilse veya kimlik doğrulaması yapılmamışsa, ilke açık başarısız olur ve nedeni Claude'a raporlar.
 </Note>
 
 ---
@@ -560,7 +560,7 @@ Bu ilke [GitHub CLI](https://cli.github.com/) (`gh`) yüklü ve kimlik doğrulam
 
 ## Bireysel ilkeleri devre dışı bırakma
 
-Yapılandırmanızdaki `enabledPolicies` öğesinden belirli bir ilkeyi kaldırın veya pano'nun İlkeler sekmesinde devre dışı bırakın.
+Konfigürasyondaki `enabledPolicies`'den belirli bir ilkeyi kaldırın veya gösterge panosunun Policies sekmesinde kapatın.
 
 ```json
 {
@@ -571,4 +571,4 @@ Yapılandırmanızdaki `enabledPolicies` öğesinden belirli bir ilkeyi kaldır
 }
 ```
 
-`enabledPolicies` listesinde yer almayan ilkeler, `policyParams` girişleri olsa bile çalışmaz.
+`enabledPolicies` içinde listelenmemiş ilkeler, `policyParams` girdileri olsa bile çalışmaz.