GSD / Get Shit Done v1.33.0 • Single HTML Cheat Sheet

GSD コマンド チートシート

meta-prompting & context engineering による spec-driven 開発システム。
v1.22.4 → v1.33.0 で 32 → 68 コマンドに拡張。どのコマンドで始めるかをすぐ判断できるように整理。

まずはこれで判定

今すぐ実装しない/gsd-add-todo or /gsd-note
アイデアを探索・深堀りしたい/gsd-explore
1行で終わる超小変更/gsd-fast
今やる小変更/gsd-quick
小さいが先に少し仕様確認したい/gsd-quick --discuss
小さいが品質保証もほしい/gsd-quick --full
独立した新機能を末尾に追加/gsd-add-phase
既存計画の途中に urgent work を差し込む/gsd-insert-phase [N]
phase の方針が曖昧/gsd-discuss-phase [N]/gsd-plan-phase [N]
コードレビューして修正まで/gsd-code-review N/gsd-code-review-fix N
何かが壊れた/gsd-debug [desc]
ワークフローが失敗・迷子になった/gsd-forensics
やること不明・次を自動判定させたい/gsd-next or /gsd-do [text]

fast / quick / full の使い分け

コマンド対象エージェント
/gsd-fastタイポ・設定変更・1文で済む修正なし(インライン実行)
/gsd-quickバグ修正・小機能(数ステップ)Planner + Executor
/gsd-quick --discuss方針も確認してから実装+ 事前確認
/gsd-quick --full品質保証必須の小変更+ plan-check + verifier
add-phase vs insert-phase:
add-phase — ロードマップ末尾に整数番号で追加。今の流れを壊さない。
insert-phase — 途中に小数番号(例: 3.1)で差し込み。後続を renumber しない。
note vs add-todo の違い:
note — ゼロフリクションの即時メモ(フォーマットなし、質問なし)
add-todo — 構造化された todo(エリア推定・重複検出あり)

コアワークフロー

CORE
コマンド用途主な引数・フラグ
/gsd-new-projectプロジェクト初期化: 質問 → リサーチ → 要件 → ロードマップ[--auto] ドキュメントから自動生成
/gsd-discuss-phase実装方針・前提を固定する(CONTEXT.md 作成)<N> [--auto] [--chain] [--batch] [--power]
/gsd-plan-phaseリサーチ + プラン作成 + 検証ループ[N] [--auto] [--skip-research] [--skip-verify] [--prd <file>] [--reviews] [--gaps]
/gsd-execute-phase全プランをウェーブ並列実行 → atomic commit<N> [--wave N] [--gaps-only] [--interactive]
/gsd-verify-work手動 UAT(受け入れテスト)+ 自動診断[N]
/gsd-audit-milestoneマイルストーン完了前の達成度監査[version]
/gsd-complete-milestoneマイルストーンをアーカイブ + タグ付け<version>
/gsd-new-milestone次のバージョンサイクル開始[name]

フェーズ管理

PHASE
コマンド用途主な引数
/gsd-add-phaseロードマップ末尾にフェーズ追加<description>
/gsd-insert-phase途中に urgent work を小数番号で差し込み<after> <description>
/gsd-remove-phase未開始フェーズを削除 + リナンバー<N>
/gsd-list-phase-assumptionsClaude の想定アプローチを計画前に確認[N]
/gsd-research-phaseフェーズの単体リサーチ(通常は plan-phase に含まれる)[N]
/gsd-validate-phase完了フェーズの Nyquist バリデーション監査[N]
/gsd-add-tests完了フェーズのテスト生成(unit + E2E)<phase> [instructions]
/gsd-plan-milestone-gaps監査ギャップを埋めるフェーズを一括作成(MILESTONE-AUDIT.md から自動)
/gsd-add-backlog999.x 番号でバックログにアイデア積み上げ<description>
/gsd-review-backlogバックログを見直し → アクティブフェーズへ昇格(対話式)
/gsd-analyze-dependenciesフェーズ間依存関係を分析して Depends on 提案(引数なし)
/gsd-undoフェーズ・プランのコミットを安全にリバート--last N | --phase NN | --plan NN-MM

品質・レビュー

QUALITY
コマンド用途主な引数
/gsd-code-review NEWフェーズ変更ファイルをバグ・セキュリティ・品質の観点でレビュー → REVIEW.md<N> [--depth=quick|standard|deep] [--files f1,f2]
/gsd-code-review-fix NEWREVIEW.md の指摘を自動修正 → REVIEW-FIX.md<N> [--all] [--auto]
/gsd-audit-uat全フェーズの未完了 UAT アイテムを横断監査(引数なし)
/gsd-audit-fix NEW監査 → 自動修正パイプライン(分類・修正・コミット)--source <audit> [--severity high|medium|all] [--max N] [--dry-run]
/gsd-secure-phase完了フェーズのセキュリティ脅威軽減を検証 → SECURITY.md[N]
/gsd-ui-phase NEWフロントエンドフェーズの UI デザイン契約を生成 → UI-SPEC.md[N]
/gsd-ui-review NEW実装済みフロントエンドを 6 柱で視覚的監査 → UI-REVIEW.md[N]
/gsd-docs-update NEWコードベース検証済みのプロジェクトドキュメントを生成・更新[--force] [--verify-only]
/gsd-ship NEW検証後に PR 作成・レビュー・マージ準備まで[phase or milestone]
/gsd-pr-branch NEW.planning/ コミットを除いたクリーンな PR ブランチ作成[target branch]
/gsd-review NEW外部 AI CLI(Gemini / Claude / Codex)にフェーズプランをクロスレビュー依頼--phase N [--gemini] [--claude] [--all]

セッション・ナビゲーション

SESSION
コマンド用途
/gsd-progress現在位置と次のアクションを表示 → 自動ルーティング
/gsd-resume-work前回セッションからフルコンテキスト復元
/gsd-pause-work中断ハンドオフ(.continue-here.md 作成)
/gsd-next NEWSTATE.md / ROADMAP.md を読んで次の論理ステップへ自動進行
/gsd-session-report NEWセッションレポート(トークン使用推定・成果)を SESSION_REPORT.md に生成

アイデア・コンテンツ管理

CONTENT
コマンド用途主な引数
/gsd-explore NEWソクラテス式のアイデア探索セッション → note / todo / seed / フェーズへルーティング[topic]
/gsd-note NEWゼロフリクションの即時メモ(質問なし・1 Write 1行確認)<text> | list | promote <N> [--global]
/gsd-add-todo構造化 todo をキャプチャ(エリア推定・重複検出)[description]
/gsd-check-todos保留 todo 一覧 → 選択 → アクションへルーティング[area filter]
/gsd-plant-seed NEW将来のマイルストーン起動条件付きでアイデアを保存 → new-milestone で自動浮上[idea summary]
/gsd-thread NEWセッションをまたぐ軽量コンテキストスレッド(フェーズに属さない継続作業用)[name | description]
/gsd-do NEW自由記述テキストを最適な GSD コマンドへ自動ディスパッチ<自由記述>

並列・チーム管理

PARALLEL
コマンド用途主な引数
/gsd-manager NEW1ターミナルでマイルストーン全フェーズを管理するダッシュボード。discuss はインライン、plan/execute はバックグラウンドエージェントで並列実行(引数なし)
/gsd-autonomous NEW残り全フェーズを discuss→plan→execute の流れで自律実行(ブロッカー時のみ停止)[--from N] [--to N] [--only N] [--interactive]
/gsd-workstreams NEW並列ワークストリームの管理(list / create / switch / status / complete / resume)[subcommand] [args]
/gsd-new-workspace NEW独立した .planning/ を持つ隔離ワークスペース作成(worktree / clone 戦略)--name <name> [--repos r1,r2] [--strategy worktree|clone]
/gsd-list-workspaces NEW~/gsd-workspaces/ 内のワークスペース一覧表示(引数なし)
/gsd-remove-workspace NEWワークスペースを削除(worktree 戦略は git worktree remove も実行)<name>
/gsd-profile-user NEWセッション分析または質問票から開発者行動プロファイルを生成し Claude をパーソナライズ[--questionnaire] [--refresh]
/gsd-milestone-summary NEWマイルストーン成果物からチームオンボーディング用サマリーを生成[version]
/gsd-forensics NEW失敗・停止したワークフローのポストモーテム解析(git 履歴・STATE.md 分析)[problem description]
/gsd-stats NEWプロジェクト統計(フェーズ進捗・プラン実行数・要件・git メトリクス)表示(引数なし)

ユーティリティ

UTILITY
コマンド用途主な引数
/gsd-quickアドホックタスクを GSD 保証付きで実行[--full] [--discuss] [--validate] [--research]
/gsd-fast NEW超小変更をサブエージェントなしでインライン実行(planning 不要)[task description]
/gsd-debug科学的手法によるデバッグ(サブエージェント分離)[--diagnose] [description]
/gsd-map-codebase既存コードベースを 4 並列エージェントで分析 → .planning/codebase/[area]
/gsd-scan NEWmap-codebase の軽量版(1 エージェント、単一フォーカス)[--focus tech|arch|quality|concerns|tech+arch]
/gsd-import NEW外部プランファイルを競合検出しながら GSD の PLAN.md として取り込み--from <filepath>
/gsd-intel NEW.planning/intel/ のコードベース知識ファイルをクエリ・検査・更新[query <term>|status|diff|refresh]
/gsd-settingsワークフロートグル・モデルプロファイル設定(対話式)(対話式)
/gsd-set-profileモデルプロファイル切替<quality|balanced|budget|inherit>
/gsd-health.planning/ ディレクトリ整合性チェック[--repair]
/gsd-cleanup完了マイルストーンのフェーズディレクトリをアーカイブ(対話式)
/gsd-updateGSD を最新版に更新(changelog 表示)
/gsd-reapply-patchesアップデート後にローカル変更を再適用
/gsd-helpコマンドリファレンス表示
/gsd-join-discordDiscord コミュニティへの招待リンク

ワークフロー全体像

┌──────────────────────────────────────────────────────────────────┐
│  既存コードがある場合                                              │
│  /gsd-map-codebase  or  /gsd-scan --focus tech+arch              │
└──────────────────────────────┬───────────────────────────────────┘
                               │
┌──────────────────────────────▼───────────────────────────────────┐
│  /gsd-new-project  [--auto @prd.md]                               │
│    質問 → リサーチ → 要件 → ロードマップ                           │
└──────────────────────────────┬───────────────────────────────────┘
                               │
          ┌────────────────────▼────────────────────────────┐
          │  各フェーズを繰り返す                             │
          │                                                  │
          │  /gsd-discuss-phase N  ← 方針固定(CONTEXT.md) │
          │  /gsd-plan-phase N     ← 計画 + 検証(PLAN.md) │
          │  /gsd-execute-phase N  ← 並列実行                │
          │  /gsd-code-review N    ← コードレビュー(任意)   │
          │  /gsd-verify-work N    ← 手動 UAT                │
          │  /gsd-ship N           ← PR 作成・マージ(任意)  │
          │           ↓ 次のフェーズへ ──────────────────────┘
          │           │ 全フェーズ完了
          └───────────┼────────────────────────────────────┘
                      │
          /gsd-audit-milestone      ← 達成度チェック
          /gsd-complete-milestone   ← アーカイブ + タグ
          /gsd-new-milestone        ← 次バージョンへ

  ─── 自動化ルート ───────────────────────────────────────────────
  /gsd-autonomous          ← 全フェーズを discuss→plan→execute 自動実行
  /gsd-manager             ← 1 ターミナルで複数フェーズを並列管理
  /gsd-next                ← 次の論理ステップへ自動進行

plan-phase のエージェント構成

/gsd-plan-phase N
  ├── Phase Researcher (×4 並列)
  │    ├── Stack / Features
  │    ├── Architecture / Pitfalls
  │    └── → RESEARCH.md
  ├── Planner
  │    └── → PLAN.md (XML 構造)
  └── Plan Checker (最大 3 回ループ)
       └── PASS → 完了 / FAIL → 修正

execute-phase のウェーブ実行

/gsd-execute-phase N
  ├── 依存関係分析
  ├── Wave 1 (独立プラン並列)
  │    ├── Executor A → commit
  │    └── Executor B → commit
  ├── Wave 2 (Wave 1 に依存)
  │    └── Executor C → commit
  └── Verifier
       └── PASS / FAIL → VERIFICATION.md

各 Executor は新鮮な 200K コンテキストで実行。メインウィンドウは 30-40% に留まる。

code-review ループ

/gsd-code-review N
  ├── diff から変更ファイル抽出
  ├── gsd-code-reviewer エージェント
  │    ├── quick: パターンマッチのみ
  │    ├── standard: ファイル別分析(デフォルト)
  │    └── deep: import graph + call chain 横断
  └── → REVIEW.md (Critical/Warning/Info)

/gsd-code-review-fix N [--auto]
  ├── REVIEW.md の指摘を分類
  ├── 自動修正可能 → 修正 + コミット
  └── → REVIEW-FIX.md

discuss-phase の主なフラグ

/gsd-discuss-phase N
  (フラグなし)  対話式で gray area を選んで深堀り
  --auto         Claude が推奨デフォルトを自動選択
  --chain        対話 discuss → 自動 plan → 自動 execute
  --batch        質問をまとめて一括回答(非同期向け)
  --power        全質問をファイルに出力(自分のペースで回答)

シナリオ別推奨コマンド

やりたいこと推奨コマンド理由
コメントのタイポ修正/gsd-fastサブエージェント不要の 1 行変更
help 文言の修正/gsd-quick局所修正で完結
エラーメッセージの見直し(表現方針も決めたい)/gsd-quick --discuss小さい変更だが事前の認識合わせが必要
バグ修正で品質保証もほしい/gsd-quick --fullplan-check + verification 付きで安全
新しい sync サブコマンドを追加/gsd-add-phase独立した機能のまとまり
設定ファイル構造を作り直してから後続に進みたい/gsd-insert-phase [N]後続フェーズの前提となる urgent work
実装後にセキュリティ問題が怖い/gsd-code-review Ncode-review-fix N脆弱性・品質問題を自動検出・修正
PR にコードレビューだけ入れたい(.planning/ は除外)/gsd-pr-branchplanning コミットを除いたクリーンブランチ
外部 AI にプランをレビューしてもらいたい/gsd-review --phase N --allGemini / Claude / Codex にクロスレビュー
そのうち欲しい機能アイデアをサッとメモ/gsd-note <text>質問なし・即時保存
アイデアを具体化して将来のマイルストーンで思い出したい/gsd-plant-seednew-milestone 時に自動浮上する構造化アイデア
アイデアを深堀りして todo / phase にしたい/gsd-explore [topic]ソクラテス式探索 → GSD アーティファクトへ
何をすべきか分からない(自然言語で伝えたい)/gsd-do <自由記述>GSD コマンドへ自動ディスパッチ
次のステップを自動決定させたい/gsd-nextSTATE.md 読み取り → 次の論理ステップへ
残り全フェーズを自動実行したい/gsd-autonomousdiscuss→plan→execute を全フェーズ自律実行
ワークフローが止まって何が起きたか不明/gsd-forensicsgit 履歴・STATE.md 分析でポストモーテム
原因不明のバグが発生/gsd-debug科学的手法 + サブエージェントで調査
フェーズの方向性が合っているか確認したい/gsd-list-phase-assumptions計画前に Claude の想定を可視化
実装後にテストを追加したい/gsd-add-tests完了フェーズから unit + E2E テスト生成
フロントエンドの UI 実装品質を確認したい/gsd-ui-review N6 柱で視覚的監査 → スコア付き UI-REVIEW.md
既存プロジェクトで初めて GSD を使う/gsd-map-codebase/gsd-new-project先にコードベースを分析してからプロジェクト初期化
実装後に少し変えたい箇所が見つかった/gsd-quick or /gsd-verify-workexecute-phase の再実行は避ける

典型的なセッションフロー

新規プロジェクト

claude --dangerously-skip-permissions
/gsd-new-project
/clear
/gsd-discuss-phase 1
/gsd-plan-phase 1
/gsd-execute-phase 1
/gsd-code-review 1
/gsd-verify-work 1
/clear
/gsd-discuss-phase 2
...

完全自律実行

/gsd-new-project --auto @prd.md
/clear
/gsd-autonomous
# ブロッカーがある場合のみ停止
/gsd-complete-milestone v1.0

セッション再開

/gsd-progress        # 状況確認
# または
/gsd-resume-work     # フルコンテキスト復元
# または
/gsd-next            # 次ステップへ自動進行

品質ループ(フェーズ完了後)

/gsd-code-review N           # レビュー
/gsd-code-review-fix N --auto # 自動修正
/gsd-verify-work N           # UAT
/gsd-ship N                  # PR 作成

複数フェーズ並列管理

/gsd-manager
# ダッシュボードで全フェーズ確認
# discuss → バックグラウンドで plan/execute
# 複数フェーズを1ターミナルで管理

ワークスペース分離

/gsd-new-workspace --name feature-x \
  --strategy worktree
/gsd-list-workspaces
# 隔離環境で独立した .planning/

設定リファレンス(.planning/config.json)

コア設定

設定選択肢デフォルト
modeinteractive / yolointeractive
granularitycoarse / standard / finestandard
model_profilequality / balanced / budgetbalanced

ワークフロートグル

設定デフォルト効果
workflow.researchtrue計画前のドメイン調査
workflow.plan_checktrueプラン検証ループ(最大3回)
workflow.verifiertrue実行後のゴール検証
workflow.nyquist_validationtrueテストカバレッジ検証
workflow.code_review_depthstandardコードレビューの深さ

モデルプロファイル詳細

エージェントqualitybalancedbudget
PlannerOpusOpusSonnet
RoadmapperOpusSonnetSonnet
ExecutorOpusSonnetSonnet
Phase ResearcherOpusSonnetHaiku
DebuggerOpusSonnetSonnet
Codebase MapperSonnetHaikuHaiku
Verifier / CheckerSonnetSonnetHaiku

速度 vs 品質プリセット

シナリオMode粒度Profile
プロトタイピングyolocoarsebudget
通常開発interactivestandardbalanced
プロダクションinteractivefinequality

Git ブランチ戦略

戦略説明
none現在のブランチに直接コミット(デフォルト)
phaseフェーズごとにブランチ作成・マージ
milestoneマイルストーン単位で 1 ブランチ

.planning/ ディレクトリ構造(v1.33.0)

.planning/
  PROJECT.md              # プロジェクトビジョン(常時ロード)
  REQUIREMENTS.md         # スコープ付き v1/v2 要件(ID 付き)
  ROADMAP.md              # フェーズ一覧 + ステータス(999.x = バックログ)
  STATE.md                # 決定・ブロッカー・セッションメモリ
  config.json             # ワークフロー設定
  MILESTONES.md           # 完了マイルストーンのアーカイブ
  research/               # /gsd-new-project のドメインリサーチ
  todos/
    pending/              # キャプチャ済みアイデア
    done/                 # 完了した todo
  notes/                  # /gsd-note のゼロフリクションメモ  ← NEW
  seeds/                  # /gsd-plant-seed の将来アイデア    ← NEW
  threads/                # /gsd-thread のクロスセッションスレッド ← NEW
  debug/
    active/               # アクティブなデバッグセッション
    resolved/             # 解決済みデバッグセッション
  forensics/              # /gsd-forensics のポストモーテムレポート ← NEW
  intel/                  # /gsd-intel のコードベース知識ファイル ← NEW
  reports/                # /gsd-session-report / milestone-summary ← NEW
  codebase/               # /gsd-map-codebase / scan の出力
    STACK.md / ARCHITECTURE.md / CONVENTIONS.md / CONCERNS.md
  phases/
    XX-phase-name/
      XX-YY-PLAN.md       # 実行用アトミックプラン(XML 構造)
      XX-YY-SUMMARY.md    # 実行結果と決定事項
      XX-CONTEXT.md       # 実装方針(discuss-phase の出力)
      XX-RESEARCH.md      # エコシステムリサーチ結果
      XX-VERIFICATION.md  # 実行後の検証結果
      XX-VALIDATION.md    # Nyquist テストカバレッジ契約
      XX-UAT.md           # 手動 UAT 結果
      XX-REVIEW.md        # コードレビュー結果           ← NEW
      XX-REVIEW-FIX.md    # コードレビュー自動修正結果   ← NEW
      XX-SECURITY.md      # セキュリティ検証結果
      XX-UI-SPEC.md        # UI デザイン契約             ← NEW
      XX-UI-REVIEW.md     # UI 視覚的監査結果            ← NEW
  milestones/
    v1.0-phases/          # アーカイブ済みフェーズ(/gsd-cleanup 後)

判定プロンプト

この変更に対して、GSD のどのコマンドで始めるべきか判定してください。
候補: fast / quick / quick --discuss / quick --full / add-phase / insert-phase /
      add-todo / note / explore / discuss-phase / code-review / debug / forensics /
      do / next / autonomous

判断基準:
- 1文で済む超小変更か(fast)
- 局所修正か(quick)
- 実装前に軽い仕様確認が必要か(--discuss)
- 品質保証(plan-check / verification)が必要か(--full)
- 独立した新機能か(add-phase)
- 既存ロードマップの途中に差し込む必要があるか(insert-phase)
- 今すぐ実装するか、後で検討するだけか(add-todo / note)
- アイデアを探索・深堀りしたいか(explore)
- コードレビューが必要か(code-review)
- 何かが壊れているか(debug)
- ワークフローが止まっているか(forensics)
- 何をすればいいか分からないか(do / next)

前提:
- プロダクトはすでに完成または運用段階にある
- 既存コードベースを前提に拡張・修正したい

変更内容:
[ここにやりたいことを書く]

出力形式:
- 推奨コマンド
- 理由
- 代替コマンドを使うならどういう場合か
- 最初に AI へ渡すべき一文の例

HTML 再生成プロンプト

最新の GSD 公式ドキュメントと最新リリースを参照して、single HTML のチートシートを 1 ファイルで生成してください。

要件:
- 出力は self-contained な single HTML
- 外部 CSS / JS / フォントに依存しない
- 日本語で記述
- ダーク / ライトの両方で読みやすい(CSS 変数 --bg ベースで統一)
- 以下を必ず含める:
  1. GSD の全コマンド早見表(コア / フェーズ管理 / 品質レビュー / セッション /
     アイデア管理 / 並列チーム管理 / ユーティリティ)
  2. fast / quick / quick --discuss / quick --full の使い分け
  3. add-phase と insert-phase の違い
  4. note vs add-todo の違い
  5. execute-phase を再実行せず quick / verify-work を使うべき注意点
  6. ワークフロー全体像とエージェント構成図(autonomous / ship ルートも含む)
  7. 設定リファレンス(config.json / モデルプロファイル / Git ブランチ戦略)
  8. シナリオ別推奨コマンド実例
  9. .planning/ ディレクトリ構造(seeds / threads / notes / intel / forensics 含む)
  10. コピーボタン付きの判定プロンプト
  11. 出典セクション
- 表とカード UI を使って見やすくする
- 印刷しても読めるようにする
- NEW バッジで新コマンドをハイライト

情報源の優先順位:
1. gsd-build/get-shit-done の README
2. docs/USER-GUIDE.md
3. 最新 release notes
4. commands/gsd/*.md の各コマンド定義(68 コマンド)

ファクト要件:
- fast(サブエージェントなし)と quick(Planner + Executor)の違いを明記
- autonomous / manager / workstreams など並列管理コマンドを含める
- code-review / code-review-fix / audit-fix の品質ループを含める
- ship / pr-branch でのリリースフローを含める
- note / plant-seed / explore / thread のアイデア管理体系を含める

出力形式:
- まず HTML 本文のみを返す
- markdown の前置きや説明文は不要

注意点

execute-phase をやり直さない。 実装後に少し変えたいなら /gsd-quick、体系的に問題を洗いたいなら /gsd-verify-work を使う。

リカバリー早見表

問題対処
新セッション / コンテキスト喪失/gsd-resume-work or /gsd-progress or /gsd-next
ワークフローが止まって原因不明/gsd-forensics
フェーズの実装がおかしい/gsd-undo --phase N → re-plan
スコープ変更が必要/gsd-add-phase / insert-phase / remove-phase
マイルストーン監査でギャップ/gsd-plan-milestone-gaps
何かが壊れた/gsd-debug "description"
コードにセキュリティ懸念/gsd-code-review N --depth=deep
素早い修正/gsd-quick または /gsd-fast(超小変更)
コストが高い/gsd-set-profile budget + エージェントをオフ
アップデートでローカル変更消失/gsd-reapply-patches
.planning/ が壊れた/gsd-health --repair

出典

Generated from submodule at v1.33.0 • Single HTML / offline friendly / editable • 前バージョン: gsd-cheatsheet-1.22.4.html