Il tuo agente di codice scrive il piano.Rivedilo prima che scriva il codice.

Rivedi il piano prima del codice

Un presupposto sbagliato in un piano costa un commento. Lo stesso nel codice costa un diff da leggere, un revert e un’altra esecuzione. Leggi quindi il piano per primo, finché cambiarlo costa poco.

In un terminale il piano è un lungo blocco di testo da scorrere. In DotMD è un documento formattato, e ogni tua osservazione è legata al passaggio di cui parla:

1. Chiedi il piano come file

   «Scrivi il piano in docs/plan.md e mandamelo in DotMD per la revisione.»

2. Commenta dove è sbagliato

   Seleziona un passaggio, premi ⌥⌘M e scrivi la modifica che vuoi. Fallo su tutto il piano, poi fai clic su Send.

3. Controlla le correzioni come diff

   L’agente modifica il file; il testo vecchio è rosso e quello nuovo verde, accanto al commento a cui risponde ogni correzione. Accept, Reopen o Accept All.

4. Approva, poi lascialo costruire

   Fai clic su Approve e l’agente prosegue con il codice.

L’agente vede ogni commento con il suo passaggio, le sue righe e chi l’ha scritto, quindi sa esattamente cosa intendi. Può anche leggere il passaggio che hai selezionato: «Riscrivi il paragrafo che ho selezionato in DotMD.»

Chiedigli di «mostrarmi le modifiche in DotMD» quando ha finito, e apre la revisione per te.

I documenti che scrivono gli agenti

I piani sono solo l’inizio. Gli agenti scrivono anche altro, e puoi rivederlo allo stesso modo:

• Spec e documenti di design.
• Architecture decision record (ADR).
• README e voci di CHANGELOG.
• Piani di migrazione, rilascio e test.
• Tabelle di confronto di librerie e servizi.

Anche un secondo agente può rivedere il lavoro del primo: Claude Code scrive, Codex lascia commenti, tu decidi. Vedi Un agente rivede un altro.

Si adatta al tuo ambiente

DotMD esegue un piccolo server MCP sul tuo Mac e il tuo agente si collega con una riga. Claude Code, Codex, Cursor e Visual Studio Code funzionano tutti; ogni guida ha la configurazione esatta.

• File, non una copia. DotMD legge e scrive i file Markdown nella cartella del tuo progetto. Non c’è niente da importare o sincronizzare.
• git. Quando git, un editor o un agente cambia un file, DotMD se ne accorge e conserva il testo precedente come versione. I commenti seguono un file rinominato con git mv la prima volta che lo apri nella nuova posizione.
• Docker. Un agente in un container raggiunge DotMD a http://host.docker.internal:8089/mcp.

Fanne un’abitudine: poche righe in AGENTS.md

Un agente manda un documento in revisione quando glielo chiedi. Perché lo faccia ogni volta e cerchi i tuoi commenti in DotMD, aggiungi queste righe a AGENTS.md per Codex o a CLAUDE.md per 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.

La prima riga è la più importante. I tuoi commenti li conserva DotMD, non il file: un agente che non pensa a DotMD li cerca nel progetto e non trova nulla.

I tuoi file restano tuoi

• Non ci sono account. I tuoi file, commenti e la cronologia delle versioni restano sul tuo Mac.
• Il server MCP risponde solo su 127.0.0.1, quindi altri computer non possono raggiungerlo e le pagine web non possono usarlo.
• Commenti e cronologia sono conservati da DotMD, non nei tuoi file. Il Markdown del tuo repository non ha marcatori né commenti HTML.

Domande degli sviluppatori

Altre domande