gsd

仓库: ctsstc/get-shit-done-skills
安装量: 624
排名: #1825

安装

npx skills add https://github.com/ctsstc/get-shit-done-skills --skill gsd

A comprehensive project management system designed for solo developers working with Claude AI agents. GSD provides structured workflows for project initialization, planning, execution, verification, and debugging.

Overview

GSD is a modular agent-based system that transforms project ideas into shipped software through:

  • Deep questioning - Extract user vision and requirements

  • Domain research - Discover standard stacks and patterns

  • Roadmap creation - Break requirements into phases

  • Phase planning - Create executable plans with verification

  • Execution - Implement plans with atomic commits

  • Verification - Ensure goals are achieved, not just tasks done

  • Debugging - Systematic investigation of issues

Core Philosophy

  • Solo Developer + Claude Workflow - No teams, no stakeholders, no ceremonies

  • Plans are Prompts - PLAN.md files ARE the execution prompts, not documents

  • Goal-Backward Planning - Start from what must be TRUE, derive what to build

  • Atomic Commits - Each task commits independently for clean history

  • Quality Over Speed - Stop before context degrades (~50% usage)

  • Ship Fast - Plan → Execute → Ship → Learn → Repeat

When to Use GSD

Use GSD when you need to:

  • Initialize a new software project

  • Plan and execute development phases

  • Map an existing codebase

  • Debug issues systematically

  • Verify phase completion

  • Track project progress and state

Quick Start Commands

New Project

/gsd:new-project

Initializes a new project with questioning → research → requirements → roadmap flow.

Plan a Phase

/gsd:plan-phase [phase-number]

Creates detailed execution plans with research and verification.

Execute a Phase

/gsd:execute-phase [phase-number]

Executes all plans in a phase with parallel execution support.

Map Codebase

/gsd:map-codebase [optional-focus-area]

Analyzes existing codebase with parallel mapper agents.

Debug Issues

/gsd:debug [issue-description]

Systematic debugging using scientific method and hypothesis testing.

Verify Phase

/gsd:verify-work [phase-number]

Goal-backward verification of phase completion.

Check Progress

/gsd:progress

Shows current project position, completed phases, and next steps.

Agent Skills

GSD includes specialized agents for different tasks:

  • gsd-codebase-mapper - Explores and documents codebase structure

  • gsd-planner - Creates executable phase plans

  • gsd-executor - Executes plans with atomic commits

  • gsd-debugger - Investigates bugs systematically

  • gsd-verifier - Verifies goal achievement

  • gsd-research-synthesizer - Synthesizes research outputs

  • gsd-roadmapper - Creates project roadmaps

  • gsd-phase-researcher - Researches phase implementation

  • gsd-project-researcher - Researches domain ecosystem

  • gsd-integration-checker - Verifies integrations work

  • gsd-plan-checker - Validates plan quality

Command Skills

GSD provides commands for orchestrating the entire project lifecycle:

  • gsd:new-project - Initialize new project

  • gsd:map-codebase - Map existing codebase

  • gsd:plan-phase - Plan a phase

  • gsd:execute-phase - Execute a phase

  • gsd:verify-work - Verify phase completion

  • gsd:debug - Debug issues

  • gsd:discuss-phase - Gather phase context

  • gsd:research-phase - Research phase implementation

  • gsd:complete-milestone - Complete milestone

  • gsd:audit-milestone - Audit milestone

  • gsd:add-phase - Add new phase

  • gsd:insert-phase - Insert phase

  • gsd:remove-phase - Remove phase

  • gsd:add-todo - Add todo item

  • gsd:check-todos - Check todos

  • gsd:plan-milestone-gaps - Plan milestone gaps

  • gsd:pause-work - Pause work

  • gsd:resume-work - Resume work

  • gsd:update - Update project state

  • gsd:whats-new - Show what's new

Workflow Skills

Detailed workflow definitions for complex operations:

  • discovery-phase - Phase discovery workflow

  • execute-phase - Phase execution workflow

  • diagnose-issues - Parallel UAT diagnosis

  • map-codebase - Codebase mapping workflow

  • discuss-phase - Phase discussion workflow

  • verify-phase - Phase verification workflow

  • verify-work - Work verification workflow

  • transition - Phase transition workflow

  • resume-project - Project resumption workflow

Reference Skills

Reference documents for best practices and guidelines:

  • questioning - Deep questioning techniques

  • tdd - Test-driven development patterns

  • ui-brand - UI/UX guidelines

  • verification-patterns - Verification methodologies

  • git-integration - Git workflow patterns

  • checkpoints - Checkpoint handling

  • continuation-format - Continuation format specification

Project Structure

GSD creates a .planning/ directory with:

.planning/
├── PROJECT.md           # Project context and vision
├── config.json          # Workflow preferences
├── REQUIREMENTS.md      # Scoped requirements
├── ROADMAP.md          # Phase structure
├── STATE.md            # Project memory and state
├── research/            # Domain research outputs
├── phases/              # Phase-specific artifacts
│   ├── XX-name/
│   │   ├── XX-PLAN.md
│   │   ├── XX-SUMMARY.md
│   │   ├── XX-CONTEXT.md
│   │   ├── XX-RESEARCH.md
│   │   ├── XX-VERIFICATION.md
│   │   └── XX-UAT.md
└── codebase/            # Codebase analysis
    ├── STACK.md
    ├── ARCHITECTURE.md
    ├── STRUCTURE.md
    ├── CONVENTIONS.md
    ├── TESTING.md
    ├── INTEGRATIONS.md
    └── CONCERNS.md

Key Concepts

Goal-Backward Planning

Instead of asking "what should we build?", ask "what must be TRUE for the goal to be achieved?"

Forward: "Build authentication system" → task list Goal-Backward: "Users can securely access accounts" → derive what must exist

Atomic Commits

Each task commits independently with descriptive messages:

feat(01-01): implement user login
fix(01-02): fix password validation
test(01-03): add login tests

Context Budgeting

Plans complete within ~50% context usage to maintain quality:

  • 0-30%: PEAK quality

  • 30-50%: GOOD quality

  • 50-70%: DEGRADING quality

  • 70%+: POOR quality (avoid)

Wave-Based Execution

Plans are grouped into waves for parallel execution:

  • Wave 1: Independent plans (no dependencies)

  • Wave 2: Plans depending only on Wave 1

  • Wave 3: Plans depending on Wave 2, etc.

Anti-Patterns to Avoid

  • Enterprise PM Theater - No RACI matrices, sprint ceremonies, stakeholder management

  • Horizontal Layers - Don't group by "all models, then all APIs" - group by features

  • Vague Success Criteria - "Authentication works" → "User can log in with email/password"

  • Time Estimates - Never estimate in hours/days/weeks

  • Task Completion ≠ Goal Achievement - Verify outcomes, not just task completion

Getting Help

Each agent, command, and workflow has its own SKILL.md with detailed instructions. Use:

  • @skills/gsd/agents/ for agent-specific help

  • @skills/gsd/commands/ for command-specific help

  • @skills/gsd/workflows/ for workflow-specific help

  • @skills/gsd/references/ for reference documentation

Version

GSD Version: 1.0.0 Last Updated: 2026-01-19

← 返回排行榜