GSD - Get Shit Done planning system (qrx)
Get Shit Done: ROADMAP-driven planning, plan-checker, wave parallelization
Il planning system di qrx che estende Claude Code con un workflow ROADMAP → PHASE → PLAN → SUMMARY. Non sono affiliato a qrx: opinioni post-uso reale su 19 phase del portfolio brownfield federicocalo.dev.
Sei cluster di approfondimento, due lead-magnet PDF, link upstream alla repository qrx ufficiale, e una demo CLI live del comando reale che ho usato per pianificare questa stessa Phase 20. Niente comparative matrix qui (vive sulla cornerstone), niente email confronto form (consolidato sulla cornerstone).
Due PDF gratuiti per partire
Ricette e pattern estratti dal portfolio reale (19 phase, sanitizzati). Scaricali gratis con la tua email - niente sequenza autoresponder.
PDF gratuito
GSD Planning Recipes
Dodici ricette di planning fasato GSD estratte dalle 19 phase del portfolio brownfield - pronte da clonare.
Cosa contiene:
- ROADMAPMd horizontal phasing template
- Plan-checker iterazione tipica (5 BLOCKER → 0)
- Wave structure per parallelizzazione 3-5x
v1.0 · aggiornato 2026-05
PDF gratuito
Agent Orchestration Patterns
Pattern di sub-agent orchestration applicati al portfolio reale - quando delegare, quando NO, come istanziare wave parallele.
Cosa contiene:
- Decision tree quando spawnare sub-agent
- 4 anti-pattern documentati (sub-agent troppo grande, serializzato, no-checkpoint)
- Worktree isolation per wave parallele safe
v1.0 · aggiornato 2026-05
GSD comando demo
Esempio reale: come aggiungo una nuova phase al portfolio brownfield, la pianifico e la eseguo in wave parallele. Sono i tre comandi che ho usato per orchestrare Phase 20 (questa serie editoriale).
# Aggiungi una nuova phase
gsd-sdk query phase.add \
--phase 21 \
--name "post-launch-analytics-claude-code-workflow" \
--goal "Misurare citation share-of-voice Phase 20 + iterate"
# Pianifica la phase
/gsd:plan-phase 21
# Esegui i plan in wave parallele
/gsd:execute-phase 21 Output reale: gsd-sdk scrive ROADMAP.md + PHASE-21-PLAN.md; /gsd:plan-phase spawna un sub-agent planner che genera la wave structure; /gsd:execute-phase spawna N sub-agent in worktree git isolati che committano in parallelo.
I 6 cluster GSD
Ogni cluster è un articolo tecnico standalone con esempi reali tratti dalle 19 phase del portfolio - niente teoria astratta, frontmatter YAML e SUMMARY.md ispezionabili.
Plan-checker: come risolvere BLOCKER + WARNING iterativamente
Leggi l'articoloAgent orchestration: sub-agent delega effettiva
Leggi l'articoloWave-based parallel execution: speedup misurato 3-5x
Leggi l'articoloIngest-docs synthesizer: consolidare 60+ doc planning
Leggi l'articoloMemory management: 60+ MEMORY.md auto-curated
Leggi l'articoloRepository upstream
Linko il repository ufficiale qrx/get-shit-done per trasparenza e citazione corretta dell'autore - niente fork, niente upselling.
qrx/get-shit-done
Planning system upstream - GSD framework di qrx. Repository ufficiale qrx/get-shit-done (MIT) con i comandi /gsd:*, gsd-sdk CLI, e il pattern ROADMAP → PHASE → PLAN → SUMMARY.
Vedi su GitHubNon sono affiliato a qrx. Le opinioni in questa sub-page sono post-uso reale di GSD sul portfolio personale federicocalo.dev (19 phase, 64 sub-agent, 556 dev-tools).
Domande frequenti su GSD
Cos'è Get Shit Done (GSD) per Claude Code?
Get Shit Done (GSD) è un planning system markdown-first creato da qrx (https://github.com/qrx/get-shit-done) che estende Claude Code con un workflow ROADMAP → PHASE → PLAN → SUMMARY. Ogni phase ha un obiettivo orizzontale (es. 'Scheduling Foundation') scomposto in plan atomici eseguibili in wave parallele via sub-agent worktree. Non è un framework di runtime: è una convenzione markdown + un CLI (gsd-sdk) che genera prompt strutturati per Claude Code, sfruttando i sub-agent built-in.
Come differisce GSD da una semplice TODO list?
Una TODO list è piatta e mutevole; GSD impone una struttura gerarchica (ROADMAP > PHASE > PLAN > SUMMARY) con frontmatter YAML strutturato, dipendenze esplicite (wave, depends_on, requirements), threat model STRIDE, gate di verifica per ogni task. Il plan-checker (`/gsd:plan-check N`) trova BLOCKER + WARNING prima dell'esecuzione, iterativo finché plan è verde. La differenza pratica sul mio portfolio: passare da '15 task in disordine' a '4 wave parallele eseguite in 32 minuti' con artefatti commit-tracciati e SUMMARY.md riproducibili.
Wave-based parallel execution: quanto è veloce?
Sul mio portfolio brownfield (Phase 17, 18, 19, 20) la wave-based parallel execution ha prodotto speedup misurati 3-5x rispetto all'esecuzione sequenziale. Il meccanismo: GSD spawna N sub-agent in worktree git isolati, ciascuno esegue un plan indipendente in parallelo, e l'orchestrator riconcilia i commit a fine wave. Il limite è la dipendenza tra plan (depends_on nel frontmatter): plan dipendenti vanno in wave successive. Phase 20 con 5 wave + 9 plan ha eseguito in ~3 ore vs. ~12-15 ore sequenziali stimate.
GSD funziona su progetti greenfield?
Sì, GSD è agnostico rispetto allo stato del progetto. Su greenfield parti dal comando `/gsd:new-project` che chiede core value + validated requirements + constraints e genera PROJECT.md + REQUIREMENTS.md + ROADMAP.md + STATE.md. Su brownfield (caso mio: 19 phase aggiunte a un monorepo Angular+SpringBoot+FastAPI esistente) usi `/gsd:plan-phase N` direttamente, lasciando coesistere GSD con la documentazione legacy. Il pattern brownfield richiede solo che la ROADMAP rifletta le fasi nuove, non l'intero storico.
Come integro GSD con sub-agent Claude Code?
GSD genera prompt strutturati che istruiscono Claude Code a spawnare sub-agent via la TaskCreate tool built-in. Ogni plan in wave parallele è eseguito da un sub-agent isolato in worktree git, con context window dedicato. L'integrazione è automatica: il comando `/gsd:execute-phase N` legge la wave structure dalla PHASE-N-PLAN.md, lancia i sub-agent in parallelo, attende i commit, e riconcilia la phase nel branch master. Niente configurazione runtime: GSD scrive solo markdown, Claude Code esegue.