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

package/.next/standalone/docs/tr/getting-started.mdx

@@ -1,13 +1,13 @@
 ---
 title: Başlarken
-description: "failproofai'ı yükleyin, politikaları etkinleştirin ve ajanlarınızı güvenilir bir şekilde çalıştırın"
+description: "failproofai'yi kurun, politikaları etkinleştirin ve ajanlarınızın güvenilir şekilde çalışmasını sağlayın"
 icon: rocket
 ---
 
 ## Gereksinimler
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (isteğe bağlı - yalnızca kaynaktan derleme için gerekli)
+- **Bun** >= 1.3.0 (isteğe bağlı - sadece kaynaktan derlemek için gerekli)
 
 ---
 
@@ -31,13 +31,13 @@ bun add -g failproofai
 
 <Steps>
   <Step title="Politikaları etkinleştirin">
-    Politikalar, her ajan araç çağrısından önce ve sonra çalışan kurallardır. Yıkıcı komutları, gizli bilgi sızıntılarını ve hasar vermeden önce diğer hata durumlarını yakalarlar.
+    Politikalar, her ajan araç çağrısından önce ve sonra çalışan kurallardır. Hasarın yapılmadan önce yıkıcı komutları, gizli bilgi sızıntılarını ve diğer hata modlarını yakalarlar.
 
     ```bash
     failproofai policies --install
     ```
 
-    Bu, Claude Code'un `settings.json` dosyasına hook girdileri yazar. Ayrıca tek bir proje için veya belirli politikalar için kurulum yapabilirsiniz:
+    Bu, Claude Code'un `settings.json` dosyasına hook girdileri yazar. Ayrıca tek bir proje için yükleyebilir veya belirli politikaları seçebilirsiniz:
 
     ```bash
     failproofai policies --install --scope project
@@ -49,28 +49,28 @@ bun add -g failproofai
     failproofai policies
     ```
 
-    Her politikayı, etkin olup olmadığını ve yapılandırılan parametreleri gösterir.
+    Her politikayı, etkinleştirilip etkinleştirilmediğini ve yapılandırılmış parametreleri gösterir.
   </Step>
   <Step title="Panoyu başlatın">
     ```bash
     failproofai
     ```
 
-    `http://localhost:8020` adresinde yerel bir panoya açılır; burada oturumları tarayabilir, araç çağrılarını inceleyebilir ve politikaları yönetebilirsiniz.
+    `http://localhost:8020` adresinde yerel bir pano açar; burada oturumları gezebilir, araç çağrılarını inceleyebilir ve politikaları yönetebilirsiniz.
   </Step>
   <Step title="Ajanınızı çalıştırın">
-    Claude Code'u normal şekilde başlatın. Ajan riskli bir işlem yapmaya çalışırsa, failproofai bunu otomatik olarak engeller. Onu çalışır durumda bırakın ve panoda neler olduğunu gözden geçirin.
+    Claude Code'u normal şekilde başlatın. Ajan riskli bir şey yapmaya çalışırsa, failproofai bunu otomatik olarak yakalar. Panodan bırakabilir ve ne olduğunu gözden geçirebilirsiniz.
   </Step>
 </Steps>
 
 ---
 
-## Politikalar nasıl çalışır
+## Politikalar nasıl çalışır?
 
-Her ajan bir araç çalıştırdığında, Claude Code failproofai'ı bir alt işlem olarak çağırır:
+Her ajan bir araç çalıştırdığında, Claude Code failproofai'yi bir alt işlem olarak çağırır:
 
 ```text
-Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'ı okur
+Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'unu okur
                                                  politikaları değerlendirir
                                                  kararı stdout'a yazar
 ```
@@ -78,26 +78,78 @@ Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'ı okur
 Her politika üç karardan birini döndürür:
 
 - **allow** - ajan normal şekilde devam eder
-- **deny** - işlem engellenir, ajana neden engellendiği söylenir
-- **instruct** - ajanın komutuna ek bağlam eklenir
+- **deny** - işlem engellenir, ajanına neden olduğu bildirilir
+- **instruct** - ajanın promptuna ek bağlam eklenir
 
 <Note>
-Politikalar yerel işleminizde çalışır. Uzak bir hizmete hiçbir şey gönderilmez.
+Politikalar yerel işlemde çalışır. Uzak bir servise hiçbir şey gönderilmez.
 </Note>
 
 ---
 
+## Kural tabanlı politikalarla takım politikaları ayarlayın
+
+Takımınızda kalite standartları oluşturmanın en hızlı yolu `.failproofai/policies/` kuralıdır. Politika dosyalarını bu dizine koyun ve otomatik olarak yüklenir — hiçbir bayrak, hiçbir konfigürasyon değişikliği, hiçbir kurulum komutu gerekmez.
+
+<Steps>
+  <Step title="Politikalar dizinini oluşturun">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Politika dosyaları ekleyin">
+    Başlangıç örneklerini kopyalayın veya kendi politikalarınızı yazın:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Veya yeni bir tane oluşturun:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    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("Commit yapmadan önce testleri çalıştırın.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Git'e commit edin">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Takım kalite politikaları eklendi"
+    ```
+
+    failproofai kurulu olan her takım üyesi bu politikaları otomatik olarak alır. Geliştirici başına kurulum yapılması gerekmez.
+  </Step>
+</Steps>
+
+<Tip>
+`.failproofai/policies/` dosyasını deponuza commit edin, böylece tüm takım aynı standartları paylaşır. Takımınız yeni hata modları keşfettikçe politikalar ekleyin ve gönderin — herkes sonraki `git pull` sırasında güncellemeyi alır. Zaman içinde bu politikalar, sürekli iyileşen canlı bir kalite standardı haline gelir.
+</Tip>
+
+---
+
 ## Veri depolama
 
-Tüm yapılandırma ve günlükler makinenizde kalır:
+Tüm konfigürasyon ve günlükler makinenizde kalır:
 
-| Yol | Sakladığı veriler |
+| Yol | Ne depolar |
 |------|----------------|
-| `~/.failproofai/policies-config.json` | Global politika yapılandırması |
+| `~/.failproofai/policies-config.json` | Genel politika konfigürasyonu |
 | `~/.failproofai/hook-activity.jsonl` | Hook yürütme geçmişi |
 | `~/.failproofai/hook.log` | Özel hook hataları için hata ayıklama günlüğü |
-| `.failproofai/policies-config.json` | Proje başına yapılandırma (işlenen) |
-| `.failproofai/policies-config.local.json` | Kişisel geçersiz kılmalar (gitignored) |
+| `.failproofai/policies-config.json` | Proje başına konfigürasyon (commit edilmiş) |
+| `.failproofai/policies-config.local.json` | Kişisel geçersiz kılmalar (gitignore'da) |
 
 ---
 
@@ -107,7 +159,7 @@ Tüm yapılandırma ve günlükler makinenizde kalır:
 failproofai policies --uninstall
 ```
 
-`~/.claude/settings.json` dosyasından hook girdilerini kaldırır. `~/.failproofai/` içindeki yapılandırma dosyaları tutulur.
+`~/.claude/settings.json` dosyasından hook girdilerini kaldırır. `~/.failproofai/` içindeki konfigürasyon dosyaları tutulur.
 
 ---
 
@@ -115,12 +167,12 @@ failproofai policies --uninstall
 
 <CardGroup cols={2}>
 
-<Card title="Yapılandırma" icon="gear" href="/tr/configuration">
-  Kapsamlar ve yapılandırma dosyası biçimi
+<Card title="Konfigürasyon" icon="gear" href="/tr/configuration">
+  Kapsamlar ve konfigürasyon dosyası formatı
 </Card>
 
 <Card title="Yerleşik politikalar" icon="shield" href="/tr/built-in-policies">
-  26 politikaların tümü ve parametreleri
+  Parametreleri ile 26 politika
 </Card>
 
 <Card title="Özel politikalar" icon="code" href="/tr/custom-policies">
@@ -128,7 +180,7 @@ failproofai policies --uninstall
 </Card>
 
 <Card title="Ajan monitörü" icon="chart-line" href="/tr/dashboard">
-  Oturumları izleyin ve politika etkinliğini gözden geçirin
+  Oturumları monitör edin ve politika aktivitesini gözden geçirin
 </Card>
 
 </CardGroup>