GSD-CC — Get Shit Done on Claude Code

A project management system for AI-powered software development. Structure your ideas, break them into executable units, and let Claude Code do the work — guided or fully autonomous.

Why GSD-CC?

Claude Code is the best coding agent available. But without structure, large projects degrade into chaos: context rot, lost decisions, no quality control.

GSD-CC orchestrates Claude Code with native Skills (Markdown) — no API costs, no build step, no custom agent.

| Feature | GSD-CC | |---------|--------| | Runtime | Claude Code (native) | | Cost model | Max Plan (flat rate) | | Dependencies | No build step (Markdown + Bash + CLI tools) | | Quality control | Mandatory UNIFY after every slice | | Boundary enforcement | Explicit DO NOT CHANGE rules per task | | Custom project types | Drop 3 files, done |

Install

npx gsd-cc            # Install globally (default)
npx gsd-cc --local    # Install to current project only
npx gsd-cc --global --yes          # Install/update without prompts
npx gsd-cc --local --language Deutsch
npx gsd-cc --uninstall            # Remove detected installs safely
npx gsd-cc --uninstall --global   # Remove only the global install
npx gsd-cc --uninstall --local    # Remove only the local install
npx gsd-cc dashboard --no-open    # Start the local dashboard

GSD-CC tracks installed assets in ~/.claude/gsd-cc/install-manifest.json (global) or ./.claude/gsd-cc/install-manifest.json (local), removes only files it owns during uninstall, and aborts if an existing target file cannot be proven safe to overwrite.

Installed layout:

• Hooks: ~/.claude/hooks/gsd-cc/ or ./.claude/hooks/gsd-cc/
• Custom types: ~/.claude/skills/seed/types/<your-type>/ or ./.claude/skills/seed/types/<your-type>/
• Scope-specific uninstall: --global or --local
• Prompt-free installs: --yes
• Explicit UI language: --language <name>

Reinstall and update runs preserve existing GSD-CC language and GSD-CC commit language settings by default. In non-interactive mode, missing UI language defaults to English and missing scope defaults to a global install. Commit language defaults to English and can be changed with /gsd-cc-config.

Usage

claude          # Open Claude Code
> /gsd-cc       # That's it. The router handles the rest.

GSD-CC reads your project state and suggests the next action. The full cycle:

SEED (ideation) → PLAN (tasks with acceptance criteria) → APPLY (execute) → UNIFY (mandatory plan vs. actual)

Auto-mode runs tasks autonomously via claude -p on your Max Plan.

Artifact convention:

• Slice overview: .gsd/S{nn}-PLAN.md
• Per-task plans: .gsd/S{nn}-T{nn}-PLAN.xml

Dashboard

The dashboard gives you a browser view of the current repository's GSD state:

npx gsd-cc dashboard
npx gsd-cc dashboard --no-open
npx gsd-cc dashboard --host 127.0.0.1 --port 4766

Inside Claude Code, run /gsd-cc-dashboard for the same launcher guidance.

The server is local-only by default: it binds to 127.0.0.1, reads .gsd/ from the current project, and serves dashboard assets from the installed package. V1 is read-only. It shows project progress, auto-mode events, token costs, and safe .gsd/ artifact previews, but it does not write files or run workflow actions.

Requirements

• Claude Code installed
• Claude Code Max Plan (recommended for auto-mode)
• Git initialized in your project
• jq installed (brew install jq) — required for hooks-ready and auto-ready installs

Install still succeeds without jq, but jq-dependent hooks stay disabled and auto-mode remains unavailable until jq is installed. Rerun the installer after adding jq to activate hooks.

Testing

From this package directory:

npm test

For dashboard integration sweeps, also launch the read-only Web App from a project that has .gsd/ state:

npx gsd-cc dashboard --no-open

The dashboard is optional for auto-mode. Auto-mode writes .gsd/events.jsonl and other artifacts directly, so it continues to work when the dashboard server is not running.

The suite uses temporary homes, projects, fake claude/jq binaries, and temporary Git repositories. It must not touch the developer's real ~/.claude, call the real claude CLI, or require network access.

Documentation

Full documentation, architecture details, and custom type guide: GitHub

License

MIT