failproofai 0.0.6-beta.1 → 0.0.6-beta.3

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

@@ -1,10 +1,10 @@
 ---
 title: Yerleşik İlkeler
-description: "Ortak 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, ortak agent başarısızlık modlarını yakalayan 30 yerleşik ilke ile birlikte gelir. Her ilke belirli bir hook olay türü ve araç adında tetiklenir. Dokuz ilke, kod yazmadan davranışlarını ayarlamanıza izin veren parametreleri kabul eder. Dört iş akışı ilkesi, Claude'un durdurmadan önce commit → push → PR → CI işlem hattını 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,46 +12,47 @@ failproofai, ortak agent başarısızlık modlarını yakalayan 30 yerleşik ilk
 
 İ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 |
 | [Veritabanı](#veritabanı) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
 | [Uyarılar](#uyarılar) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
+| [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-`** — ajanı ilerlemekten durdur.
-- **`warn-`** — ajanı kendini düzeltmesi için ek bağlam sağla.
-- **`sanitize-`** — araç çıktısından gizli verileri temizle.
+- **`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 tabanlı ilkeler ile çalışır. Ayrıntılar için [Konfigürasyon → hint](/tr/configuration#hint-cross-cutting) bölümüne bakınız.
+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
 
-Ajanları geri alması zor olan veya ana sistemi hasar görebilecek işlemleri çalıştırmaktan engelleyin.
+Aracıları geri almasi zor veya ana sisteme zarar verebilecek işlemleri çalıştırmaktan alıkoy.
 
 ### `block-sudo`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Herhangi bir `sudo` komutunu reddeder.
+**Varsayılan:** Tüm `sudo` komutlarını reddeder.
 
-`sudo` anahtar kelimesini içeren çağrıları engeller. Desen eşleştirmesi, shell operatör enjeksiyonu yoluyla bypass'ı önlemek için ham dizgiye değil, ayrıştırılmış komut jetonlarında 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 jetonlarına 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:**
 
@@ -65,10 +66,10 @@ Ajanları geri alması zor olan veya ana sistemi hasar görebilecek işlemleri
 }
 ```
 
-Bu yapılandırma ile `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 ayrıştırılmış jetonlara karşı eşleştirilir, ham komut dizgesine değil. Bu, eklenen shell operatörleri yoluyla bypass'ı önler (örn. `sudo systemctl status x; rm -rf /` öğesi `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>
 
 ---
@@ -76,13 +77,13 @@ Desenler ayrıştırılmış jetonlara karşı eşleştirilir, ham komut dizgesi
 ### `block-rm-rf`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** `rm -rf`, `rm -fr` ve benzer özyinelemeli silme biçimlerini reddeder.
+**Varsayılan:** `rm -rf`, `rm -fr` ve benzeri özyinelemeli silme biçimlerini reddeder.
 
 **Parametreler:**
 
-| Parametre | Tür | Varsayılan | Açıklama |
-|-----------|-----|-----------|----------|
-| `allowPaths` | `string[]` | `[]` | Güvenli bir şekilde özyinelemeli olarak silinebilecek yollar (ör. `/tmp`). |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `allowPaths` | `string[]` | `[]` | Özyinelemeli silme işleminin güvenli olduğu yollar (örn. `/tmp`). |
 
 **Örnek:**
 
@@ -101,7 +102,7 @@ Desenler ayrıştırılmış jetonlara karşı eşleştirilir, ham komut dizgesi
 ### `block-curl-pipe-sh`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` ve benzer desenleri reddeder.
+**Varsayılan:** `curl <url> | bash`, `curl <url> | sh`, `wget <url> | bash` ve benzeri desenleri reddeder.
 
 Parametre yok.
 
@@ -110,20 +111,20 @@ Parametre yok.
 ### `block-failproofai-commands`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** failproofai'ın kendisini kaldıracak veya devre dışı bırakacak komutları reddeder (ör. `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)
 
-Ajanları kimlik bilgilerini bağlamlarına veya çıktılarına sızmaktan engelleyin. Sanitizer ilkeleri **PostToolUse** olaylarında tetiklenir. Claude bir Bash komutunu çalıştırdığında, bir dosya okuduğunda veya herhangi bir aracı çağırdığında, bu ilkeler çıktıyı Claude'a geri gelmeden önce inceler. Gizli bir desen algılanırsa, ilke çıktının geri geçirilmesini ö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 jetonlarını (nokta ile ayrılan üç base64url segmenti) gizler.
+**Varsayılan:** JWT tokenlerini (nokta ile ayrılmış üç base64url segmenti) temizler.
 
 Parametre yok.
 
@@ -132,13 +133,13 @@ Parametre yok.
 ### `sanitize-api-keys`
 
 **Olay:** PostToolUse (tüm araçlar)  
-**Varsayılan:** Yaygın API anahtarı biçimlerini gizler: Anthropic (`sk-ant-`), OpenAI (`sk-`), GitHub PAT'ları (`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 }[]` | `[]` | Gizli olarak kabul edilecek ek regex desenleri. |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | Gizli olarak düşünülecek ek regex desenleri. |
 
 **Örnek:**
 
@@ -160,7 +161,7 @@ Parametre yok.
 ### `sanitize-connection-strings`
 
 **Olay:** PostToolUse (tüm araçlar)  
-**Varsayılan:** Gömülü kimlik bilgilerini içeren veritabanı bağlantı dizelerini gizler (ör. `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.
 
@@ -169,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.
 
@@ -178,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 jeton 20 veya daha fazla karakterdir.
+**Varsayılan:** `Authorization: Bearer <token>` başlıklarını temizler; burada token 20 veya daha fazla karakterdir.
 
 Parametre yok.
 
@@ -186,14 +187,14 @@ Parametre yok.
 
 ## Ortam
 
-Gizli ortam yapılandırmasını ajanlar tarafından okunmasından veya maruz kalmasından koruyun.
+Hassas ortam konfigürasyonunu aracılar tarafından okunmaktan veya ortaya çıkarılmaktan koru.
 
 ### `block-env-files`
 
 **Olay:** PreToolUse (Bash, Read)  
-**Varsayılan:** `.env` dosyalarını `cat .env` aracılığıyla okumayı, dosya yolu olarak `.env` olan Read araç çağrılarını, vb. 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 ile ilgili dosyaları engellemiyor; yalnızca tam olarak `.env` adlı dosyaları engeller.
+`.envrc` veya diğer ortam-yakın dosyaları engellemez - yalnızca tam olarak `.env` adlı dosyaları engeller.
 
 Parametre yok.
 
@@ -210,18 +211,18 @@ Parametre yok.
 
 ## Dosya erişimi
 
-Ajanları proje sınırları içinde çalışmakta ve gizli dosyalarından 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:** Mevcut çalışma dizini (proje kökü) dışındaki dosyaları okumayı 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:**
 
@@ -240,13 +241,13 @@ Ajanları proje sınırları içinde çalışmakta ve gizli dosyalarından uzak
 ### `block-secrets-write`
 
 **Olay:** PreToolUse (Write, Edit)  
-**Varsayılan:** Özel anahtarlar ve sertifikalar için yaygın olarak kullanılan dosyalara yazmaları 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[]` | `[]` | Engellecek ek dosya adı desenleri (glob stili). |
+| Param | Tür | Varsayılan | Açıklama |
+|-------|-----|-----------|---------|
+| `additionalPatterns` | `string[]` | `[]` | Engellenecek ek dosya adı desenleri (glob tarzı). |
 
 **Örnek:**
 
@@ -264,7 +265,7 @@ Ajanları proje sınırları içinde çalışmakta ve gizli dosyalarından uzak
 
 ## Git
 
-Geri alması zor olan yanlışlıkla push'ları, force-push'ları ve dal hatalarını engelleyin.
+Yanlışlıkla yapılan push'ları, force-push'ları ve geri almasi zor olan dal hatalarını engelle.
 
 ### `block-push-master`
 
@@ -273,9 +274,9 @@ Geri alması zor olan yanlışlıkla push'ları, force-push'ları ve dal hatalar
 
 **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:**
 
@@ -290,7 +291,7 @@ Geri alması zor olan yanlışlıkla push'ları, force-push'ları ve dal hatalar
 ```
 
 <Tip>
-Tüm dallara push yapılmasına izin vermek için (`enabledPolicies` içinden kaldırmadan bu ilkeyi etkili bir şekilde devre dışı bırakmak için), `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>
 
 ---
@@ -298,13 +299,13 @@ Tüm dallara push yapılmasına izin vermek için (`enabledPolicies` içinden ka
 ### `block-work-on-main`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** `main` veya `master` dallarını doğrudan checkout yapmayı 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ı. |
 
 ---
 
@@ -313,13 +314,13 @@ Tüm dallara push yapılmasına izin vermek için (`enabledPolicies` içinden ka
 **Olay:** PreToolUse (Bash)  
 **Varsayılan:** `git push --force` ve `git push -f` komutlarını reddeder.
 
-İlke özgü parametre yok. Alternatifler önerisi için çapraz kesim [`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 (ör. `git checkout -b <new-branch>`) ve bunu push edin."
+      "hint": "Mevcut HEAD'nizden yeni bir dal oluşturun (örn. `git checkout -b <new-branch>`) ve bunun yerine bu dalı push edin."
     }
   }
 }
@@ -330,7 +331,7 @@ Tüm dallara push yapılmasına izin vermek için (`enabledPolicies` içinden ka
 ### `warn-git-amend`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `git commit --amend` çalıştırırken dikkatli ilerleme talimatı verir. Komutu engellemiyor.
+**Varsayılan:** Claude'a `git commit --amend` çalıştırırken dikkatli olmak üzere talimat verir. Komutu engellmez.
 
 Parametre yok.
 
@@ -339,7 +340,7 @@ Parametre yok.
 ### `warn-git-stash-drop`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `git stash drop` çalıştırmadan önce onay alması talimatı verir. Komutu engellemiyor.
+**Varsayılan:** Claude'a `git stash drop` çalıştırmadan önce onaylaması gerektiğini talimat verir. Komutu engellmez.
 
 Parametre yok.
 
@@ -348,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 neyi staging yaptığını gözden geçirme talimatı verir. Komutu engellemiyor.
+**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.
 
@@ -356,12 +357,12 @@ Parametre yok.
 
 ## Veritabanı
 
-Veritabanınıza karşı yürütülmeden önce yıkıcı SQL işlemlerini yakalayın.
+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 onay alması 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.
 
@@ -370,7 +371,7 @@ Parametre yok.
 ### `warn-schema-alteration`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `ALTER TABLE` ifadeleri çalıştırmadan önce onay alması talimatı verir.
+**Varsayılan:** Claude'a `ALTER TABLE` deyimlerini çalıştırmadan önce onay alması talimatı verir.
 
 Parametre yok.
 
@@ -378,18 +379,18 @@ Parametre yok.
 
 ## Uyarılar
 
-Ajanları potansiyel olarak riskli ancak yıkıcı olmayan işlemlerden önce ek bağlam sağlayın.
+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 onay alması 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). |
+| 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:**
 
@@ -404,7 +405,7 @@ Ajanları potansiyel olarak riskli ancak yıkıcı olmayan işlemlerden önce ek
 ```
 
 <Note>
-Hook işleyicisi yüklerde 1 MB stdin sınırı uygular. Bu ilkeyi küçük içerikle test etmek için `thresholdKb` öğesini 1024'ün 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>
 
 ---
@@ -412,7 +413,7 @@ Hook işleyicisi yüklerde 1 MB stdin sınırı uygular. Bu ilkeyi küçük içe
 ### `warn-package-publish`
 
 **Olay:** PreToolUse (Bash)  
-**Varsayılan:** Claude'u `npm publish` çalıştırmadan önce onay alması talimatı verir.
+**Varsayılan:** Claude'a `npm publish` çalıştırmadan önce onay alması talimatı verir.
 
 Parametre yok.
 
@@ -421,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 olması 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.
 
@@ -430,20 +431,56 @@ 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 onay alması 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.
 
 ---
 
+## Paket yöneticileri
+
+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 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 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 listede yer almayan yöneticileri eklemek için `blocked` kullan.
+
+**Örnek konfigürasyon:**
+
+```json
+{
+  "enabledPolicies": ["prefer-package-manager"],
+  "policyParams": {
+    "prefer-package-manager": {
+      "allowed": ["uv", "bun"],
+      "blocked": ["pdm", "pipx"]
+    }
+  }
+}
+```
+
+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ışı
 
-Ajanların takılı kaldığı veya beklenmedik şekilde davrandığı zamanları algılayın.
+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 veya daha fazla kez aynı parametrelerle çağrıldığında Claude'u yeniden düşünmesi talimatı verir; bu durum ajanın bir döngüde takılı olduğunun yaygın bir işaretidir.
+**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.
 
@@ -451,14 +488,14 @@ Parametre yok.
 
 ## İş akışı
 
-Disiplinli bir oturum sonu iş akışını uygulayın. Bu ilkeler **Stop** olayında tetiklenir ve her koşul karşılanana kadar Claude'u durdurmaktan engeller. Doğal bir bağımlılık zincirini takip eder: commit → push → PR → CI. Bir ilke reddederse, zincirdeki sonraki ilkeler atlanır (deny kısa devre yapar).
+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 **başarısızlık açılır**: gerekli araç kullanılabilir değilse (ör. `gh` kurulmamış, git remote yoksa), ilke kontrol neden atlandığını açıklayan bilgilendirici bir mesaj ile 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:** Değiştirilmemiş değişiklikler varken (değiştirilmiş, staged veya izlenmeyen dosyalar) durdurmayı 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.
 
@@ -467,13 +504,13 @@ Parametre yok.
 ### `require-push-before-stop`
 
 **Olay:** Stop  
-**Varsayılan:** Push edilmemiş commit'ler olduğunda veya geçerli dal izleme dalı olmadığında durdurmayı reddeder. Gerekirse tracking dalı oluşturmak için `git push -u` önerir. Yapılandırılmış remote yoksa açık başarısız 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:**
 
@@ -492,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 durdurmayı reddeder. Claude'u `gh pr create` ile PR oluşturması 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`) kurulu ve kimliği doğrulanmış olmasını gerektirir.
-Pull request'lere okuma erişimi için `repo` kapsamına sahip kişisel erişim jetonuyla `gh auth login` çalıştırın.
-`gh` kurulu veya kimliği doğrulanmamışsa, ilke açık başarısız 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>
 
 ---
@@ -507,14 +544,14 @@ Pull request'lere okuma erişimi için `repo` kapsamına sahip kişisel erişim
 ### `require-ci-green-before-stop`
 
 **Olay:** Stop  
-**Varsayılan:** Geçerli dal üzerinde CI kontrolleri başarısız veya hala çalışıyorsa durdurmayı reddeder. Hem GitHub Actions iş akışı çalıştırmaları hem de üçüncü taraf bot kontrolleri (ör. CodeRabbit, SonarCloud, Codecov) kontrol eder. `skipped` sonuçlarını başarı olarak kabul eder. Tüm kontroller 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`) kurulu ve kimliği doğrulanmış olmasını gerektirir.
-İş akışı çalıştırmalarına okuma erişimi ve Checks API'ye erişim için `repo` kapsamına sahip kişisel erişim jetonuyla `gh auth login` çalıştırın.
-`gh` kurulu veya kimliği doğrulanmamışsa, ilke açık başarısız 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>
 
 ---
@@ -523,7 +560,7 @@ Bu ilke [GitHub CLI](https://cli.github.com/) (`gh`) kurulu ve kimliği doğrula
 
 ## Bireysel ilkeleri devre dışı bırakma
 
-Yapılandırmanızda `enabledPolicies` içinden belirli bir ilkeyi kaldırın veya panonun Policies sekmesinde kapatın.
+Konfigürasyondaki `enabledPolicies`'den belirli bir ilkeyi kaldırın veya gösterge panosunun Policies sekmesinde kapatın.
 
 ```json
 {
@@ -534,4 +571,4 @@ Yapılandırmanızda `enabledPolicies` içinden belirli bir ilkeyi kaldırın ve
 }
 ```
 
-`enabledPolicies` içinde listelenmemiş ilkeler çalışmaz; hatta `policyParams` girdileri olsa bile.
+`enabledPolicies` içinde listelenmemiş ilkeler, `policyParams` girdileri olsa bile çalışmaz.