1. Ana sayfa
  2. Yapay zeka destek
  3. 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?
Tarayıcınızda çalışır Ücretsiz, üyelik yok

Hazır başlangıç

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

Güvenlik kuralları
Üretilen dosyalar

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.