Claude Code
CompletoImplementazione di riferimento, con WebFetch nativo e slash command.
Metodologia aperta · MIT · Indipendente dall’agente
Deep Work Plan trasforma qualsiasi repository in un ambiente strutturato — contesto, guardrail e un piano duraturo — dove qualsiasi agente di coding esegue con precisione ed efficienza e porta a termine il lavoro di lungo corso.
Copi il prompt di init.md e lo incolli nel Suo agente di coding — Claude Code, Cursor, Codex o qualsiasi altro — per rendere qualsiasi repository AI-first.
Deep Work Plan è spec-driven development in cui il repository stesso diventa la harness.
Il problema e la risposta
Nei burst brevi, gli agenti di coding sono notevoli. Affidategli una missione di lungo corso — una migrazione, un nuovo sottosistema, un refactoring su decine di file — e derivano: il contesto si riempie, le decisioni precedenti sfumano e ore di lavoro si fermano a metà.
Deep Work Plan risponde con lo sviluppo guidato dalla specifica: un piano duraturo, task atomici e validation gate che l’agente deve superare. “Fatto” smette di essere una sensazione — diventa evidenza verificabile e recensibile.
E poiché il contesto è la risorsa più scarsa del vostro agente, l’harness è progettato per mantenere piccola e verificabile la propria carga di istruzioni: le istruzioni si caricano progressivamente, la validazione tocca solo ciò che è cambiato e ogni task impara in loco. Il carico di ogni flusso è misurato in byte e pubblicato a ogni rilascio — l’ultimo rilascio ha ridotto il flusso di esecuzione del 45,7% e il flusso di ripresa del 67,5%. Anche il piano stesso scala allo stesso modo: un piano Lite per una correzione delimitata, un piano Full per il lavoro che si estende su ore — il formato segue sempre l’ampiezza del lavoro, mai il contrario.
Sei tu a decidere cosa significa “fatto” e dove corrono i confini. Il piano porta la tua intenzione; gli agenti mettono le ore — senza supervisione continua, senza correzioni ogni venti minuti.
Leggi la metodologia →
Gli umani governano. Gli agenti eseguono.
I task lunghi riempiono il contesto di qualsiasi modello. I dettagli sfumano e l’agente deriva. Un piano scritto — task atomici, validation gate, stato ripristinabile — è ciò a cui torna, giro dopo giro.
Vedi il ciclo principale →
Un piano da cui gli agenti non possono deviare.
Ogni task nomina i propri criteri di accettazione e le verifiche che devono passare. L’agente non può sentirsi finito — deve passare, o il task resta aperto.
Leggi la specifica →
Fatto è un contratto, non una sensazione.
Contesto, strumenti, guardrail e stato vivono nel tuo repository come semplici file che qualsiasi agente può leggere. Niente lock-in, niente cervello esterno — sopravvive ai reset del contesto.
Vedi cosa genera l’onboarding →
Il repository è il harness.
Il contesto è la risorsa più scarsa del vostro agente. L’harness si carica progressivamente, valida solo ciò che è cambiato e impara task per task — con il carico di istruzioni di ogni flusso misurato e pubblicato, rilascio dopo rilascio.
Leggi la metodologia →
Ogni token conta.
Onboarding basato sul ragionamento
Il flusso di onboarding esamina i linguaggi, i framework, il package manager e i comandi di validazione reali del Suo repository, poi genera artefatti adattati a quel repository. Uno stub generico è considerato un fallimento.
Legge i manifest, la struttura delle cartelle e la CI per dedurre i comandi reali di test, lint e build, poi classifica il repository come repo individuale o hub orchestratore.
Un AGENTS.md ragionato, una gerarchia docs/ categorizzata e un README più docs/ all’interno di ogni modulo principale — popolati con i comandi reali del Suo repository, non con segnaposto.
Una directory .agents/ multi-agente (skill, agenti, comandi) e i symlink da .claude e .cursor a .agents, che riflette CLAUDE.md su AGENTS.md, così ogni strumento legge un’unica fonte di verità.
Collega la skill Deep Work Plan e crea la cartella .dwp/ esclusa da git per piani, installa la revisione locale obbligatoria di AI Diff Reviewer, poi aggiunge facoltativamente addon opt-in come il supporto devcontainer.
Cosa succede quando lo esegui
Non sceglie un metodo di installazione né copia un template. Consegna al Suo agente una sola riga; questo installa la skill — il motore riutilizzabile — e vi adatta il Suo repository.
Legge il prompt di onboarding su deepworkplan.com/init.md e la metodologia, la specifica e il kit a cui rimanda — lo standard che sta per adottare.
La skill è il motore — lo stesso in ogni repository. Un solo comando importa il router e le sue sub-skill (create, execute, refine, resume, status, verify, onboard, author, upgrade) per Claude Code, Cursor, Codex, Gemini e Copilot.
Ragionando sul Suo stack reale — senza mai copiare e incollare — scrive AGENTS.md, un albero docs/ categorizzato, README per modulo, un kit .agents/ ragionato e una .dwp/ esclusa da git. Il Suo repository diventa la harness.
Genera Deep Work Plan a lungo termine per qualsiasi attività e li esegue passo dopo passo, con criteri di accettazione espliciti, validation gate e stato ripristinabile — in autonomia, per ore.
La skill viene installata in modo identico ovunque; ciò che si adatta è il Suo repository — l’AGENTS.md, i docs e il kit .agents/ ragionato generati per il Suo stack. È questa separazione a rendere la metodologia uno standard riutilizzabile anziché un’impalcatura usa e getta.
Cosa ottieni
Una singola esecuzione, sottoposta a commit in modo atomico. Ogni output è in Markdown e ogni modifica è verificabile.
Ragionato a partire dallo stack, dai comandi e dalla struttura reali del Suo repository — non un template con segnaposto. CLAUDE.md è collegato tramite symlink ad AGENTS.md.
Architettura, setup, standard e troubleshooting — più un README e docs/ all’interno di ogni modulo principale, generati dal Suo codebase.
Una directory .agents/ multi-agente (skill, agenti, comandi) con i symlink da .claude e .cursor a .agents, così ogni strumento legge un’unica fonte di verità.
create, execute, refine, resume, status, verify, onboard, author e upgrade — a disposizione del Suo agente come un unico pacchetto di skill, senza copie per repository.
/dwp-verify produce un report oggettivo di esito positivo/negativo rispetto alla specifica, così «AI-first» è verificato, non dichiarato — e ri-verificabile dopo ogni piano.
L’onboarding classifica il Suo repository come repo individuale (il caso più comune) o come hub orchestratore che coordina piani figli su più repository.
La sub-skill author (skill-create, agent-create) consente al repository di evolvere le proprie skill, agenti e comandi; gli addon di manutenzione opt-in come dependency-upgrade lo aiutano a restare aggiornato.
Nessun daemon e nessuno stato esterno. I piani finiscono in una cartella .dwp/ esclusa da git e qualsiasi attività riprende dal solo git — anche dopo un overflow del contesto.
Agenti
Una metodologia, molti adapter. Il Markdown non accoppia il framework a nulla — ogni agente che legge Markdown può eseguire un Deep Work Plan.
Implementazione di riferimento, con WebFetch nativo e slash command.
Adapter completo. Usi il bundle offline se WebFetch è bloccato.
Bundle offline consigliato; regole installate in .codex/.
Adapter completo — i comandi dwp-* girano tramite AGENTS.md e le procedure #.
Richiede Gemini 2.5 Pro o versione successiva, con WebFetch nativo.
Open source. Legge AGENTS.md in modo nativo ed esegue dwp-* tramite comandi #.
Le regole e le procedure dei comandi # guidano l'intero ciclo Deep Work Plan.
Open source. Le regole Markdown e i comandi # eseguono ogni passo dwp-*.
Adapter completo con una superficie di comandi nativa.
Stack
Sono ausili al ragionamento, non template. L’onboarding legge i manifest reali del Suo repository e si adatta a ogni stack — non copia mai un preset alla cieca. I monorepo ottengono documentazione per modulo.
Due archetipi
L’onboarding si dirama in base all’archetipo. La maggior parte dei repository sono repo individuali. Un hub coordina Deep Work Plan figli su molti repository. La metodologia gestisce entrambi come cittadini di prima classe.
Repository individuale
una base di codice autonoma
Hub orchestratore
coordina i sotto-repository
Un singolo codebase con uno stack primario, i propri comandi di validazione e documentazione per modulo. È l’impostazione predefinita — l’onboarding la assume a meno che il repository non sia chiaramente un hub.
Per esempio, un’API Django, un’app Vue o un servizio TypeScript Lambda.
Un repository di coordinamento che orchestra il lavoro su più sotto-repository tramite un manifest orchestratore, generando piani figli che eseguono il commit ciascuno nel proprio repository, con regole di confine e un indice di navigazione.
Per esempio, un hub che coordina cinque repository di prodotto.
Metodologia contro strumento
Deep Work Plan non è l’ennesimo scaffolder. È il livello di metodologia che sta sotto qualsiasi strumento spec-driven o di scaffolding, focalizzato su esecuzioni autonome di più ore.
| Metodologia contro strumento | Deep Work Plan | Strumenti di scaffolding / spec |
|---|---|---|
| Focus principale | Esecuzione autonoma di più ore | Generazione di spec o scaffold |
| Unità di lavoro | Un Deep Work Plan (sessione ripristinabile) | Un documento di spec o uno scaffold |
| Modello di stato | Cartella .dwp/ git-native, ripristinabile | Spesso esterno o nell’IDE |
| Accoppiamento con l’agente | Indipendente dall’agente (Markdown e Bash) | Spesso legato a uno strumento o IDE |
| Recupero del contesto | Riprende dopo un overflow del contesto | In genere riavvia l’attività |
| Licenza | MIT, metodologia e kit aperti | Variabile |
Origine
Realizzato da Dailybot — l’azienda dietro gli standup asincroni per team distribuiti. Internamente abbiamo usato i Deep Work Plan per rendere pilotabili dagli agenti repository di produzione che spaziano tra Django, Vue, TypeScript Lambda e Astro. Dopo mesi di uso in produzione, abbiamo reso open source la metodologia sotto licenza MIT.
Rendi il tuo repository AI-first
Consegni al Suo agente una sola riga — lo punti su /init.md — e renderà il Suo repository AI-first: installa la skill, ragiona sul Suo stack ed esegue il commit di una gerarchia AGENTS.md completa. Da lì crea ed esegue Deep Work Plan che girano in autonomia per ore.
Per agenti e sviluppatoriLicenza MIT · zero telemetria · output in una cartella .dwp/ esclusa da git.