O seu agente de código escreve o plano.Reveja-o antes de ele escrever o código.

Reveja o plano antes do código

Uma suposição errada num plano custa um comentário. A mesma no código custa ler um diff, um revert e outra execução. Leia primeiro o plano, enquanto alterá-lo sai barato.

Num terminal, o plano é um bloco de texto comprido por onde se faz scroll. No DotMD é um documento formatado, e cada observação fica ligada à passagem de que fala:

1. Peça o plano como ficheiro

   «Escreve o plano em docs/plan.md e envia-mo no DotMD para revisão.»

2. Comente onde está errado

   Selecione uma passagem, prima ⌥⌘M e escreva a alteração que pretende. Faça-o em todo o plano e depois clique em Send.

3. Verifique as correções como um diff

   O agente edita o ficheiro; o texto antigo fica a vermelho e o novo a verde, junto ao comentário a que cada correção responde. Accept, Reopen ou Accept All.

4. Aprove e deixe-o construir

   Clique em Approve e o agente continua com o código.

O agente vê cada comentário com a sua passagem, as suas linhas e quem o escreveu, por isso sabe exatamente o que quer dizer. Também pode ler a passagem que selecionou: «Reescreve o parágrafo que selecionei no DotMD.»

Peça-lhe que «me mostre as alterações no DotMD» quando acabar, e ele abre a revisão por si.

Os documentos que os agentes escrevem

Os planos são só o começo. Os agentes também escrevem outros documentos, e pode revê-los da mesma forma:

• Specs e documentos de design.
• Registos de decisões de arquitetura (ADR).
• READMEs e entradas de CHANGELOG.
• Planos de migração, lançamento e teste.
• Tabelas de comparação de bibliotecas e serviços.

Um segundo agente também pode rever o trabalho do primeiro: o Claude Code escreve, o Codex deixa comentários, você decide. Veja Um agente revê outro.

Encaixa no seu ambiente

O DotMD executa um pequeno servidor MCP no seu Mac e o seu agente liga-se com uma linha. O Claude Code, o Codex, o Cursor e o Visual Studio Code funcionam; cada guia tem a configuração exata.

• Ficheiros, não uma cópia. O DotMD lê e escreve os ficheiros Markdown da pasta do seu projeto. Não há nada para importar nem sincronizar.
• git. Quando o git, um editor ou um agente altera um ficheiro, o DotMD repara e guarda o texto anterior como versão. Os comentários acompanham um ficheiro renomeado com git mv na primeira vez que o abre no novo local.
• Docker. Um agente num contentor chega ao DotMD em http://host.docker.internal:8089/mcp.

Faça disto um hábito: algumas linhas no AGENTS.md

Um agente envia um documento para revisão quando lho pede. Para o fazer sempre e procurar os seus comentários no DotMD, acrescente estas linhas ao AGENTS.md para o Codex ou ao CLAUDE.md para o Claude Code:

Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.

A primeira linha é a mais importante. Os seus comentários ficam guardados no DotMD, não no ficheiro, por isso um agente que não pensa no DotMD procura-os no projeto e não encontra nada.

Os seus ficheiros continuam seus

• Não há contas. Os seus ficheiros, comentários e histórico de versões ficam no seu Mac.
• O servidor MCP só responde em 127.0.0.1, por isso outros computadores não lhe chegam e as páginas web não o podem usar.
• Os comentários e o histórico são guardados pelo DotMD, não nos seus ficheiros. O Markdown do seu repositório não tem marcas nem comentários HTML.

Perguntas de programadores

Mais perguntas