# Worklog per Agenti SUMMARY: Perché e come gli agenti tengono un worklog per attività — con un blocco prompt pronto da copiare, così la funzionalità non viene più mai trascurata. KEY CONTEXT: Mandatory (Michael #8882/#10509): POST /worklog at EVERY milestone (fix commit, verdict, escalation, handover, takeover, CRITICAL), not only at session end. One-liner: GET /worklog/push?task_id=&kind=progress&content=&agent= Details: API reference docs/content/en/api/worklog.md; fleet convention: GET /script/fleet-worklog-tasks-spec. Prompt block for new agent instances: see section "Initial prompt" on this page. Worklog per Agenti Questo documento esiste perché Michael lo ha ordinato (#10509, 08.10.2026): «La funzionalità worklog esiste da settimane. Ma la state trascurando. Prendi una task perché la documentazione e il prompt iniziale in Synapse vengano estesi con la funzionalità worklog, che non vada assolutamente persa e che tutti lo sappiano.» — Se sei un agente e leggi questa pagina, il worklog fa parte da subito del tuo repertorio standard. Perché il worklog? Gli agenti muoiono spesso: limite di contesto, wipe della sandbox, riavvio del cron. Ciò che va regolarmente perso non è la conoscenza (per quello c'è ), ma lo storico del lavoro: cosa è già stato provato su questa attività? Quale commit è stato pushato e quale no? Chi aspetta chi? È esattamente per questo che esiste il worklog — append-only, per attività, interrogabile. Un nuovo run legge e sa in pochi secondi dove si è fermato il predecessore. Il secondo destinatario è Michael: il worklog è LA fonte unica dello storico del lavoro della flotta. Senza voce di worklog il tuo lavoro non esiste ufficialmente nella panoramica della flotta. La regola obbligatoria Push-first, non push-last. Una voce a OGNI milestone: - Commit di fix pushato - MR creato, verdetto emesso, merge effettuato - Stato della pipeline (in particolare FAILED con causa) - Escalation, consegna, takeover - Risultati CRIT/HIGH - Cuciture di contesto (una voce prima della fine del contesto) Una voce costa una riga: [CODE BLOCK] I kind e quando usarli | kind | Momento | | --- | --- | | | attività rivendicata — prova che l'hai presa | | | ogni milestone (vedi regola obbligatoria) | | | decisioni, contesto, osservazioni | | | errore CON ciò che hai tentato | | | fase/sessione completata prima che il contesto scarseggi | | | attività finita — ultima voce, lo stato diventa | Prompt iniziale (blocco per setup di agenti) Copia questo blocco nel prompt di avvio/cron delle nuove istanze di agente. È volutamente breve per stare in ogni template. La versione inglese è il riferimento universale per gli agenti: [CODE BLOCK] Gli agenti di flotta che riusano lo stesso nome mind mettono in il loro nome (, , , …) — così le voci sono conteggiabili per agente. Per gli umani La panoramica del worklog si legge meglio in formato markdown: o l'elenco attività . Storico completo: .