Markdown için Agent Docs – Yerel Markdown’ı AI ajanları için bir LLM Wiki’ye dönüştüren VS Code eklentisi

Son dönemde LLM Wiki, Code as Knowledge ve Context Engineering gibi yaklaşımlarla, AI ajanlarının kullanacağı bilgileri Markdown ve dosya biçiminde yönetme eğilimi artıyor.

LLM’lerin performansı artsa bile, bir ajanın önce hangi belgeleri okuması gerektiğini, hangi belgenin referans belge olduğunu ve değişiklik yaparken hangi belgeleri birlikte kontrol etmesi gerektiğini bilmiyorsa sonuçlar kolayca tutarsızlaşabiliyor.

Ben de araştırma notlarını, teknik dokümanları, wiki’leri ve raporları Markdown ile yönetirken benzer sorunlar yaşadım.

Biriken çok sayıda Markdown dosyası vardı, ancak klasörü olduğu gibi AI ajanına açtığımda şu sorunlar ortaya çıktı.

• Birbiriyle bağlantılı belgeleri kaçırma
• Benzer belgeler arasında hangisinin referans belge olduğunu belirlemenin zor olması
• Bozuk bağlantılar ve izole belgelerin olduğu gibi kullanılması
• Build çıktıları ve ajan yapılandırma dosyalarının da birlikte aranması
• Bir belge düzenlendikten sonra ilgili belgeler arasında içerik tutarsızlığı oluşması

Bu yüzden, yerel Markdown klasörünü AI ajanlarının anlayabileceği bir LLM Wiki yapısında düzenleyen bir VS Code eklentisi olan Agent Docs for Markdown’ı geliştirdim.

Bu, yalnızca Markdown arama ya da önizleme aracı değil; belgeler arasındaki ilişkileri ve ajanın çalışma akışını birlikte yönetmeyi hedefliyor.

Başlıca özellikler şunlar:

• Markdown belgelerini ve bağlantı ilişkilerini Source Graph olarak indeksleme
• Belirli bir belgeyi merkez alarak ilgili belgeleri genişleten Focus / Hop gezintisi
• Bozuk bağlantıları, izole belgeleri, yinelenen çıktıları ve arama dışı bırakma adaylarını bulan Workspace Cleanup Audit
• Claude, Codex, Gemini, Cursor vb. için Markdown’a özel ajan becerileri kurma
• Markdown’ı bağımsız HTML ve blog için HTML olarak dışa aktarma
• Tüm indeksleri ve belgeleri yerel workspace içinde yönetme

Birlikte sunulan beceriler iki role sadeleştirildi.

• markdown-manager
  Belge arama, Source Graph üzerinde gezinme, bağlantı denetimi, referans belgeyi belirleme ve değişikliğin etki alanını kontrol etme işlerini yapar.

• markdown-writer
  Araştırma notlarını rapor ya da blog yazısı biçiminde yeniden yapılandırır ve HTML olarak dışa aktarmadan önce render sonucunu kontrol eder.

Örneğin ajana şu şekilde istek verebilirsiniz.

“Bu belgeyi düzenlemeden önce, bağlantılı belgelerle birlikte kontrol edilmesi gereken güncelleme kapsamını söyle.”

“Bu Markdown workspace’inde bozuk bağlantıları, izole belgeleri ve arama dışında bırakılması gereken klasörleri bul.”

“Bu araştırma notunu yönetici raporu biçiminde yeniden yapılandır ve HTML render’ını da kontrol et.”

VS Code’da mevcut Markdown klasörünü açıp Agent Docs kenar çubuğunda Source Graph oluşturduğunuzda hemen deneyebilirsiniz.

Markdown klasörünü sadece bir belge deposu değil, insanların ve AI ajanlarının birlikte okuyup güncellediği yerel bir LLM Wiki’ye dönüştürmek isteyenlerden geri bildirim almak isterim.

GitHub:
https://github.com/sungreong/agent-docs-for-markdown