Sorun
Dürüst olalım: Artık kod okumak istemiyoruz. Ajanların yaptığı her şeyi doğrulamak da, projenin her teknik ayrıntısını akılda tutmak da istemiyoruz.
Ama ajanları kimse kontrol etmezse, her projeyi ne insanın ne de ajanın içinden çıkabileceği, sürdürülemez bir kaosa çevirirler. Bu yalnızca zaman meselesidir.
Fikir
HUMAN-INTENT.md, deponuzun kök dizinindeki tek bir dosyadır. İçinde sizin niyetiniz yer alır: projenin mimarisi, geliştirme kuralları ve ürün kararları.
Bu, kodun dokümantasyonu değildir. Kodun uymak zorunda olduğu yasadır.
Kurallar
-
Onu siz yazarsınız — yalnızca siz
Ajanlar bu dosyayı asla düzenlemez. İçindeki her satır, bir insanın verdiği karardır.
-
Talimatları ajan için yasadır
HUMAN-INTENT.md'de yazanlar her şeyin üzerindedir. Kod dosyayla çelişiyorsa, yanlış olan koddur.
-
Mimariyi, kuralları ve ürünü tanımlar
Tarif değil, niyet. Ajan zaten tüm desenleri bilir; sizin işiniz neyin geçerli olması gerektiğini — ve nedenini — belirlemektir.
Neden işe yarıyor
Ajanlara yetişmek imkânsız: kimsenin okumak istemeyeceği kadar çok kod üretiliyor. Her satırı kontrol etmek umutsuz; niyeti kontrol etmekse mümkün.
HUMAN-INTENT.md kontrolü bir seviye yukarı taşır: binlerce satır kod yerine kararlarınızı içeren tek bir dosyayı izlersiniz. Dosya yasa olduğu sürece proje sizin niyetinize göre gelişir — kodu kimse okumasa bile.
Nasıl başlanır
- Deponuzun kök dizininde HUMAN-INTENT.md oluşturun.
- Zaten verdiğiniz kararları yazın: mimari, geliştirme kuralları, ürün.
- Ajanınıza bu dosyayı okumasını ve yasa olarak görmesini söyleyin — AGENTS.md veya CLAUDE.md içinden ona atıfta bulunun.
- Her yeni kararı dosyaya ekleyin. Bir ajanın oraya yazmasına asla izin vermeyin.
- Kodu değil, bu dosyayı gözden geçirin.