22 yıl boyunca Markdown bir dokümantasyon formatıydı. README’ler, blog yazıları ve notlar yazıyordunuz. İnsanlara şeyler açıklıyordu.

Sonra bir şey değişti. 2024’te AI kodlama asistanları .cursorrules ve copilot-instructions.md okumaya başladı. 2025’te AGENTS.md evrensel bir standart olarak ortaya çıktı. 2026’nın başında Andrej Karpathy autoresearch’ü yayınladı; burada insan katkısının tamamı program.md adlı bir Markdown dosyasıdır.

Evrim açık:

Dönem	Dosya	Hedef Kitle	Amaç
2004-2023	`README.md`	İnsanlar	Dokümantasyon
2024	`.cursorrules`	AI kodlama araçları	Kod stili kuralları
2025	`AGENTS.md`	AI kodlama ajanları	Proje talimatları
2026	`program.md`	Otonom ajanlar	Araştırma programları

Markdown artık sadece dokümantasyon değil. AI için bir programlama dili.

Üç Nesil

1. Nesil: Dokümantasyon (README.md)

Orijinal Markdown kullanım senaryosu. Projenizi insanların anlaması için bir README yazıyorsunuz. Pasif — bir insan okuyana kadar orada duruyor. Hiçbir makine ona göre hareket etmiyor.

2. Nesil: Yapılandırma (AGENTS.md, CLAUDE.md)

AI kodlama asistanlarının proje bağlamına ihtiyacı var. AGENTS.md onlara build komutlarınızı, kodlama kurallarınızı ve mimari kararlarınızı söylüyor. CLAUDE.md, Claude Code’un davranışını özelleştiriyor. Bu dosyalar aktif — bir AI onları okur ve davranışını buna göre değiştirir.

Ama kodu hâlâ insan yazıyor. Markdown dosyası sadece AI’ın daha iyi yardım etmesine yardımcı oluyor.

3. Nesil: Programlama (program.md)

Autoresearch ile insan hiç kod yazmıyor. Tüm katkı program.md — araştırma hedeflerini, kısıtlamaları ve stratejiyi tanımlayan bir Markdown dosyası. AI ajanı onu okur ve ardından saatlerce ya da günlerce özerk bir şekilde kod yazar, çalıştırır ve üzerinde yineleme yapar.

Bu, bir programlama dili olarak Markdown. Çıktı biçimlendirilmiş metin değil — çalışan kod, deneysel sonuçlar ve bilimsel keşifler.

Neden Markdown?

Neden her AI sistemi YAML, JSON veya özel bir DSL yerine Markdown’a yöneldi?

Eğitim verilerinde mevcut. LLM’ler eğitim sırasında milyarlarca Markdown dosyası gördü. Kurallarını derinden anlıyorlar — başlıklar hiyerarşiyi, madde işaretleri listeleri, kod blokları çalıştırılabilir içeriği gösteriyor.

Esnek. Markdown katı bir şema dayatmıyor. Serbest biçimli talimatlar, yapılandırılmış tablolar, kod örnekleri ve doğal dili aynı dosyada yazabilirsiniz. Bu esneklik, insanların AI ajanlarını yönlendirme biçimiyle örtüşüyor.

Denetlenebilir. Bir program.md okuyabilir ve ajana tam olarak ne yapmasının söylendiğini anlayabilirsiniz. Bunu 500 satırlık bir YAML yapılandırmasıyla deneyin.

Sürüm kontrolüne uygun. Ajanınızın talimatlarındaki her değişiklik bir git commit’i. Davranış değişikliklerini tıpkı kod değişiklikleri gibi diff edebilir, inceleyebilir ve geri alabilirsiniz.

Bu Sizin İçin Ne Anlama Geliyor

Markdown bir programlama diline dönüşüyorsa, Markdown yazan herkes bir anlamda programcı oluyor. Beceri sözdizimi değil — düşünce netliği ve talimat hassasiyeti.

Şu an önemli olan şeyler:

Kesin Markdown talimatları yazmayı öğrenin. AGENTS.md ya da program.md ne kadar iyi olursa AI ajanınız o kadar iyi performans gösterir. Bu, teknik bilgiyi açık yazarlıkla birleştiren yeni bir beceri.

Markdown’da bir referans kütüphanesi oluşturun. AI ajanları için talimat yazarken referans materyale ihtiyacınız var: dokümantasyon, örnekler, makaleler, en iyi uygulamalar. Bu materyali temiz Markdown formatında bulundurmak onu hemen kullanılabilir kılıyor.

AI Markdown ekosistemini anlayın. AGENTS.md, CLAUDE.md, llms.txt ve program.md arasındaki farkı bilin. Her biri büyüyen Markdown-for-AI yığınında farklı bir amaca hizmet ediyor.

Ajan Talimatları İçin Bilgi Yakalamak

İyi AI ajanı talimatları yazmak bilgi gerektirir. Alanı, araçları, kısıtlamaları ve hedefleri anlamanız gerekiyor. Bu bilginin büyük kısmı web’de yaşıyor — dokümantasyon sayfalarında, blog yazılarında, araştırma makalelerinde ve eğitimlerde.

Save bu web kaynaklarından herhangi birini tek tıklamayla temiz Markdown’a dönüştürür. Bir program.md veya AGENTS.md hazırlarken referans materyalinizin zaten Markdown formatında olması, ondan hemen alıntı yapabileceğiniz, referans verebileceğiniz ve üzerine inşa edebileceğiniz anlamına gelir.

En iyi program.md dosyalarını yazan araştırmacılar sıfırdan başlamıyor. Markdown formatında yakaladıkları ve organize ettikleri bilgi üzerine inşa ediyorlar.

Save, herhangi bir web sayfasını temiz Markdown’a dönüştürür — etkili AI ajanı talimatları yazmak için ihtiyaç duyduğunuz referans kütüphanesini oluşturmak için mükemmel. Save’i ücretsiz deneyin.