GSD-Lite
Get Shit Done — AI orchestration for Claude Code
GSD-Lite is an AI orchestration tool for Claude Code. It combines structured project management with built-in quality discipline: TDD enforcement, anti-rationalization guards, multi-level code review, and automatic failure recovery — all driven by a 12-state workflow machine that keeps multi-phase projects on track.
Discuss thoroughly, execute automatically. Have as many rounds of requirement discussion as needed. Once the plan is approved, GSD-Lite auto-executes: coding, self-review, independent review, verification, and phase advancement — with minimal human intervention.
Features
Structured Execution Engine
- Phase-based project management — Break work into phases with ordered tasks, dependency tracking, and handoff gates
- 12-state workflow machine —
planning → executing_task → reviewing_task → reviewing_phase → completed with precise transitions, persistent to state.json
- Automatic task scheduling — Gate-aware dependency resolution determines what runs next
- Session resilience — Stop anytime, resume exactly where you left off — crash protection via Stop hook auto-saves state markers
Quality Discipline (Built-in, Not Optional)
- TDD enforcement — "No production code without a failing test first" baked into every executor dispatch
- Anti-rationalization guards — Red-flag checklists inline in every agent prompt, blocking common excuses to skip process
- Multi-level code review — L0 self-review / L1 phase-batch review / L2 immediate independent review / phase review retry limit
- Contract change propagation — When an API contract changes, downstream tasks automatically invalidate
Intelligent Failure Recovery
- 3-strike retry with debugger escalation — Failed tasks retry up to 3 times, then auto-dispatch a debugger agent
- Systematic root cause analysis — Debugger tests hypotheses, finds root cause, feeds fix guidance back to executor
- Blocked task handling — Blocked tasks are parked; execution continues with remaining tasks
- Rework propagation — Critical review issues cascade invalidation to dependent tasks
Adaptive Review & Parallel Execution
- Confidence-based review adjustment — Executor self-assesses confidence (high/medium/low); orchestrator auto-adjusts review level with evidence cross-validation
- Impact analysis before review — Reviewer runs impact analysis on multi-file changes to catch missed downstream effects
- Parallel task scheduling — Independent tasks within the same phase are identified for concurrent dispatch
- Auto PR suggestion — Phase/project completion prompts PR creation with evidence summary
Context Protection & Monitoring
- Subagent isolation — Each task runs in its own agent context, preventing cross-contamination
- Real-time context health monitoring — StatusLine tracks context usage and project phase; composite StatusLine support coexists with other plugins
- Session lifecycle hooks — Stop hook writes crash marker; SessionStart injects project status into CLAUDE.md; resume detects non-graceful exits
- Evidence-based verification — Every claim backed by command output, not assertions
- Research with TTL — Research artifacts include volatility ratings and expiration dates
Auto-Update & Version Management
- Automatic update checks — Checks GitHub Releases every 24 hours with rate-limit backoff
- Version drift detection — Server startup compares running version against disk and plugin registry, warns on mismatch
- Smart cache management — Keeps latest 3 cached versions, auto-prunes old entries
- Idempotent installer — Reinstall anytime without uninstalling; legacy files auto-cleaned
Architecture
User → discuss + research (confirm requirements) → approve plan → auto-execute
↑ ↑ ↑
Interaction 1 Interaction 2 Autonomous execution
(code→review→verify→advance)
6 Commands
| Command | Purpose |
|---|
/gsd:start | Interactive start — discuss requirements, research, plan, then auto-execute |
/gsd:prd <input> | Start from a requirements doc or description text |
/gsd:resume | Resume execution from saved state with workspace validation |
/gsd:status | View project progress dashboard (derived from canonical state fields) |
/gsd:stop | Save state and pause execution |
/gsd:doctor | Diagnostic checks on GSD-Lite installation and project health |
4 Agents
