Leggere i file Markdown scritti dai tuoi agenti IA

Gli agenti IA di programmazione scrivono molto Markdown. Una pianificazione prima di iniziare. Una specifica. Appunti su ciò che hanno deciso. Un report quando finiscono. File di istruzioni che leggono, come AGENTS.md o CLAUDE.md. Spesso un file di memoria a cui continuano ad aggiungere cose.

Tutto questo è testo semplice con dentro #, ** e |. Puoi leggerlo in un editor di codice, ma pianificazioni lunghe e tabelle sono difficili da leggere lì, ed è facile non accorgersi di ciò che l'agente ha appena cambiato.

Questa pagina riguarda la lettura di quei file: come pagine ben strutturate e in un modo che ti mostri cosa è cambiato.

Cosa scrivono gli agenti

FileCos'èChi lo scrive
AGENTS.md, CLAUDE.mdIstruzioni che l'agente legge all'inizio di ogni sessioneTu, spesso con l'aiuto dell'agente
Pianificazioni e specificheCosa sta per costruire l'agente, passo per passoL'agente, quando gli chiedi una pianificazione
Appunti e decisioniPerché ha fatto qualcosa, cosa ha provatoL'agente
Report e riepiloghiCosa ha fatto, cosa restaL'agente, alla fine di un'attività
File di memoriaCose che ha imparato su di te e sul progettoAlcuni agenti, di propria iniziativa

Pagine dedicate ai singoli agenti:

Tre cose che aiutano

1. Leggi la cartella, non un solo file. Gli agenti scrivono molti file in varie cartelle. Apri l'intera cartella del progetto in un lettore Markdown, così puoi passare dalla pianificazione alla specifica al report.

2. Vedi i file nuovi e modificati. Mentre un agente lavora, i file compaiono e cambiano. Vuoi vedere quali, senza aprirli uno per uno.

3. Vedi cosa è cambiato dentro un file. Quando un agente modifica una pianificazione che hai già letto, vuoi vedere solo ciò che è cambiato, senza rileggere tutta la pianificazione.

Su Mac: PilcrowMD (beta)

PilcrowMD per Mac (beta) è un lettore Markdown gratuito pensato per questo.

PilcrowMD per Mac (beta)

Sul telefono: controlla il lavoro dell'agente

Gli agenti non girano su un telefono, ma puoi leggere ciò che hanno scritto. Se la cartella dell'agente si sincronizza con Google Drive, aggiungi quella cartella in Le mie cartelle in PilcrowMD per Android.

Testato con Google Drive e con la memoria del telefono. Altre app cloud possono funzionare se mostrano le loro cartelle nel selettore di cartelle di Android.

Domande frequenti

Mi serve PilcrowMD per leggere questi file? No. Sono testo semplice; qualsiasi editor li apre. Un lettore Markdown mostra tabelle, codice e titoli come una pagina, il che aiuta con le pianificazioni lunghe.

PilcrowMD modificherà i file del mio agente? No, a meno che tu non modifichi e salvi. Altrimenti non viene scritto nulla, e chiede conferma prima di salvare sopra una modifica fatta da un'altra app.

Invia i miei file da qualche parte? No. L'app Mac non stabilisce alcuna connessione a internet e l'app Android non ha il permesso di accesso a internet. Su Android, la sincronizzazione è affidata all'app cloud che hai scelto, come Google Drive.

Anche su Mac: PilcrowMD per Mac (beta)