gsd

Get Shit Done (GSD) - プロジェクト管理システム

Claude AI エージェントと連携する個人開発者向けに設計された、包括的なプロジェクト管理システムです。GSD は、プロジェクトの初期化、計画、実行、検証、デバッグのための構造化されたワークフローを提供します。

概要

GSD は、モジュール式のエージェントベースのシステムで、次の手順を通じてプロジェクトのアイデアをリリース可能なソフトウェアへと変換します。

1. 詳細なヒアリング - ユーザーのビジョンと要件を引き出します
2. ドメイン調査 - 標準的な技術スタックやパターンを見つけます
3. ロードマップの作成 - 要件をフェーズに分割します
4. フェーズ計画 - 検証手順を含む実行可能な計画を作成します
5. 実行 - アトミックコミットを行いながら計画を実装します
6. 検証 - タスクを完了するだけでなく、目標が達成されたことを確認します
7. デバッグ - 問題を体系的に調査します

中核となる理念

• 個人開発者 + Claude のワークフロー - チームも、ステークホルダーも、儀式的な会議もありません
• 計画はプロンプト - PLAN.md ファイルはドキュメントではなく、実行用のプロンプトそのものです
• 目標から逆算する計画 - 何が TRUE であるべきかを起点に、何を構築するかを導き出します
• アトミックコミット - 履歴を整理しやすくするため、各タスクを個別にコミットします
• 速度より品質 - コンテキストが劣化する前に停止します（使用率約50％）
• 素早くリリース - 計画 → 実行 → リリース → 学習 → 繰り返し

GSD を使う場面

次のような場合に GSD を使用してください。

• 新しいソフトウェアプロジェクトを初期化する
• 開発フェーズを計画して実行する
• 既存のコードベースをマッピングする
• 問題を体系的にデバッグする
• フェーズの完了を検証する
• プロジェクトの進捗と状態を追跡する

クイックスタートコマンド

新規プロジェクト

/gsd:new-project

ヒアリング → 調査 → 要件 → ロードマップの流れで、新しいプロジェクトを初期化します。

フェーズを計画する

/gsd:plan-phase [phase-number]

調査と検証を含む詳細な実行計画を作成します。

フェーズを実行する

/gsd:execute-phase [phase-number]

並列実行に対応し、フェーズ内のすべての計画を実行します。

コードベースをマッピングする

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

並列のマッパーエージェントを使用して、既存のコードベースを分析します。

問題をデバッグする

/gsd:debug [issue-description]

科学的手法と仮説検証を用いて、体系的にデバッグします。

フェーズを検証する

/gsd:verify-work [phase-number]

目標から逆算して、フェーズの完了を検証します。

進捗を確認する

/gsd:progress

現在のプロジェクトの位置、完了したフェーズ、次のステップを表示します。

エージェントスキル

GSD には、さまざまなタスクに対応する専門エージェントが含まれています。

• gsd-codebase-mapper - コードベースの構造を調査し、ドキュメント化します
• gsd-planner - 実行可能なフェーズ計画を作成します
• gsd-executor - アトミックコミットを行いながら計画を実行します
• gsd-debugger - バグを体系的に調査します
• gsd-verifier - 目標の達成を検証します
• gsd-research-synthesizer - 調査結果を統合します
• gsd-roadmapper - プロジェクトのロードマップを作成します
• gsd-phase-researcher - フェーズの実装方法を調査します
• gsd-project-researcher - ドメインのエコシステムを調査します
• gsd-integration-checker - インテグレーションが機能することを検証します
• gsd-plan-checker - 計画の品質を検証します

コマンドスキル

GSD は、プロジェクトのライフサイクル全体をオーケストレーションするコマンドを提供します。

• gsd:new-project - 新しいプロジェクトを初期化します
• gsd:map-codebase - 既存のコードベースをマッピングします
• gsd:plan-phase - フェーズを計画します
• gsd:execute-phase - フェーズを実行します
• gsd:verify-work - フェーズの完了を検証します
• gsd:debug - 問題をデバッグします
• gsd:discuss-phase - フェーズのコンテキストを収集します
• gsd:research-phase - フェーズの実装方法を調査します
• gsd:complete-milestone - マイルストーンを完了します
• gsd:audit-milestone - マイルストーンを監査します
• gsd:add-phase - 新しいフェーズを追加します
• gsd:insert-phase - フェーズを挿入します
• gsd:remove-phase - フェーズを削除します
• gsd:add-todo - todo 項目を追加します
• gsd:check-todos - todo を確認します
• gsd:plan-milestone-gaps - マイルストーンの不足分を計画します
• gsd:pause-work - 作業を一時停止します
• gsd:resume-work - 作業を再開します
• gsd:update - プロジェクトの状態を更新します
• gsd:whats-new - 新機能を表示します

ワークフロースキル

複雑な操作のための詳細なワークフロー定義です。

• discovery-phase - フェーズ発見ワークフロー
• execute-phase - フェーズ実行ワークフロー
• diagnose-issues - 並列 UAT 診断
• map-codebase - コードベースのマッピングワークフロー
• discuss-phase - フェーズ議論ワークフロー
• verify-phase - フェーズ検証ワークフロー
• verify-work - 作業検証ワークフロー
• transition - フェーズ移行ワークフロー
• resume-project - プロジェクト再開ワークフロー

リファレンススキル

ベストプラクティスとガイドラインに関するリファレンスドキュメントです。

• questioning - 深掘り質問のテクニック
• tdd - テスト駆動開発のパターン
• ui-brand - UI/UX ガイドライン
• verification-patterns - 検証方法
• git-integration - Git ワークフローのパターン
• checkpoints - チェックポイントの処理
• continuation-format - 継続形式の仕様

プロジェクト構成

GSD は .planning/ ディレクトリを作成します。

.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

主な概念

目標から逆算する計画

「何を構築すべきか？」ではなく、「目標を達成するには何が TRUE でなければならないか？」と問いかけます。

順方向：「認証システムを構築する」→ タスクリスト
目標から逆算：「ユーザーが安全にアカウントへアクセスできる」→ 必要なものを導き出す

アトミックコミット

各タスクは、内容がわかるメッセージを付けて個別にコミットします。

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

コンテキスト予算の管理

品質を維持するため、計画はコンテキスト使用率約 50％以内で完了させます。

• 0～30％：最高品質
• 30～50％：高品質
• 50～70％：品質低下
• 70％以上：低品質（避けてください）

ウェーブベースの実行

並列実行できるよう、計画をウェーブにグループ化します。

• **ウェーブ 1：**依存関係のない独立した計画
• **ウェーブ 2：**ウェーブ 1 のみに依存する計画
• **ウェーブ 3：**ウェーブ 2 に依存する計画など

避けるべきアンチパターン

• エンタープライズ PM の形骸化 - RACI マトリックス、スプリントの儀式、ステークホルダー管理は行いません
• 水平レイヤー - 「すべてのモデル、その次にすべての API」のようにグループ化せず、機能ごとにグループ化します
• 曖昧な成功基準 - 「認証が機能する」ではなく、「ユーザーがメールアドレスとパスワードでログインできる」とします
• 所要時間の見積もり - 時間、日、週単位で見積もらないでください
• タスク完了 ≠ 目標達成 - タスクの完了だけでなく、成果を検証してください

ヘルプの利用

各エージェント、コマンド、ワークフローには、詳細な手順を記載した独自の SKILL.md があります。以下を参照してください。

• エージェント固有のヘルプは @skills/gsd/agents/
• コマンド固有のヘルプは @skills/gsd/commands/
• ワークフロー固有のヘルプは @skills/gsd/workflows/
• リファレンスドキュメントは @skills/gsd/references/

バージョン

GSD バージョン：1.0.0
最終更新日：2026-01-19