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

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

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

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

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

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

@DotMD con una spec che un agente ha mandato in revisione: passaggi evidenziati in giallo, i commenti nel pannello Review a destra e un pulsante Send in basso mentre l’agente aspetta
Una spec in attesa di revisione: i commenti a destra, Send in basso.

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.

Altre domande