> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Başlarken

> failproofai'ı kurun, politikaları etkinleştirin ve ajanlarınızın güvenilir şekilde çalışmasını sağlayın

## Gereksinimler

* **Node.js** >= 20.9.0
* **Bun** >= 1.3.0 (isteğe bağlı - yalnızca kaynaktan derlemek için gerekli)

***

## Kurulum

<CodeGroup>
  ```bash npm theme={null}
  npm install -g failproofai
  ```

  ```bash bun theme={null}
  bun add -g failproofai
  ```
</CodeGroup>

***

## Hızlı başlangıç

<Steps>
  <Step title="Politikaları etkinleştirin">
    Politikalar, ajanın her araç çağrısından önce ve sonra çalışan kurallardır. Yıkıcı komutları, gizli bilgi sızıntılarını ve hasara neden olmadan diğer başarısızlık modlarını yakalar.

    ```bash theme={null}
    failproofai policies --install
    ```

    Bu, yüklü ajan CLI'lerinize hook girişleri yazar (Claude Code'un `~/.claude/settings.json`, OpenAI Codex'in `~/.codex/hooks.json`, GitHub Copilot CLI'nin `~/.copilot/hooks/failproofai.json`, Cursor Agent'ın `~/.cursor/hooks.json`, OpenCode'un `~/.config/opencode/plugins/failproofai.mjs` konumundaki oluşturulmuş plugin shim'i ve `~/.config/opencode/opencode.json` dosyasındaki `plugin` dizisinde bir kayıt girişi, Pi'nin `~/.pi/agent/settings.json` veya Hermes'in `~/.hermes/config.yaml` dosyası). Birden fazla varsa size sorulacak; `--cli claude codex copilot cursor opencode pi hermes` (herhangi bir alt küme) geçerek sorguyu atlayabilirsiniz.

    GitHub Copilot CLI, Cursor Agent, OpenCode ve Pi desteği **beta** aşamasındadır — `--cli copilot`, `--cli cursor`, `--cli opencode` veya `--cli pi` ile kurun. Hermes (hermes-agent, bir Slack/Telegram ağ geçidi) `--cli hermes` ile kullanıcı kapsamında yüklenir ve **ayrıca** çevrimdışı bir denetim kaynağıdır.

    ```bash theme={null}
    failproofai policies --install --scope project
    failproofai policies --install --cli codex --scope project
    failproofai policies --install --cli copilot --scope project
    failproofai policies --install --cli cursor --scope project
    failproofai policies --install --cli opencode --scope project
    failproofai policies --install --cli pi --scope project
    failproofai policies --install --cli hermes --scope user
    failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
    ```
  </Step>

  <Step title="Doğrulayın">
    ```bash theme={null}
    failproofai policies
    ```

    Her politikayı, etkinleştirilip etkinleştirilmediğini ve yapılandırılmış parametreleri gösterir.
  </Step>

  <Step title="Panoyu başlatın">
    ```bash theme={null}
    failproofai
    ```

    Oturumları göz atabilir, araç çağrılarını inceleyebilir ve politikaları yönetebileceğiniz `http://localhost:8020` konumundaki yerel bir panoyu açar.
  </Step>

  <Step title="Ajanınızı çalıştırın">
    Claude Code'u her zamanki gibi başlatın. Ajan riskli bir şey denerse, failproofai bunu otomatik olarak durdurur. Bunu çalıştırılır durumda bırakın ve panoda ne olduğunu gözden geçirin.
  </Step>
</Steps>

***

## Politikalar nasıl çalışır

Ajan bir araç her çalıştırdığında, Claude Code failproofai'ı bir alt işlem olarak çağırır:

```text theme={null}
Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'ı okur
                                                 politikaları değerlendirir
                                                 kararı stdout'a yazar
```

Her politika üç karardan birini döndürür:

* **allow** - ajan normal şekilde devam eder
* **deny** - eylem engellenir, ajanına neden engelleneceği söylenir
* **instruct** - ajanın isteminine ek bağlam eklenir

<Note>
  Politikalar yerel işleminizde çalışır. Hiçbir şey uzak bir hizmete gönderilmez.
</Note>

***

## Kural tabanlı politikalarla ekip politikaları ayarlayın

Ekibiniz genelinde kalite standartları oluşturmanın en hızlı yolu `.failproofai/policies/` kuralıdır. Bu dizine politika dosyalarını bırakın ve otomatik olarak yüklenir — bayrak yok, yapılandırma değişikliği yok, kurulum komutu yok.

<Steps>
  <Step title="Politikalar dizinini oluşturun">
    ```bash theme={null}
    mkdir -p .failproofai/policies
    ```
  </Step>

  <Step title="Politika dosyaları ekleyin">
    Başlangıç örneklerini kopyalayın veya kendi dosyalarınızı yazın:

    ```bash theme={null}
    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
    ```

    Veya yeni bir tane oluşturun:

    ```js theme={null}
    // .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("Run tests before committing.");
        }
        return allow();
      },
    });
    ```
  </Step>

  <Step title="Git'e işleyin">
    ```bash theme={null}
    git add .failproofai/policies/
    git commit -m "Add team quality policies"
    ```

    failproofai yüklü olan her ekip üyesi bu politikaları otomatik olarak alır. Geliştirici başına kurulum gerekmez.
  </Step>
</Steps>

<Tip>
  Tüm ekibin aynı standartları paylaşması için `.failproofai/policies/` dizinini deponuza işleyin. Ekibiniz yeni başarısızlık modları keşfettikçe politika ekleyin ve gönderin — herkes bir sonraki `git pull` işleminde güncellemeyi alır. Zamanla bu politikalar, sürekli iyileşen ve ekibi güvende tutan canlı bir kalite standardı haline gelir.
</Tip>

***

## Veri depolama

Tüm yapılandırma ve günlükler makinenizde kalır:

| Yol                                       | Ne depolar                                    |
| ----------------------------------------- | --------------------------------------------- |
| `~/.failproofai/policies-config.json`     | Genel politika yapılandırması                 |
| `~/.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şlenmiş)          |
| `.failproofai/policies-config.local.json` | Kişisel geçersiz kılmalar (gitignore)         |

***

## Kaldırma

```bash theme={null}
failproofai policies --uninstall
```

`~/.claude/settings.json` dosyasından hook girişlerini kaldırır. `~/.failproofai/` içindeki yapılandırma dosyaları korunur.

***

## Sonraki adımlar

<CardGroup cols={2}>
  <Card title="Yapılandırma" icon="gear" href="/tr/configuration">
    Kapsamlar ve yapılandırma dosyası biçimi
  </Card>

  <Card title="Yerleşik politikalar" icon="shield" href="/tr/built-in-policies">
    Parameterlerle 26 politikanın tümü
  </Card>

  <Card title="Özel politikalar" icon="code" href="/tr/custom-policies">
    JavaScript'te kendi politikalarınızı yazın
  </Card>

  <Card title="Ajan izleyici" icon="chart-line" href="/tr/dashboard">
    Oturumları izleyin ve politika etkinliğini gözden geçirin
  </Card>
</CardGroup>