Son zamanlarda bir AI kodlama asistanı kullandıysanız, muhtemelen bir şey fark ettiniz: hepsi bir Markdown dosyası istiyor.

GitHub Copilot .github/copilot-instructions.md dosyasını okuyor. Cursor .cursor/rules/ dosyasını okuyor. Claude Code CLAUDE.md dosyasını okuyor. Windsurf .windsurf/rules dosyasını okuyor. Google’ın Jules’ü JULES.md dosyasını okuyor. Ve evrensel standart? AGENTS.md — artık 60.000’den fazla açık kaynak deposu tarafından kullanılan ve Linux Foundation’ın Agentic AI Foundation’ı tarafından yönetilen.

Markdown, bir dokümantasyon formatından AI kodlama ajanları için işletim sistemine dönüştü.

AGENTS.md Nedir?

AGENTS.md, deponuzda yaşayan ve AI kodlama ajanları için bir brifing paketi işlevi gören basit, açık formatlı bir Markdown dosyasıdır. Bunu README.md’nin karşılığı olarak düşünün:

README.md insanlar içindir: hızlı başlangıçlar, proje açıklamaları, rozetler
AGENTS.md AI ajanları içindir: derleme adımları, test komutları, kodlama kuralları, mimari kararlar

Ajan, dizin ağacındaki en yakın dosyayı okur, dolayısıyla en yakın olan öncelik alır. Her alt proje özelleştirilmiş talimatlar gönderebilir.

CLAUDE.md Nedir?

CLAUDE.md özellikle Anthropic’in Claude Code’u içindir. Her oturumun başında otomatik olarak okunur ve her promptta tekrarlayacağınız projeye özgü talimatları içerir.

İyi bir CLAUDE.md tipik olarak şunları içerir:

Proje bağlamı: Claude’u projenin ne yaptığı konusunda yönlendiren tek satır
Kod stili: Biçimlendirme tercihleriniz, adlandırma kuralları, takip edilecek desenler
Komutlar: Testleri nasıl çalıştırır, derler, lint eder ve dağıtırsınız
Mimari notlar: Claude’un saygı göstermesi gereken temel kararlar

Önerilen yaklaşım: paylaşılan talimatları AGENTS.md’ye koyun (böylece tüm AI araçları yararlanır), ardından Claude’a özgü özellikleri CLAUDE.md’ye ekleyin.

AI Talimat Dosyalarının Tam Manzarası

İşte her önemli AI kodlama aracı ve Markdown kuralı:

Araç	Dosya	Format
GitHub Copilot	`.github/copilot-instructions.md`	Markdown
Cursor	`.cursor/rules/*.md`	Markdown
Claude Code	`CLAUDE.md`	Markdown
Windsurf	`.windsurf/rules`	Markdown
Google Jules	`JULES.md`	Markdown
Evrensel	`AGENTS.md`	Markdown

Deseni fark ettiniz mi? Hepsi Markdown. Her biri.

Markdown Neden Kazandı

Markdown, AI talimat dosyaları için mükemmel formattır çünkü:

LLM’ler onu doğal olarak anlıyor — eğitim verilerindeki en yaygın format
İnsan tarafından okunabilir — geliştiriciler talimatları kolayca inceleyip düzenleyebilir
Sürüm kontrol edilebilir — kodunuzun yanında git’te yaşar
Hafif — ayrıştırma ek yükü yok, özel araç gerekmez
Evrensel — tüm AI araçları, editörler ve platformlarda çalışır

Visual Studio Magazine’in ifadesiyle: agentic AI’da her şey Markdown ile ilgili.

Ajan Talimatları Yazmak için En İyi Uygulamalar

Binlerce deponun analizine dayanarak:

Minimumdan başlayın. Yalnızca ajanın aynı hatayı tekrar tekrar yaptığını fark ettiğinizde kurallar ekleyin. Aşırı belirlenmiş talimatlar yardım etmekten çok kafa karıştırabilir.

Komutlar hakkında spesifik olun. “Testleri çalıştır” demeyin — pnpm test veya pytest -x tests/ deyin.

Mimarinizi belgeleyin. Projeniz belirli bir desen kullanıyorsa (içerik script’i ve service worker arasındaki mesaj geçişi gibi), açıklayın. Ajan, yalnızca koddan mimari kararları çıkaramaz.

YAPMAMASI gerekenleri dahil edin. Olumsuz talimatlar şaşırtıcı derecede etkilidir: “Veritabanı şemasını asla doğrudan değiştirme” veya “Sınıf bileşenleri kullanma, her zaman hook kullan.”

Save Bu Dünyaya Nasıl Uyuyor

Ajan talimat dosyaları oluşturuyorsanız, muhtemelen web’den de referans materyali kaydediyorsunuzdur: dokümantasyon sayfaları, Stack Overflow yanıtları, GitHub README’leri, API referansları.

Save, bu web kaynaklarından herhangi birini tek tıklamayla temiz Markdown’a dönüştürür — AI ajanlarınızın ihtiyaç duyduğu bağlamı oluşturmak için mükemmel. Bir dokümantasyon sayfasını kaydedin, Markdown’ı AGENTS.md’nize veya referans belgelerinize yapıştırın; AI kodlama asistanınız anında ihtiyaç duyduğu bağlama sahip olur.

İş akışı:

Web’de faydalı dokümantasyon veya kod örnekleri bulun
Markdown’a dönüştürmek için Save’e tıklayın
Ajan talimat dosyalarınıza referans verin veya dahil edin
AI kodlama asistanınız her kayıtla daha iyi çalışır

Gelecek: AI’nın Kontrol Yüzeyi Olarak Markdown

Microsoft ve GitHub artık Markdown’ı AI davranışı için kararlı, denetlenebilir bir kontrol yüzeyi olarak ele alıyor. Artık yalnızca dokümantasyon değil — insan niyeti ile AI yürütmesi arasındaki arayüz.

Markdown dosyalarının üç farklı rol üstlendiğini görüyoruz:

Dokümantasyon: Bir sistemi insanlara açıklar
Talimat: AI davranışını kısıtlar ve yönlendirir
Beceri: Ajanların iş akışlarını tekrarlayabilmesi için talimatları kaynaklarla bir araya getirir

Bu trend yalnızca hızlanıyor. AI kodlama asistanları daha yetenekli hale geldikçe, onlara rehberlik eden Markdown dosyaları daha önemli hale geliyor.

Save, herhangi bir web sayfasını tek tıklamayla temiz Markdown’a dönüştürür. Referans kütüphaneleri oluşturmak, dokümantasyon yakalamak ve AI kodlama iş akışlarınız için bağlam oluşturmak için mükemmel. Save’i ücretsiz deneyin.