Files

Tom Boucher eb365f7336 docs: audit and update docs/ for v1.40.0 release (#3048 )

* docs(en): update FEATURES/USER-GUIDE/COMMANDS for v1.40.0 surface

- FEATURES.md: append v1.40.0 section (#122 skill consolidation, #123
  namespace meta-skills, #124 context-window guard, #125 phase-lifecycle
  status-line read-side); add to TOC.
- USER-GUIDE.md: add slash-command form (hyphen vs colon) primer and
  namespace routing primer; replace deleted slash forms in walkthroughs
  (`/gsd-add-backlog`, `/gsd-plant-seed`, `/gsd-add-phase`,
  `/gsd-set-profile`, `/gsd-list-workspaces`, etc.) with consolidated
  forms (`/gsd-capture --backlog`, `/gsd-phase --insert`,
  `/gsd-config --profile`, `/gsd-workspace --list`, etc.); fix
  `/gsd-spike-wrap-up` and `/gsd-sketch-wrap-up` to flag form.
- COMMANDS.md: clarify Command Syntax (Gemini = colon form, others =
  hyphen form); add Namespace Meta-Skills section with all six routers;
  add `--context` to /gsd-health flag table.

Refs #3047

* docs(en): refresh INVENTORY/CLI-TOOLS/STATE-MD-LIFECYCLE for v1.40.0

- INVENTORY.md: workflow-row "Invoked by" column updated to point at
  consolidated commands (`/gsd-phase` family, `/gsd-workspace --list`,
  `/gsd-config --advanced/--integrations/--profile`,
  `/gsd-sketch --wrap-up`, `/gsd-spike --wrap-up`); CLI-modules row for
  `secrets.cjs` updated to `/gsd-config --integrations`. Command count
  and namespace meta-skills section already reflect 65 shipped (= 59
  consolidated sub-skills + 6 ns-* routers).
- CLI-TOOLS.md: add `validate context` row under Validation Commands
  with the 60 %/70 % threshold envelope used by `/gsd-health --context`.
- STATE-MD-LIFECYCLE.md: flip status header from "proposed" to
  "shipped in v1.40.0" since `parseStateMd()` and `formatGsdState()`
  now read and render `active_phase`, `next_action`, `next_phases`,
  and `progress`.

`docs/AGENTS.md` audited and verified clean — `gsd-code-fixer` row
already lists the correct `/gsd-code-review --fix` spawner; no
deleted-skill references found. `docs/INVENTORY-MANIFEST.json`
audited and verified clean — already enumerates the 65 commands
(including six ns-* routers) and contains no deleted slash forms.

Refs #3047

* docs(en): cleanup ARCHITECTURE/CONFIGURATION for v1.40.0

- ARCHITECTURE.md: split Commands install-target list to call out the
  Gemini colon form (`/gsd:command-name`) vs hyphen form for every
  other runtime. Add a new subsection covering two-stage hierarchical
  routing via the six namespace meta-skills (#2792) and a paired note
  on the MCP token-budget interaction so readers see the two big
  per-turn cost levers in one place.
- CONFIGURATION.md: rewrite three references to the deleted
  `/gsd-settings-advanced` and `/gsd-settings-integrations` slash
  forms to use the consolidated `/gsd-config --advanced` /
  `/gsd-config --integrations` invocations. Add a new "STATE.md
  Frontmatter (Phase Lifecycle)" section documenting the four
  optional fields (`active_phase`, `next_action`, `next_phases`,
  `progress`) read by the v1.40 status-line, with a pointer to
  STATE-MD-LIFECYCLE.md for the full reference.

`docs/manual-update.md` audited and verified clean — already documents
`/gsd-update --reapply` (the consolidated form), no reference to the
deleted `/gsd-reapply-patches`.

Refs #3047

* docs(i18n): mirror v1.40.0 slash-command rename into ja-JP/ko-KR/zh-CN/pt-BR

Mechanical token-level renames only — every reference to a deleted
micro-skill slash form is rewritten to the consolidated form on the
matching parent skill. No prose was machine-translated; new prose
sections (slash-form primer, namespace routing primer, v1.40 feature
entries, STATE.md frontmatter) were left for human translator
follow-up.

Renames applied uniformly across all four trees:
  /gsd-add-todo, /gsd-add-note, /gsd-add-backlog,
  /gsd-plant-seed, /gsd-check-todos      → /gsd-capture[ --note|
                                            --backlog|--seed|--list]
  /gsd-add-phase, /gsd-insert-phase,
  /gsd-remove-phase, /gsd-edit-phase     → /gsd-phase[ --insert|
                                            --remove|--edit]
  /gsd-new-workspace, /gsd-list-workspaces,
  /gsd-remove-workspace                  → /gsd-workspace[ --new|
                                            --list|--remove]
  /gsd-settings-advanced,
  /gsd-settings-integrations,
  /gsd-set-profile                       → /gsd-config[ --advanced|
                                            --integrations|--profile]
  /gsd-sketch-wrap-up                    → /gsd-sketch --wrap-up
  /gsd-spike-wrap-up                     → /gsd-spike --wrap-up
  /gsd-reapply-patches                   → /gsd-update --reapply
  /gsd-code-review-fix                   → /gsd-code-review --fix
  /gsd-plan-milestone-gaps               → /gsd-audit-milestone

Refs #3047

* docs(changelog): regroup [Unreleased] under Feature/Enhancement/Fix

Replace the existing Keep-a-Changelog \`Added\` / \`Changed\` /
\`Performance\` / \`Removed\` / \`Fixed\` sub-headers in the [Unreleased]
block with the issue/PR template taxonomy:

  Added                 → Feature
  Changed / Performance → Enhancement
  Removed               → Enhancement
  Fixed                 → Fix

Order within the release: Feature → Enhancement → Fix. Every bullet
preserved verbatim — only headers and grouping changed; the awkward
inline-versioned headers (\`### Added — 1.40.0-rc.1\`,
\`### Changed — 1.40.0-rc.1\`, \`### Fixed — 1.40.0-rc.1\`) folded into
the same buckets with the \`— 1.40.0-rc.1\` suffix dropped, since the
[Unreleased] block IS 1.40.0-rc.1.

The [1.39.2] hotfix block called out in #3047's spec does not yet
exist in CHANGELOG.md (the previously released hotfix is [1.39.1]),
so this commit only regroups [Unreleased]. Older release blocks
([1.39.1] and earlier) are frozen and untouched.

Refs #3047

* docs(changeset): add fragment for v1.40.0 doc audit

Refs #3047

* docs(en): strip leading / from deleted slash-command tokens in FEATURES

REQ-CONSOLIDATE-03 and REQ-CONSOLIDATE-04 listed deleted commands by
their `/gsd-foo` form for the historical record. The docs-parity tests
in bug-3010, bug-3029-3034, and bug-3042-3044 use the regex
`/\/gsd-[a-z0-9][a-z0-9-]*/g` to scan user-facing surfaces for any
remaining mention of removed slash forms — they cannot tell prose
about a deleted command from a live recommendation.

Strip the leading slash from the bare-name references (preserve the
historical text otherwise). Tests now require a `/` prefix to match,
so `gsd-add-todo` reads identically to a human but no longer trips
the parser.

Verified locally: 65/65 tests pass across the three docs-parity
suites that were red on CI run 25270072600.

Refs #3047

* docs(en): fix CR feedback + drop literal /gsd:plan-phase from USER-GUIDE

CI: tests/bug-2543-gsd-slash-namespace.test.cjs flagged
docs/USER-GUIDE.md:35 for embedding the literal `/gsd:plan-phase`
token in the parenthetical Gemini-form example. The test scans every
.md under docs/ for `/gsd:<live-cmd>` because non-Gemini surfaces must
not advertise the colon form. Replaced the literal example with a
prose substitution rule.

CR: docs/ARCHITECTURE.md:125 — the namespace meta-skills were listed
by file-prefix (`gsd-ns-workflow`) but the invocable frontmatter `name:`
is the bare form (`gsd-workflow`). Verified against the six
`commands/gsd/ns-*.md` files. Replaced with the canonical names and
noted the file/name disagreement in-line.

CR: docs/COMMANDS.md:723 — `v1.40` aligned to canonical `v1.40.0`.

CR: docs/FEATURES.md:2679 — REQ-CTX-GUARD-02 advertised the wrong
invocation (`gsd-tools validate context`). The shipped handler is
exposed via `gsd-sdk query validate.context` and requires explicit
`--tokens-used <int>` + `--context-window <int>` flags (verified
against sdk/src/query/validate.ts:849-882 and
get-shit-done/bin/lib/validate-command-router.cjs:19-36).

CR: docs/zh-CN/README.md:533 — added `inherit` to the profile-options
parenthetical to match the canonical set (verified against
model-profiles.cjs:29 `VALID_PROFILES = […MODEL_PROFILES['gsd-planner'], 'inherit']`).

Verified locally: 74/74 tests pass across the four docs-parity suites
that were red on CI runs 25270072600 and 25270182903.

Refs #3047

2026-05-03 07:33:27 -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-next`

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

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

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

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

`/gsd-session-report`

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

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

/gsd-session-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-list-phase-assumptions`

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

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

/gsd-list-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-analyze-dependencies`

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

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

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

`/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-do`

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

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

`/gsd-note`

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

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

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

/gsd-note "Consider caching strategy for API responses"
/gsd-note list
/gsd-note 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 — 完全な行動プロファイル
/gsd-dev-preferences コマンド — 任意のセッションでプリファレンスをロード
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"  # 新規作成

コミュニティコマンド

`/gsd-join-discord`

Discordコミュニティの招待を開きます。

/gsd-join-discord

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-next

/gsd-session-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-list-phase-assumptions

/gsd-plan-phase --research-phase

/gsd-validate-phase

ナビゲーションコマンド

/gsd-progress

/gsd-resume-work

/gsd-pause-work

/gsd-manager

/gsd-analyze-dependencies

/gsd-help

ユーティリティコマンド

/gsd-quick

/gsd-autonomous

/gsd-do

/gsd-note

/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

コミュニティコマンド

/gsd-join-discord

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-next`

`/gsd-session-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-list-phase-assumptions`

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

`/gsd-validate-phase`

`/gsd-progress`

`/gsd-resume-work`

`/gsd-pause-work`

`/gsd-manager`

`/gsd-analyze-dependencies`

`/gsd-help`

`/gsd-quick`

`/gsd-autonomous`

`/gsd-do`

`/gsd-note`

`/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`

`/gsd-join-discord`