- Ana sayfa
- Yapay zeka destek
- AGENTS.md Oluşturucu
AI Kod Ajanları için AGENTS.md Oluşturucu
Nasıl çalıştığınızı seçin, bildiğinizi doldurun, dosyaları indirin. Repo köküne koyun. Kod ajanı boş kalanı bir kez sorar, cevabı docs/ altına yazar, bir daha sormaz.
Ne işe yarar?Proje
Kullandığınız yapay zeka araçları
Cursor, Codex, Windsurf, Zed ve çoğu araç AGENTS.md’yi doğrudan okur. Ek dosyalar sadece ona yönlendirir.
Teknoloji
Sonra sorulsun o satırı boş bırakır. Ajan bir kez sorar, cevabı yazar, bir daha sormaz. Yok, o katmanı ekleme demektir.
Komutlar
Boş komutlar framework’e göre tahmin edilir ve “doğrulanmadı” diye işaretlenir.
Kurallar
Dosyalar İngilizce. Repo köküne koyun. Token sayıları yaklaşıktır (token başına ~4 karakter); ajan bu dosyaları her sohbette okur, kısa olan daha ucuzdur.
Ne işe yarar?
Bu bir uygulama değil. Kod ajanı (Cursor, Codex, Claude, Copilot) için bir başlangıç paketi: kökte AGENTS.md, ajanın güncel tutması istenen bir docs/ klasörü. Bu dosyaları kendiniz yazmasanız da kullanılabilir bir taban elinizde olur.
Ne çıkar
- AGENTS.md: duran kurallar (en küçük değişiklik, hızı düşüren fazla tedbir yok, yalnız ilgili testler, docs/ İngilizce) ve ajanın sizinle nasıl konuşacağı.
- docs/project.md ve docs/stack.md: dil, veritabanı, önbellek (cache), Docker, kuyruk, Graphify. Boş satır bir kez sorulur, yazılır, bir daha sorulmaz.
- docs/TODO.md: sonra yapılacaklar için onay kutusu, notlar için düz madde (“bunu unutma”).
- docs/testing.md, docs/adr/: bir örnek mimari karar kaydı (ADR) ve bir şablon. Graphify açıksa docs/graphify.md da gelir.
- Sırlar, veritabanı, güvenlik ve doğrulama için güvenlik kuralları, bir de seçtiğiniz git kuralı. Kimlik etiketi açıksa ajan uyarıya kuralla başlar, örneğin [DB-001].
- İsteğe bağlı CLAUDE.md, GEMINI.md ve .github/copilot-instructions.md; hepsi AGENTS.md’ye yönlendirir, her araç aynı kuralları okur.
docs klasörü istemiyor musunuz? Sadece AGENTS.md seçin: stack, komutlar, yapılacaklar ve notlar o tek dosyaya girer.
Ajan bunu nasıl kullanır
İlk sohbet: bir bilgi hâlâ boşsa tek mesajda soru, ajan markdown’ı günceller. Sonraki sohbetler dosyaları okur. “Redis’e geçiyoruz” stack.md ve bir ADR günceller; anketi baştan açmaz. Docker kullanmak Compose dosyası yaratmak değildir; kurmak ayrı bir evet ister.
Tarayıcıda kalır
Hiçbir şey yüklenmez. Zip bu sekmede üretilir. Dosyaları git’e koyun; her ajan oturumu aynı tabanı görsün.