Agent Docs for Markdown: una extensión de VS Code que convierte Markdown local en una Wiki LLM para agentes de IA

Últimamente está creciendo la tendencia de gestionar el conocimiento que usarán los agentes de IA en forma de Markdown y archivos, como ocurre con LLM Wiki, Knowledge as Code y Context Engineering.

Aunque mejore el rendimiento de los LLM, si el agente no sabe qué documentos debe leer primero, cuál es el documento de referencia o qué documentos debe revisar en conjunto al hacer cambios, los resultados pueden volverse inestables fácilmente.

Yo también enfrenté problemas similares mientras gestionaba notas de investigación, documentación técnica, wikis e informes en Markdown.

Se acumulaban muchos archivos Markdown, pero cuando le abría la carpeta tal cual a un agente de IA, aparecían problemas como estos.

• Pasaba por alto documentos relacionados entre sí
• Era difícil determinar cuál era el documento de referencia entre documentos similares
• Usaba enlaces rotos y documentos aislados tal como estaban
• También buscaba entre artefactos de build y archivos de configuración del agente
• Después de modificar un documento, el contenido de documentos relacionados quedaba desalineado

Por eso creé Agent Docs for Markdown, una extensión de VS Code que organiza una carpeta local de Markdown en una forma de LLM Wiki que los agentes de IA puedan entender.

No apunta a ser simplemente una herramienta para buscar o previsualizar Markdown, sino a gestionar en conjunto las relaciones entre documentos y el flujo de trabajo del agente.

Sus funciones principales son las siguientes.

• Indexa documentos Markdown y relaciones de enlaces como un Source Graph
• Exploración Focus / Hop que expande documentos relacionados a partir de un documento específico
• Workspace Cleanup Audit para encontrar enlaces rotos, documentos aislados, artefactos duplicados y candidatos a excluir de las búsquedas
• Instalación de habilidades de agente dedicadas a Markdown para Claude, Codex, Gemini, Cursor y otros
• Exportación de Markdown a HTML independiente y HTML para blogs
• Gestión de todos los índices y documentos dentro del workspace local

Las habilidades incluidas simplifican los roles en dos.

• markdown-manager
  Revisa la búsqueda de documentos, la exploración del Source Graph, la verificación de enlaces, la identificación de documentos de referencia y el alcance del impacto de las modificaciones.

• markdown-writer
  Reestructura notas de investigación como informes o posts de blog y revisa el resultado de renderizado antes de exportar a HTML.

Por ejemplo, puedes pedirle al agente lo siguiente.

“Antes de modificar este documento, dime el alcance de las actualizaciones que debo revisar junto con los documentos conectados.”

“Encuentra en este workspace de Markdown enlaces rotos, documentos aislados y carpetas que deberían excluirse de la búsqueda.”

“Reestructura esta nota de investigación en formato de informe ejecutivo y revisa también el renderizado HTML.”

Puedes probarlo de inmediato abriendo una carpeta Markdown existente en VS Code y generando el Source Graph desde la barra lateral de Agent Docs.

Me gustaría recibir feedback de quienes quieran convertir una carpeta Markdown no solo en un simple repositorio de documentos, sino en una LLM Wiki local que puedan leer y actualizar tanto personas como agentes de IA.

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