Get Shit Done (GSD): Beast Mode for AI Coding 🔥

ai-agentsclaude-codecontext-engineeringlink-notespec-driven-development

Yo, my guy, this repo is GSD — a lightweight powerhouse that turns flaky AI code gen into reliable, shippable software. Built by TÂCHES for solo devs who let Claude (or friends) do the heavy lifting. 48k stars, 4k forks? It's popping off for a reason. 💀

1️⃣ WHY? (The Pain It Slays) 🤯

Context rot — that's the villain.

Before GSD:

AI Chat Session (Vanilla Vibes) ❌
═══════════════════════════════
User: Build a todo app
AI: Here's v1 (kinda works)
User: Add auth
AI: (Context bloated w/ old crap) Uh... auth on top? Breaks stuff 😱
User: Fix bugs
AI: (200k tokens of garbage) "I'll be concise now" → Hallucinations + drift
Result: Inconsistent trash, manual fixes, rage quits

Pain points:

  • Context window fills → Quality tanks → "Vibecoding" turns to dumpster fire
  • No structure → AI forgets requirements mid-project
  • Solo dev? No Jira theater needed, but vanilla AI flakes at scale

GSD exists to give AI everything it needs (context engineering + meta-prompts) so it builds exactly what you spec, verified, committed, shipped. No bs. 🚀

Ohhhhh moment: Fresh 200k contexts per task + agent orchestration = pro-level output every time.

2️⃣ BIG PICTURE (The System Map) 🗺️

GSD is a spec-driven dev workflow for AI tools (Claude Code, Cursor, Copilot, etc.). Install once, slash commands like /gsd-new-project.

Core Loop: Milestone → Phases → Ship → Repeat ✅
══════════════════════════════════════════════
          ┌─────────────────┐
User Idea │  /gsd-new-project  │ → PROJECT.md + ROADMAP.md
  ↓       └─────────────────┘
Phases:   ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
  1-N     │ discuss(N)   │ │ plan(N)      │ │ execute(N)   │ → Atomic commits
(for each)│ CONTEXT.md   │ │ RESEARCH.md  │ │ SUMMARY.md   │
          │ Gray areas   │ │ + PLAN.md    │ │ Waves/Agents │
          └──────┬───────┘ └──────┬───────┘ └──────┬───────┘
                 │                 │                 │
                 └────────── verify(N) ───────────────┘ → UAT.md
                                 │
                                 ▼
                           /gsd-ship(N) → PR
  • .planning/: Brain of the project (roadmaps, plans, state)
  • Agents: Subagents for research/planning/exec (parallel, fresh contexts)
  • Hooks/Skills: Auto-integrates w/ your AI runtime (Claude skills, Cline rules)
  • Fits: New/greenfield OR brownfield (/gsd-map-codebase scans existing code)

Multi-runtime: Claude, Cursor, Copilot, Gemini CLI, etc. — npx handles it.

3️⃣ HOW? (Mechanics Step-by-Step) ⚙️

Install: npx get-shit-done-cc@latest (pick runtime, global/local). Boom, commands ready.

Full Workflow (Per Milestone)

  1. Init: /gsd-new-project

    • Q&A → Research (parallel agents scan stack/domain)
    • Outputs: REQUIREMENTS.md, ROADMAP.md (phases sliced fine/standard/coarse)

  2. Discuss Phase N: /gsd-discuss-phase 1

    • Probes your vision (UI density? API flags? Tone?)
    • → {1}-CONTEXT.md (feeds research/planner)

  3. Plan Phase N: /gsd-plan-phase 1

    • Research → 2-3 atomic XML plans
    • Checker verifies → Loop till perfect
    <task>
  <name>User Model</name>
  <files>models/user.ts</files>
  <action>ORM w/ validation</action>
  <verify>Query works</verify>
</task>

  4. Execute Phase N: /gsd-execute-phase 1

    • Waves: Parallel independent plans, seq deps 
      Wave 1 (||)    Wave 2 (||)    Wave 3
Plan1 + Plan2 ──> Plan3 + Plan4 ──> Plan5
(Models)        (APIs)           (UI)
    • Fresh context/task → Commit → Verify

  5. Verify N: /gsd-verify-work 1

    • UAT checklist → Auto-debug fixes if broken

  6. Ship/Next: /gsd-ship 1 (PR), /gsd-next (auto-advance), /gsd-complete-milestone

Quick Mode: /gsd-quick "Add dark mode" — Ad-hoc w/ guarantees (add --full for all gates).

Agents Orchestration:

Orchestrator ──spawns──> 4 Researchers (stack/features/etc.)
                    │
                    └─> Planner + Checker (loop)
                    │
                    └─> Executors (waves, parallel)

4️⃣ Details + Edges (Configs, Gotchas) 🔧

| Config | Default | Why Tweak? | |--------|---------|------------| | mode | interactive | yolo = auto-approve | | granularity | standard | fine = tiny phases | | workflow.research | true | Skip for speed | | Profiles | balanced | quality (Opus everywhere) vs budget (Haiku) |

Edges:

  • Brownfield: /gsd-map-codebase → Auto-loads your stack
  • Security: Injection guards, deny secrets in Claude perms
  • Git: Atomic commits/phase branches, no .planning/ in PRs
  • Multi-proj: Workstreams/workspaces for parallel milestones
  • Uninstall: npx get-shit-done-cc --claude --global --uninstall

Troubleshoot: Restart runtime post-install. Hooks need --dangerously-skip-permissions in Claude for max speed.

BURN THIS IN: TL;DR 🔥

  • Why: Kills context rot → Reliable AI coding.
  • Flow: New-project → Discuss/Plan/Exec/Verify per phase → Ship.
  • Magic: Fresh contexts + waves + XML + agents = Pro output.
  • Start: npx get-shit-done-cc@latest → /gsd-new-project.

Tracking? Hit me if you wanna dive into agents or configs, bro. You got this! 🎯

Original article

← All notes