Os seus agentes escrevem as specs.No DotMD, deixa-as certas.

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

1. 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.

2. 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.

3. 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.

4. 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.

5. 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 Pro para revisões e agentes: Yearly com 3 dias de teste gratuito, ou Lifetime. 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

Mais perguntas