meta-prompting & context engineering による spec-driven 開発システム。
v1.22.4 → v1.33.0 で 32 → 68 コマンドに拡張。どのコマンドで始めるかをすぐ判断できるように整理。
| コマンド | 対象 | エージェント |
|---|---|---|
/gsd-fast | タイポ・設定変更・1文で済む修正 | なし(インライン実行) |
/gsd-quick | バグ修正・小機能(数ステップ) | Planner + Executor |
/gsd-quick --discuss | 方針も確認してから実装 | + 事前確認 |
/gsd-quick --full | 品質保証必須の小変更 | + plan-check + verifier |
add-phase — ロードマップ末尾に整数番号で追加。今の流れを壊さない。insert-phase — 途中に小数番号(例: 3.1)で差し込み。後続を renumber しない。
note — ゼロフリクションの即時メモ(フォーマットなし、質問なし)add-todo — 構造化された todo(エリア推定・重複検出あり)
| コマンド | 用途 | 主な引数・フラグ |
|---|---|---|
/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] |
| コマンド | 用途 | 主な引数 |
|---|---|---|
/gsd-add-phase | ロードマップ末尾にフェーズ追加 | <description> |
/gsd-insert-phase | 途中に urgent work を小数番号で差し込み | <after> <description> |
/gsd-remove-phase | 未開始フェーズを削除 + リナンバー | <N> |
/gsd-list-phase-assumptions | Claude の想定アプローチを計画前に確認 | [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-backlog | 999.x 番号でバックログにアイデア積み上げ | <description> |
/gsd-review-backlog | バックログを見直し → アクティブフェーズへ昇格 | (対話式) |
/gsd-analyze-dependencies | フェーズ間依存関係を分析して Depends on 提案 | (引数なし) |
/gsd-undo | フェーズ・プランのコミットを安全にリバート | --last N | --phase NN | --plan NN-MM |
| コマンド | 用途 | 主な引数 |
|---|---|---|
/gsd-code-review NEW | フェーズ変更ファイルをバグ・セキュリティ・品質の観点でレビュー → REVIEW.md | <N> [--depth=quick|standard|deep] [--files f1,f2] |
/gsd-code-review-fix NEW | REVIEW.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] |
| コマンド | 用途 |
|---|---|
/gsd-progress | 現在位置と次のアクションを表示 → 自動ルーティング |
/gsd-resume-work | 前回セッションからフルコンテキスト復元 |
/gsd-pause-work | 中断ハンドオフ(.continue-here.md 作成) |
/gsd-next NEW | STATE.md / ROADMAP.md を読んで次の論理ステップへ自動進行 |
/gsd-session-report NEW | セッションレポート(トークン使用推定・成果)を SESSION_REPORT.md に生成 |
| コマンド | 用途 | 主な引数 |
|---|---|---|
/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 コマンドへ自動ディスパッチ | <自由記述> |
| コマンド | 用途 | 主な引数 |
|---|---|---|
/gsd-manager NEW | 1ターミナルでマイルストーン全フェーズを管理するダッシュボード。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 メトリクス)表示 | (引数なし) |
| コマンド | 用途 | 主な引数 |
|---|---|---|
/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 NEW | map-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-update | GSD を最新版に更新(changelog 表示) | — |
/gsd-reapply-patches | アップデート後にローカル変更を再適用 | — |
/gsd-help | コマンドリファレンス表示 | — |
/gsd-join-discord | Discord コミュニティへの招待リンク | — |
┌──────────────────────────────────────────────────────────────────┐
│ 既存コードがある場合 │
│ /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 ← 次の論理ステップへ自動進行
/gsd-plan-phase N
├── Phase Researcher (×4 並列)
│ ├── Stack / Features
│ ├── Architecture / Pitfalls
│ └── → RESEARCH.md
├── Planner
│ └── → PLAN.md (XML 構造)
└── Plan Checker (最大 3 回ループ)
└── PASS → 完了 / FAIL → 修正
/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% に留まる。
/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
/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 --full | plan-check + verification 付きで安全 |
新しい sync サブコマンドを追加 | /gsd-add-phase | 独立した機能のまとまり |
| 設定ファイル構造を作り直してから後続に進みたい | /gsd-insert-phase [N] | 後続フェーズの前提となる urgent work |
| 実装後にセキュリティ問題が怖い | /gsd-code-review N → code-review-fix N | 脆弱性・品質問題を自動検出・修正 |
| PR にコードレビューだけ入れたい(.planning/ は除外) | /gsd-pr-branch | planning コミットを除いたクリーンブランチ |
| 外部 AI にプランをレビューしてもらいたい | /gsd-review --phase N --all | Gemini / Claude / Codex にクロスレビュー |
| そのうち欲しい機能アイデアをサッとメモ | /gsd-note <text> | 質問なし・即時保存 |
| アイデアを具体化して将来のマイルストーンで思い出したい | /gsd-plant-seed | new-milestone 時に自動浮上する構造化アイデア |
| アイデアを深堀りして todo / phase にしたい | /gsd-explore [topic] | ソクラテス式探索 → GSD アーティファクトへ |
| 何をすべきか分からない(自然言語で伝えたい) | /gsd-do <自由記述> | GSD コマンドへ自動ディスパッチ |
| 次のステップを自動決定させたい | /gsd-next | STATE.md 読み取り → 次の論理ステップへ |
| 残り全フェーズを自動実行したい | /gsd-autonomous | discuss→plan→execute を全フェーズ自律実行 |
| ワークフローが止まって何が起きたか不明 | /gsd-forensics | git 履歴・STATE.md 分析でポストモーテム |
| 原因不明のバグが発生 | /gsd-debug | 科学的手法 + サブエージェントで調査 |
| フェーズの方向性が合っているか確認したい | /gsd-list-phase-assumptions | 計画前に Claude の想定を可視化 |
| 実装後にテストを追加したい | /gsd-add-tests | 完了フェーズから unit + E2E テスト生成 |
| フロントエンドの UI 実装品質を確認したい | /gsd-ui-review N | 6 柱で視覚的監査 → スコア付き UI-REVIEW.md |
| 既存プロジェクトで初めて GSD を使う | /gsd-map-codebase → /gsd-new-project | 先にコードベースを分析してからプロジェクト初期化 |
| 実装後に少し変えたい箇所が見つかった | /gsd-quick or /gsd-verify-work | execute-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/
| 設定 | 選択肢 | デフォルト |
|---|---|---|
mode | interactive / yolo | interactive |
granularity | coarse / standard / fine | standard |
model_profile | quality / balanced / budget | balanced |
| 設定 | デフォルト | 効果 |
|---|---|---|
workflow.research | true | 計画前のドメイン調査 |
workflow.plan_check | true | プラン検証ループ(最大3回) |
workflow.verifier | true | 実行後のゴール検証 |
workflow.nyquist_validation | true | テストカバレッジ検証 |
workflow.code_review_depth | standard | コードレビューの深さ |
| エージェント | quality | balanced | budget |
|---|---|---|---|
| Planner | Opus | Opus | Sonnet |
| Roadmapper | Opus | Sonnet | Sonnet |
| Executor | Opus | Sonnet | Sonnet |
| Phase Researcher | Opus | Sonnet | Haiku |
| Debugger | Opus | Sonnet | Sonnet |
| Codebase Mapper | Sonnet | Haiku | Haiku |
| Verifier / Checker | Sonnet | Sonnet | Haiku |
| シナリオ | Mode | 粒度 | Profile |
|---|---|---|---|
| プロトタイピング | yolo | coarse | budget |
| 通常開発 | interactive | standard | balanced |
| プロダクション | interactive | fine | quality |
| 戦略 | 説明 |
|---|---|
none | 現在のブランチに直接コミット(デフォルト) |
phase | フェーズごとにブランチ作成・マージ |
milestone | マイルストーン単位で 1 ブランチ |
.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 へ渡すべき一文の例
最新の 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 の前置きや説明文は不要
/gsd-fast は 1 文で終わる超小変更専用。リサーチや複数ステップが必要なら /gsd-quick を使う。/clear してから /gsd-resume-work。commit_docs: false + .gitignore に追加。/gsd-autonomous は grey area 承認・バリデーション失敗時のみ停止する。完全自動で進めたくない場合は /gsd-manager で手動制御。| 問題 | 対処 |
|---|---|
| 新セッション / コンテキスト喪失 | /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