DotMDOs seus agentes escrevem as specs.No DotMD, deixa-as certas.
O Claude Code, o Codex e o Cursor escrevem specs, planos e documentos de design em minutos. O DotMD transforma cada um num documento que revê como um pull request: comentários na passagem exata, correções visíveis no ficheiro e a sua aprovação no fim.
macOS 14 ou posterior. Ler é grátis; editar e rever são um pagamento único.
Resposta rápida
O DotMD permite-lhe rever as especificações, os planos e os documentos que o Claude Code, o Codex e o Cursor escrevem, como revê um pull request: comentários na passagem exata, correções mostradas no ficheiro e a sua aprovação no fim. As revisões fazem parte do DotMD Reviewer, uma compra única; ler é grátis.
Porque é que o chat é um mau sítio para rever
Um agente escreve uma spec num minuto. Lê-la com atenção e deixá-la certa continua a ser consigo, e um chat é um mau sítio para isso. Cita um parágrafo e descreve o que quer, o agente reescreve metade do ficheiro e não percebe o que mudou. A ronda seguinte começa com as mesmas suposições.
Reveja antes uma spec como revê código. No DotMD, cada comentário está ligado à passagem de que fala, a correção aparece no ficheiro mesmo ao lado e cada versão do ficheiro fica guardada.
O ciclo de revisão
-
O agente envia-lhe o ficheiro
Escreve a spec e envia-lha para revisão. Uma notificação avisa-o, o ficheiro espera em Needs You na barra lateral, e o agente também espera.
-
Comenta as passagens
Leia o documento como vai ficar, com as tabelas, diagramas e código. Selecione uma passagem que deva mudar, prima ⌥⌘M e escreva o que pretende. Percorra o ficheiro todo antes de enviar seja o que for.
-
Prime Send
Clique em Send no fundo do painel Review. O agente recebe todos os comentários de uma vez, cada um com a passagem e as linhas.
-
As correções aparecem no ficheiro
O agente edita o ficheiro e devolve cada comentário com uma nota sobre o que fez. O texto antigo fica a vermelho e o novo a verde, junto ao comentário a que responde.
-
Aceita ou reabre, depois aprova
Use Accept para aceitar uma correção, Reopen para a devolver com uma nota melhor, ou Accept All. Quando já não houver nada a mudar, clique em Approve e o agente continua a sua tarefa.
O que rever assim
Tudo o que um agente escreve como ficheiro Markdown e que precisa de deixar certo antes de ele agir com base nisso:
- Specs e documentos de design de uma funcionalidade.
- Planos de implementação, antes de o agente escrever o código.
- Planos de migração e de lançamento, em que um passo esquecido sai caro.
- READMEs e documentação que outras pessoas vão seguir.
- Tabelas de comparação, em que cada linha pode estar errada por si.
Os comentários também funcionam sem qualquer agente, como notas para si num rascunho.
Nada passa despercebido
É fácil esquecer um agente que está à sua espera. O DotMD mantém-no à vista sem se pôr à frente do que está a fazer:
- Needs You, no topo da barra lateral, lista cada ficheiro em que alguém espera por si: um agente à espera da sua revisão ou correções que ainda não verificou.
- O ícone do Dock mostra quantos ficheiros precisam de si.
- Num ficheiro, uma faixa diz o que está à espera, com um botão Review, e o botão Review da barra de ferramentas mostra a vermelho quantas correções há por verificar.
- O agente espera numa única chamada e não gasta tokens enquanto lê, por muito tempo que demore.
O que precisa
- Um Mac com macOS 14 ou posterior.
- O DotMD Reviewer para revisões e agentes: $39.99 uma vez, ou $24.99 para quem tem o Editor. Ler Markdown é grátis. Veja os preços.
- Um agente que fale MCP, ligado ao DotMD. Os guias do Claude Code e do Codex têm a configuração numa linha para cada um.
Perguntas sobre rever specs de IA
Como reviso a especificação de um agente de IA antes de ele escrever código?
Ligue o agente ao DotMD através de MCP e peça-lhe que lhe envie a especificação. Comente as passagens, clique em Send, aceite ou reabra cada correção e depois clique em Approve; o agente espera até o fazer.
Porque não rever a especificação no chat?
Num chat cita um parágrafo, o agente pode reescrever metade do ficheiro, e você não sabe o que mudou. No DotMD cada comentário está ligado a uma passagem, a correção aparece ao lado como diff, e cada versão do ficheiro é guardada.
Como vejo o que um agente alterou para além do que pedi?
Abra o painel Review. As alterações que nenhum comentário pediu aparecem em Other changes, e a Version History permite reverter um único bloco ou o ficheiro todo.
Que agentes me podem enviar um documento?
Qualquer cliente MCP: Claude Code, Codex, Cursor, Visual Studio Code e outros.
O agente gasta tokens enquanto espera?
Não. Espera numa única chamada de ferramenta até premir Send ou Approve.
Posso enviar eu um documento, sem o agente pedir?
Sim. Comente qualquer ficheiro e diga ao agente: «Lê os meus comentários no DotMD e corrige-os.» O painel Review tem este prompt com um botão Copy.