# Kurallar (/tr/docs/verdent-manager/configuration/rules)

> Kural dosyaları aracılığıyla Verdent'in davranışını kontrol etme



Kural dosyaları, kodlama oturumları sırasında Verdent'in nasıl davranacağını tanımlayan Markdown belgeleridir. Yapay zeka aracısının davranışını, çıktı biçimlendirmesini ve proje standartlarına uyumu yönlendirir.

## Neler öğreneceksiniz [#neler-öğreneceksiniz]

* Kullanıcı kuralları ve proje kurallarını anlama
* Her kural türünün ne zaman kullanılacağı
* Etkili kurallar yazma

***

## Kural türleri [#kural-türleri]

| Kural türü              | Dosya      | Kapsam               | Amaç                               |
| ----------------------- | ---------- | -------------------- | ---------------------------------- |
| **Kullanıcı kuralları** | VERDENT.md | Genel (tüm projeler) | Kişisel kodlama tercihleri         |
| **Proje kuralları**     | AGENTS.md  | Geçerli proje        | Ekip kuralları, proje standartları |

**Konum:**

* Kullanıcı kuralları: `~/.verdent/VERDENT.md`
* Proje kuralları: `<project>/AGENTS.md`

***

## Kullanıcı kuralları (VERDENT.md) [#kullanıcı-kuralları-verdentmd]

Kullanıcı kuralları, Verdent'in tüm projelerde nasıl davrandığını özelleştirmenizi sağlar.

**Erişim:** Settings → User Rules

**Otomatik kaydetme:** Değişiklikler 500 ms sonra otomatik kaydedilir

<Tabs>
  <Tab title="Amaç">
    * **Kodlama stili tercihleri:** Girintileme, adlandırma kuralları
    * **Framework kuralları:** React, Vue, dil standartları
    * **Yanıt biçimlendirme:** Ayrıntı düzeyi, açıklama stili
    * **Kişisel iş akışı tercihleri:** Üslup, iletişim stili
  </Tab>

  <Tab title="Örnek">
    ```markdown
    # User Rules

    ## Code Style
    - Always use TypeScript with strict mode
    - Prefer functional components over class components
    - Use Tailwind CSS for styling
    - Follow the project's existing naming conventions

    ## Communication
    - Provide brief explanations
    - Show code first, explain after
    - Write concise commit messages in conventional format
    ```
  </Tab>
</Tabs>

***

## Proje kuralları (AGENTS.md) [#proje-kuralları-agentsmd]

Proje kuralları, geçerli projeye özgü standartları tanımlar. Ekip genelinde paylaşmak için sürüm kontrolüne ekleyin.

**Erişim:** Project Settings paneli

**Konum:** Proje kök dizini (`<project>/AGENTS.md`)

<Tabs>
  <Tab title="Kullanım senaryoları">
    * **Ekip kuralları:** Ortak kodlama standartları
    * **Mimari:** Tasarım desenleri, durum yönetimi
    * **Test:** Kapsam gereksinimleri, framework'ler
    * **İş akışları:** Derleme komutları, PR yönergeleri
  </Tab>

  <Tab title="Örnek">
    ```markdown
    # AGENTS.md

    ## Dev Environment
    - Run `pnpm install` to set up
    - Use `pnpm dev` for local development

    ## Testing
    - Run `pnpm test` before committing
    - Minimum 80% coverage required

    ## PR Guidelines
    - Use conventional commit format
    - Include tests for new features
    ```
  </Tab>
</Tabs>

<Tip>
  Tüm ekip üyeleri arasında tutarlı yapay zeka davranışı sağlamak için AGENTS.md dosyasını sürüm kontrolü aracılığıyla ekibinizle paylaşın.
</Tip>

***

## Etkili kurallar yazma [#etkili-kurallar-yazma]

**Belirgin olun:**

```markdown
# Good
- Use async/await for asynchronous operations
- Include JSDoc comments for exported functions

# Avoid
- Try to use modern JavaScript features
- Add comments when necessary
```

**En iyi uygulamalar:**

* Açık, yönlendirici bir dil kullanın ("Her zaman...", "Asla...", "Tercih et...")
* İlgili kuralları bölüm başlıkları altında gruplandırın
* Kuralları kısa tutun (madde başına bir kavram)
* Proje geliştikçe kuralları gözden geçirin ve güncelleyin

***

## SSS [#sss]

<AccordionGroup>
  <Accordion title="Kural dosyalarını nasıl oluştururum?">
    Kişisel tercihler için `VERDENT.md` dosyasını düzenlemek üzere Settings → User Rules bölümüne gidin. Projeye özgü kurallar için proje kök dizininizde `AGENTS.md` oluşturun. Madde işaretleriyle düz Markdown kullanın.
  </Accordion>

  <Accordion title="Kural değişiklikleri ne zaman geçerli olur?">
    Kural değişiklikleri yeni konuşmalarda hemen geçerli olur ve geçerli konuşmanın yanıtlarını etkiler.
  </Accordion>

  <Accordion title="Kuralları geçici olarak geçersiz kılabilir miyim?">
    Tek bir istek için kuralları geçersiz kılmak amacıyla isteminizde belirli talimatlar verebilirsiniz.
  </Accordion>
</AccordionGroup>