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, salvaguardie e un piano duraturo — in cui ogni agente di coding esegue con precisione e porta a termine il lavoro a lungo termine.
Leggi e segui le istruzioni su https://deepworkplan.com/init.md per rendere questo repository AI-first.
Deep Work Plan è spec-driven development in cui il repository stesso diventa la harness.
Il problema e la risposta
Gli agenti di coding AI sono notevolmente efficaci in brevi sessioni. Sul lavoro a lungo termine — una migrazione, un nuovo sottosistema, un refactoring su decine di file — vanno alla deriva: il contesto si riempie, le decisioni vengono dimenticate e le attività di più ore vengono abbandonate a metà.
Deep Work Plan risponde con lo spec-driven development: il piano è la fonte di verità duratura e gli agenti eseguono rispetto a criteri di accettazione e validation gate espliciti. La deriva si riduce, il lavoro resta verificabile e qualsiasi agente può riprenderlo tra una sessione e l’altra.
È anche harness engineering reso portabile. Una harness per agenti è l’impalcatura attorno a un modello — contesto, strumenti, ciclo di controllo, salvaguardie, stato ripristinabile — che lo rende affidabile. Deep Work Plan installa quella harness nel repository stesso (AGENTS.md, docs, la home delle skill .agents/, la skill DWP), così qualsiasi agente può pilotare qualsiasi repo. Nato in Dailybot, collaudato per mesi e rilasciato come DailybotHQ/deepworkplan-skill.
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 il symlink da .claude 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 e bozze, 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) 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 il symlink da .claude a .agents, così ogni strumento legge un’unica fonte di verità.
create, execute, refine, resume, status, verify, onboard e author — 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. Piani e bozze 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.
Licenza MIT · zero telemetria · output in una cartella .dwp/ esclusa da git.