I tuoi agenti scrivono le spec.Tu le metti a posto in DotMD.
Claude Code, Codex e Cursor scrivono spec, piani e documenti di design in pochi minuti. DotMD trasforma ognuno in un documento che rivedi come una pull request: commenti sul passaggio esatto, correzioni visibili nel file e la tua approvazione alla fine.
macOS 14 o successivo. La lettura è gratuita; DotMD Pro ha 3 giorni di prova gratuita.
Risposta rapida
Collega il tuo agente a DotMD tramite MCP. Quando scrive una spec o un piano, ti manda il file e aspetta. Tu commenti i passaggi e premi Send; l’agente corregge ogni commento e tu accetti o riapri ogni correzione nel file. Poi Approve.
Perché la chat è un posto sbagliato per rivedere
Un agente scrive una spec in un minuto. Leggerla con attenzione e renderla giusta resta compito tuo, e una chat è un posto sbagliato per farlo. Citi un paragrafo e descrivi cosa vuoi, l’agente riscrive metà file e non capisci cosa ha cambiato. Il giro successivo riparte dalle stesse supposizioni.
Rivedi invece una spec come rivedi il codice. In DotMD ogni commento è legato al passaggio di cui parla, la correzione compare nel file proprio accanto e ogni versione del file viene conservata.
Il ciclo di revisione
-
L’agente ti manda il file
Scrive la spec e te la manda per la revisione. Una notifica ti avvisa, il file aspetta sotto Needs You nella barra laterale e anche l’agente aspetta.
-
Commenti i passaggi
Leggi il documento come apparirà, con tabelle, diagrammi e codice. Seleziona un passaggio da cambiare, premi ⌥⌘M e scrivi cosa vuoi. Scorri tutto il file prima di inviare qualcosa.
-
Premi Send
Fai clic su Send in fondo al pannello Review. L’agente riceve tutti i tuoi commenti insieme, con il passaggio e le righe di ciascuno.
-
Le correzioni compaiono nel file
L’agente modifica il file e rimanda ogni commento con una nota su cosa ha fatto. Il testo vecchio è rosso, quello nuovo verde, accanto al commento a cui risponde.
-
Accetti o riapri, poi approvi
Accept una correzione, Reopen con una nota migliore, oppure Accept All. Quando non resta niente da cambiare, fai clic su Approve e l’agente prosegue con il suo compito.
Cosa rivedere così
Tutto ciò che un agente scrive come file Markdown e che devi rendere giusto prima che ci agisca sopra:
- Spec e documenti di design di una funzionalità.
- Piani di implementazione, prima che l’agente scriva il codice.
- Piani di migrazione e di rilascio, dove un passaggio dimenticato costa caro.
- README e documentazione che altri seguiranno.
- Tabelle di confronto, dove ogni riga può essere sbagliata da sola.
I commenti funzionano anche senza alcun agente, come appunti per te su una bozza.
Niente resta in sospeso a tua insaputa
Un agente che ti aspetta si dimentica facilmente. DotMD lo tiene in vista senza mettersi davanti a quello che stai facendo:
- Needs You, in cima alla barra laterale, elenca ogni file in cui qualcuno ti aspetta: un agente che attende la tua revisione o correzioni che non hai ancora controllato.
- L’icona nel Dock mostra quanti file hanno bisogno di te.
- In un file, un banner dice cosa è in attesa, con un pulsante Review, e il pulsante Review della barra degli strumenti mostra in rosso quante correzioni restano da controllare.
- L’agente attende in una sola chiamata e non consuma token mentre leggi, per quanto tempo ci metta.
Cosa ti serve
- Un Mac con macOS 14 o successivo.
- DotMD Pro per revisioni e agenti: Yearly con 3 giorni di prova gratuita, oppure Lifetime. Leggere Markdown è gratis. Vedi i prezzi.
- Un agente che parli MCP, collegato a DotMD. Le guide di Claude Code e Codex hanno la configurazione in una riga per ciascuno.
Domande sulla revisione di spec AI
Perché non rivedere direttamente in chat?
In chat citi un paragrafo, l’agente riscrive mezzo file e tu non capisci cosa è cambiato. In DotMD un commento è legato al passaggio, la correzione appare come diff accanto ad esso e ogni versione del file viene conservata. È una code review, per i documenti.
Quali agenti possono mandarmi un documento?
Qualsiasi client MCP: Claude Code, Codex, Cursor, Visual Studio Code e altri.
L’agente consuma token mentre aspetta?
No. Aspetta in una sola chiamata di strumento finché non premi Send o Approve.
Posso mandare io un documento, senza che l’agente lo chieda?
Sì. Commenta un file qualsiasi, poi di’ all’agente: «Leggi i miei commenti in DotMD e correggili.» Il pannello Review ha questo prompt con un pulsante Copy.