---
title: Kurallar
description: "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

- 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ü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ı, 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ı, 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

**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

<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>