Agent Docs for Markdown – extensão do VS Code que transforma Markdown local em uma Wiki LLM para agentes de IA

Recentemente, tem crescido a tendência de gerenciar, em Markdown e arquivos, o conhecimento que agentes de IA vão usar, como em LLM Wiki, Knowledge as Code e Context Engineering.

Mesmo que o desempenho dos LLMs melhore, se o agente não souber qual documento deve ler primeiro, qual é o documento de referência e quais documentos precisam ser verificados juntos ao fazer alterações, o resultado facilmente perde consistência.

Eu também enfrentei um problema parecido ao gerenciar notas de pesquisa, documentação técnica, wiki e relatórios em Markdown.

Havia muitos arquivos Markdown acumulados, mas quando eu simplesmente abria a pasta para um agente de IA, surgiam problemas como estes.

• Deixar passar documentos conectados entre si
• Dificuldade para determinar, entre documentos parecidos, qual é o documento de referência
• Usar links quebrados e documentos isolados do jeito que estão
• Pesquisar junto até os artefatos de build e os arquivos de configuração do agente
• Depois de editar um documento, o conteúdo dos documentos relacionados ficar divergente

Por isso, criei o Agent Docs for Markdown, uma extensão do VS Code que organiza pastas locais de Markdown no formato de uma LLM Wiki que agentes de IA conseguem entender.

Não é apenas uma ferramenta para pesquisar ou visualizar Markdown; o objetivo é gerenciar junto as relações entre documentos e o fluxo de trabalho do agente.

Os principais recursos são os seguintes.

• Indexação de documentos Markdown e suas relações de links em um Source Graph
• Navegação Focus / Hop para expandir documentos relacionados com base em um documento específico
• Workspace Cleanup Audit para encontrar links quebrados, documentos isolados, artefatos duplicados e candidatos a exclusão da busca
• Instalação de skills de agente dedicadas a Markdown para Claude, Codex, Gemini, Cursor e outros
• Exportação de Markdown para HTML independente e HTML para blog
• Gerenciamento de todos os índices e documentos no workspace local

As skills fornecidas em conjunto foram simplificadas em dois papéis.

• markdown-manager
  Faz busca de documentos, navegação no Source Graph, verificação de links, identificação de documentos de referência e checagem do escopo de impacto de alterações.

• markdown-writer
  Reestrutura notas de pesquisa em relatórios ou posts de blog e verifica o resultado da renderização antes de exportar para HTML.

Por exemplo, você pode pedir ao agente algo como o seguinte.

“Antes de editar este documento, me diga qual é o escopo de atualização que preciso revisar junto com os documentos conectados.”

“Encontre, neste workspace de Markdown, links quebrados, documentos isolados e pastas que devem ser excluídas da busca.”

“Reestruture esta nota de pesquisa no formato de relatório executivo e verifique também a renderização em HTML.”

Basta abrir uma pasta Markdown existente no VS Code e gerar o Source Graph na barra lateral do Agent Docs para começar a usar imediatamente.

Quero receber feedback de quem deseja transformar uma pasta Markdown não apenas em um repositório de documentos, mas em uma LLM Wiki local lida e atualizada em conjunto por pessoas e agentes de IA.

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