AI Ajan Harness'ını Sıfırdan Kurmak: AGENTS.md, feature_list.json, verify.sh ve Otonom Döngü

Harness'i on iki ders boyunca parça parça kurduk. Peki bütün hâlinde gerçekten çalışıyor mu?

• AGENTS.md, feature_list., PROGRESS.md, sprint sözleşmesi ve graph.md farklı haftalarda yazıldı
• Her artefakt tek tek doğrulandı — peki yanındakiyle çelişiyor mu?
• Bugünkü tek anlamlı sınav: sistem bütün hâlinde çalışıyor mu?

İşte kursun son gününe kadar sorulması kolay unutulan soru: talimatlar, durum, doğrulama ve feature sözleşmesi her seferinde tek bir bileşen için yazıldıysa, aynı repoda birbiriyle çelişmediklerinin garantisi nedir? feature_list.'daki WIP=1 kuralı, rol grafiğindeki paralel düğümlerle farkında olmadan çelişebilir. Definition of Done, script'i artık olmayan bir adımı zorunlu kılıyor olabilir. Bugün yeni hiçbir şey eklemiyoruz — ödeme backend'inin hâlihazırda yazılmış beş alt sistemini alıyor ve yapının dayanıp dayanmadığını görmek için harness'i ilk kez bir bütün hâlinde çalıştırıyoruz.

Harness sonunda tamamlandığında repo işte böyle görünür

• Üst seviye: AGENTS.md, PROGRESS.md, DECISIONS.md, program.md, graph.md
• .agent/: feature_list., session-handoff.md, clean-state-checklist.md, quality.md
• scripts/: verify.sh, arch-check.sh, init.sh, cleanup.sh — bunlar tavsiye değil, gate
• Şimdi her dosyayı tek tek gezip bütünün içinde gerçekte ne yaptığına bakacağız

Ödeme backend'inin kök dizini, kursun ilk haftasında değil de bugün açıldığında işte böyle görünüyor. On bir dosya ve bir yardımcı klasör — ve hiçbiri tik atmak için orada değil: her biri, kurs boyunca tek tek ele aldığımız belirli bir hata katmanını kapatıyor. Şimdi hepsini tek tek gezeceğiz — önce talimatlar ve Definition of Done, sonra feature listesi ve doğrulama gate'i, ardından oturumlar arası süreklilik, mimari kural, sprint sözleşmesi, otonom döngü ve rol grafiği. Sonda hikâye değil, rakamlar var: MTTR'de, verification gap'te ve kurtarma maliyetinde aynı projede ne değişti?

AGENTS.md — öğüt listesi değil, 80 satırlık bir router

• Üst seviye yalnızca üç soruya cevap verir: ne, nasıl çalıştırılır, nasıl doğrulanır
• Spesifik her şey docs/* içindedir, router'ın kendisinde değil
• Dokümantasyon bağlantısı her zaman 'ne zaman' koşuluyla gelir; salt bir yol olarak değil
• 100 satırın altında tutulur — yoksa router, diğer tüm talimat dosyaları gibi aynı sebeplerle bozulmaya başlar

Ajan repoyu açtığında gördüğü ilk şey bin satırlık talimat listesi değil; onu doğru yere yönlendiren kısa bir router. Kurs sonunda ödeme backend'inin AGENTS.md'sine bakarsanız, içinde hiçbir konunun baştan sona anlatıldığını görmezsiniz — yalnızca komutlar, katı kısıtlamalar ve docs/api-patterns.md, docs/db-rules.md ile docs/testing.md'ye koşullu bağlantılar vardır. 'Modelleri değiştirmeden önce mutlaka oku' koşulu, çıplak bir dosya yolundan çok daha iyi çalışır — ajan önünde yalnızca bir dosya değil, o dosyayı açma sebebini görür.

## Router: ne / nasıl çalıştırılır / nasıl doğrulanır
- Yığın: FastAPI + PostgreSQL + iyzico webhook'ları.
- Çalıştırma: `make setup && make dev`. Doğrulama: `make check`.

## Ayrıntılar — koşula göre okuyun, hepsini bir anda değil
- `docs/api-patterns.md` — herhangi bir endpoint eklemeden önce mutlaka
- `docs/db-rules.md` — model ya da migration değiştirmeden önce mutlaka
- `docs/payments.md` — ödeme mantığını ya da webhook'ları değiştirmeden önce mutlaka
- `docs/testing.md` — yeni test yazarken