Eu parei de escrever prompts para revisar PRDs — agora eu apenas 'corrijo' o dever de casa do meu agente de IA

O inferno do copiar e colar

Se você já pediu a um agente de IA para revisar um PRD de 50 páginas, você conhece a dor.

Você encontra um problema na página 12. Você copia aquele parágrafo. Você escreve um prompt: "Na seção sobre autenticação, a lógica de repetição está errada. Por favor, mude para backoff exponencial com no máximo 3 tentativas."

O agente encontra uma seção diferente sobre autenticação. Ou ele muda a seção certa, mas também "melhora" três outras coisas que você não pediu. Você perde 10 minutos desenrolando o que aconteceu.

Repita isso 30 vezes por documento. Esse foi meu fluxo de trabalho por meses.

O que eu realmente queria

Eu queria fazer o que um professor faz com o trabalho de um aluno:

• Traçar uma linha através da parte ruim
• Escrever "corrija isso" ou "o que isso significa?"
• Devolver

O aluno (agente) deve saber exatamente onde está a marca e exatamente que tipo de feedback é. Sem ambiguidade, sem contexto perdido.

O que eu construí

MD Feedback — uma extensão do VS Code + servidor MCP.

Abra qualquer arquivo markdown. Selecione o texto. Pressione 2 para corrigir ou 3 para pergunta. É isso.

Cada anotação é armazenada como um comentário HTML dentro do próprio markdown:

[FIX] id:abc status:open
Use backoff exponencial, não repetição linear
(armazenado como comentários HTML — invisível em visualizadores normais de markdown)

Como são apenas comentários HTML:

• Eles sobrevivem a commits, branches e merges do git
• Eles são renderizados invisivelmente em qualquer visualizador de markdown
• Eles não quebram o documento para quem não está usando a ferramenta

A parte do MCP

A extensão vem com um servidor MCP (27 ferramentas). Seu agente de IA se conecta e pode:

• ler todas as anotações com locais exatos
• aplicar correções e relatar o que mudou
• verificar portas de qualidade ("3 correções restantes → bloqueado")
• gerar transferências de sessão para que a próxima sessão continue de onde você parou

Sem copiar e colar. Sem exportação. O agente lê suas marcas vermelhas diretamente.

O sistema de portas

Isso mudou meu fluxo de trabalho mais. O agente não pode prosseguir para a implementação até que eu aprove suas correções. Eu vejo as diferenças antes/depois em linha para cada mudança.

É como uma revisão de pull request, mas para o próprio plano.

Fluxo de trabalho

1. VOCÊ     → Escreve o plano em markdown
2. VOCÊ     → Anota: destaque (1), corrija (2), pergunta (3)
3. AGENTE   → Lê anotações via MCP
4. AGENTE   → Implementa correções
5. VOCÊ     → Aprova / rejeita em linha
6. AGENTE   → Portas autoavaliam: "tudo pronto → pronto"

Você faz os passos 1-2 e 5. O agente faz o resto.

Configuração (2 minutos)

Instale a partir do VS Code Marketplace, depois adicione à sua configuração MCP:

{
  "mcpServers": {
    "md-feedback": {
      "command": "npx",
      "args": ["-y", "md-feedback"]
    }
  }
}

Funciona com Claude Code, Cursor, Copilot, Codex, Cline, Windsurf e mais.

Código aberto

GitHub: yeominux/md-feedback

Gratuito para uso pessoal. Eu adoraria saber como seu fluxo de revisão se compara — especialmente se você encontrou outras maneiras de resolver o problema "o agente perde o contexto em documentos longos".