Skip to content
Deep Work Plan è su Product Hunt oggi Vota ora
← Tutti i capitoli

Capitolo 03

Template di piani e attività

Un Deep Work Plan è una directory di file Markdown. La forma di quella directory — e di ciascun file al suo interno — è ciò che rende un piano revisionabile sia dalle persone sia dagli agenti.

Struttura del piano

Un piano è una directory sotto .dwp/plans/ denominata PLAN_<slug>/. Contiene:

  • README.md — la panoramica del piano: obiettivo, materiale di origine, tabella delle attività e stato.
  • Un file per attività, denominato <n>.task_<slug>.md.
  • PROGRESS.md — un log di esecuzione continuo.

Struttura del file di attività

Ogni file di attività è denominato <n>.task_<slug>.md e segue l’anatomia in dieci sezioni: Goal, Context, Superficie toccata, Steps, Acceptance criteria, Validation, Files, Dependencies, Risks e Completion & Log. Le sezioni compaiono sempre in quell’ordine, così ogni lettore sa dove guardare. Ogni attività si riancora all’obiettivo del piano prima di agire, il che impedisce a un agente di andare alla deriva su un orizzonte lungo, di più ore.

Il Final Review

Ogni piano deve concludersi con esattamente un’attività obbligatoria: il Final Review. Chiude il piano in tre passaggi ordinati — nulla del passaggio di sicurezza viene allentato:

  1. Passaggio di sicurezza — verificare tutto ciò che il piano ha modificato alla ricerca di segreti, rischi di injection e nuova superficie di attacco, e mantenere aggiornato docs/SECURITY.md. La sicurezza non è un flusso di lavoro separato aggiunto alla fine: ogni piano lascia le proprie modifiche verificate, e un rilievo critico blocca il completamento.
  2. Validazione dello stato finale — la validazione completa del repository viene eseguita e superata sull’ultimo stato rilevante, dopo l’ultima correzione.
  3. Riconciliazione delle skill — ogni attività ha registrato la propria disposizione sulle skill mentre la sua evidenza era fresca; la revisione riconcilia il registro. L’Executive Report resta disponibile su richiesta.

Convenzioni di README e PROGRESS

Il README.md del piano deve contenere un titolo (# Deep Work Plan: <name>), una dichiarazione discorsiva dell’obiettivo, una sezione facoltativa sul materiale di origine, una tabella delle attività (numero, nome dell’attività, casella di stato) e una riga di stato del piano nella forma <n>/<total> tasks complete.

PROGRESS.md è un log di esecuzione a sola aggiunta. Ogni voce registra un timestamp ISO 8601, il numero e il nome dell’attività, cosa è stato fatto e qualsiasi deviazione o motivo di salto. Poiché non fa che crescere, è una cronologia affidabile di come il piano si è effettivamente svolto.

Intestazioni e riferimenti incrociati

Tutte le intestazioni usano lo stile a frase (sentence case) e i documenti evitano il linguaggio di marketing e i punti esclamativi. Queste convenzioni mantengono i piani coerenti tra gli agenti e nel tempo.