Agent Docs for Markdown – Ekstensi VS Code yang Mengubah Markdown Lokal Menjadi LLM Wiki untuk Agen AI

Belakangan ini makin banyak arus seperti LLM Wiki, Knowledge as Code, dan Context Engineering yang mencoba mengelola pengetahuan untuk agen AI dalam bentuk Markdown dan file.

Meskipun performa LLM semakin baik, jika agen tidak tahu dokumen mana yang harus dibaca lebih dulu, dokumen mana yang menjadi acuan, dan dokumen mana yang perlu dicek bersama saat melakukan perubahan, hasilnya mudah menjadi tidak konsisten.

Saya juga mengalami masalah serupa saat mengelola catatan riset, dokumentasi teknis, wiki, dan laporan dengan Markdown.

File Markdown memang menumpuk banyak, tetapi ketika folder dibuka begitu saja untuk agen AI, muncul masalah seperti berikut.

• Melewatkan dokumen yang saling terhubung
• Sulit menentukan dokumen mana yang menjadi acuan di antara dokumen-dokumen yang mirip
• Menggunakan link rusak dan dokumen terisolasi apa adanya
• Ikut menelusuri hasil build dan file konfigurasi agen
• Setelah satu dokumen diubah, isi dokumen terkait menjadi tidak selaras satu sama lain

Karena itu, saya membuat Agent Docs for Markdown, ekstensi VS Code yang merapikan folder Markdown lokal ke dalam bentuk LLM Wiki yang dapat dipahami agen AI.

Ini bukan sekadar alat untuk mencari atau melihat pratinjau Markdown, melainkan ditujukan untuk mengelola hubungan antardokumen sekaligus alur kerja agen.

Fitur utamanya adalah sebagai berikut.

• Mengindeks dokumen Markdown dan hubungan link sebagai Source Graph
• Penelusuran Focus / Hop yang memperluas dokumen terkait dengan berpusat pada dokumen tertentu
• Workspace Cleanup Audit untuk menemukan link rusak, dokumen terisolasi, hasil duplikat, dan kandidat pengecualian pencarian
• Memasang skill agen khusus Markdown untuk Claude, Codex, Gemini, Cursor, dan lainnya
• Mengekspor Markdown ke HTML mandiri dan HTML untuk blog
• Mengelola semua indeks dan dokumen di workspace lokal

Skill yang disediakan bersama juga disederhanakan menjadi dua peran.

• markdown-manager
  Menangani pencarian dokumen, penelusuran Source Graph, pemeriksaan link, penentuan dokumen acuan, dan pemeriksaan cakupan dampak perubahan.

• markdown-writer
  Menyusun ulang catatan riset menjadi laporan atau artikel blog, lalu memeriksa hasil render sebelum diekspor ke HTML.

Sebagai contoh, Anda bisa meminta agen seperti berikut.

“Beri tahu cakupan pembaruan yang perlu dicek bersama dokumen-dokumen yang terhubung sebelum dokumen ini diubah.”

“Di workspace Markdown ini, temukan link rusak, dokumen terisolasi, dan folder yang perlu dikecualikan dari pencarian.”

“Susun ulang catatan riset ini menjadi format laporan eksekutif dan periksa hingga render HTML.”

Anda bisa langsung mencobanya dengan membuka folder Markdown yang sudah ada di VS Code dan membuat Source Graph dari sidebar Agent Docs.

Saya ingin menerima masukan dari mereka yang ingin menjadikan folder Markdown bukan sekadar repositori dokumen, tetapi LLM Wiki lokal yang dibaca dan diperbarui bersama oleh manusia dan agen AI.

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