Agent Docs for Markdown – VS-Code-Erweiterung, die lokales Markdown in ein LLM-Wiki für KI-Agenten verwandelt

In letzter Zeit gibt es zunehmend den Trend, Wissen, das KI-Agenten nutzen sollen, in Form von Markdown und Dateien zu verwalten – etwa als LLM Wiki, Knowledge as Code oder Context Engineering.

Auch wenn LLMs immer leistungsfähiger werden: Wenn ein Agent nicht weiß, welche Dokumente er zuerst lesen soll, welches Dokument die maßgebliche Referenz ist oder welche Dokumente bei Änderungen gemeinsam geprüft werden müssen, geraten die Ergebnisse schnell ins Wanken.

Auch ich bin beim Verwalten von Research Notes, technischer Dokumentation, Wikis und Berichten in Markdown auf ähnliche Probleme gestoßen.

Es hatten sich viele Markdown-Dateien angesammelt, aber wenn ich einem KI-Agenten einfach den Ordner geöffnet habe, traten folgende Probleme auf:

• miteinander verknüpfte Dokumente wurden übersehen
• bei ähnlichen Dokumenten war schwer zu erkennen, welches das maßgebliche Dokument ist
• defekte Links und isolierte Dokumente wurden unverändert verwendet
• Build-Artefakte und Agent-Konfigurationsdateien wurden mit durchsucht
• nach der Änderung eines Dokuments wichen die Inhalte verwandter Dokumente voneinander ab

Deshalb habe ich Agent Docs for Markdown entwickelt, eine VS-Code-Erweiterung, die lokale Markdown-Ordner in eine Form eines LLM Wiki bringt, die KI-Agenten verstehen können.

Ziel ist nicht einfach ein Tool zum Durchsuchen oder Anzeigen von Markdown, sondern die gemeinsame Verwaltung der Beziehungen zwischen Dokumenten und der Arbeitsabläufe von Agenten.

Die wichtigsten Funktionen sind:

• Indexierung von Markdown-Dokumenten und Link-Beziehungen als Source Graph
• Focus-/Hop-Navigation, die verwandte Dokumente ausgehend von einem bestimmten Dokument erweitert
• Workspace Cleanup Audit zum Finden defekter Links, isolierter Dokumente, doppelter Artefakte und Kandidaten für den Ausschluss aus der Suche
• Installation Markdown-spezifischer Agent Skills für Claude, Codex, Gemini, Cursor usw.
• Export von Markdown als eigenständiges HTML und als HTML für Blogs
• Verwaltung aller Indizes und Dokumente im lokalen Workspace

Die mitgelieferten Skills sind auf zwei Rollen vereinfacht:

• markdown-manager
  Prüft Dokumentsuche, Source-Graph-Navigation, Links, die Bestimmung maßgeblicher Dokumente und den Änderungsumfang.

• markdown-writer
  Strukturiert Research Notes zu Berichten oder Blogbeiträgen um und prüft vor dem HTML-Export das Rendering-Ergebnis.

Zum Beispiel kann man den Agenten so beauftragen:

„Bevor dieses Dokument geändert wird, sag mir bitte, welchen Update-Umfang ich zusammen mit den verknüpften Dokumenten prüfen sollte.“

„Finde in diesem Markdown-Workspace defekte Links, isolierte Dokumente und Ordner, die von der Suche ausgeschlossen werden sollten.“

„Strukturiere diese Research Notes als Executive Report um und prüfe auch das HTML-Rendering.“

Man kann in VS Code einen bestehenden Markdown-Ordner öffnen und in der Agent-Docs-Seitenleiste einen Source Graph erzeugen, um es sofort auszuprobieren.

Ich freue mich über Feedback von allen, die aus einem Markdown-Ordner nicht nur eine einfache Dokumentenablage machen möchten, sondern ein lokales LLM Wiki, das Menschen und KI-Agenten gemeinsam lesen und aktualisieren.

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