failproofai 0.0.6-beta.0 → 0.0.6-beta.2

package/.next/standalone/docs/tr/custom-policies.mdx

@@ -1,11 +1,10 @@
 ---
----
 title: Özel İlkeler
-description: "JavaScript'te kendi ilkelerinizi yazın - kuralları uygulayın, kaymaları önleyin, arızaları tespit edin, dış sistemlerle entegre olun"
+description: "JavaScript'te kendi ilkelerinizi yazın - kuralları uygulayın, sapmaları önleyin, hataları tespit edin, dış sistemlerle entegre olun"
 icon: code
 ---
 
-Özel ilkeler, herhangi bir agent davranışı için kurallar yazmanıza izin verir: proje kurallarını uygulayın, kaymaları önleyin, yıkıcı işlemleri engelleyin, takılmış agent'ları tespit edin veya Slack, onay iş akışları ve daha fazlasıyla entegre olun. Yerleşik ilkelerle aynı hook event sistemini ve `allow`, `deny`, `instruct` kararlarını kullanırlar.
+Özel ilkeler, herhangi bir agent davranışı için kurallar yazmanızı sağlar: proje kurallarını uygulayın, sapmaları önleyin, yıkıcı işlemleri kontrol edin, takılı kalmış aracıları tespit edin veya Slack, onay iş akışları ve daha fazlası ile entegre olun. Yerleşik ilkeler ile aynı hook event sistemini ve `allow`, `deny`, `instruct` kararlarını kullanırlar.
 
 ---
 
@@ -40,34 +39,34 @@ failproofai policies --install --custom ./my-policies.js
 
 ## Özel ilkeleri yüklemenin iki yolu
 
-### Seçenek 1: Kural tabanlı (önerilir)
+### Seçenek 1: Kural tabanlı (önerilen)
 
-`*policies.{js,mjs,ts}` dosyalarını `.failproofai/policies/` dizinine bırakın ve otomatik olarak yüklenir — bayrak veya yapılandırma değişikliğine gerek yoktur. Bu, git hook'ları gibi çalışır: bir dosya bırakın, çalışır.
+`*policies.{js,mjs,ts}` dosyalarını `.failproofai/policies/` klasörüne koyun ve otomatik olarak yüklenir — hiçbir bayrak veya yapılandırma değişikliği gerekmez. Bu git hooks gibi çalışır: dosyayı koyun, işte bu kadar.
 
 ```
-# Proje düzeyi — git'e kaydedilir, takımla paylaşılır
+# Proje düzeyi — git'e kaydedilir, takım ile paylaşılır
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Kullanıcı düzeyi — kişisel, tüm projelere uygulanır
+# Kullanıcı düzeyi — kişisel, tüm projeler için geçerli
 ~/.failproofai/policies/my-policies.mjs
 ```
 
 **Nasıl çalışır:**
-- Hem proje hem de kullanıcı dizinleri taranır (birleşim — ilk kapsam kazanmaz)
-- Dosyalar her dizin içinde alfabetik olarak yüklenir. Sırayı kontrol etmek için `01-`, `02-` ön eki ekleyin
-- Yalnızca `*policies.{js,mjs,ts}` ile eşleşen dosyalar yüklenir; diğer dosyalar yoksayılır
+- Hem proje hem de kullanıcı dizinleri taranır (birleşim — ilk kapsam kazanması değil)
+- Dosyalar her klasöre alfabetik olarak yüklenir. Sırayı kontrol etmek için `01-`, `02-` ön ekini kullanın
+- Sadece `*policies.{js,mjs,ts}` ile eşleşen dosyalar yüklenir; diğer dosyalar göz ardı edilir
 - Her dosya bağımsız olarak yüklenir (dosya başına açık başarısızlık)
-- Açık `--custom` ve yerleşik ilkelerle birlikte çalışır
+- Açık `--custom` ve yerleşik ilkeler ile yan yana çalışır
 
 <Tip>
-Kural tabanlı ilkeler, ilkeleri bir takım arasında paylaşmanın en kolay yoludur. `.failproofai/policies/` öğesini git'e gönderin ve her takım üyesi otomatik olarak bunları alır.
+Kural tabanlı ilkeler, kuruluşunuz için bir kalite standardı oluşturmanın en kolay yoludur. `.failproofai/policies/` git'e kaydedin ve her takım üyesi otomatik olarak aynı kuralları alır — geliştirici başına kurulum gerekmez. Takımınız yeni hata modları keşfettikçe, bir ilke ekleyin ve gönderin. Zaman içinde bu, her katkıyla iyileşen canlı bir kalite standardı haline gelir.
 </Tip>
 
 ### Seçenek 2: Açık dosya yolu
 
 ```bash
-# Özel ilkeler dosyasıyla yükleyin
+# Özel ilkeler dosyası ile yükleyin
 failproofai policies --install --custom ./my-policies.js
 
 # İlkeler dosya yolunu değiştirin
@@ -77,13 +76,13 @@ failproofai policies --install --custom ./new-policies.js
 failproofai policies --uninstall --custom
 ```
 
-Çözümlenen mutlak yol, `policies-config.json` öğesine `customPoliciesPath` olarak depolanır. Dosya her hook event'i sırasında yeni yüklenir - event'ler arasında hiçbir önbelleğe alma yoktur.
+Çözümlenen mutlak yol, `policies-config.json` içinde `customPoliciesPath` olarak depolanır. Dosya her hook eventinde yeniden yüklenir - eventler arasında önbellekleme yoktur.
 
 ### Her ikisini birlikte kullanma
 
-Kural tabanlı ilkeler ve açık `--custom` dosyası bir arada bulunabilir. Yükleme sırası:
+Kural tabanlı ilkeler ve açık `--custom` dosyası birlikte var olabilir. Yükleme sırası:
 
-1. Açık `customPoliciesPath` dosyası (yapılandırılmışsa)
+1. Açık `customPoliciesPath` dosyası (yapılandırıldıysa)
 2. Proje kural tabanlı dosyaları (`{cwd}/.failproofai/policies/`, alfabetik)
 3. Kullanıcı kural tabanlı dosyaları (`~/.failproofai/policies/`, alfabetik)
 
@@ -91,7 +90,7 @@ Kural tabanlı ilkeler ve açık `--custom` dosyası bir arada bulunabilir. Yük
 
 ## API
 
-### İçe aktarma
+### İçe aktar
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -103,9 +102,9 @@ Bir ilkeyi kaydeder. Aynı dosyada birden fazla ilke için gerektiği kadar ça
 
 ```ts
 customPolicies.add({
-  name: string;                         // gerekli - benzersiz tanımlayıcı
-  description?: string;                 // `failproofai policies` çıktısında gösterilir
-  match?: { events?: HookEventType[] }; // event türüne göre filtre; tümüyle eşleştirmek için atla
+  name: string;                         // required - unique identifier
+  description?: string;                 // shown in `failproofai policies` output
+  match?: { events?: HookEventType[] }; // filter by event type; omit to match all
   fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
 });
 ```
@@ -114,30 +113,30 @@ customPolicies.add({
 
 | İşlev | Etki | Ne zaman kullanılır |
 |----------|--------|----------|
-| `allow()` | İşleme izin ver sessizce | İşlem güvenli, ileti gerekmez |
+| `allow()` | İşlemi sessizce izin ver | İşlem güvenli, mesaj gerekmez |
 | `deny(message)` | İşlemi engelle | Agent bu işlemi yapmamalı |
-| `instruct(message)` | Engellemeden bağlam ekle | Agent'a yolunda kalmak için ek bağlam ver |
+| `instruct(message)` | Bloklama olmaksızın bağlam ekle | Agent'a yolda kalmak için ek bağlam ver |
 
-`deny(message)` - ileti Claude'a `"Blocked by failproofai:"` ön ekiyle görünür. Tek bir `deny`, tüm sonraki değerlendirmeleri kısaltır.
+`deny(message)` - ileti Claude'a `"Blocked by failproofai:"` ön ekiyle görünür. Tek bir `deny` tüm diğer değerlendirmeleri kısa devre yapar.
 
-`instruct(message)` - ileti, geçerli araç çağrısı için Claude'un bağlamına eklenir. Tüm `instruct` iletileri biriktirilir ve birlikte teslim edilir.
+`instruct(message)` - ileti Claude'un geçerli araç çağrısı için bağlamına eklenir. Tüm `instruct` iletileri birlikte biriktirilir ve gönderilir.
 
 <Tip>
-Kod değişikliğine gerek olmadan `policyParams` öğesinde bir `hint` alanı ekleyerek herhangi bir `deny` veya `instruct` iletisine ek rehberlik ekleyebilirsiniz. Bu, özel (`custom/`), proje kuralı (`.failproofai-project/`), ve kullanıcı kuralı (`.failproofai-user/`) ilkeleri için de çalışır. Ayrıntılar için bkz. [Yapılandırma → hint](/tr/configuration#hint-cross-cutting).
+Kod değişikliği gerekmeksizin `deny` veya `instruct` iletisine ekstra rehberlik ekleyebilirsiniz — `policyParams` içine bir `hint` alanı ekleyerek. Bu özel (`custom/`), proje kural tabanlı (`.failproofai-project/`) ve kullanıcı kural tabanlı (`.failproofai-user/`) ilkeler için de çalışır. Ayrıntılar için [Yapılandırma → hint](/tr/configuration#hint-cross-cutting) bölümüne bakın.
 </Tip>
 
-### Bilgisel izin iletileri
+### Bilgilendirme amaçlı izin iletileri
 
-`allow(message)` işleme izin verir **ve** Claude'a geri bilgisel bir ileti gönderir. İleti, hook handler'ın stdout yanıtında `additionalContext` olarak teslim edilir — `instruct` tarafından kullanılan aynı mekanizma, ancak anlamsal olarak farklıdır: bir uyarı değil, bir durum güncellemesidir.
+`allow(message)` işlemi izin verir **ve** Claude'a bilgilendirici bir ileti geri gönderir. İleti, hook işleyicisinin stdout yanıtında `additionalContext` olarak gönderilir — `instruct` ile aynı mekanizma kullanılır, ancak semantik olarak farklıdır: bu bir uyarı değil, durum güncellemesidir.
 
 | İşlev | Etki | Ne zaman kullanılır |
 |----------|--------|----------|
-| `allow(message)` | İzin ver ve Claude'a bağlam gönder | Bir kontrolün geçtiğini doğrula veya neden atlandığını açıkla |
+| `allow(message)` | İzin ver ve Claude'a bağlam gönder | Bir kontrol başarılı olduğunu onaylayın veya kontrol atlanışını açıklayın |
 
 Kullanım durumları:
 - **Durum onayları:** `allow("All CI checks passed.")` — Claude'a her şeyin yeşil olduğunu söyler
-- **Açık başarısızlık açıklamaları:** `allow("GitHub CLI not installed, skipping CI check.")` — Claude'a bir kontrolün neden atlandığını söyler böylece tam bağlama sahip olur
-- **Birden fazla ileti birikir:** birkaç ilke her biri `allow(message)` döndürürse, tüm iletiler yeni satırlarla birleştirilir ve birlikte teslim edilir
+- **Açık başarısızlık açıklamaları:** `allow("GitHub CLI not installed, skipping CI check.")` — Claude'a kontrol atlanışını açıklar, böylece tam bağlama sahip olur
+- **Birden fazla ileti birikir:** birden fazla ilke her biri `allow(message)` döndürürse, tüm iletiler satırbaşı ile birleştirilir ve birlikte gönderilir
 
 ```js
 customPolicies.add({
@@ -163,7 +162,7 @@ customPolicies.add({
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string \| undefined` | Çağrılan araç (ör. `"Bash"`, `"Write"`, `"Read"`) |
 | `toolInput` | `Record<string, unknown> \| undefined` | Aracın giriş parametreleri |
-| `payload` | `Record<string, unknown>` | Claude Code'dan tam ham event payload |
+| `payload` | `Record<string, unknown>` | Claude Code'dan gelen tam ham event payload'ı |
 | `session` | `SessionMetadata \| undefined` | Oturum bağlamı (aşağıya bakın) |
 
 ### `SessionMetadata` alanları
@@ -172,13 +171,13 @@ customPolicies.add({
 |-------|------|-------------|
 | `sessionId` | `string` | Claude Code oturum tanımlayıcısı |
 | `cwd` | `string` | Claude Code oturumunun çalışma dizini |
-| `transcriptPath` | `string` | Oturumun JSONL transcript dosyasının yolu |
+| `transcriptPath` | `string` | Oturumun JSONL transkript dosyası yolu |
 
 ### Event türleri
 
-| Event | Ne zaman çalışır | `toolInput` içeriği |
+| Event | Ne zaman tetiklenir | `toolInput` içeriği |
 |-------|--------------|----------------------|
-| `PreToolUse` | Claude bir aracı çalıştırmadan önce | Aracın girdisi (ör. Bash için `{ command: "..." }`) |
+| `PreToolUse` | Claude bir araç çalıştırmadan önce | Aracın girdisi (ör. Bash için `{ command: "..." }`) |
 | `PostToolUse` | Bir araç tamamlandıktan sonra | Aracın girdisi + `tool_result` (çıktı) |
 | `Notification` | Claude bir bildirim gönderdiğinde | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hook'lar her zaman `allow()` döndürmelidir, bildirimleri engelleyemezler |
 | `Stop` | Claude oturumu sona erdiğinde | Boş |
@@ -187,15 +186,15 @@ customPolicies.add({
 
 ## Değerlendirme sırası
 
-İlkeler şu sırayla değerlendirilir:
+İlkeler şu sırada değerlendirilir:
 
 1. Yerleşik ilkeler (tanım sırasında)
-2. `customPoliciesPath` öğesinden açık özel ilkeler (.add() sırasında)
-3. Proje `.failproofai/policies/` öğesinden kural ilkeleri (dosyalar alfabetik, .add() sırasında)
-4. Kullanıcı `~/.failproofai/policies/` öğesinden kural ilkeleri (dosyalar alfabetik, .add() sırasında)
+2. `customPoliciesPath` adresinden açık özel ilkeler (`.add()` sırasında)
+3. Proje `.failproofai/policies/` adresinden kural tabanlı ilkeler (dosyalar alfabetik, içinde `.add()` sırası)
+4. Kullanıcı `~/.failproofai/policies/` adresinden kural tabanlı ilkeler (dosyalar alfabetik, içinde `.add()` sırası)
 
 <Note>
-İlk `deny`, sonraki tüm ilkeleri kısaltır. Tüm `instruct` iletileri biriktirilir ve birlikte teslim edilir.
+İlk `deny` tüm sonraki ilkeleri kısa devre yapar. Tüm `instruct` iletileri biriktirilir ve birlikte gönderilir.
 </Note>
 
 ---
@@ -219,43 +218,43 @@ customPolicies.add({
 });
 ```
 
-Giriş dosyasından ulaşılabilir tüm göreceli içe aktarmalar çözümlenir. Bu, `from "failproofai"` içe aktarmalarını gerçek dist yoluna yeniden yazarak ve ESM uyumluluğunu sağlamak için geçici `.mjs` dosyaları oluşturarak uygulanır.
+Giriş dosyasından erişilebilen tüm göreceli içe aktarmalar çözümlenir. Bu, `from "failproofai"` içe aktarmalarını gerçek dist yoluna yeniden yazarak ve ESM uyumluluğu sağlamak için geçici `.mjs` dosyaları oluşturarak uygulanır.
 
 ---
 
 ## Event türü filtrelemesi
 
-Bir ilkenin ne zaman çalıştığını sınırlandırmak için `match.events` kullanın:
+Bir ilkenin ne zaman tetiklendiğini sınırlandırmak için `match.events` kullanın:
 
 ```js
 customPolicies.add({
   name: "require-summary-on-stop",
   match: { events: ["Stop"] },
   fn: async (ctx) => {
-    // Yalnızca oturum sona erdiğinde çalışır
+    // Sadece oturum sona erdiğinde tetiklenir
     // ctx.session.transcriptPath tam oturum günlüğünü içerir
     return allow();
   },
 });
 ```
 
-Her event türüne ateş etmek için `match` öğesini tamamen atlayın.
+Her event türüne tetiklenmek için `match` tamamen atlayın.
 
 ---
 
 ## Hata işleme ve başarısızlık modları
 
-Özel ilkeler **açık başarısızlıktır**: hatalar asla yerleşik ilkeleri engelleme veya hook handler'ı kilitlenmez.
+Özel ilkeler **açık başarısızlık** modundadır: hatalar yerleşik ilkeleri hiçbir zaman engelleme veya hook işleyiciyi kilitlemez.
 
 | Başarısızlık | Davranış |
 |---------|----------|
-| `customPoliciesPath` ayarlanmadı | Açık özel ilkeler çalışmaz; kural ilkeleri ve yerleşikler normal şekilde devam eder |
-| Dosya bulunamadı | `~/.failproofai/hook.log` öğesine uyarı kaydedilir; yerleşikler devam eder |
-| Söz dizimi/içe aktarma hatası (açık) | Hata `~/.failproofai/hook.log` öğesine kaydedilir; açık özel ilkeler atlanır |
-| Söz dizimi/içe aktarma hatası (kural) | Hata kaydedilir; dosya atlanır, diğer kural dosyaları yine de yüklenir |
-| `fn` çalışma zamanında throw atar | Hata kaydedilir; bu hook `allow` olarak kabul edilir; diğer hook'lar devam eder |
-| `fn` 10s'den daha uzun sürer | Zaman aşımı kaydedilir; `allow` olarak kabul edilir |
-| Kural dizini eksik | Kural ilkeleri çalışmaz; hata yok |
+| `customPoliciesPath` ayarlanmamış | Açık özel ilke çalışmaz; kural tabanlı ve yerleşik ilkeler normal şekilde devam eder |
+| Dosya bulunamadı | `~/.failproofai/hook.log` adresine uyarı yazılır; yerleşik ilkeler devam eder |
+| Söz dizimi/içe aktarma hatası (açık) | `~/.failproofai/hook.log` adresine hata yazılır; açık özel ilkeler atlanır |
+| Söz dizimi/içe aktarma hatası (kural tabanlı) | Hata yazılır; bu dosya atlanır, diğer kural tabanlı dosyalar yüklenir |
+| `fn` çalışma zamanında hatanın atılması | Hata yazılır; bu hook `allow` olarak işlem görür; diğer hook'lar devam eder |
+| `fn` 10 saniyeden uzun süre alması | Zaman aşımı yazılır; `allow` olarak işlem görür |
+| Kural tabanlı dizin eksik | Kural tabanlı ilke çalışmaz; hata yok |
 
 <Tip>
 Özel ilke hatalarını ayıklamak için günlük dosyasını izleyin:
@@ -273,7 +272,7 @@ tail -f ~/.failproofai/hook.log
 // my-policies.js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
-// Agent'ı secrets/ dizinine yazmasını engelle
+// Agent'ın secrets/ dizinine yazmasını engelle
 customPolicies.add({
   name: "block-secrets-dir",
   description: "Prevent agent from writing to secrets/ directory",
@@ -286,7 +285,7 @@ customPolicies.add({
   },
 });
 
-// Agent'ı yolunda tut: commit'lemeden önce testleri doğrula
+// Agent'ı yolda tut: commit etmeden önce testleri doğrula
 customPolicies.add({
   name: "remind-test-before-commit",
   description: "Keep the agent on track: verify tests pass before committing",
@@ -301,7 +300,7 @@ customPolicies.add({
   },
 });
 
-// Dondurma döneminde planlanmamış bağımlılık değişikliklerini engelle
+// Donma döneminde planlanmamış bağımlılık değişikliklerini engelle
 customPolicies.add({
   name: "dependency-freeze",
   description: "Prevent unplanned dependency changes during freeze period",
@@ -324,14 +323,14 @@ export { customPolicies };
 
 ## Örnekler
 
-`examples/` dizini çalışmaya hazır ilke dosyalarını içerir:
+`examples/` dizini çalıştırmaya hazır ilke dosyaları içerir:
 
 | Dosya | İçerik |
 |------|----------|
-| `examples/policies-basic.js` | Yaygın agent başarısızlık modlarını kapsayan beş başlangıç ilkesi |
-| `examples/policies-advanced/index.js` | İleri düzey desenler: geçişli içe aktarmalar, zaman uyumsuz çağrılar, çıktı temizleme ve oturum sonu hook'ları |
-| `examples/convention-policies/security-policies.mjs` | Kural tabanlı güvenlik ilkeleri (.env yazmalarını engelle, git geçmişi yeniden yazmayı önle) |
-| `examples/convention-policies/workflow-policies.mjs` | Kural tabanlı iş akışı ilkeleri (test anımsatıcıları, denetim dosyası yazmaları) |
+| `examples/policies-basic.js` | Yaygın agent hata modlarını kapsayan beş başlatıcı ilke |
+| `examples/policies-advanced/index.js` | Gelişmiş desenler: geçişli içe aktarmalar, zaman uyumsuz çağrılar, çıktı kazıyıcıları ve oturum sonu hook'ları |
+| `examples/convention-policies/security-policies.mjs` | Kural tabanlı güvenlik ilkeleri (.env yazımları engelle, git geçmişi yeniden yazımını önle) |
+| `examples/convention-policies/workflow-policies.mjs` | Kural tabanlı iş akışı ilkeleri (test anımsatıcıları, denetim dosya yazımları) |
 
 ### Açık dosya örneklerini kullanma
 
@@ -351,4 +350,4 @@ mkdir -p ~/.failproofai/policies
 cp examples/convention-policies/*.mjs ~/.failproofai/policies/
 ```
 
-Yükleme komutu gerekmez — dosyalar sonraki hook event'i sırasında otomatik olarak alınır.
+Yükleme komutu gerekmez — dosyalar bir sonraki hook olayında otomatik olarak seçilir.

package/.next/standalone/docs/tr/examples.mdx

@@ -1,65 +1,66 @@
 ---
+---
 title: Örnekler
-description: "Claude Code ve Agents SDK için hook'ları nasıl kurulacağı"
+description: "Claude Code ve Agents SDK için hook'lar nasıl ayarlanır"
 icon: book-open
 ---
 
-Yaygın senaryolar için kullanıma hazır örnekler. Her biri kurulumun nasıl yapılacağını ve nelerin beklenebileceğini gösterir.
+Yaygın senaryolar için kullanıma hazır örnekler. Her biri nasıl yüklenileceğini ve ne beklenebileceğini gösterir.
 
 ---
 
-## Claude Code için hook'ları ayarlama
+## Claude Code için hook'lar ayarlama
 
-Failproof AI, Claude Code ile [hook'lar sistemi](https://docs.anthropic.com/en/docs/claude-code/hooks) aracılığıyla entegre olur. `failproofai policies --install` komutunu çalıştırdığınızda, Claude Code'un `settings.json` dosyasında her araç çağrısında tetiklenen hook komutlarını kaydeder.
+Failproof AI, Claude Code ile [hook'lar sistemi](https://docs.anthropic.com/en/docs/claude-code/hooks) aracılığıyla entegre olur. `failproofai policies --install` komutunu çalıştırdığınızda, Claude Code'un `settings.json` dosyasında her araç çağrısında çalışan hook komutları kaydedilir.
 
 <Steps>
-  <Step title="failproofai'yi yükleyin">
+  <Step title="failproofai yükle">
     ```bash
     npm install -g failproofai
     ```
   </Step>
-  <Step title="Tüm yerleşik politikaları etkinleştirin">
+  <Step title="Tüm yerleşik politikaları etkinleştir">
     ```bash
     failproofai policies --install
     ```
   </Step>
-  <Step title="Hook'ların kaydedilip kaydedilmediğini doğrulayın">
+  <Step title="Hook'ların kaydedildiğini doğrula">
     ```bash
     cat ~/.claude/settings.json | grep failproofai
     ```
 
     `PreToolUse`, `PostToolUse`, `Notification` ve `Stop` olayları için hook girdilerini görmelisiniz.
   </Step>
-  <Step title="Claude Code'u çalıştırın">
+  <Step title="Claude Code'u çalıştır">
     ```bash
     claude
     ```
 
-    Politikalar şimdi her araç çağrısında otomatik olarak çalışır. Claude'dan `sudo rm -rf /` komutunu çalıştırmasını istemesi deneyin - engellenir.
+    Politikalar artık her araç çağrısında otomatik olarak çalışır. Claude'dan `sudo rm -rf /` çalıştırmasını istemeyi deneyin - engellenir.
   </Step>
 </Steps>
 
 ---
 
-## Agents SDK için hook'ları ayarlama
+## Agents SDK için hook'lar ayarlama
 
-[Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) ile inşa ediyorsanız, aynı hook sistemini programlı olarak kullanabilirsiniz.
+[Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) ile geliştiriyorsanız, aynı hook sistemini programlı olarak kullanabilirsiniz.
 
 <Steps>
-  <Step title="failproofai'yi projenize yükleyin">
+  <Step title="failproofai'ı projenize yükle">
     ```bash
     npm install failproofai
     ```
   </Step>
-  <Step title="Aracınızda hook'ları yapılandırın">
-    Aracı işlemi oluştururken hook komutlarını geçin. Hook'lar Claude Code'da olduğu gibi aynı şekilde çalışır - stdin/stdout JSON aracılığıyla:
+  <Step title="Hook'ları aracınızda yapılandır">
+    Aracı işlemi oluştururken hook komutlarını geçin. Hook'lar Claude Code'dakiyle aynı şekilde çalışır - stdin/stdout JSON aracılığıyla:
 
     ```bash
-    failproofai --hook PreToolUse   # her araçtan önce çağrılır
-    failproofai --hook PostToolUse  # her araçtan sonra çağrılır
+    failproofai --hook PreToolUse   # her araçtan önce çalışır
+    failproofai --hook PostToolUse  # her araçtan sonra çalışır
     ```
   </Step>
-  <Step title="Aracınız için özel bir politika yazın">
+  <Step title="Aracınız için özel politika yaz">
     ```javascript
     import { customPolicies, allow, deny } from "failproofai";
 
@@ -77,7 +78,7 @@ Failproof AI, Claude Code ile [hook'lar sistemi](https://docs.anthropic.com/en/d
     });
     ```
   </Step>
-  <Step title="Özel politikayı yükleyin">
+  <Step title="Özel politikayı yükle">
     ```bash
     failproofai policies --install --custom ./my-agent-policies.js
     ```
@@ -86,37 +87,37 @@ Failproof AI, Claude Code ile [hook'lar sistemi](https://docs.anthropic.com/en/d
 
 ---
 
-## Yıkıcı komutları engelleme
+## Yıkıcı komutları engelle
 
-En yaygın kurulum - ajanların geri döndürülemez hasar vermesini önleyin.
+En yaygın kurulum - aracıların geri döndürülemez hasarlar vermesini önle.
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
 ```
 
-Bunu yapar:
+Bunu ne yapar:
 - `block-sudo` - tüm `sudo` komutlarını engeller
 - `block-rm-rf` - özyinelemeli dosya silmeyi engeller
-- `block-force-push` - `git push --force`'u engeller
-- `block-curl-pipe-sh` - uzak komut dosyalarını shell'e yönlendirmeyi engeller
+- `block-force-push` - `git push --force` komutunu engeller
+- `block-curl-pipe-sh` - uzak betikleri shell'e aktarmayı engeller
 
 ---
 
-## Gizli bilgi sızıntısını önleme
+## Sır sızıntısını önle
 
-Ajanların araç çıktısında kimlik bilgilerini görmesini veya sızıtmasını durdurun.
+Aracıların kimlik bilgilerini görmesini veya araç çıktısında sızıntısını yapmasını engelle.
 
 ```bash
 failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
 ```
 
-Bunlar `PostToolUse`'de çalışırlar - bir araç çalıştıktan sonra, ajan görmeden önce çıktıyı temizlerler.
+Bunlar `PostToolUse` üzerine çalışır - bir araç çalıştıktan sonra, aracı görmeden önce çıktıyı temizlerler.
 
 ---
 
-## Ajanlar dikkat gerektirdiğinde Slack uyarısı alın
+## Aracılara dikkat edilmesine gerek duyulduğunda Slack uyarıları al
 
-Bildirim hook'unu kullanarak boşta olma uyarılarını Slack'e iletin.
+Boş uyarılarını Slack'a iletmek için bildirim hook'unu kullan.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -150,7 +151,7 @@ customPolicies.add({
 });
 ```
 
-Yükleyin:
+Yükle:
 
 ```bash
 SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
@@ -158,9 +159,9 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
 
 ---
 
-## Ajanları bir dalda tutun
+## Aracıları bir dal üzerinde tut
 
-Ajanların dalları değiştirmesini veya korumalı dallara gönderimde bulunmasını önleyin.
+Aracıların dal değiştirmesini veya korunan dallara push yapmasını engelle.
 
 ```javascript
 import { customPolicies, allow, deny } from "failproofai";
@@ -182,9 +183,9 @@ customPolicies.add({
 
 ---
 
-## Commit'ten önce testler gerekli kıl
+## Commit'ten önce testler iste
 
-Ajanları commit'lemeden önce testleri çalıştırmaya hatırlatın.
+Aracıları commit'ten önce testleri çalıştırmaya hatırlat.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -208,9 +209,9 @@ customPolicies.add({
 
 ## Üretim deposunu kilitle
 
-Takımınızdaki her geliştirici aynı politikaları alması için proje düzeyinde bir yapılandırma commit'leyin.
+Proje seviyesi config'i işle et, böylece ekibindeki her geliştirici aynı politikaları alır.
 
-Deponuzda `.failproofai/policies-config.json` dosyasını oluşturun:
+Reponuzda `.failproofai/policies-config.json` oluştur:
 
 ```json
 {
@@ -231,23 +232,77 @@ Deponuzda `.failproofai/policies-config.json` dosyasını oluşturun:
 }
 ```
 
-Sonra commit'leyin:
+Sonra işle et:
 
 ```bash
 git add .failproofai/policies-config.json
 git commit -m "Add failproofai team policies"
 ```
 
-failproofai yüklenmiş olan her takım üyesi bu kuralları otomatik olarak alır.
+failproofai yüklü olan her ekip üyesi otomatik olarak bu kuralları alır.
+
+---
+
+## Convention politikaları ile kuruluş çapında bir kalite standardı oluştur
+
+En etkili kurulum: reponuza `.failproofai/policies/` işle et ve projenize uyarlanmış politikalar ekle. Her ekip üyesi onları otomatik olarak alır — yükleme komutları yok, yapılandırma değişiklikleri yok.
+
+<Steps>
+  <Step title="Dizini oluştur ve politikalar ekle">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Enforce your team's preferred package manager
+    // (or enable the built-in prefer-package-manager policy instead)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Remind the agent to run tests before committing
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Git'e işle et">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="İyileştirmeye devam et">
+    Ekibiniz yeni hata modlarıyla karşılaştıkça, politikalar ekle ve push et. Herkes sonraki `git pull` işleminde güncellemeyi alır. Bu politikalar, ekibinizle birlikte gelişen canlı bir kalite standardı haline gelir.
+  </Step>
+</Steps>
 
 ---
 
 ## Daha fazla örnek
 
-Depo içindeki [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) dizini şunları içerir:
+Repodaki [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) dizini şunları içerir:
 
-| Dosya | Neyi gösterir |
+| Dosya | Ne gösterir |
 |------|---------------|
-| `policies-basic.js` | Başlangıç politikaları - üretim yazısını, force-push'u, yönlendirilen komut dosyalarını engelle |
-| `policies-notification.js` | Boşta bildirimler ve oturum sonu için Slack uyarıları |
-| `policies-advanced/index.js` | Geçişli içe aktarmalar, asenkron hook'lar, PostToolUse çıktı temizleme, Stop olayı işleme |
+| `policies-basic.js` | Başlangıç politikaları - üretim yazılarını, force-push'u, boru hattı betiklerini engelle |
+| `policies-notification.js` | Boş bildirimler ve oturum sonu için Slack uyarıları |
+| `policies-advanced/index.js` | Geçişli importlar, eşzamansız hook'lar, PostToolUse çıktısı temizliği, Stop olayı işleme |