Bir AI asistanını projenizin kodlama kurallarına uyacak şekilde nasıl yapılandırırsınız?

Question

Accepted Answer

Bir AI, eğitim verilerinin genel ortalamasıyla başlar, bu yüzden **sizin** stilinizi elde etmek için onu **göstermek ve uygulamak** gerekir — örnekler, açık bir kural dosyası ve kaçan sorunları yakalayan bir linter döngüsü aracılığıyla. AI'ın standartlarınızı (WordPress Coding Standards, PSR-12, vb.) tahmin edeceğine güvenmeyin.

## Teknikler (etki sırasına göre)

- **Linter konfigürasyonu ve örnekleri sağlayın** — `.eslintrc`, `phpcs.xml` veya `.editorconfig` dosyalarınızı yapıştırın. Bunlar makine tarafından kontrol edilebilir biçimdeki kurallar ve AI bunları okuyabilir.
- **Bir kural/talimat dosyası tutun** — standardi açıkça belirten `CLAUDE.md` veya sistem istemi: "Bu proje **PSR-12** takip eder. 4 boşluklu girinti kullanın, işlevler için süslü parantezler sonraki satırda, kancalar için snake_case." Sabit talimatlar her bir istemde kendinizi tekrarlamaktan daha iyidir.
- **Temsili mevcut kodu gösterin** — bir veya iki temiz dosya, herhangi bir açıklamadan daha hızlı adlandırma, yapı ve deyimler öğretir. AI gördüğü şeyleri örüntü eşleştirme yapar.
- **AI çıktısında linter çalıştırın ve hataları geri besleyin** — en güvenilir adım. Linter, temel kaynaktır; hatalarını yapıştırın ve AI'ın bunları düzeltmesini isteyin.

## Linter döngüsü

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

Bu döngü hızlı yakınsar çünkü linter, AI'ın doğrudan üzerinde çalışabileceği kesin, satır düzeyinde geri bildirim sağlar; yerine siz stili düz metin olarak tanımlamış olursunuz.

## Neden önemli

Proje kurallarını göz ardı eden kod, işlevsel olarak doğru olsa bile **inceleme kayması ve tutarsızlık** oluşturur — gözden geçirenler biçimlendirme konusunda zaman harcayar ve kod tabanı kayar. Bir AI, siz sağlamadığınız sürece ev stilinizin farkında değildir, bu yüzden iş kuralları **açık ve kontrol edilebilir** yapmaktır: amaç için bir kural dosyası, deyimler için temsili kod ve döngüdeki enforcer olarak linter. Aynı disiplin (yapılandırma + örnekler + otomatik kontrol), bir insan iş arkadaşını kurallarınıza nasıl dahil ettiğinizle de aynıdır.