Files

Tom Boucher 3aaed8f5d7 test: replace deny-list parity tests with polarity-inverted live-registry (#3049 ) (#3284 )

* test: reproduce Windows SDK not found after fresh npx install (#3211)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test: red — docs-parity live-registry tests fail against stub helper (#3049)

Adds:
- tests/helpers/live-command-registry.cjs (stub: returns empty Set)
- tests/docs-parity-live-registry.test.cjs (new polarity-inverted test)
- tests/fixtures/live-command-registry/ (fixture .md files)

All parity and helper-contract tests fail because the stub returns an
empty registry. This is the intentional RED state before GREEN
implementation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(test-helpers): live-command-registry derives canonical tokens from commands/gsd/*.md (#3049)

Implements GREEN phase:
- tests/helpers/live-command-registry.cjs: walks commands/gsd/*.md, parses
  YAML frontmatter name: field, emits /gsd-slug, /gsd:slug, $gsd-slug per
  command. Memoized per process. Fails loud on malformed frontmatter (k302).
- tests/docs-parity-live-registry.test.cjs: updated with INTERNAL_COMPONENT_SLUGS
  exemption for path-component and placeholder tokens (gsd-build from GitHub
  org URLs, gsd-workspaces from ~/gsd-workspaces/ paths, gsd-tools from
  bin/gsd-tools.cjs paths, etc.)

Docs drift caught and fixed:
- ns-* rename: /gsd-ns-workflow→/gsd-workflow etc. in COMMANDS, FEATURES,
  INVENTORY, USER-GUIDE (6 commands across 4 English files)
- /gsd-scan → /gsd-map-codebase --fast (FEATURES, INVENTORY, USER-GUIDE)
- /gsd-note → /gsd-capture (FEATURES, issue-driven-orchestration, ja-JP, ko-KR)
- /gsd-do → /gsd-fast (FEATURES, ja-JP, ko-KR)
- /gsd-from-gsd2 → /gsd-import --from-gsd2 (CLI-TOOLS, FEATURES, INVENTORY)
- /gsd-verify-phase → /gsd-validate-phase (STATE-MD-LIFECYCLE)
- /gsd-settings-integrations → /gsd-settings or /gsd-config --integrations (CLI-TOOLS)
- /gsd-dev-preferences removed from profile-user artifact lists (AGENTS, COMMANDS,
  FEATURES in English, ja-JP, ko-KR)
- /gsd-select-framework removed from gsd-framework-selector spawner list
  (AGENTS, INVENTORY)

All 28 new tests pass.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* refactor(test): replace deny-list parity tests with polarity-inverted live-registry approach (#3049)

- Delete bug-3010-reapply-patches-references.test.cjs (hardcoded deny-list)
- Delete bug-3029-3034-stale-command-routes.test.cjs (hardcoded deny-list)
- Delete bug-3042-3044-research-flag-and-stale-refs.test.cjs (deny-list + frontmatter checks)
- Add tests/skill-frontmatter-contract.test.cjs (frontmatter structural checks extracted from deleted file)
- Update tests/commands-doc-parity.test.cjs to derive slug from name: frontmatter field
  instead of filename, so ns-* commands resolve to their actual deployed tokens

Closes #3049

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test: annotate commands-doc-parity with source-text-is-the-product exemption (#3049 lint fix)

The readFileSync on commands/gsd/*.md reads product markdown whose deployed
text IS what the user sees — content.startsWith('---') detects YAML frontmatter
in those files, not source-code structure. Add the allow-test-rule exemption
matching the same rationale used in docs-parity-live-registry.test.cjs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test: walk docs/** recursively to cover nested locale trees (CR finding 7)

Replaced the non-recursive listMdFiles() with a hand-rolled DFS walker
compatible with Node 20+. Surfaces unreadable-directory errors as stderr
warnings (PRED.k302) rather than silently skipping.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test: annotate live-command-registry helper and commands-doc-parity with source-text exemptions (CR findings 6, 8)

Adds allow-test-rule comments to suppress lint-no-source-grep false
positives on YAML frontmatter structure checks in both files.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test: anchor --research-phase assertions to arg-parsing section and verify combined refresh (CR findings 9, 10)

Finding 9: scopes --research-phase check to within 1200 chars of the flag
description section header, preventing false positives from prose mentions.

Finding 10: tightens the force-refresh assertion to require BOTH --research
and force/refresh semantics within the --research-phase description section,
verifying the combined-mode contract rather than standalone --research presence.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* test: fix execSync mock to accept opts parameter, forward to saved implementation (CR finding 5)

The mock at line 212 dropped the options parameter when delegating to
savedExecSync. Updated to (cmd, opts) signature and pass opts through.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs: correct routing entrypoint, --fast default, /gsd-review collision, verifying-stage mapping (CR findings 1-4)

Finding 1: Change Freeform Routing command from /gsd-fast to /gsd-progress --do.
/gsd-fast is the inline trivial-task executor, not the routing entrypoint.

Finding 2: Clarify that /gsd-map-codebase --fast REQ-SCAN-02 default (tech+arch)
runs as a single combined-focus agent, resolving the contradiction with REQ-SCAN-01.

Finding 3: Rename the namespace router /gsd-review to /gsd-quality across all docs,
command file, and help.md to eliminate the naming collision with the concrete
cross-AI peer-review command (review.md, name: gsd:review).

Finding 4: Replace /gsd-validate-phase with /gsd-verify-work in the STATE-MD-LIFECYCLE.md
verifying-stage table. /gsd-validate-phase is the retroactive Nyquist-validation
flow, not the normal phase-verification step.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs+test: fix locale doc drift surfaced by recursive walker (CR finding 7 follow-up)

The recursive listMdFiles() walker newly covered docs/**/*.md subdirs.
Stale command references in locale docs are now caught and fixed:

- docs/zh-CN/references/model-profiles.md: remove /gsd-set-profile (deleted command);
  config.json is the current mechanism
- docs/zh-CN/references/ui-brand.md: remove /gsd-alternative-1/2 template placeholders
- docs/{ja-JP,ko-KR,pt-BR}/superpowers/specs/2026-03-20-*: replace
  /gsd-new-workspace, /gsd-list-workspaces, /gsd-remove-workspace with
  /gsd-workspace --new / --list / --remove (consolidated in #2790)

Also adds smoke- and alternative-{1,2} to INTERNAL_COMPONENT_SLUGS (filesystem
path and template placeholder patterns, not slash commands) and introduces
listEnglishMdFiles() to scope the English parity check to docs/ excluding
locale subdirectories (which have their own per-locale describe blocks).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* docs: add bash language tag to fenced code blocks in ja-JP and ko-KR workspace specs (CR round 2)

Satisfies MD040 fenced-code-language requirement. These blocks contain
shell commands and were missing the language specifier.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-09 02:49:19 -04:00

32 KiB

Raw Blame History

GSD コマンドリファレンス

コマンド構文、フラグ、オプション、使用例の完全なリファレンスです。機能の詳細については機能リファレンスを、ワークフローのチュートリアルについてはユーザーガイドをご覧ください。

コマンド構文

Claude Code / Gemini / Copilot: /gsd-command-name [args]
OpenCode / Kilo: /gsd-command-name [args]
Codex: $gsd-command-name [args]

コアワークフローコマンド

`/gsd-new-project`

詳細なコンテキスト収集を行い、新しいプロジェクトを初期化します。

フラグ	説明
`--auto @file.md`	ドキュメントから自動抽出し、対話的な質問をスキップ

前提条件: 既存の .planning/PROJECT.md がないこと 生成物: PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md、config.json、research/、CLAUDE.md

/gsd-new-project                    # 対話モード
/gsd-new-project --auto @prd.md     # PRDから自動抽出

`/gsd-workspace --new`

リポジトリのコピーと独立した .planning/ ディレクトリを持つ分離されたワークスペースを作成します。

フラグ	説明
`--name <name>`	ワークスペース名（必須）
`--repos repo1,repo2`	カンマ区切りのリポジトリパスまたは名前
`--path /target`	対象ディレクトリ（デフォルト: `~/gsd-workspaces/<name>`）
`--strategy worktree\|clone`	コピー戦略（デフォルト: `worktree`）
`--branch <name>`	チェックアウトするブランチ（デフォルト: `workspace/<name>`）
`--auto`	対話的な質問をスキップ

ユースケース:

マルチリポ: リポジトリのサブセットを分離されたGSD状態で作業
機能の分離: --repos . で現在のリポジトリのworktreeを作成

生成物: WORKSPACE.md、.planning/、リポジトリコピー（worktreeまたはclone）

/gsd-workspace --new --name feature-b --repos hr-ui,ZeymoAPI
/gsd-workspace --new --name feature-b --repos . --strategy worktree  # 同一リポジトリの分離
/gsd-workspace --new --name spike --repos api,web --strategy clone   # フルクローン

`/gsd-workspace --list`

アクティブなGSDワークスペースとそのステータスを一覧表示します。

スキャン対象: ~/gsd-workspaces/ 内の WORKSPACE.md マニフェスト 表示内容: 名前、リポジトリ数、戦略、GSDプロジェクトのステータス

/gsd-workspace --list

`/gsd-workspace --remove`

ワークスペースを削除し、git worktreeをクリーンアップします。

引数	必須	説明
`<name>`	はい	削除するワークスペース名

安全性: コミットされていない変更があるリポジトリの削除を拒否します。名前の確認が必要です。

/gsd-workspace --remove feature-b

`/gsd-discuss-phase`

計画の前に実装に関する意思決定を記録します。

引数	必須	説明
`N`	いいえ	フェーズ番号（デフォルトは現在のフェーズ）

フラグ	説明
`--auto`	すべての質問で推奨デフォルトを自動選択
`--batch`	質問を一つずつではなくバッチ取り込みでグループ化
`--analyze`	ディスカッション中にトレードオフ分析を追加
`--chain`	discuss → plan → execute を1つのフローで自動チェーン (v1.31)
`--power`	準備済み回答ファイルから一括入力で質問に回答 (v1.32)

前提条件: .planning/ROADMAP.md が存在すること 生成物: {phase}-CONTEXT.md、{phase}-DISCUSSION-LOG.md（監査証跡）

/gsd-discuss-phase 1                # フェーズ1の対話的ディスカッション
/gsd-discuss-phase 3 --auto         # フェーズ3でデフォルトを自動選択
/gsd-discuss-phase --batch          # 現在のフェーズのバッチモード
/gsd-discuss-phase 2 --analyze      # トレードオフ分析付きディスカッション

`/gsd-ui-phase`

フロントエンドフェーズのUIデザイン契約書を生成します。

引数	必須	説明
`N`	いいえ	フェーズ番号（デフォルトは現在のフェーズ）

前提条件: .planning/ROADMAP.md が存在し、フェーズにフロントエンド/UI作業があること 生成物: {phase}-UI-SPEC.md

/gsd-ui-phase 2                     # フェーズ2のデザイン契約書

`/gsd-plan-phase`

フェーズの調査、計画、検証を行います。

引数	必須	説明
`N`	いいえ	フェーズ番号（デフォルトは次の未計画フェーズ）

フラグ	説明
`--auto`	対話的な確認をスキップ
`--research`	RESEARCH.mdが存在しても強制的に再調査
`--skip-research`	ドメイン調査ステップをスキップ
`--gaps`	ギャップ解消モード（VERIFICATION.mdを読み込み、調査をスキップ）
`--skip-verify`	プランチェッカーの検証ループをスキップ
`--prd <file>`	discuss-phaseの代わりにPRDファイルをコンテキストとして使用
`--reviews`	REVIEWS.mdのクロスAIレビューフィードバックで再計画

前提条件: .planning/ROADMAP.md が存在すること 生成物: {phase}-RESEARCH.md、{phase}-{N}-PLAN.md、{phase}-VALIDATION.md

/gsd-plan-phase 1                   # フェーズ1の調査＋計画＋検証
/gsd-plan-phase 3 --skip-research   # 調査なしで計画（馴染みのあるドメイン）
/gsd-plan-phase --auto              # 非対話型の計画

`/gsd-execute-phase`

フェーズ内のすべてのプランをウェーブベースの並列化で実行するか、特定のウェーブを実行します。

引数	必須	説明
`N`	はい	実行するフェーズ番号
`--wave N`	いいえ	フェーズ内のウェーブ `N` のみを実行

前提条件: フェーズにPLAN.mdファイルがあること 生成物: プランごとの {phase}-{N}-SUMMARY.md、gitコミット、フェーズ完了時に {phase}-VERIFICATION.md

/gsd-execute-phase 1                # フェーズ1を実行
/gsd-execute-phase 1 --wave 2       # ウェーブ2のみを実行

`/gsd-verify-work`

自動診断付きのユーザー受入テスト。

引数	必須	説明
`N`	いいえ	フェーズ番号（デフォルトは最後に実行されたフェーズ）

前提条件: フェーズが実行済みであること 生成物: {phase}-UAT.md、問題が見つかった場合は修正プラン

/gsd-verify-work 1                  # フェーズ1のUAT

`/gsd-progress --next`

次の論理的なワークフローステップに自動的に進みます。プロジェクトの状態を読み取り、適切なコマンドを実行します。

前提条件: .planning/ ディレクトリが存在すること 動作:

プロジェクトなし → /gsd-new-project を提案
フェーズにディスカッションが必要 → /gsd-discuss-phase を実行
フェーズに計画が必要 → /gsd-plan-phase を実行
フェーズに実行が必要 → /gsd-execute-phase を実行
フェーズに検証が必要 → /gsd-verify-work を実行
全フェーズ完了 → /gsd-complete-milestone を提案

/gsd-progress --next                           # 次のステップを自動検出して実行

`/gsd-pause-work --report`

作業サマリー、成果、推定リソース使用量を含むセッションレポートを生成します。

前提条件: 直近の作業があるアクティブなプロジェクト 生成物: .planning/reports/SESSION_REPORT.md

/gsd-pause-work --report                 # セッション後のサマリーを生成

レポートに含まれる内容:

実施した作業（コミット、実行したプラン、進行したフェーズ）
成果と成果物
ブロッカーと意思決定
推定トークン/コスト使用量
次のステップの推奨事項

`/gsd-ship`

完了したフェーズの作業から自動生成された本文でPRを作成します。

引数	必須	説明
`N`	いいえ	フェーズ番号またはマイルストーンバージョン（例: `4` または `v1.0`）
`--draft`	いいえ	ドラフトPRとして作成

前提条件: フェーズが検証済み（/gsd-verify-work が合格）、gh CLIがインストールされ認証済みであること 生成物: 計画アーティファクトからリッチな本文を持つGitHub PR、STATE.mdの更新

/gsd-ship 4                         # フェーズ4をシップ
/gsd-ship 4 --draft                 # ドラフトPRとしてシップ

PR本文に含まれる内容:

ROADMAP.mdからのフェーズ目標
SUMMARY.mdファイルからの変更サマリー
対応した要件（REQ-ID）
検証ステータス
主要な意思決定

`/gsd-ui-review`

実装済みフロントエンドの事後的な6軸ビジュアル監査。

引数	必須	説明
`N`	いいえ	フェーズ番号（デフォルトは最後に実行されたフェーズ）

前提条件: プロジェクトにフロントエンドコードがあること（単体で動作、GSDプロジェクト不要） 生成物: {phase}-UI-REVIEW.md、.planning/ui-reviews/ 内のスクリーンショット

/gsd-ui-review                      # 現在のフェーズを監査
/gsd-ui-review 3                    # フェーズ3を監査

`/gsd-audit-uat`

全フェーズを横断した未処理のUATおよび検証項目の監査。

前提条件: 少なくとも1つのフェーズがUATまたは検証付きで実行されていること 生成物: カテゴリ分類された監査レポートと人間用テストプラン

/gsd-audit-uat

`/gsd-audit-milestone`

マイルストーンが完了定義を満たしたかを検証します。

前提条件: 全フェーズが実行済みであること 生成物: ギャップ分析付き監査レポート

/gsd-audit-milestone

`/gsd-complete-milestone`

マイルストーンをアーカイブし、リリースをタグ付けします。

前提条件: マイルストーン監査が完了していること（推奨） 生成物: MILESTONES.md エントリ、gitタグ

/gsd-complete-milestone

`/gsd-milestone-summary`

チームのオンボーディングやレビューのために、マイルストーンのアーティファクトから包括的なプロジェクトサマリーを生成します。

引数	必須	説明
`version`	いいえ	マイルストーンバージョン（デフォルトは現在/最新のマイルストーン）

前提条件: 少なくとも1つの完了済みまたは進行中のマイルストーンがあること 生成物: .planning/reports/MILESTONE_SUMMARY-v{version}.md

サマリーに含まれる内容:

概要、アーキテクチャの意思決定、フェーズごとの詳細分析
主要な意思決定とトレードオフ
要件カバレッジ
技術的負債と先送り項目
新しいチームメンバー向けのスタートガイド
生成後に対話的なQ&Aを提供

/gsd-milestone-summary                # 現在のマイルストーンをサマリー
/gsd-milestone-summary v1.0           # 特定のマイルストーンをサマリー

`/gsd-new-milestone`

次のバージョンサイクルを開始します。

引数	必須	説明
`name`	いいえ	マイルストーン名
`--reset-phase-numbers`	いいえ	新しいマイルストーンをフェーズ1から開始し、ロードマップ作成前に古いフェーズディレクトリをアーカイブ

前提条件: 前のマイルストーンが完了していること 生成物: 更新された PROJECT.md、新しい REQUIREMENTS.md、新しい ROADMAP.md

/gsd-new-milestone                  # 対話モード
/gsd-new-milestone "v2.0 Mobile"    # 名前付きマイルストーン
/gsd-new-milestone --reset-phase-numbers "v2.0 Mobile"  # マイルストーン番号を1からリスタート

フェーズ管理コマンド

`/gsd-phase`

ロードマップに新しいフェーズを追加します。

/gsd-phase                      # 対話型 — フェーズの説明を入力

`/gsd-phase --insert`

小数番号を使用して、フェーズ間に緊急の作業を挿入します。

引数	必須	説明
`N`	いいえ	このフェーズ番号の後に挿入

/gsd-phase --insert 3                 # フェーズ3と4の間に挿入 → 3.1を作成

`/gsd-phase --remove`

将来のフェーズを削除し、後続のフェーズの番号を振り直します。

引数	必須	説明
`N`	いいえ	削除するフェーズ番号

/gsd-phase --remove 7                 # フェーズ7を削除、8→7、9→8等に番号振り直し

`/gsd-discuss-phase --assumptions`

計画前にClaudeの意図するアプローチをプレビューします。

引数	必須	説明
`N`	いいえ	フェーズ番号

/gsd-discuss-phase --assumptions 2       # フェーズ2の前提を確認

`/gsd-plan-phase --research-phase`

詳細なエコシステム調査のみを実行します（単体機能 — 通常は /gsd-plan-phase を使用してください）。

引数	必須	説明
`N`	いいえ	フェーズ番号

/gsd-plan-phase --research-phase 4               # フェーズ4のドメインを調査

`/gsd-validate-phase`

遡及的にNyquistバリデーションのギャップを監査・補填します。

引数	必須	説明
`N`	いいえ	フェーズ番号

/gsd-validate-phase 2               # フェーズ2のテストカバレッジを監査

ナビゲーションコマンド

`/gsd-progress`

ステータスと次のステップを表示します。

/gsd-progress                       # "今どこにいる？次は何？"

`/gsd-resume-work`

前回のセッションから完全なコンテキストを復元します。

/gsd-resume-work                    # コンテキストリセットまたは新しいセッション後に使用

`/gsd-pause-work`

フェーズの途中で中断する際にコンテキストのハンドオフを保存します。

/gsd-pause-work                     # continue-here.mdを作成

`/gsd-manager`

1つのターミナルから複数のフェーズを管理する対話的なコマンドセンター。

前提条件: .planning/ROADMAP.md が存在すること 動作:

全フェーズのビジュアルステータスインジケータ付きダッシュボード
依存関係と進捗に基づいた最適な次のアクションを推奨
作業のディスパッチ: discussはインラインで実行、plan/executeはバックグラウンドエージェントとして実行
1つのターミナルから複数フェーズの作業を並列化するパワーユーザー向け

/gsd-manager                        # コ<><E382B3>ンドセンターダッシュボードを開く

`/gsd-manager --analyze-deps`

フェーズ依存関係を検出し、ROADMAP.md に Depends on エントリを提案します。(v1.32)

前提<EFBFBD><EFBFBD><EFBFBD>件: .planning/ROADMAP.md が存在すること 検出方法: ファイルオーバーラップ、セマンティック依存関係（API/スキーマのプロデューサーとコンシューマー）、データフロー依存関係 動作: 依存関係提案テーブルを表示し、ユーザー確認後に ROADMAP.md の Depends on フィールドを更新します。

/gsd-manager --analyze-deps            # 依存関係の分析と提案

`/gsd-help`

すべてのコマンドと使用ガイドを表示します。

/gsd-help                           # クイックリファレンス

ユーティリティコマンド

`/gsd-quick`

GSDの保証付きでアドホックタスクを実行します。

フラグ	説明
`--full`	プランチェック（2回のイテレーション）＋実行後検証を有効化
`--discuss`	軽量な事前計画ディスカッション
`--research`	計画前にフォーカスされたリサーチャーを起動

フラグは組み合わせ可能です。

/gsd-quick                          # 基本的なクイックタスク
/gsd-quick --discuss --research     # ディスカッション＋調査＋計画
/gsd-quick --full                   # プランチェックと検証付き
/gsd-quick --discuss --research --full  # すべてのオプションステージ

`/gsd-autonomous`

残りのすべてのフェーズを自律的に実行します。

フラグ	説明
`--from N`	特定のフェーズ番号から開始
`--to N`	フェーズ N 完了後に自律実行を停止 (v1.32)
`--only N`	指定された単一フェーズのみを自律的に実行 (v1.31)
`--interactive`	各フェーズのディスカスステップでユーザー確認を要求

/gsd-autonomous                     # 残りの全フェーズを実行
/gsd-autonomous --from 3            # フェーズ3から開始
/gsd-autonomous --to 5              # フェーズ5まで実行
/gsd-autonomous --from 3 --to 5     # フェーズ3〜5の範囲を実行
/gsd-autonomous --only 4            # フェーズ4のみを自律実行

`/gsd-fast`

フリーテキストを適切なGSDコマンドにルーティングします。

/gsd-fast                             # その後、やりたいことを説明

`/gsd-capture`

手軽にアイデアをキャプチャ — メモの追加、一覧表示、またはTodoへの昇格。

引数	必須	説明
`text`	いいえ	キャプチャするメモテキスト（デフォルト: 追加モード）
`list`	いいえ	プロジェクトおよびグローバルスコープからすべてのメモを一覧表示
`promote N`	いいえ	メモNを構造化されたTodoに変換

フラグ	説明
`--global`	メモ操作にグローバルスコープを使用

/gsd-capture "Consider caching strategy for API responses"
/gsd-capture list
/gsd-capture promote 3

`/gsd-debug`

永続的な状態を持つ体系的なデバッグ。

引数	必須	説明
`description`	いいえ	バグの説明

フラグ	説明
`--diagnose`	修正を試みず調査のみを行う診断専用モード (v1.32)

/gsd-debug "Login button not responding on mobile Safari"
/gsd-debug --diagnose "API returning 500 on /users endpoint"

`/gsd-capture`

後で取り組むアイデアやタスクをキャプチャします。

引数	必須	説明
`description`	いいえ	Todoの説明

/gsd-capture "Consider adding dark mode support"

`/gsd-capture --list`

保留中のTodoを一覧表示し、取り組むものを選択します。

/gsd-capture --list

`/gsd-add-tests`

完了したフェーズのテストを生成します。

引数	必須	説明
`N`	いいえ	フェーズ番号

/gsd-add-tests 2                    # フェーズ2のテストを生成

`/gsd-stats`

プロジェクトの統計情報を表示します。

/gsd-stats                          # プロジェクトメトリクスダッシュボード

`/gsd-profile-user`

Claude Codeのセッション分析から8つの次元（コミュニケーションスタイル、意思決定パターン、デバッグアプローチ、UXプリファレンス、ベンダー選択、フラストレーションのトリガー、学習スタイル、説明の深さ）にわたる開発者行動プロファイルを生成します。Claudeのレスポンスをパーソナライズするアーティファクトを生成します。

フラグ	説明
`--questionnaire`	セッション分析の代わりに対話型アンケートを使用
`--refresh`	セッションを再分析してプロファイルを再生成

生成されるアーティファクト:

USER-PROFILE.md — 完全な行動プロファイル
CLAUDE.md プロファイルセクション — Claude Codeが自動検出

/gsd-profile-user                   # セッションを分析してプロファイルを構築
/gsd-profile-user --questionnaire   # 対話型アンケートのフォールバック
/gsd-profile-user --refresh         # 新鮮な分析からの再生成

`/gsd-health`

.planning/ ディレクトリの整合性を検証します。

フラグ	説明
`--repair`	回復可能な問題を自動修復

/gsd-health                         # 整合性チェック
/gsd-health --repair                # チェックして修復

`/gsd-cleanup`

完了したマイルストーンの蓄積されたフェーズディレクトリをアーカイブします。

/gsd-cleanup

診断コマンド

`/gsd-forensics`

失敗またはスタックしたGSDワークフローの事後調査。

引数	必須	説明
`description`	いいえ	問題の説明（省略時はプロンプトで入力）

前提条件: .planning/ ディレクトリが存在すること 生成物: .planning/forensics/report-{timestamp}.md

調査の対象:

Git履歴分析（直近のコミット、スタックパターン、時間的ギャップ）
アーティファクトの整合性（完了フェーズで期待されるファイル）
STATE.mdの異常とセッション履歴
コミットされていない作業、コンフリクト、放棄された変更
少なくとも4種類の異常をチェック（スタックループ、欠損アーティファクト、放棄された作業、クラッシュ/中断）
アクション可能な所見がある場合、GitHubイシューの作成を提案

/gsd-forensics                              # 対話型 — 問題の入力を促す
/gsd-forensics "Phase 3 execution stalled"  # 問題の説明付き

ワークストリーム管理

`/gsd-workstreams`

マイルストーンの異なる領域で並行作業するためのワークストリームを管理します。

サブコマンド:

サブコマンド	説明
`list`	すべてのワークストリームをステータス付きで一覧表示（サブコマンド未指定時のデフォルト）
`create <name>`	新しいワークストリームを作成
`status <name>`	1つのワークストリームの詳細ステータス
`switch <name>`	アクティブなワークストリームを設定
`progress`	全ワークストリームの進捗サマリー
`complete <name>`	完了したワークストリームをアーカイブ
`resume <name>`	ワークストリームでの作業を再開

前提条件: アクティブなGSDプロジェクト 生成物: .planning/ 配下のワークストリームディレクトリ、ワークストリームごとの状態追跡

/gsd-workstreams                    # すべてのワークストリームを一覧表示
/gsd-workstreams create backend-api # 新しいワークストリームを作成
/gsd-workstreams switch backend-api # アクティブなワークストリームを設定
/gsd-workstreams status backend-api # 詳細ステータス
/gsd-workstreams progress           # ワークストリーム横断の進捗概要
/gsd-workstreams complete backend-api  # 完了したワークストリームをアーカイブ
/gsd-workstreams resume backend-api    # ワークストリームでの作業を再開

設定コマンド

`/gsd-settings`

ワークフロートグルとモデルプロファイルの対話的な設定。

/gsd-settings                       # 対話型設定

`/gsd-config --profile`

クイックプロファイル切り替え。

引数	必須	説明
`profile`	はい	`quality`、`balanced`、`budget`、または `inherit`

/gsd-config --profile budget             # budgetプロファイルに切り替え
/gsd-config --profile quality            # qualityプロファイルに切り替え

ブラウンフィールドコマンド

`/gsd-map-codebase`

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

引数	必須	説明
`area`	いいえ	マッピングを特定の領域にスコープ

/gsd-map-codebase                   # コードベース全体を分析
/gsd-map-codebase auth              # auth領域にフォーカス

アップデートコマンド

`/gsd-update`

変更履歴のプレビュー付きでGSDをアップデートします。

/gsd-update                         # アップデートを確認してインストール

`/gsd-update --reapply`

GSDアップデート後にローカルの変更を復元します。

/gsd-update --reapply               # ローカルの変更をマージバック

高速＆インラインコマンド

`/gsd-fast`

簡単なタスクをインラインで実行 — サブエージェントなし、計画のオーバーヘッドなし。タイポ修正、設定変更、小さなリファクタリング、忘れたコミットなどに最適。

引数	必須	説明
`task description`	いいえ	実行する内容（省略時はプロンプトで入力）

/gsd-quick の代替ではありません — 調査、複数ステップの計画、または検証が必要な場合は /gsd-quick を使用してください。

/gsd-fast "fix typo in README"
/gsd-fast "add .env to gitignore"

コード品質コマンド

`/gsd-review`

外部AI CLIからのフェーズプランのクロスAIピアレビュー。

引数	必須	説明
`--phase N`	はい	レビューするフェーズ番号

フラグ	説明
`--gemini`	Gemini CLIレビューを含める
`--claude`	Claude CLIレビューを含める（別セッション）
`--codex`	Codex CLIレビューを含める
`--coderabbit`	CodeRabbitレビューを含める
`--opencode`	OpenCodeレビューを含める（GitHub Copilot経由）
`--qwen`	Qwen Codeレビューを含める（Alibaba Qwenモデル）
`--cursor`	Cursorエージェントレビューを含める
`--all`	利用可能なすべてのCLIを含める

生成物: {phase}-REVIEWS.md — /gsd-plan-phase --reviews で利用可能

/gsd-review --phase 3 --all
/gsd-review --phase 2 --gemini

`/gsd-pr-branch`

.planning/ のコミットをフィルタリングしてクリーンなPRブランチを作成します。

引数	必須	説明
`target branch`	いいえ	ベースブランチ（デフォルト: `main`）

目的: レビュアーにはコード変更のみを表示し、GSD計画アーティファクトは含めません。

/gsd-pr-branch                     # mainに対してフィルタリング
/gsd-pr-branch develop             # developに対してフィルタリング

`/gsd-audit-uat`

全フェーズを横断した未処理のUATおよび検証項目の監査。

前提条件: 少なくとも1つのフェーズがUATまたは検証付きで実行されていること 生成物: カテゴリ分類された監査レポートと人間用テストプラン

/gsd-audit-uat

バックログ＆スレッドコマンド

`/gsd-capture --backlog`

999.x番号付けを使用して、バックログのパーキングロットにアイデアを追加します。

引数	必須	説明
`description`	はい	バックログ項目の説明

999.x番号付けにより、バックログ項目はアクティブなフェーズシーケンスの外に保持されます。フェーズディレクトリは即座に作成されるため、/gsd-discuss-phase や /gsd-plan-phase がそれらに対して動作します。

/gsd-capture --backlog "GraphQL API layer"
/gsd-capture --backlog "Mobile responsive redesign"

`/gsd-review-backlog`

バックログ項目をレビューし、アクティブなマイルストーンに昇格させます。

項目ごとのアクション: 昇格（アクティブシーケンスに移動）、保持（バックログに残す）、削除。

/gsd-review-backlog

`/gsd-capture --seed`

トリガー条件付きの将来のアイデアをキャプチャ — 適切なマイルストーンで自動的に表面化します。

引数	必須	説明
`idea summary`	いいえ	シードの説明（省略時はプロンプトで入力）

シードはコンテキストの劣化を解決します：誰も読まないDeferredの一行メモの代わりに、シードは完全なWHY、いつ表面化すべきか、詳細への手がかりを保存します。

生成物: .planning/seeds/SEED-NNN-slug.md 利用先: /gsd-new-milestone（シードをスキャンしてマッチするものを提示）

/gsd-capture --seed "Add real-time collaboration when WebSocket infra is in place"

`/gsd-thread`

クロスセッション作業のための永続的なコンテキストスレッドを管理します。

引数	必須	説明
（なし）	—	すべてのスレッドを一覧表示
`name`	—	名前で既存のスレッドを再開
`description`	—	新しいスレッドを作成

スレッドは、複数のセッションにまたがるが特定のフェーズに属さない作業のための軽量なクロスセッション知識ストアです。/gsd-pause-work よりも軽量です。

/gsd-thread                         # すべてのスレッドを一覧表示
/gsd-thread fix-deploy-key-auth     # スレッドを再開
/gsd-thread "Investigate TCP timeout in pasta service"  # 新規作成

32 KiB Raw Blame History Unescape Escape

GSD コマンドリファレンス

コマンド構文

コアワークフローコマンド

/gsd-new-project

/gsd-workspace --new

/gsd-workspace --list

/gsd-workspace --remove

/gsd-discuss-phase

/gsd-ui-phase

/gsd-plan-phase

/gsd-execute-phase

/gsd-verify-work

/gsd-progress --next

/gsd-pause-work --report

/gsd-ship

/gsd-ui-review

/gsd-audit-uat

/gsd-audit-milestone

/gsd-complete-milestone

/gsd-milestone-summary

/gsd-new-milestone

フェーズ管理コマンド

/gsd-phase

/gsd-phase --insert

/gsd-phase --remove

/gsd-discuss-phase --assumptions

/gsd-plan-phase --research-phase

/gsd-validate-phase

ナビゲーションコマンド

/gsd-progress

/gsd-resume-work

/gsd-pause-work

/gsd-manager

/gsd-manager --analyze-deps

/gsd-help

ユーティリティコマンド

/gsd-quick

/gsd-autonomous

/gsd-fast

/gsd-capture

/gsd-debug

/gsd-capture

/gsd-capture --list

/gsd-add-tests

/gsd-stats

/gsd-profile-user

/gsd-health

/gsd-cleanup

診断コマンド

/gsd-forensics

ワークストリーム管理

/gsd-workstreams

設定コマンド

/gsd-settings

/gsd-config --profile

ブラウンフィールドコマンド

/gsd-map-codebase

アップデートコマンド

/gsd-update

/gsd-update --reapply

高速＆インラインコマンド

/gsd-fast

コード品質コマンド

/gsd-review

/gsd-pr-branch

/gsd-audit-uat

バックログ＆スレッドコマンド

/gsd-capture --backlog

/gsd-review-backlog

/gsd-capture --seed

/gsd-thread

コミュニティコマンド

32 KiB

Raw Blame History

`/gsd-new-project`

`/gsd-workspace --new`

`/gsd-workspace --list`

`/gsd-workspace --remove`

`/gsd-discuss-phase`

`/gsd-ui-phase`

`/gsd-plan-phase`

`/gsd-execute-phase`

`/gsd-verify-work`

`/gsd-progress --next`

`/gsd-pause-work --report`

`/gsd-ship`

`/gsd-ui-review`

`/gsd-audit-uat`

`/gsd-audit-milestone`

`/gsd-complete-milestone`

`/gsd-milestone-summary`

`/gsd-new-milestone`

`/gsd-phase`

`/gsd-phase --insert`

`/gsd-phase --remove`

`/gsd-discuss-phase --assumptions`

`/gsd-plan-phase --research-phase`

`/gsd-validate-phase`

`/gsd-progress`

`/gsd-resume-work`

`/gsd-pause-work`

`/gsd-manager`

`/gsd-manager --analyze-deps`

`/gsd-help`

`/gsd-quick`

`/gsd-autonomous`

`/gsd-fast`

`/gsd-capture`

`/gsd-debug`

`/gsd-capture`

`/gsd-capture --list`

`/gsd-add-tests`

`/gsd-stats`

`/gsd-profile-user`

`/gsd-health`

`/gsd-cleanup`

`/gsd-forensics`

`/gsd-workstreams`

`/gsd-settings`

`/gsd-config --profile`

`/gsd-map-codebase`

`/gsd-update`

`/gsd-update --reapply`

`/gsd-fast`

`/gsd-review`

`/gsd-pr-branch`

`/gsd-audit-uat`

`/gsd-capture --backlog`

`/gsd-review-backlog`

`/gsd-capture --seed`

`/gsd-thread`