fix: replace /gsd: slash command format with /gsd- skill format in all user-facing content (#1579)

* fix: replace /gsd: command format with /gsd- skill format in all suggestions

All next-step suggestions shown to users were still using the old colon
format (/gsd:xxx) which cannot be copy-pasted as skills. Migrated all
occurrences across agents/, commands/, get-shit-done/, docs/, README files,
bin/install.js (hardcoded defaults for claude runtime), and
get-shit-done/bin/lib/*.cjs (generate-claude-md templates and error messages).
Updated tests to assert new hyphen format instead of old colon format.

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

* fix: migrate remaining /gsd: format to /gsd- in hooks, workflows, and sdk

Addresses remaining user-facing occurrences missed in the initial migration:

- hooks/: fix 4 user-facing messages (pause-work, update, fast, quick)
  and 2 comments in gsd-workflow-guard.js
- get-shit-done/workflows/: fix 21 Skill() literal calls that Claude
  executes directly (installer does not transform workflow content)
- sdk/prompt-sanitizer.ts: update regex to strip /gsd- format in addition
  to legacy /gsd: format; update JSDoc comment
- tests/: update autonomous-ui-steps, prompt-sanitizer to assert new format

Note: commands/gsd/*.md frontmatter (name: gsd:xxx) intentionally unchanged
— installer derives skillName from directory path, not the name field.

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

* fix(plan-phase): preserve --chain flag in auto-advance sync and handle ui-phase gate in chain mode

Bug 1: step 15 sync-flag check only guarded against --auto, causing
_auto_chain_active to be cleared when plan-phase is invoked without
--auto in ARGUMENTS even though a --chain pipeline was active. Added
--chain to the guard condition, matching discuss-phase behaviour.

Bug 2: UI Design Contract gate (step 5.6) always exited the workflow
when UI-SPEC was missing, breaking the discuss --chain pipeline
silently. When _auto_chain_active is true, the gate now auto-invokes
gsd-ui-phase --auto via Skill() and continues to step 6 without
prompting. Manual invocations retain the existing AskUserQuestion flow.

* fix: remove <sub>/clear</sub> pattern and duplicate old-format command in discuss-phase.md

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Quang Do
2026-04-04 18:24:31 +07:00
committed by GitHub
parent 05e35ac09a
commit d4767ac2e0
173 changed files with 3461 additions and 3419 deletions

View File

@@ -34,7 +34,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:new-project`, `/gsd:new-milestone` |
| **スポーン元** | `/gsd-new-project`, `/gsd-new-milestone` |
| **並列数** | 4インスタンス(stack, features, architecture, pitfalls) |
| **ツール** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
| **モデル (balanced)** | Sonnet |
@@ -53,7 +53,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:plan-phase` |
| **スポーン元** | `/gsd-plan-phase` |
| **並列数** | 4インスタンス(project-researcher と同じフォーカスエリア) |
| **ツール** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
| **モデル (balanced)** | Sonnet |
@@ -72,7 +72,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:ui-phase` |
| **スポーン元** | `/gsd-ui-phase` |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
| **モデル (balanced)** | Sonnet |
@@ -138,7 +138,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:new-project`(4つのリサーチャー完了後) |
| **スポーン元** | `/gsd-new-project`(4つのリサーチャー完了後) |
| **並列数** | 単一インスタンス(リサーチャー後に順次実行) |
| **ツール** | Read, Write, Bash |
| **モデル (balanced)** | Sonnet |
@@ -153,7 +153,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:plan-phase`, `/gsd:quick` |
| **スポーン元** | `/gsd-plan-phase`, `/gsd-quick` |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Write, Bash, Glob, Grep, WebFetch, mcp (context7) |
| **モデル (balanced)** | Opus |
@@ -175,7 +175,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:new-project` |
| **スポーン元** | `/gsd-new-project` |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Write, Bash, Glob, Grep |
| **モデル (balanced)** | Sonnet |
@@ -196,7 +196,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:execute-phase`, `/gsd:quick` |
| **スポーン元** | `/gsd-execute-phase`, `/gsd-quick` |
| **並列数** | 複数(ウェーブ内は並列、ウェーブ間は順次) |
| **ツール** | Read, Write, Edit, Bash, Grep, Glob |
| **モデル (balanced)** | Sonnet |
@@ -219,7 +219,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:plan-phase`(検証ループ、最大3回の反復) |
| **スポーン元** | `/gsd-plan-phase`(検証ループ、最大3回の反復) |
| **並列数** | 単一インスタンス(反復型) |
| **ツール** | Read, Bash, Glob, Grep |
| **モデル (balanced)** | Sonnet |
@@ -244,7 +244,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:audit-milestone` |
| **スポーン元** | `/gsd-audit-milestone` |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Bash, Grep, Glob |
| **モデル (balanced)** | Sonnet |
@@ -259,7 +259,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:ui-phase`(検証ループ、最大2回の反復) |
| **スポーン元** | `/gsd-ui-phase`(検証ループ、最大2回の反復) |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Bash, Glob, Grep |
| **モデル (balanced)** | Sonnet |
@@ -274,7 +274,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:execute-phase`(すべてのエグゼキューター完了後) |
| **スポーン元** | `/gsd-execute-phase`(すべてのエグゼキューター完了後) |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Write, Bash, Grep, Glob |
| **モデル (balanced)** | Sonnet |
@@ -284,7 +284,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
**主な動作:**
- タスク完了だけでなく、フェーズ目標に対してコードベースを検証
- 具体的なエビデンス付きの PASS/FAIL 判定
- `/gsd:verify-work` で対処すべき問題をログに記録
- `/gsd-verify-work` で対処すべき問題をログに記録
---
@@ -294,7 +294,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:validate-phase` |
| **スポーン元** | `/gsd-validate-phase` |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Write, Edit, Bash, Grep, Glob |
| **モデル (balanced)** | Sonnet |
@@ -313,7 +313,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:ui-review` |
| **スポーン元** | `/gsd-ui-review` |
| **並列数** | 単一インスタンス |
| **ツール** | Read, Write, Bash, Grep, Glob |
| **モデル (balanced)** | Sonnet |
@@ -336,7 +336,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:map-codebase` |
| **スポーン元** | `/gsd-map-codebase` |
| **並列数** | 4インスタンス(tech, architecture, quality, concerns) |
| **ツール** | Read, Bash, Grep, Glob, Write |
| **モデル (balanced)** | Haiku |
@@ -356,7 +356,7 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:debug`, `/gsd:verify-work`(失敗時) |
| **スポーン元** | `/gsd-debug`, `/gsd-verify-work`(失敗時) |
| **並列数** | 単一インスタンス(インタラクティブ) |
| **ツール** | Read, Write, Edit, Bash, Grep, Glob, WebSearch |
| **モデル (balanced)** | Sonnet |
@@ -381,12 +381,12 @@ GSD はマルチエージェントアーキテクチャを採用しており、
| プロパティ | 値 |
|------------|-----|
| **スポーン元** | `/gsd:profile-user` |
| **スポーン元** | `/gsd-profile-user` |
| **並列数** | 単一インスタンス |
| **ツール** | Read |
| **モデル (balanced)** | Sonnet |
| **カラー** | Magenta |
| **生成物** | `USER-PROFILE.md`、`/gsd:dev-preferences`、`CLAUDE.md` プロファイルセクション |
| **生成物** | `USER-PROFILE.md`、`/gsd-dev-preferences`、`CLAUDE.md` プロファイルセクション |
**行動ディメンション:**
コミュニケーションスタイル、意思決定パターン、デバッグアプローチ、UXの好み、ベンダー選択、フラストレーショントリガー、学習スタイル、説明の深度。

View File

@@ -31,7 +31,7 @@ GSDは、ユーザーとAIコーディングエージェント(Claude Code、G
```
┌──────────────────────────────────────────────────────┐
│ USER │
│ /gsd:command [args] │
│ /gsd-command [args] │
└─────────────────────┬────────────────────────────────┘
│
┌─────────────────────▼────────────────────────────────┐
@@ -107,10 +107,10 @@ GSDは、ユーザーとAIコーディングエージェント(Claude Code、G
### コマンド(`commands/gsd/*.md`)
ユーザー向けのエントリーポイントです。各ファイルにはYAMLフロントマター(name、description、allowed-tools)とワークフローをブートストラップするプロンプト本文が含まれています。コマンドは以下の形式でインストールされます:
- **Claude Code:** カスタムスラッシュコマンド(`/gsd:command-name`)
- **Claude Code:** カスタムスラッシュコマンド(`/gsd-command-name`)
- **OpenCode / Kilo:** スラッシュコマンド(`/gsd-command-name`)
- **Codex:** スキル(`$gsd-command-name`)
- **Copilot:** スラッシュコマンド(`/gsd:command-name`)
- **Copilot:** スラッシュコマンド(`/gsd-command-name`)
- **Antigravity:** スキル
**コマンド総数:** 44
@@ -378,13 +378,13 @@ UI-SPEC.md (per phase) ───────────────────
├── STATE.md # 生きたメモリ:位置、決定事項、ブロッカー、メトリクス
├── config.json # ワークフロー設定
├── MILESTONES.md # 完了済みマイルストーンのアーカイブ
├── research/ # /gsd:new-project によるドメインリサーチ
├── research/ # /gsd-new-project によるドメインリサーチ
│ ├── SUMMARY.md
│ ├── STACK.md
│ ├── FEATURES.md
│ ├── ARCHITECTURE.md
│ └── PITFALLS.md
├── codebase/ # ブラウンフィールドマッピング(/gsd:map-codebase から)
├── codebase/ # ブラウンフィールドマッピング(/gsd-map-codebase から)
│ ├── STACK.md
│ ├── ARCHITECTURE.md
│ ├── CONVENTIONS.md
@@ -410,13 +410,13 @@ UI-SPEC.md (per phase) ───────────────────
├── todos/
│ ├── pending/ # キャプチャされたアイデア
│ └── done/ # 完了済みtodo
├── threads/ # 永続コンテキストスレッド(/gsd:thread から)
├── seeds/ # 将来に向けたアイデア(/gsd:plant-seed から)
├── threads/ # 永続コンテキストスレッド(/gsd-thread から)
├── seeds/ # 将来に向けたアイデア(/gsd-plant-seed から)
├── debug/ # アクティブなデバッグセッション
│ ├── *.md # アクティブセッション
│ ├── resolved/ # アーカイブ済みセッション
│ └── knowledge-base.md # 永続的なデバッグ知見
├── ui-reviews/ # /gsd:ui-review からのスクリーンショット(gitignore対象)
├── ui-reviews/ # /gsd-ui-review からのスクリーンショット(gitignore対象)
└── continue-here.md # コンテキスト引き継ぎ(pause-work から)
```
@@ -439,7 +439,7 @@ UI-SPEC.md (per phase) ───────────────────
- Antigravity: Googleモデル同等品によるスキルファースト
5. **パス正規化** — `~/.claude/` パスをランタイム固有のパスに置換
6. **設定統合** — ランタイムの `settings.json` にフックを登録
7. **パッチバックアップ** — v1.17以降、ローカルで変更されたファイルを `/gsd:reapply-patches` 用に `gsd-local-patches/` へバックアップ
7. **パッチバックアップ** — v1.17以降、ローカルで変更されたファイルを `/gsd-reapply-patches` 用に `gsd-local-patches/` へバックアップ
8. **マニフェスト追跡** — クリーンアンインストールのために `gsd-file-manifest.json` を書き込み
9. **アンインストールモード** — `--uninstall` ですべてのGSDファイル、フック、設定を削除
@@ -499,8 +499,8 @@ Runtime Engine (Claude Code / Gemini CLI)
**Workflow Guard**(`gsd-workflow-guard.js`):
- `.planning/` 以外のファイルへのWrite/Edit時にトリガー
- GSDワークフローコンテキスト外での編集を検出(アクティブな `/gsd:` コマンドやTaskサブエージェントがない場合)
- 状態追跡される変更には `/gsd:quick` や `/gsd:fast` の使用をアドバイス
- GSDワークフローコンテキスト外での編集を検出(アクティブな `/gsd-` コマンドやTaskサブエージェントがない場合)
- 状態追跡される変更には `/gsd-quick` や `/gsd-fast` の使用をアドバイス
- `hooks.workflow_guard: true` によるオプトイン(デフォルト: false)
---
@@ -511,12 +511,12 @@ GSDは統一されたコマンド/ワークフローアーキテクチャを通
| ランタイム | コマンド形式 | エージェントシステム | 設定場所 |
|---------|---------------|--------------|-----------------|
| Claude Code | `/gsd:command` | Task起動 | `~/.claude/` |
| Claude Code | `/gsd-command` | Task起動 | `~/.claude/` |
| OpenCode | `/gsd-command` | サブエージェントモード | `~/.config/opencode/` |
| Kilo | `/gsd-command` | サブエージェントモード | `~/.config/kilo/` |
| Gemini CLI | `/gsd:command` | Task起動 | `~/.gemini/` |
| Gemini CLI | `/gsd-command` | Task起動 | `~/.gemini/` |
| Codex | `$gsd-command` | スキル | `~/.codex/` |
| Copilot | `/gsd:command` | エージェント委譲 | `~/.github/` |
| Copilot | `/gsd-command` | エージェント委譲 | `~/.github/` |
| Antigravity | スキル | スキル | `~/.gemini/antigravity/` |
### 抽象化ポイント

View File

@@ -6,7 +6,7 @@
## コマンド構文
- **Claude Code / Gemini / Copilot:** `/gsd:command-name [args]`
- **Claude Code / Gemini / Copilot:** `/gsd-command-name [args]`
- **OpenCode / Kilo:** `/gsd-command-name [args]`
- **Codex:** `$gsd-command-name [args]`
@@ -14,7 +14,7 @@
## コアワークフローコマンド
### `/gsd:new-project`
### `/gsd-new-project`
詳細なコンテキスト収集を行い、新しいプロジェクトを初期化します。
@@ -26,13 +26,13 @@
**生成物:** `PROJECT.md`、`REQUIREMENTS.md`、`ROADMAP.md`、`STATE.md`、`config.json`、`research/`、`CLAUDE.md`
```bash
/gsd:new-project # 対話モード
/gsd:new-project --auto @prd.md # PRDから自動抽出
/gsd-new-project # 対話モード
/gsd-new-project --auto @prd.md # PRDから自動抽出
```
---
### `/gsd:new-workspace`
### `/gsd-new-workspace`
リポジトリのコピーと独立した `.planning/` ディレクトリを持つ分離されたワークスペースを作成します。
@@ -52,14 +52,14 @@
**生成物:** `WORKSPACE.md`、`.planning/`、リポジトリコピー(worktreeまたはclone)
```bash
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI
/gsd:new-workspace --name feature-b --repos . --strategy worktree # 同一リポジトリの分離
/gsd:new-workspace --name spike --repos api,web --strategy clone # フルクローン
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
/gsd-new-workspace --name feature-b --repos . --strategy worktree # 同一リポジトリの分離
/gsd-new-workspace --name spike --repos api,web --strategy clone # フルクローン
```
---
### `/gsd:list-workspaces`
### `/gsd-list-workspaces`
アクティブなGSDワークスペースとそのステータスを一覧表示します。
@@ -67,12 +67,12 @@
**表示内容:** 名前、リポジトリ数、戦略、GSDプロジェクトのステータス
```bash
/gsd:list-workspaces
/gsd-list-workspaces
```
---
### `/gsd:remove-workspace`
### `/gsd-remove-workspace`
ワークスペースを削除し、git worktreeをクリーンアップします。
@@ -83,12 +83,12 @@
**安全性:** コミットされていない変更があるリポジトリの削除を拒否します。名前の確認が必要です。
```bash
/gsd:remove-workspace feature-b
/gsd-remove-workspace feature-b
```
---
### `/gsd:discuss-phase`
### `/gsd-discuss-phase`
計画の前に実装に関する意思決定を記録します。
@@ -106,15 +106,15 @@
**生成物:** `{phase}-CONTEXT.md`、`{phase}-DISCUSSION-LOG.md`(監査証跡)
```bash
/gsd:discuss-phase 1 # フェーズ1の対話的ディスカッション
/gsd:discuss-phase 3 --auto # フェーズ3でデフォルトを自動選択
/gsd:discuss-phase --batch # 現在のフェーズのバッチモード
/gsd:discuss-phase 2 --analyze # トレードオフ分析付きディスカッション
/gsd-discuss-phase 1 # フェーズ1の対話的ディスカッション
/gsd-discuss-phase 3 --auto # フェーズ3でデフォルトを自動選択
/gsd-discuss-phase --batch # 現在のフェーズのバッチモード
/gsd-discuss-phase 2 --analyze # トレードオフ分析付きディスカッション
```
---
### `/gsd:ui-phase`
### `/gsd-ui-phase`
フロントエンドフェーズのUIデザイン契約書を生成します。
@@ -126,12 +126,12 @@
**生成物:** `{phase}-UI-SPEC.md`
```bash
/gsd:ui-phase 2 # フェーズ2のデザイン契約書
/gsd-ui-phase 2 # フェーズ2のデザイン契約書
```
---
### `/gsd:plan-phase`
### `/gsd-plan-phase`
フェーズの調査、計画、検証を行います。
@@ -153,14 +153,14 @@
**生成物:** `{phase}-RESEARCH.md`、`{phase}-{N}-PLAN.md`、`{phase}-VALIDATION.md`
```bash
/gsd:plan-phase 1 # フェーズ1の調査+計画+検証
/gsd:plan-phase 3 --skip-research # 調査なしで計画(馴染みのあるドメイン)
/gsd:plan-phase --auto # 非対話型の計画
/gsd-plan-phase 1 # フェーズ1の調査+計画+検証
/gsd-plan-phase 3 --skip-research # 調査なしで計画(馴染みのあるドメイン)
/gsd-plan-phase --auto # 非対話型の計画
```
---
### `/gsd:execute-phase`
### `/gsd-execute-phase`
フェーズ内のすべてのプランをウェーブベースの並列化で実行するか、特定のウェーブを実行します。
@@ -173,13 +173,13 @@
**生成物:** プランごとの `{phase}-{N}-SUMMARY.md`、gitコミット、フェーズ完了時に `{phase}-VERIFICATION.md`
```bash
/gsd:execute-phase 1 # フェーズ1を実行
/gsd:execute-phase 1 --wave 2 # ウェーブ2のみを実行
/gsd-execute-phase 1 # フェーズ1を実行
/gsd-execute-phase 1 --wave 2 # ウェーブ2のみを実行
```
---
### `/gsd:verify-work`
### `/gsd-verify-work`
自動診断付きのユーザー受入テスト。
@@ -191,31 +191,31 @@
**生成物:** `{phase}-UAT.md`、問題が見つかった場合は修正プラン
```bash
/gsd:verify-work 1 # フェーズ1のUAT
/gsd-verify-work 1 # フェーズ1のUAT
```
---
### `/gsd:next`
### `/gsd-next`
次の論理的なワークフローステップに自動的に進みます。プロジェクトの状態を読み取り、適切なコマンドを実行します。
**前提条件:** `.planning/` ディレクトリが存在すること
**動作:**
- プロジェクトなし → `/gsd:new-project` を提案
- フェーズにディスカッションが必要 → `/gsd:discuss-phase` を実行
- フェーズに計画が必要 → `/gsd:plan-phase` を実行
- フェーズに実行が必要 → `/gsd:execute-phase` を実行
- フェーズに検証が必要 → `/gsd:verify-work` を実行
- 全フェーズ完了 → `/gsd:complete-milestone` を提案
- プロジェクトなし → `/gsd-new-project` を提案
- フェーズにディスカッションが必要 → `/gsd-discuss-phase` を実行
- フェーズに計画が必要 → `/gsd-plan-phase` を実行
- フェーズに実行が必要 → `/gsd-execute-phase` を実行
- フェーズに検証が必要 → `/gsd-verify-work` を実行
- 全フェーズ完了 → `/gsd-complete-milestone` を提案
```bash
/gsd:next # 次のステップを自動検出して実行
/gsd-next # 次のステップを自動検出して実行
```
---
### `/gsd:session-report`
### `/gsd-session-report`
作業サマリー、成果、推定リソース使用量を含むセッションレポートを生成します。
@@ -223,7 +223,7 @@
**生成物:** `.planning/reports/SESSION_REPORT.md`
```bash
/gsd:session-report # セッション後のサマリーを生成
/gsd-session-report # セッション後のサマリーを生成
```
**レポートに含まれる内容:**
@@ -235,7 +235,7 @@
---
### `/gsd:ship`
### `/gsd-ship`
完了したフェーズの作業から自動生成された本文でPRを作成します。
@@ -244,12 +244,12 @@
| `N` | いいえ | フェーズ番号またはマイルストーンバージョン(例: `4` または `v1.0`) |
| `--draft` | いいえ | ドラフトPRとして作成 |
**前提条件:** フェーズが検証済み(`/gsd:verify-work` が合格)、`gh` CLIがインストールされ認証済みであること
**前提条件:** フェーズが検証済み(`/gsd-verify-work` が合格)、`gh` CLIがインストールされ認証済みであること
**生成物:** 計画アーティファクトからリッチな本文を持つGitHub PR、STATE.mdの更新
```bash
/gsd:ship 4 # フェーズ4をシップ
/gsd:ship 4 --draft # ドラフトPRとしてシップ
/gsd-ship 4 # フェーズ4をシップ
/gsd-ship 4 --draft # ドラフトPRとしてシップ
```
**PR本文に含まれる内容:**
@@ -261,7 +261,7 @@
---
### `/gsd:ui-review`
### `/gsd-ui-review`
実装済みフロントエンドの事後的な6軸ビジュアル監査。
@@ -273,13 +273,13 @@
**生成物:** `{phase}-UI-REVIEW.md`、`.planning/ui-reviews/` 内のスクリーンショット
```bash
/gsd:ui-review # 現在のフェーズを監査
/gsd:ui-review 3 # フェーズ3を監査
/gsd-ui-review # 現在のフェーズを監査
/gsd-ui-review 3 # フェーズ3を監査
```
---
### `/gsd:audit-uat`
### `/gsd-audit-uat`
全フェーズを横断した未処理のUATおよび検証項目の監査。
@@ -287,12 +287,12 @@
**生成物:** カテゴリ分類された監査レポートと人間用テストプラン
```bash
/gsd:audit-uat
/gsd-audit-uat
```
---
### `/gsd:audit-milestone`
### `/gsd-audit-milestone`
マイルストーンが完了定義を満たしたかを検証します。
@@ -300,12 +300,12 @@
**生成物:** ギャップ分析付き監査レポート
```bash
/gsd:audit-milestone
/gsd-audit-milestone
```
---
### `/gsd:complete-milestone`
### `/gsd-complete-milestone`
マイルストーンをアーカイブし、リリースをタグ付けします。
@@ -313,12 +313,12 @@
**生成物:** `MILESTONES.md` エントリ、gitタグ
```bash
/gsd:complete-milestone
/gsd-complete-milestone
```
---
### `/gsd:milestone-summary`
### `/gsd-milestone-summary`
チームのオンボーディングやレビューのために、マイルストーンのアーティファクトから包括的なプロジェクトサマリーを生成します。
@@ -338,13 +338,13 @@
- 生成後に対話的なQ&Aを提供
```bash
/gsd:milestone-summary # 現在のマイルストーンをサマリー
/gsd:milestone-summary v1.0 # 特定のマイルストーンをサマリー
/gsd-milestone-summary # 現在のマイルストーンをサマリー
/gsd-milestone-summary v1.0 # 特定のマイルストーンをサマリー
```
---
### `/gsd:new-milestone`
### `/gsd-new-milestone`
次のバージョンサイクルを開始します。
@@ -357,24 +357,24 @@
**生成物:** 更新された `PROJECT.md`、新しい `REQUIREMENTS.md`、新しい `ROADMAP.md`
```bash
/gsd:new-milestone # 対話モード
/gsd:new-milestone "v2.0 Mobile" # 名前付きマイルストーン
/gsd:new-milestone --reset-phase-numbers "v2.0 Mobile" # マイルストーン番号を1からリスタート
/gsd-new-milestone # 対話モード
/gsd-new-milestone "v2.0 Mobile" # 名前付きマイルストーン
/gsd-new-milestone --reset-phase-numbers "v2.0 Mobile" # マイルストーン番号を1からリスタート
```
---
## フェーズ管理コマンド
### `/gsd:add-phase`
### `/gsd-add-phase`
ロードマップに新しいフェーズを追加します。
```bash
/gsd:add-phase # 対話型 — フェーズの説明を入力
/gsd-add-phase # 対話型 — フェーズの説明を入力
```
### `/gsd:insert-phase`
### `/gsd-insert-phase`
小数番号を使用して、フェーズ間に緊急の作業を挿入します。
@@ -383,10 +383,10 @@
| `N` | いいえ | このフェーズ番号の後に挿入 |
```bash
/gsd:insert-phase 3 # フェーズ3と4の間に挿入 → 3.1を作成
/gsd-insert-phase 3 # フェーズ3と4の間に挿入 → 3.1を作成
```
### `/gsd:remove-phase`
### `/gsd-remove-phase`
将来のフェーズを削除し、後続のフェーズの番号を振り直します。
@@ -395,10 +395,10 @@
| `N` | いいえ | 削除するフェーズ番号 |
```bash
/gsd:remove-phase 7 # フェーズ7を削除、8→7、9→8等に番号振り直し
/gsd-remove-phase 7 # フェーズ7を削除、8→7、9→8等に番号振り直し
```
### `/gsd:list-phase-assumptions`
### `/gsd-list-phase-assumptions`
計画前にClaudeの意図するアプローチをプレビューします。
@@ -407,30 +407,30 @@
| `N` | いいえ | フェーズ番号 |
```bash
/gsd:list-phase-assumptions 2 # フェーズ2の前提を確認
/gsd-list-phase-assumptions 2 # フェーズ2の前提を確認
```
### `/gsd:plan-milestone-gaps`
### `/gsd-plan-milestone-gaps`
マイルストーン監査のギャップを解消するフェーズを作成します。
```bash
/gsd:plan-milestone-gaps # 各監査ギャップに対してフェーズを作成
/gsd-plan-milestone-gaps # 各監査ギャップに対してフェーズを作成
```
### `/gsd:research-phase`
### `/gsd-research-phase`
詳細なエコシステム調査のみを実行します(単体機能 — 通常は `/gsd:plan-phase` を使用してください)。
詳細なエコシステム調査のみを実行します(単体機能 — 通常は `/gsd-plan-phase` を使用してください)。
| 引数 | 必須 | 説明 |
|----------|----------|-------------|
| `N` | いいえ | フェーズ番号 |
```bash
/gsd:research-phase 4 # フェーズ4のドメインを調査
/gsd-research-phase 4 # フェーズ4のドメインを調査
```
### `/gsd:validate-phase`
### `/gsd-validate-phase`
遡及的にNyquistバリデーションのギャップを監査・補填します。
@@ -439,38 +439,38 @@
| `N` | いいえ | フェーズ番号 |
```bash
/gsd:validate-phase 2 # フェーズ2のテストカバレッジを監査
/gsd-validate-phase 2 # フェーズ2のテストカバレッジを監査
```
---
## ナビゲーションコマンド
### `/gsd:progress`
### `/gsd-progress`
ステータスと次のステップを表示します。
```bash
/gsd:progress # "今どこにいる?次は何?"
/gsd-progress # "今どこにいる?次は何?"
```
### `/gsd:resume-work`
### `/gsd-resume-work`
前回のセッションから完全なコンテキストを復元します。
```bash
/gsd:resume-work # コンテキストリセットまたは新しいセッション後に使用
/gsd-resume-work # コンテキストリセットまたは新しいセッション後に使用
```
### `/gsd:pause-work`
### `/gsd-pause-work`
フェーズの途中で中断する際にコンテキストのハンドオフを保存します。
```bash
/gsd:pause-work # continue-here.mdを作成
/gsd-pause-work # continue-here.mdを作成
```
### `/gsd:manager`
### `/gsd-manager`
1つのターミナルから複数のフェーズを管理する対話的なコマンドセンター。
@@ -482,24 +482,24 @@
- 1つのターミナルから複数フェーズの作業を並列化するパワーユーザー向け
```bash
/gsd:manager # コマンドセンターダッシュボードを開く
/gsd-manager # コマンドセンターダッシュボードを開く
```
---
### `/gsd:help`
### `/gsd-help`
すべてのコマンドと使用ガイドを表示します。
```bash
/gsd:help # クイックリファレンス
/gsd-help # クイックリファレンス
```
---
## ユーティリティコマンド
### `/gsd:quick`
### `/gsd-quick`
GSDの保証付きでアドホックタスクを実行します。
@@ -512,13 +512,13 @@ GSDの保証付きでアドホックタスクを実行します。
フラグは組み合わせ可能です。
```bash
/gsd:quick # 基本的なクイックタスク
/gsd:quick --discuss --research # ディスカッション+調査+計画
/gsd:quick --full # プランチェックと検証付き
/gsd:quick --discuss --research --full # すべてのオプションステージ
/gsd-quick # 基本的なクイックタスク
/gsd-quick --discuss --research # ディスカッション+調査+計画
/gsd-quick --full # プランチェックと検証付き
/gsd-quick --discuss --research --full # すべてのオプションステージ
```
### `/gsd:autonomous`
### `/gsd-autonomous`
残りのすべてのフェーズを自律的に実行します。
@@ -527,19 +527,19 @@ GSDの保証付きでアドホックタスクを実行します。
| `--from N` | 特定のフェーズ番号から開始 |
```bash
/gsd:autonomous # 残りの全フェーズを実行
/gsd:autonomous --from 3 # フェーズ3から開始
/gsd-autonomous # 残りの全フェーズを実行
/gsd-autonomous --from 3 # フェーズ3から開始
```
### `/gsd:do`
### `/gsd-do`
フリーテキストを適切なGSDコマンドにルーティングします。
```bash
/gsd:do # その後、やりたいことを説明
/gsd-do # その後、やりたいことを説明
```
### `/gsd:note`
### `/gsd-note`
手軽にアイデアをキャプチャ — メモの追加、一覧表示、またはTodoへの昇格。
@@ -554,12 +554,12 @@ GSDの保証付きでアドホックタスクを実行します。
| `--global` | メモ操作にグローバルスコープを使用 |
```bash
/gsd:note "Consider caching strategy for API responses"
/gsd:note list
/gsd:note promote 3
/gsd-note "Consider caching strategy for API responses"
/gsd-note list
/gsd-note promote 3
```
### `/gsd:debug`
### `/gsd-debug`
永続的な状態を持つ体系的なデバッグ。
@@ -568,10 +568,10 @@ GSDの保証付きでアドホックタスクを実行します。
| `description` | いいえ | バグの説明 |
```bash
/gsd:debug "Login button not responding on mobile Safari"
/gsd-debug "Login button not responding on mobile Safari"
```
### `/gsd:add-todo`
### `/gsd-add-todo`
後で取り組むアイデアやタスクをキャプチャします。
@@ -580,18 +580,18 @@ GSDの保証付きでアドホックタスクを実行します。
| `description` | いいえ | Todoの説明 |
```bash
/gsd:add-todo "Consider adding dark mode support"
/gsd-add-todo "Consider adding dark mode support"
```
### `/gsd:check-todos`
### `/gsd-check-todos`
保留中のTodoを一覧表示し、取り組むものを選択します。
```bash
/gsd:check-todos
/gsd-check-todos
```
### `/gsd:add-tests`
### `/gsd-add-tests`
完了したフェーズのテストを生成します。
@@ -600,18 +600,18 @@ GSDの保証付きでアドホックタスクを実行します。
| `N` | いいえ | フェーズ番号 |
```bash
/gsd:add-tests 2 # フェーズ2のテストを生成
/gsd-add-tests 2 # フェーズ2のテストを生成
```
### `/gsd:stats`
### `/gsd-stats`
プロジェクトの統計情報を表示します。
```bash
/gsd:stats # プロジェクトメトリクスダッシュボード
/gsd-stats # プロジェクトメトリクスダッシュボード
```
### `/gsd:profile-user`
### `/gsd-profile-user`
Claude Codeのセッション分析から8つの次元(コミュニケーションスタイル、意思決定パターン、デバッグアプローチ、UXプリファレンス、ベンダー選択、フラストレーションのトリガー、学習スタイル、説明の深さ)にわたる開発者行動プロファイルを生成します。Claudeのレスポンスをパーソナライズするアーティファクトを生成します。
@@ -622,16 +622,16 @@ Claude Codeのセッション分析から8つの次元(コミュニケーシ
**生成されるアーティファクト:**
- `USER-PROFILE.md` — 完全な行動プロファイル
- `/gsd:dev-preferences` コマンド — 任意のセッションでプリファレンスをロード
- `/gsd-dev-preferences` コマンド — 任意のセッションでプリファレンスをロード
- `CLAUDE.md` プロファイルセクション — Claude Codeが自動検出
```bash
/gsd:profile-user # セッションを分析してプロファイルを構築
/gsd:profile-user --questionnaire # 対話型アンケートのフォールバック
/gsd:profile-user --refresh # 新鮮な分析からの再生成
/gsd-profile-user # セッションを分析してプロファイルを構築
/gsd-profile-user --questionnaire # 対話型アンケートのフォールバック
/gsd-profile-user --refresh # 新鮮な分析からの再生成
```
### `/gsd:health`
### `/gsd-health`
`.planning/` ディレクトリの整合性を検証します。
@@ -640,23 +640,23 @@ Claude Codeのセッション分析から8つの次元(コミュニケーシ
| `--repair` | 回復可能な問題を自動修復 |
```bash
/gsd:health # 整合性チェック
/gsd:health --repair # チェックして修復
/gsd-health # 整合性チェック
/gsd-health --repair # チェックして修復
```
### `/gsd:cleanup`
### `/gsd-cleanup`
完了したマイルストーンの蓄積されたフェーズディレクトリをアーカイブします。
```bash
/gsd:cleanup
/gsd-cleanup
```
---
## 診断コマンド
### `/gsd:forensics`
### `/gsd-forensics`
失敗またはスタックしたGSDワークフローの事後調査。
@@ -676,15 +676,15 @@ Claude Codeのセッション分析から8つの次元(コミュニケーシ
- アクション可能な所見がある場合、GitHubイシューの作成を提案
```bash
/gsd:forensics # 対話型 — 問題の入力を促す
/gsd:forensics "Phase 3 execution stalled" # 問題の説明付き
/gsd-forensics # 対話型 — 問題の入力を促す
/gsd-forensics "Phase 3 execution stalled" # 問題の説明付き
```
---
## ワークストリーム管理
### `/gsd:workstreams`
### `/gsd-workstreams`
マイルストーンの異なる領域で並行作業するためのワークストリームを管理します。
@@ -704,28 +704,28 @@ Claude Codeのセッション分析から8つの次元(コミュニケーシ
**生成物:** `.planning/` 配下のワークストリームディレクトリ、ワークストリームごとの状態追跡
```bash
/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-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`
ワークフロートグルとモデルプロファイルの対話的な設定。
```bash
/gsd:settings # 対話型設定
/gsd-settings # 対話型設定
```
### `/gsd:set-profile`
### `/gsd-set-profile`
クイックプロファイル切り替え。
@@ -734,15 +734,15 @@ Claude Codeのセッション分析から8つの次元(コミュニケーシ
| `profile` | **はい** | `quality`、`balanced`、`budget`、または `inherit` |
```bash
/gsd:set-profile budget # budgetプロファイルに切り替え
/gsd:set-profile quality # qualityプロファイルに切り替え
/gsd-set-profile budget # budgetプロファイルに切り替え
/gsd-set-profile quality # qualityプロファイルに切り替え
```
---
## ブラウンフィールドコマンド
### `/gsd:map-codebase`
### `/gsd-map-codebase`
並列マッパーエージェントで既存のコードベースを分析します。
@@ -751,35 +751,35 @@ Claude Codeのセッション分析から8つの次元(コミュニケーシ
| `area` | いいえ | マッピングを特定の領域にスコープ |
```bash
/gsd:map-codebase # コードベース全体を分析
/gsd:map-codebase auth # auth領域にフォーカス
/gsd-map-codebase # コードベース全体を分析
/gsd-map-codebase auth # auth領域にフォーカス
```
---
## アップデートコマンド
### `/gsd:update`
### `/gsd-update`
変更履歴のプレビュー付きでGSDをアップデートします。
```bash
/gsd:update # アップデートを確認してインストール
/gsd-update # アップデートを確認してインストール
```
### `/gsd:reapply-patches`
### `/gsd-reapply-patches`
GSDアップデート後にローカルの変更を復元します。
```bash
/gsd:reapply-patches # ローカルの変更をマージバック
/gsd-reapply-patches # ローカルの変更をマージバック
```
---
## 高速&インラインコマンド
### `/gsd:fast`
### `/gsd-fast`
簡単なタスクをインラインで実行 — サブエージェントなし、計画のオーバーヘッドなし。タイポ修正、設定変更、小さなリファクタリング、忘れたコミットなどに最適。
@@ -787,18 +787,18 @@ GSDアップデート後にローカルの変更を復元します。
|----------|----------|-------------|
| `task description` | いいえ | 実行する内容(省略時はプロンプトで入力) |
**`/gsd:quick` の代替ではありません** — 調査、複数ステップの計画、または検証が必要な場合は `/gsd:quick` を使用してください。
**`/gsd-quick` の代替ではありません** — 調査、複数ステップの計画、または検証が必要な場合は `/gsd-quick` を使用してください。
```bash
/gsd:fast "fix typo in README"
/gsd:fast "add .env to gitignore"
/gsd-fast "fix typo in README"
/gsd-fast "add .env to gitignore"
```
---
## コード品質コマンド
### `/gsd:review`
### `/gsd-review`
外部AI CLIからのフェーズプランのクロスAIピアレビュー。
@@ -814,16 +814,16 @@ GSDアップデート後にローカルの変更を復元します。
| `--coderabbit` | CodeRabbitレビューを含める |
| `--all` | 利用可能なすべてのCLIを含める |
**生成物:** `{phase}-REVIEWS.md` — `/gsd:plan-phase --reviews` で利用可能
**生成物:** `{phase}-REVIEWS.md` — `/gsd-plan-phase --reviews` で利用可能
```bash
/gsd:review --phase 3 --all
/gsd:review --phase 2 --gemini
/gsd-review --phase 3 --all
/gsd-review --phase 2 --gemini
```
---
### `/gsd:pr-branch`
### `/gsd-pr-branch`
`.planning/` のコミットをフィルタリングしてクリーンなPRブランチを作成します。
@@ -834,13 +834,13 @@ GSDアップデート後にローカルの変更を復元します。
**目的:** レビュアーにはコード変更のみを表示し、GSD計画アーティファクトは含めません。
```bash
/gsd:pr-branch # mainに対してフィルタリング
/gsd:pr-branch develop # developに対してフィルタリング
/gsd-pr-branch # mainに対してフィルタリング
/gsd-pr-branch develop # developに対してフィルタリング
```
---
### `/gsd:audit-uat`
### `/gsd-audit-uat`
全フェーズを横断した未処理のUATおよび検証項目の監査。
@@ -848,14 +848,14 @@ GSDアップデート後にローカルの変更を復元します。
**生成物:** カテゴリ分類された監査レポートと人間用テストプラン
```bash
/gsd:audit-uat
/gsd-audit-uat
```
---
## バックログ&スレッドコマンド
### `/gsd:add-backlog`
### `/gsd-add-backlog`
999.x番号付けを使用して、バックログのパーキングロットにアイデアを追加します。
@@ -863,28 +863,28 @@ GSDアップデート後にローカルの変更を復元します。
|----------|----------|-------------|
| `description` | **はい** | バックログ項目の説明 |
**999.x番号付け**により、バックログ項目はアクティブなフェーズシーケンスの外に保持されます。フェーズディレクトリは即座に作成されるため、`/gsd:discuss-phase` や `/gsd:plan-phase` がそれらに対して動作します。
**999.x番号付け**により、バックログ項目はアクティブなフェーズシーケンスの外に保持されます。フェーズディレクトリは即座に作成されるため、`/gsd-discuss-phase` や `/gsd-plan-phase` がそれらに対して動作します。
```bash
/gsd:add-backlog "GraphQL API layer"
/gsd:add-backlog "Mobile responsive redesign"
/gsd-add-backlog "GraphQL API layer"
/gsd-add-backlog "Mobile responsive redesign"
```
---
### `/gsd:review-backlog`
### `/gsd-review-backlog`
バックログ項目をレビューし、アクティブなマイルストーンに昇格させます。
**項目ごとのアクション:** 昇格(アクティブシーケンスに移動)、保持(バックログに残す)、削除。
```bash
/gsd:review-backlog
/gsd-review-backlog
```
---
### `/gsd:plant-seed`
### `/gsd-plant-seed`
トリガー条件付きの将来のアイデアをキャプチャ — 適切なマイルストーンで自動的に表面化します。
@@ -895,15 +895,15 @@ GSDアップデート後にローカルの変更を復元します。
シードはコンテキストの劣化を解決します:誰も読まないDeferredの一行メモの代わりに、シードは完全なWHY、いつ表面化すべきか、詳細への手がかりを保存します。
**生成物:** `.planning/seeds/SEED-NNN-slug.md`
**利用先:** `/gsd:new-milestone`(シードをスキャンしてマッチするものを提示)
**利用先:** `/gsd-new-milestone`(シードをスキャンしてマッチするものを提示)
```bash
/gsd:plant-seed "Add real-time collaboration when WebSocket infra is in place"
/gsd-plant-seed "Add real-time collaboration when WebSocket infra is in place"
```
---
### `/gsd:thread`
### `/gsd-thread`
クロスセッション作業のための永続的なコンテキストスレッドを管理します。
@@ -913,22 +913,22 @@ GSDアップデート後にローカルの変更を復元します。
| `name` | — | 名前で既存のスレッドを再開 |
| `description` | — | 新しいスレッドを作成 |
スレッドは、複数のセッションにまたがるが特定のフェーズに属さない作業のための軽量なクロスセッション知識ストアです。`/gsd:pause-work` よりも軽量です。
スレッドは、複数のセッションにまたがるが特定のフェーズに属さない作業のための軽量なクロスセッション知識ストアです。`/gsd-pause-work` よりも軽量です。
```bash
/gsd:thread # すべてのスレッドを一覧表示
/gsd:thread fix-deploy-key-auth # スレッドを再開
/gsd:thread "Investigate TCP timeout in pasta service" # 新規作成
/gsd-thread # すべてのスレッドを一覧表示
/gsd-thread fix-deploy-key-auth # スレッドを再開
/gsd-thread "Investigate TCP timeout in pasta service" # 新規作成
```
---
## コミュニティコマンド
### `/gsd:join-discord`
### `/gsd-join-discord`
Discordコミュニティの招待を開きます。
```bash
/gsd:join-discord
/gsd-join-discord
```

View File

@@ -6,7 +6,7 @@
## 設定ファイル
GSD はプロジェクト設定を `.planning/config.json` に保存します。`/gsd:new-project` 実行時に作成され、`/gsd:settings` で更新できます。
GSD はプロジェクト設定を `.planning/config.json` に保存します。`/gsd-new-project` 実行時に作成され、`/gsd-settings` で更新できます。
### 完全スキーマ
@@ -96,12 +96,12 @@ GSD はプロジェクト設定を `.planning/config.json` に保存します。
| `workflow.auto_advance` | boolean | `false` | discuss → plan → execute を停止せずに自動連鎖 |
| `workflow.nyquist_validation` | boolean | `true` | plan-phase のリサーチ中にテストカバレッジマッピングを実施 |
| `workflow.ui_phase` | boolean | `true` | フロントエンドフェーズで UI デザインコントラクトを生成 |
| `workflow.ui_safety_gate` | boolean | `true` | plan-phase 中にフロントエンドフェーズに対して /gsd:ui-phase の実行を促すプロンプトを表示 |
| `workflow.ui_safety_gate` | boolean | `true` | plan-phase 中にフロントエンドフェーズに対して /gsd-ui-phase の実行を促すプロンプトを表示 |
| `workflow.node_repair` | boolean | `true` | 検証失敗時にタスクを自律的に修復 |
| `workflow.node_repair_budget` | number | `2` | 失敗タスクあたりの最大修復試行回数 |
| `workflow.research_before_questions` | boolean | `false` | ディスカッション質問の後ではなく前にリサーチを実行 |
| `workflow.discuss_mode` | string | `'discuss'` | `/gsd:discuss-phase` のコンテキスト収集方法を制御。`'discuss'`(デフォルト)は質問を1つずつ行います。`'assumptions'` はまずコードベースを読み取り、信頼度レベル付きの構造化された仮説を生成し、誤っている点のみ修正を求めます。v1.28 で追加 |
| `workflow.skip_discuss` | boolean | `false` | `true` の場合、`/gsd:autonomous` は discuss-phase を完全にスキップし、ROADMAP のフェーズ目標から最小限の CONTEXT.md を作成します。開発者の要望が PROJECT.md/REQUIREMENTS.md に十分に記載されているプロジェクトに適しています。v1.28 で追加 |
| `workflow.discuss_mode` | string | `'discuss'` | `/gsd-discuss-phase` のコンテキスト収集方法を制御。`'discuss'`(デフォルト)は質問を1つずつ行います。`'assumptions'` はまずコードベースを読み取り、信頼度レベル付きの構造化された仮説を生成し、誤っている点のみ修正を求めます。v1.28 で追加 |
| `workflow.skip_discuss` | boolean | `false` | `true` の場合、`/gsd-autonomous` は discuss-phase を完全にスキップし、ROADMAP のフェーズ目標から最小限の CONTEXT.md を作成します。開発者の要望が PROJECT.md/REQUIREMENTS.md に十分に記載されているプロジェクトに適しています。v1.28 で追加 |
| `workflow.text_mode` | boolean | `false` | AskUserQuestion の TUI メニューをプレーンテキストの番号付きリストに置き換えます。TUI メニューが表示されない Claude Code リモートセッション(`/rc` モード)で必要です。discuss-phase で `--text` フラグを使用してセッションごとに設定することもできます。v1.28 で追加 |
### 推奨プリセット
@@ -132,7 +132,7 @@ GSD はプロジェクト設定を `.planning/config.json` に保存します。
| 設定 | 型 | デフォルト | 説明 |
|------|-----|-----------|------|
| `hooks.context_warnings` | boolean | `true` | コンテキストモニターフックによるコンテキストウィンドウ使用量の警告を表示 |
| `hooks.workflow_guard` | boolean | `false` | GSD ワークフローのコンテキスト外でファイル編集が行われた場合に警告(`/gsd:quick` または `/gsd:fast` の使用を推奨) |
| `hooks.workflow_guard` | boolean | `false` | GSD ワークフローのコンテキスト外でファイル編集が行われた場合に警告(`/gsd-quick` または `/gsd-fast` の使用を推奨) |
プロンプトインジェクションガードフック(`gsd-prompt-guard.js`)は常に有効であり、無効にすることはできません。これはワークフロートグルではなく、セキュリティ機能です。
@@ -168,7 +168,7 @@ GSD はプロジェクト設定を `.planning/config.json` に保存します。
| `git.branching_strategy` | enum | `none` | `none`、`phase`、または `milestone` |
| `git.phase_branch_template` | string | `gsd/phase-{phase}-{slug}` | phase 戦略のブランチ名テンプレート |
| `git.milestone_branch_template` | string | `gsd/{milestone}-{slug}` | milestone 戦略のブランチ名テンプレート |
| `git.quick_branch_template` | string or null | `null` | `/gsd:quick` タスク用のオプションのブランチ名テンプレート |
| `git.quick_branch_template` | string or null | `null` | `/gsd-quick` タスク用のオプションのブランチ名テンプレート |
### 戦略の比較
@@ -339,4 +339,4 @@ GSD が非 Claude ランタイム向けにインストールされると、イ
**保存場所:** `~/.gsd/defaults.json`
`/gsd:new-project` が新しい `config.json` を作成する際、グローバルデフォルトを読み込み、初期設定としてマージします。プロジェクトごとの設定は常にグローバル設定を上書きします。
`/gsd-new-project` が新しい `config.json` を作成する際、グローバルデフォルトを読み込み、初期設定としてマージします。プロジェクトごとの設定は常にグローバル設定を上書きします。

View File

@@ -77,7 +77,7 @@
### 1. プロジェクト初期化
**コマンド:** `/gsd:new-project [--auto @file.md]`
**コマンド:** `/gsd-new-project [--auto @file.md]`
**目的:** ユーザーのアイデアを、リサーチ、スコープ化された要件、フェーズ分けされたロードマップを持つ完全に構造化されたプロジェクトに変換します。
@@ -116,13 +116,13 @@
- リサーチエージェントは最新のエコシステム情報を取得するための Web 検索機能を持つ
- 粒度設定によりフェーズ数を制御: `coarse`(3-5)、`standard`(5-8)、`fine`(8-12)
- `--auto` モードではインタラクティブな質問なしで提供されたドキュメントからすべての情報を抽出
- 既存のコードベースコンテキスト(`/gsd:map-codebase` から取得)がある場合は読み込む
- 既存のコードベースコンテキスト(`/gsd-map-codebase` から取得)がある場合は読み込む
---
### 2. フェーズディスカッション
**コマンド:** `/gsd:discuss-phase [N] [--auto] [--batch]`
**コマンド:** `/gsd-discuss-phase [N] [--auto] [--batch]`
**目的:** リサーチとプランニング開始前に、ユーザーの実装に関する要望や決定事項を収集します。AI が推測する原因となるグレーゾーンを排除します。
@@ -149,7 +149,7 @@
### 3. UI デザインコントラクト
**コマンド:** `/gsd:ui-phase [N]`
**コマンド:** `/gsd-ui-phase [N]`
**目的:** プランニング前にデザインの決定事項を確定し、フェーズ内のすべてのコンポーネントが一貫したビジュアル基準を共有できるようにします。
@@ -181,7 +181,7 @@
### 4. フェーズプランニング
**コマンド:** `/gsd:plan-phase [N] [--auto] [--skip-research] [--skip-verify]`
**コマンド:** `/gsd-plan-phase [N] [--auto] [--skip-research] [--skip-verify]`
**目的:** 実装ドメインをリサーチし、検証済みのアトミックな実行プランを作成します。
@@ -192,7 +192,7 @@
- REQ-PLAN-04: システムはすべてのプランに `read_first` と `acceptance_criteria` セクションを含めなければならない
- REQ-PLAN-05: `--skip-verify` が設定されていない限り、システムはプランチェッカー検証ループ(最大3回の反復)を実行しなければならない
- REQ-PLAN-06: システムはリサーチフェーズをバイパスする `--skip-research` フラグをサポートしなければならない
- REQ-PLAN-07: フロントエンドフェーズが検出され UI-SPEC.md が存在しない場合、システムはユーザーに `/gsd:ui-phase` の実行を促さなければならない(UI セーフティゲート)
- REQ-PLAN-07: フロントエンドフェーズが検出され UI-SPEC.md が存在しない場合、システムはユーザーに `/gsd-ui-phase` の実行を促さなければならない(UI セーフティゲート)
- REQ-PLAN-08: `workflow.nyquist_validation` が有効な場合、システムは Nyquist バリデーションマッピングを含めなければならない
- REQ-PLAN-09: プランニング完了前に、すべてのフェーズ要件が少なくとも1つのプランでカバーされていることをシステムは検証しなければならない(要件カバレッジゲート)
@@ -231,7 +231,7 @@
### 5. フェーズ実行
**コマンド:** `/gsd:execute-phase <N>`
**コマンド:** `/gsd-execute-phase <N>`
**目的:** ウェーブベースの並列化を使用して、フェーズ内のすべてのプランを実行します。各エグゼキューターにはフレッシュなコンテキストウィンドウが割り当てられます。
@@ -275,7 +275,7 @@
### 6. 作業検証
**コマンド:** `/gsd:verify-work [N]`
**コマンド:** `/gsd-verify-work [N]`
**目的:** ユーザー受け入れテスト — 各成果物のテストをユーザーに順に案内し、失敗を自動診断します。
@@ -293,7 +293,7 @@
### 6.5. Ship
**コマンド:** `/gsd:ship [N] [--draft]`
**コマンド:** `/gsd-ship [N] [--draft]`
**目的:** ローカル完了からマージ済み PR への橋渡し。検証通過後、ブランチをプッシュし、プランニング成果物から自動生成された本文で PR を作成します。オプションでレビューをトリガーし、STATE.md で追跡します。
@@ -312,7 +312,7 @@
### 7. UI レビュー
**コマンド:** `/gsd:ui-review [N]`
**コマンド:** `/gsd-ui-review [N]`
**目的:** 実装済みフロントエンドコードに対する遡及的な6本柱のビジュアル監査。任意のプロジェクトでスタンドアロンで動作します。
@@ -337,7 +337,7 @@
### 8. マイルストーン管理
**コマンド:** `/gsd:audit-milestone`、`/gsd:complete-milestone`、`/gsd:new-milestone [name]`
**コマンド:** `/gsd-audit-milestone`、`/gsd-complete-milestone`、`/gsd-new-milestone [name]`
**目的:** マイルストーンの完了を検証し、アーカイブし、リリースにタグを付け、次の開発サイクルを開始します。
@@ -352,7 +352,7 @@
- REQ-MILE-08: 新しいマイルストーンは new-project と同じフロー(質問 → リサーチ → 要件 → ロードマップ)に従わなければならない
- REQ-MILE-09: 新しいマイルストーンは既存のワークフロー設定をリセットしてはならない
**ギャップクローズ:** `/gsd:plan-milestone-gaps` は監査で特定されたギャップを埋めるためのフェーズを作成します。
**ギャップクローズ:** `/gsd-plan-milestone-gaps` は監査で特定されたギャップを埋めるためのフェーズを作成します。
---
@@ -360,7 +360,7 @@
### 9. フェーズ管理
**コマンド:** `/gsd:add-phase`、`/gsd:insert-phase [N]`、`/gsd:remove-phase [N]`
**コマンド:** `/gsd-add-phase`、`/gsd-insert-phase [N]`、`/gsd-remove-phase [N]`
**目的:** 開発中のロードマップの動的な変更。
@@ -375,7 +375,7 @@
### 10. Quick モード
**コマンド:** `/gsd:quick [--full] [--discuss] [--research]`
**コマンド:** `/gsd-quick [--full] [--discuss] [--research]`
**目的:** GSD の保証を維持しながら、より高速なパスでアドホックなタスクを実行します。
@@ -394,7 +394,7 @@
### 11. 自律モード
**コマンド:** `/gsd:autonomous [--from N]`
**コマンド:** `/gsd-autonomous [--from N]`
**目的:** 残りのすべてのフェーズを自律的に実行します — フェーズごとにディスカッション → プラン → 実行を行います。
@@ -409,7 +409,7 @@
### 12. フリーフォームルーティング
**コマンド:** `/gsd:do`
**コマンド:** `/gsd-do`
**目的:** 自由形式のテキストを分析し、適切な GSD コマンドにルーティングします。
@@ -423,7 +423,7 @@
### 13. ノートキャプチャ
**コマンド:** `/gsd:note`
**コマンド:** `/gsd-note`
**目的:** ワークフローを中断することなくアイデアを記録する、摩擦ゼロのメモ機能。タイムスタンプ付きメモの追加、全メモの一覧表示、または構造化された Todo へのプロモーションが可能です。
@@ -438,7 +438,7 @@
### 14. 自動進行(Next)
**コマンド:** `/gsd:next`
**コマンド:** `/gsd-next`
**目的:** 現在のプロジェクト状態を自動検出し、次の論理的なワークフローステップに進めます。どのフェーズ/ステップにいるかを覚えておく必要がなくなります。
@@ -446,18 +446,18 @@
- REQ-NEXT-01: システムは STATE.md、ROADMAP.md、フェーズディレクトリを読み取り、現在のポジションを判定しなければならない
- REQ-NEXT-02: システムはディスカッション、プラン、実行、検証のいずれが必要かを検出しなければならない
- REQ-NEXT-03: システムは適切なコマンドを自動的に呼び出さなければならない
- REQ-NEXT-04: プロジェクトが存在しない場合、システムは `/gsd:new-project` を提案しなければならない
- REQ-NEXT-05: すべてのフェーズが完了している場合、システムは `/gsd:complete-milestone` を提案しなければならない
- REQ-NEXT-04: プロジェクトが存在しない場合、システムは `/gsd-new-project` を提案しなければならない
- REQ-NEXT-05: すべてのフェーズが完了している場合、システムは `/gsd-complete-milestone` を提案しなければならない
**状態検出ロジック:**
| 状態 | アクション |
|------|----------|
| `.planning/` ディレクトリなし | `/gsd:new-project` を提案 |
| フェーズに CONTEXT.md がない | `/gsd:discuss-phase` を実行 |
| フェーズに PLAN.md ファイルがない | `/gsd:plan-phase` を実行 |
| プランはあるが SUMMARY.md がない | `/gsd:execute-phase` を実行 |
| 実行済みだが VERIFICATION.md がない | `/gsd:verify-work` を実行 |
| すべてのフェーズが完了 | `/gsd:complete-milestone` を提案 |
| `.planning/` ディレクトリなし | `/gsd-new-project` を提案 |
| フェーズに CONTEXT.md がない | `/gsd-discuss-phase` を実行 |
| フェーズに PLAN.md ファイルがない | `/gsd-plan-phase` を実行 |
| プランはあるが SUMMARY.md がない | `/gsd-execute-phase` を実行 |
| 実行済みだが VERIFICATION.md がない | `/gsd-verify-work` を実行 |
| すべてのフェーズが完了 | `/gsd-complete-milestone` を提案 |
---
@@ -472,12 +472,12 @@
- REQ-NYQ-02: システムは各要件を特定のテストコマンドにマッピングしなければならない
- REQ-NYQ-03: システムはウェーブ 0 タスク(実装前に必要なテストスキャフォールディング)を特定しなければならない
- REQ-NYQ-04: プランチェッカーは Nyquist 準拠を8番目の検証次元として適用しなければならない
- REQ-NYQ-05: システムは `/gsd:validate-phase` による遡及的バリデーションをサポートしなければならない
- REQ-NYQ-05: システムは `/gsd-validate-phase` による遡及的バリデーションをサポートしなければならない
- REQ-NYQ-06: システムは `workflow.nyquist_validation: false` で無効化可能でなければならない
**生成物:** `{phase}-VALIDATION.md` — テストカバレッジコントラクト
**遡及的バリデーション(`/gsd:validate-phase [N]`):**
**遡及的バリデーション(`/gsd-validate-phase [N]`):**
- 実装をスキャンし、要件をテストにマッピング
- 自動検証がない要件のギャップを特定
- テストを生成するオーディターを起動(最大3回試行)
@@ -505,7 +505,7 @@
**要件:**
- REQ-POSTVER-01: システムはタスク完了だけでなく、フェーズ目標に対してチェックしなければならない
- REQ-POSTVER-02: システムは合否分析を含む VERIFICATION.md を生成しなければならない
- REQ-POSTVER-03: システムは `/gsd:verify-work` が対処すべき問題をログに記録しなければならない
- REQ-POSTVER-03: システムは `/gsd-verify-work` が対処すべき問題をログに記録しなければならない
- REQ-POSTVER-04: システムは `workflow.verifier: false` で無効化可能でなければならない
---
@@ -526,7 +526,7 @@
### 19. ヘルスバリデーション
**コマンド:** `/gsd:health [--repair]`
**コマンド:** `/gsd-health [--repair]`
**目的:** `.planning/` ディレクトリの整合性を検証し、問題を自動修復します。
@@ -549,7 +549,7 @@
- REQ-REGR-03: 回帰は実行後検証の前に表面化されなければならない
- REQ-REGR-04: システムはどの過去フェーズのテストが壊れたかを特定しなければならない
**実行タイミング:** `/gsd:execute-phase` の検証ステップの前に自動実行されます。
**実行タイミング:** `/gsd-execute-phase` の検証ステップの前に自動実行されます。
---
@@ -563,7 +563,7 @@
- REQ-COVGATE-03: カバーされていない要件はプランニング完了をブロックしなければならない
- REQ-COVGATE-04: システムはどの特定の要件にプランカバレッジがないかを報告しなければならない
**実行タイミング:** `/gsd:plan-phase` の末尾、プランチェッカーループの後に自動実行されます。
**実行タイミング:** `/gsd-plan-phase` の末尾、プランチェッカーループの後に自動実行されます。
---
@@ -591,7 +591,7 @@
### 23. セッション管理
**コマンド:** `/gsd:pause-work`、`/gsd:resume-work`、`/gsd:progress`
**コマンド:** `/gsd-pause-work`、`/gsd-resume-work`、`/gsd-progress`
**目的:** コンテキストリセットやセッション間でのプロジェクトの継続性を維持します。
@@ -608,7 +608,7 @@
### 24. セッションレポート
**コマンド:** `/gsd:session-report`
**コマンド:** `/gsd-session-report`
**目的:** 実施した作業、達成した成果、推定リソース使用量をキャプチャした、構造化されたセッション後のサマリードキュメントを生成します。
@@ -647,7 +647,7 @@
### 26. モデルプロファイル
**コマンド:** `/gsd:set-profile <quality|balanced|budget|inherit>`
**コマンド:** `/gsd-set-profile <quality|balanced|budget|inherit>`
**目的:** 各エージェントが使用する AI モデルを制御し、品質とコストのバランスを取ります。
@@ -683,7 +683,7 @@
### 27. コードベースマッピング
**コマンド:** `/gsd:map-codebase [area]`
**コマンド:** `/gsd-map-codebase [area]`
**目的:** 新しいプロジェクトを開始する前に既存のコードベースを分析し、GSD が既存の構成を理解できるようにします。
@@ -691,7 +691,7 @@
- REQ-MAP-01: システムは各分析領域に対して並列マッパーエージェントを起動しなければならない
- REQ-MAP-02: システムは `.planning/codebase/` に構造化されたドキュメントを生成しなければならない
- REQ-MAP-03: システムは技術スタック、アーキテクチャパターン、コーディング規約、懸念事項を検出しなければならない
- REQ-MAP-04: 後続の `/gsd:new-project` はコードベースマッピングを読み込み、追加する内容に焦点を当てた質問を行わなければならない
- REQ-MAP-04: 後続の `/gsd-new-project` はコードベースマッピングを読み込み、追加する内容に焦点を当てた質問を行わなければならない
- REQ-MAP-05: オプションの `[area]` 引数はマッピングを特定の領域にスコープしなければならない
**生成物:**
@@ -711,7 +711,7 @@
### 28. デバッグシステム
**コマンド:** `/gsd:debug [description]`
**コマンド:** `/gsd-debug [description]`
**目的:** コンテキストリセットを超えて持続する状態を持つ、体系的なデバッグ。
@@ -729,7 +729,7 @@
### 29. Todo 管理
**コマンド:** `/gsd:add-todo [desc]`、`/gsd:check-todos`
**コマンド:** `/gsd-add-todo [desc]`、`/gsd-check-todos`
**目的:** セッション中にアイデアやタスクをキャプチャし、後で作業できるようにします。
@@ -743,7 +743,7 @@
### 30. 統計ダッシュボード
**コマンド:** `/gsd:stats`
**コマンド:** `/gsd-stats`
**目的:** プロジェクトメトリクスを表示します — フェーズ、プラン、要件、git 履歴、タイムライン。
@@ -757,7 +757,7 @@
### 31. アップデートシステム
**コマンド:** `/gsd:update`
**コマンド:** `/gsd-update`
**目的:** GSD を最新バージョンに更新し、チェンジログのプレビューを表示します。
@@ -766,13 +766,13 @@
- REQ-UPDATE-02: システムは更新前に新しいバージョンのチェンジログを表示しなければならない
- REQ-UPDATE-03: システムはランタイムを認識し、正しいディレクトリを対象としなければならない
- REQ-UPDATE-04: システムはローカルで変更されたファイルを `gsd-local-patches/` にバックアップしなければならない
- REQ-UPDATE-05: `/gsd:reapply-patches` は更新後にローカルの変更を復元しなければならない
- REQ-UPDATE-05: `/gsd-reapply-patches` は更新後にローカルの変更を復元しなければならない
---
### 32. 設定管理
**コマンド:** `/gsd:settings`
**コマンド:** `/gsd-settings`
**目的:** ワークフロートグルとモデルプロファイルのインタラクティブな設定。
@@ -805,7 +805,7 @@
### 33. テスト生成
**コマンド:** `/gsd:add-tests [N]`
**コマンド:** `/gsd-add-tests [N]`
**目的:** 完了したフェーズに対して、UAT 基準と実装に基づいてテストを生成します。
@@ -897,14 +897,14 @@ fix(03-01): correct auth token expiry
**ステータスライン表示:**
```
[⬆ /gsd:update │] model │ [current task │] directory [█████░░░░░ 50%]
[⬆ /gsd-update │] model │ [current task │] directory [█████░░░░░ 50%]
```
カラーコーディング: 50% 未満は緑、65% 未満は黄、80% 未満はオレンジ、80% 以上はドクロ絵文字付き赤
### 38. 開発者プロファイリング
**コマンド:** `/gsd:profile-user [--questionnaire] [--refresh]`
**コマンド:** `/gsd-profile-user [--questionnaire] [--refresh]`
**目的:** Claude Code のセッション履歴を分析し、8つの次元にわたる行動プロファイルを構築します。開発者のスタイルに合わせて Claude のレスポンスをパーソナライズするための成果物を生成します。
@@ -920,7 +920,7 @@ fix(03-01): correct auth token expiry
**生成される成果物:**
- `USER-PROFILE.md` — 証拠引用付きの完全な行動プロファイル
- `/gsd:dev-preferences` コマンド — 任意のセッションで好みを読み込み
- `/gsd-dev-preferences` コマンド — 任意のセッションで好みを読み込み
- `CLAUDE.md` プロファイルセクション — Claude Code により自動検出
**フラグ:**
@@ -962,14 +962,14 @@ fix(03-01): correct auth token expiry
### 40. 検証デット追跡
**コマンド:** `/gsd:audit-uat`
**コマンド:** `/gsd-audit-uat`
**目的:** 未解決のテストを持つフェーズを通過した際の UAT/検証項目のサイレントな喪失を防止します。すべての過去フェーズの検証デットを表面化し、項目が忘れられないようにします。
**コンポーネント:**
**1. クロスフェーズヘルスチェック**(progress.md ステップ 1.6)
すべての `/gsd:progress` 呼び出しで、現在のマイルストーンのすべてのフェーズの未解決項目(pending、skipped、blocked、human_needed)をスキャンします。アクション可能なリンク付きのノンブロッキング警告セクションを表示します。
すべての `/gsd-progress` 呼び出しで、現在のマイルストーンのすべてのフェーズの未解決項目(pending、skipped、blocked、human_needed)をスキャンします。アクション可能なリンク付きのノンブロッキング警告セクションを表示します。
**2. `status: partial`**(verify-work.md、UAT.md)
「セッション終了」と「すべてのテスト解決済み」を区別する新しい UAT ステータス。テストがまだ pending、blocked、または理由なく skipped の場合に `status: complete` を防止します。
@@ -984,12 +984,12 @@ fix(03-01): correct auth token expiry
`phase complete` CLI は JSON 出力に検証デット警告を返します。トランジションワークフローは確認前に未解決項目を表面化します。
**要件:**
- REQ-DEBT-01: システムは `/gsd:progress` ですべての過去フェーズの未解決 UAT/検証項目を表面化しなければならない
- REQ-DEBT-01: システムは `/gsd-progress` ですべての過去フェーズの未解決 UAT/検証項目を表面化しなければならない
- REQ-DEBT-02: システムは不完全なテスト(partial)と完了したテスト(complete)を区別しなければならない
- REQ-DEBT-03: システムはブロックされたテストを `blocked_by` タグでカテゴリ分けしなければならない
- REQ-DEBT-04: システムは human_needed の検証項目を追跡可能な UAT ファイルとして永続化しなければならない
- REQ-DEBT-05: システムは検証デットが存在する場合、フェーズ完了とトランジション時に警告(ノンブロッキング)しなければならない
- REQ-DEBT-06: `/gsd:audit-uat` はすべてのフェーズをスキャンし、項目をテスト可能性別にカテゴリ分けし、人的テストプランを生成しなければならない
- REQ-DEBT-06: `/gsd-audit-uat` はすべてのフェーズをスキャンし、項目をテスト可能性別にカテゴリ分けし、人的テストプランを生成しなければならない
---
@@ -997,7 +997,7 @@ fix(03-01): correct auth token expiry
### 41. Fast モード
**コマンド:** `/gsd:fast [task description]`
**コマンド:** `/gsd-fast [task description]`
**目的:** サブエージェントの起動や PLAN.md ファイルの生成なしに、些細なタスクをインラインで実行します。プランニングのオーバーヘッドを正当化できないほど小さなタスク向け: タイポ修正、設定変更、小規模なリファクタリング、コミット忘れ、簡単な追加。
@@ -1007,15 +1007,15 @@ fix(03-01): correct auth token expiry
- REQ-FAST-03: システムは状態の一貫性のためにタスクを `.planning/quick/` で追跡しなければならない
- REQ-FAST-04: リサーチ、マルチステッププランニング、または検証が必要なタスクにシステムを使用してはならない
**`/gsd:quick` との使い分け:**
- `/gsd:fast` — 2分以内に実行可能な一文のタスク(タイポ修正、設定変更、小規模な追加)
- `/gsd:quick` — リサーチ、マルチステッププランニング、または検証が必要なもの
**`/gsd-quick` との使い分け:**
- `/gsd-fast` — 2分以内に実行可能な一文のタスク(タイポ修正、設定変更、小規模な追加)
- `/gsd-quick` — リサーチ、マルチステッププランニング、または検証が必要なもの
---
### 42. クロス AI ピアレビュー
**コマンド:** `/gsd:review --phase N [--gemini] [--claude] [--codex] [--coderabbit] [--all]`
**コマンド:** `/gsd-review --phase N [--gemini] [--claude] [--codex] [--coderabbit] [--all]`
**目的:** 外部の AI CLI(Gemini、Claude、Codex、CodeRabbit)を呼び出して、フェーズプランを独立してレビューします。レビュアーごとのフィードバックを含む構造化された REVIEWS.md を生成します。
@@ -1024,7 +1024,7 @@ fix(03-01): correct auth token expiry
- REQ-REVIEW-02: システムはフェーズプランから構造化されたレビュープロンプトを構築しなければならない
- REQ-REVIEW-03: システムは選択された各 CLI を独立して呼び出さなければならない
- REQ-REVIEW-04: システムはレスポンスを収集して `REVIEWS.md` を生成しなければならない
- REQ-REVIEW-05: レビューは `/gsd:plan-phase --reviews` で使用可能でなければならない
- REQ-REVIEW-05: レビューは `/gsd-plan-phase --reviews` で使用可能でなければならない
**生成物:** `{phase}-REVIEWS.md` — レビュアーごとの構造化されたフィードバック
@@ -1032,17 +1032,17 @@ fix(03-01): correct auth token expiry
### 43. バックログパーキングロット
**コマンド:** `/gsd:add-backlog <description>`、`/gsd:review-backlog`、`/gsd:plant-seed <idea>`
**コマンド:** `/gsd-add-backlog <description>`、`/gsd-review-backlog`、`/gsd-plant-seed <idea>`
**目的:** アクティブなプランニングの準備ができていないアイデアをキャプチャします。バックログ項目は 999.x の番号付けを使用して、アクティブなフェーズシーケンスの外に留まります。シードは、適切なマイルストーンで自動的に表面化するトリガー条件を持つ、将来を見据えたアイデアです。
**要件:**
- REQ-BACKLOG-01: バックログ項目はアクティブなフェーズシーケンスの外に留まるために 999.x の番号付けを使用しなければならない
- REQ-BACKLOG-02: `/gsd:discuss-phase` と `/gsd:plan-phase` が動作するよう、フェーズディレクトリは即座に作成されなければならない
- REQ-BACKLOG-03: `/gsd:review-backlog` は項目ごとにプロモート、維持、削除のアクションをサポートしなければならない
- REQ-BACKLOG-02: `/gsd-discuss-phase` と `/gsd-plan-phase` が動作するよう、フェーズディレクトリは即座に作成されなければならない
- REQ-BACKLOG-03: `/gsd-review-backlog` は項目ごとにプロモート、維持、削除のアクションをサポートしなければならない
- REQ-BACKLOG-04: プロモートされた項目はアクティブなマイルストーンシーケンスに再番号付けされなければならない
- REQ-SEED-01: シードは完全な WHY と表面化条件の WHEN をキャプチャしなければならない
- REQ-SEED-02: `/gsd:new-milestone` はシードをスキャンして一致するものを提示しなければならない
- REQ-SEED-02: `/gsd-new-milestone` はシードをスキャンして一致するものを提示しなければならない
**生成物:**
| 成果物 | 説明 |
@@ -1054,9 +1054,9 @@ fix(03-01): correct auth token expiry
### 44. 永続コンテキストスレッド
**コマンド:** `/gsd:thread [name | description]`
**コマンド:** `/gsd-thread [name | description]`
**目的:** 複数セッションにまたがるが特定のフェーズには属さない作業のための、軽量なクロスセッションナレッジストア。`/gsd:pause-work` よりも軽量 — フェーズ状態やプランコンテキストは不要です。
**目的:** 複数セッションにまたがるが特定のフェーズには属さない作業のための、軽量なクロスセッションナレッジストア。`/gsd-pause-work` よりも軽量 — フェーズ状態やプランコンテキストは不要です。
**要件:**
- REQ-THREAD-01: システムは作成、一覧、再開モードをサポートしなければならない
@@ -1071,7 +1071,7 @@ fix(03-01): correct auth token expiry
### 45. PR ブランチフィルタリング
**コマンド:** `/gsd:pr-branch [target branch]`
**コマンド:** `/gsd-pr-branch [target branch]`
**目的:** `.planning/` のコミットを除外して、プルリクエストに適したクリーンなブランチを作成します。レビュアーにはコード変更のみが表示され、GSD プランニング成果物は表示されません。
@@ -1099,7 +1099,7 @@ fix(03-01): correct auth token expiry
`.planning/` を対象とする Write/Edit 呼び出しをインジェクションパターンでスキャンする PreToolUse フック。アドバイザリーのみ — 正当な操作をブロックせず、検出を認識のためにログ記録します。
**3. ワークフローガードフック**(`gsd-workflow-guard.js`)
Claude が GSD ワークフローコンテキスト外でファイル編集を試行した際に検出する PreToolUse フック。直接編集の代わりに `/gsd:quick` や `/gsd:fast` の使用をアドバイスします。`hooks.workflow_guard`(デフォルト: false)で設定可能です。
Claude が GSD ワークフローコンテキスト外でファイル編集を試行した際に検出する PreToolUse フック。直接編集の代わりに `/gsd-quick` や `/gsd-fast` の使用をアドバイスします。`hooks.workflow_guard`(デフォルト: false)で設定可能です。
**4. CI 対応インジェクションスキャナー**(`prompt-injection-scan.test.cjs`)
すべてのエージェント、ワークフロー、コマンドファイルに埋め込まれたインジェクションベクターをスキャンするテストスイート。
@@ -1126,7 +1126,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
### 48. ディスカッション監査証跡
**目的:** `/gsd:discuss-phase` 中に `DISCUSSION-LOG.md` を自動生成し、ディスカッション中の決定事項の完全な監査証跡を残します。
**目的:** `/gsd-discuss-phase` 中に `DISCUSSION-LOG.md` を自動生成し、ディスカッション中の決定事項の完全な監査証跡を残します。
**要件:**
- REQ-DISCLOG-01: システムは discuss-phase 中に DISCUSSION-LOG.md を自動生成しなければならない
@@ -1139,7 +1139,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
### 49. フォレンジクス
**コマンド:** `/gsd:forensics [description]`
**コマンド:** `/gsd-forensics [description]`
**目的:** 失敗または停滞した GSD ワークフローのポストモーテム調査。
@@ -1165,7 +1165,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
### 50. マイルストーンサマリー
**コマンド:** `/gsd:milestone-summary [version]`
**コマンド:** `/gsd-milestone-summary [version]`
**目的:** チームオンボーディングのためにマイルストーン成果物から包括的なプロジェクトサマリーを生成します。
@@ -1188,7 +1188,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
### 51. ワークストリームネームスペーシング
**コマンド:** `/gsd:workstreams`
**コマンド:** `/gsd-workstreams`
**目的:** 異なるマイルストーン領域での同時作業のための並列ワークストリーム。
@@ -1211,7 +1211,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
### 52. マネージャーダッシュボード
**コマンド:** `/gsd:manager`
**コマンド:** `/gsd-manager`
**目的:** 1つのターミナルから複数のフェーズを管理するためのインタラクティブなコマンドセンター。
@@ -1231,7 +1231,7 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
### 53. Assumptions ディスカッションモード
**コマンド:** `/gsd:discuss-phase`(`workflow.discuss_mode: 'assumptions'` 設定時)
**コマンド:** `/gsd-discuss-phase`(`workflow.discuss_mode: 'assumptions'` 設定時)
**目的:** インタビュー形式の質問をコードベースファーストの仮定分析に置き換えます。
@@ -1257,20 +1257,20 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
### 54. UI フェーズ自動検出
**対象:** `/gsd:new-project` および `/gsd:progress`
**対象:** `/gsd-new-project` および `/gsd-progress`
**目的:** UI 重視のプロジェクトを自動検出し、`/gsd:ui-phase` の推奨を表面化します。
**目的:** UI 重視のプロジェクトを自動検出し、`/gsd-ui-phase` の推奨を表面化します。
**要件:**
- REQ-UI-DETECT-01: システムはプロジェクト説明の UI シグナル(キーワード、フレームワーク参照)を検出しなければならない
- REQ-UI-DETECT-02: システムは該当する場合に ROADMAP.md のフェーズに `ui_hint` をアノテーションしなければならない
- REQ-UI-DETECT-03: システムは UI 重視フェーズのネクストステップに `/gsd:ui-phase` を提案しなければならない
- REQ-UI-DETECT-04: システムは `/gsd:ui-phase` を必須にしてはならない
- REQ-UI-DETECT-03: システムは UI 重視フェーズのネクストステップに `/gsd-ui-phase` を提案しなければならない
- REQ-UI-DETECT-04: システムは `/gsd-ui-phase` を必須にしてはならない
**プロセス:**
1. **検出** — プロジェクト説明と技術スタックの UI シグナル(キーワード、フレームワーク参照)をスキャン
2. **アノテーション** — ROADMAP.md の該当フェーズに `ui_hint` マーカーを追加
3. **表面化** — UI 重視フェーズのネクストステップに `/gsd:ui-phase` の推奨を含める
3. **表面化** — UI 重視フェーズのネクストステップに `/gsd-ui-phase` の推奨を含める
---

View File

@@ -19,7 +19,7 @@ Get Shit Done(GSD)フレームワークの包括的なドキュメントで
## クイックリンク
- **v1.28 の新機能:** フォレンジクス、マイルストーンサマリー、ワークストリーム、assumptions モード、UI 自動検出、マネージャーダッシュボード
- **はじめに:** [README](../README.md) → インストール → `/gsd:new-project`
- **はじめに:** [README](../README.md) → インストール → `/gsd-new-project`
- **ワークフロー完全ガイド:** [ユーザーガイド](USER-GUIDE.md)
- **コマンド一覧:** [コマンドリファレンス](COMMANDS.md)
- **GSD の設定:** [設定リファレンス](CONFIGURATION.md)

View File

@@ -26,7 +26,7 @@
```
┌──────────────────────────────────────────────────┐
│ NEW PROJECT │
│ /gsd:new-project │
│ /gsd-new-project │
│ Questions -> Research -> Requirements -> Roadmap│
└─────────────────────────┬────────────────────────┘
│
@@ -34,27 +34,27 @@
│ FOR EACH PHASE: │
│ │
│ ┌────────────────────┐ │
│ │ /gsd:discuss-phase │ │ <- Lock in preferences
│ │ /gsd-discuss-phase │ │ <- Lock in preferences
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:ui-phase │ │ <- Design contract (frontend)
│ │ /gsd-ui-phase │ │ <- Design contract (frontend)
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:plan-phase │ │ <- Research + Plan + Verify
│ │ /gsd-plan-phase │ │ <- Research + Plan + Verify
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:execute-phase │ │ <- Parallel execution
│ │ /gsd-execute-phase │ │ <- Parallel execution
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:verify-work │ │ <- Manual UAT
│ │ /gsd-verify-work │ │ <- Manual UAT
│ └──────────┬─────────┘ │
│ │ │
│ ┌──────────▼─────────┐ │
│ │ /gsd:ship │ │ <- Create PR (optional)
│ │ /gsd-ship │ │ <- Create PR (optional)
│ └──────────┬─────────┘ │
│ │ │
│ Next Phase?────────────┘
@@ -62,8 +62,8 @@
└─────────────┼──────────────┘
│
┌───────────────▼──────────────┐
│ /gsd:audit-milestone │
│ /gsd:complete-milestone │
│ /gsd-audit-milestone │
│ /gsd-complete-milestone │
└───────────────┬──────────────┘
│
Another milestone?
@@ -71,14 +71,14 @@
Yes No -> Done!
│
┌───────▼──────────────┐
│ /gsd:new-milestone │
│ /gsd-new-milestone │
└──────────────────────┘
```
### プランニングエージェントの連携
```
/gsd:plan-phase N
/gsd-plan-phase N
│
├── Phase Researcher (x4 parallel)
│ ├── Stack researcher
@@ -119,14 +119,14 @@ plan-phase のリサーチ時に、GSD はコードが書かれる前に各フ
**出力:** `{phase}-VALIDATION.md` -- フェーズのフィードバックコントラクト。
**無効化:** テストインフラが重視されないラピッドプロトタイピングフェーズでは、`/gsd:settings` で `workflow.nyquist_validation: false` を設定してください。
**無効化:** テストインフラが重視されないラピッドプロトタイピングフェーズでは、`/gsd-settings` で `workflow.nyquist_validation: false` を設定してください。
### 遡及バリデーション (`/gsd:validate-phase`)
### 遡及バリデーション (`/gsd-validate-phase`)
Nyquist バリデーションが存在する前に実行されたフェーズ、または従来のテストスイートのみを持つ既存コードベースに対して、遡及的に監査しカバレッジのギャップを埋めます:
```
/gsd:validate-phase N
/gsd-validate-phase N
|
+-- Detect state (VALIDATION.md exists? SUMMARY.md exists?)
|
@@ -146,13 +146,13 @@ Nyquist バリデーションが存在する前に実行されたフェーズ、
オーディターは実装コードを変更しません — テストファイルと VALIDATION.md のみを変更します。テストが実装のバグを発見した場合、対処が必要なエスカレーションとしてフラグが立てられます。
**使用タイミング:** Nyquist が有効化される前にプランニングされたフェーズを実行した後、または `/gsd:audit-milestone` が Nyquist コンプライアンスのギャップを検出した後。
**使用タイミング:** Nyquist が有効化される前にプランニングされたフェーズを実行した後、または `/gsd-audit-milestone` が Nyquist コンプライアンスのギャップを検出した後。
### 前提確認ディスカッションモード
デフォルトでは、`/gsd:discuss-phase` は実装の好みについてオープンエンドな質問を行います。前提確認モードではこれを反転させます:GSD がまずコードベースを読み込み、フェーズの構築方法に関する構造化された前提を提示し、修正が必要な箇所のみを確認します。
デフォルトでは、`/gsd-discuss-phase` は実装の好みについてオープンエンドな質問を行います。前提確認モードではこれを反転させます:GSD がまずコードベースを読み込み、フェーズの構築方法に関する構造化された前提を提示し、修正が必要な箇所のみを確認します。
**有効化:** `/gsd:settings` で `workflow.discuss_mode` を `'assumptions'` に設定します。
**有効化:** `/gsd-settings` で `workflow.discuss_mode` を `'assumptions'` に設定します。
**動作の仕組み:**
1. PROJECT.md、コードベースマッピング、既存の規約を読み込む
@@ -175,18 +175,18 @@ Nyquist バリデーションが存在する前に実行されたフェーズ、
AI 生成のフロントエンドの見た目が一貫しないのは、Claude Code の UI 能力が低いからではなく、実行前にデザインコントラクトが存在しなかったためです。共通のスペーシングスケール、カラーコントラクト、コピーライティング基準なしに構築された5つのコンポーネントは、5つのわずかに異なるビジュアル上の判断を生み出します。
`/gsd:ui-phase` はプランニング前にデザインコントラクトを確定させます。`/gsd:ui-review` は実行後に結果を監査します。
`/gsd-ui-phase` はプランニング前にデザインコントラクトを確定させます。`/gsd-ui-review` は実行後に結果を監査します。
### コマンド
| コマンド | 説明 |
|---------|-------------|
| `/gsd:ui-phase [N]` | フロントエンドフェーズ用の UI-SPEC.md デザインコントラクトを生成 |
| `/gsd:ui-review [N]` | 実装済み UI の遡及的6ピラービジュアル監査 |
| `/gsd-ui-phase [N]` | フロントエンドフェーズ用の UI-SPEC.md デザインコントラクトを生成 |
| `/gsd-ui-review [N]` | 実装済み UI の遡及的6ピラービジュアル監査 |
### ワークフロー:`/gsd:ui-phase`
### ワークフロー:`/gsd-ui-phase`
**実行タイミング:** `/gsd:discuss-phase` の後、`/gsd:plan-phase` の前 — フロントエンド/UI 作業を含むフェーズで使用。
**実行タイミング:** `/gsd-discuss-phase` の後、`/gsd-plan-phase` の前 — フロントエンド/UI 作業を含むフェーズで使用。
**フロー:**
1. CONTEXT.md、RESEARCH.md、REQUIREMENTS.md を読み込んで既存の決定事項を確認
@@ -199,9 +199,9 @@ AI 生成のフロントエンドの見た目が一貫しないのは、Claude C
**出力:** `.planning/phases/{phase-dir}/` 内の `{padded_phase}-UI-SPEC.md`
### ワークフロー:`/gsd:ui-review`
### ワークフロー:`/gsd-ui-review`
**実行タイミング:** `/gsd:execute-phase` または `/gsd:verify-work` の後 — フロントエンドコードを含むプロジェクトで使用。
**実行タイミング:** `/gsd-execute-phase` または `/gsd-verify-work` の後 — フロントエンドコードを含むプロジェクトで使用。
**スタンドアロン:** GSD 管理プロジェクトに限らず、あらゆるプロジェクトで動作します。UI-SPEC.md が存在しない場合は、抽象的な6ピラー基準に基づいて監査します。
@@ -220,9 +220,9 @@ AI 生成のフロントエンドの見た目が一貫しないのは、Claude C
| 設定 | デフォルト | 説明 |
|---------|---------|-------------|
| `workflow.ui_phase` | `true` | フロントエンドフェーズ用の UI デザインコントラクトを生成 |
| `workflow.ui_safety_gate` | `true` | plan-phase 時にフロントエンドフェーズで /gsd:ui-phase の実行を促す |
| `workflow.ui_safety_gate` | `true` | plan-phase 時にフロントエンドフェーズで /gsd-ui-phase の実行を促す |
どちらも「未設定=有効」パターンに従います。`/gsd:settings` から無効化できます。
どちらも「未設定=有効」パターンに従います。`/gsd-settings` から無効化できます。
### shadcn の初期化
@@ -245,7 +245,7 @@ React/Next.js/Vite プロジェクトの場合、UI リサーチャーは `compo
### スクリーンショットの保存
`/gsd:ui-review` は Playwright CLI を使用してスクリーンショットを `.planning/ui-reviews/` にキャプチャします。バイナリファイルが git に含まれないよう、`.gitignore` が自動的に作成されます。スクリーンショットは `/gsd:complete-milestone` 時にクリーンアップされます。
`/gsd-ui-review` は Playwright CLI を使用してスクリーンショットを `.planning/ui-reviews/` にキャプチャします。バイナリファイルが git に含まれないよう、`.gitignore` が自動的に作成されます。スクリーンショットは `/gsd-complete-milestone` 時にクリーンアップされます。
---
@@ -256,23 +256,23 @@ React/Next.js/Vite プロジェクトの場合、UI リサーチャーは `compo
アクティブなプランニングの準備ができていないアイデアは、999.x 番号を使用してバックログに格納され、アクティブなフェーズシーケンスの外に保持されます。
```
/gsd:add-backlog "GraphQL API layer" # Creates 999.1-graphql-api-layer/
/gsd:add-backlog "Mobile responsive" # Creates 999.2-mobile-responsive/
/gsd-add-backlog "GraphQL API layer" # Creates 999.1-graphql-api-layer/
/gsd-add-backlog "Mobile responsive" # Creates 999.2-mobile-responsive/
```
バックログアイテムは完全なフェーズディレクトリを取得するため、`/gsd:discuss-phase 999.1` でアイデアをさらに探索したり、準備が整ったら `/gsd:plan-phase 999.1` を使用できます。
バックログアイテムは完全なフェーズディレクトリを取得するため、`/gsd-discuss-phase 999.1` でアイデアをさらに探索したり、準備が整ったら `/gsd-plan-phase 999.1` を使用できます。
**レビューとプロモーション** は `/gsd:review-backlog` で行います — すべてのバックログアイテムを表示し、プロモーション(アクティブシーケンスへの移動)、保持(バックログに残す)、または削除を選択できます。
**レビューとプロモーション** は `/gsd-review-backlog` で行います — すべてのバックログアイテムを表示し、プロモーション(アクティブシーケンスへの移動)、保持(バックログに残す)、または削除を選択できます。
### シード
シードは、トリガー条件を持つ将来を見据えたアイデアです。バックログアイテムとは異なり、適切なマイルストーンが到来すると自動的に表面化されます。
```
/gsd:plant-seed "Add real-time collab when WebSocket infra is in place"
/gsd-plant-seed "Add real-time collab when WebSocket infra is in place"
```
シードは完全な WHY と表面化タイミングを保持します。`/gsd:new-milestone` はすべてのシードをスキャンし、一致するものを提示します。
シードは完全な WHY と表面化タイミングを保持します。`/gsd-new-milestone` はすべてのシードをスキャンし、一致するものを提示します。
**保存場所:** `.planning/seeds/SEED-NNN-slug.md`
@@ -281,14 +281,14 @@ React/Next.js/Vite プロジェクトの場合、UI リサーチャーは `compo
スレッドは、複数のセッションにまたがるが特定のフェーズに属さない作業のための、軽量なクロスセッション知識ストアです。
```
/gsd:thread # List all threads
/gsd:thread fix-deploy-key-auth # Resume existing thread
/gsd:thread "Investigate TCP timeout" # Create new thread
/gsd-thread # List all threads
/gsd-thread fix-deploy-key-auth # Resume existing thread
/gsd-thread "Investigate TCP timeout" # Create new thread
```
スレッドは `/gsd:pause-work` より軽量です — フェーズ状態やプランコンテキストはありません。各スレッドファイルには Goal、Context、References、Next Steps セクションが含まれます。
スレッドは `/gsd-pause-work` より軽量です — フェーズ状態やプランコンテキストはありません。各スレッドファイルには Goal、Context、References、Next Steps セクションが含まれます。
スレッドは成熟した段階でフェーズ (`/gsd:add-phase`) やバックログアイテム (`/gsd:add-backlog`) にプロモーションできます。
スレッドは成熟した段階でフェーズ (`/gsd-add-phase`) やバックログアイテム (`/gsd-add-backlog`) にプロモーションできます。
**保存場所:** `.planning/threads/{slug}.md`
@@ -304,16 +304,16 @@ React/Next.js/Vite プロジェクトの場合、UI リサーチャーは `compo
| コマンド | 用途 |
|---------|---------|
| `/gsd:workstreams create <name>` | 独立したプランニング状態を持つ新しいワークストリームを作成 |
| `/gsd:workstreams switch <name>` | アクティブコンテキストを別のワークストリームに切り替え |
| `/gsd:workstreams list` | すべてのワークストリームとアクティブなものを表示 |
| `/gsd:workstreams complete <name>` | ワークストリームを完了としてマークし、状態をアーカイブ |
| `/gsd-workstreams create <name>` | 独立したプランニング状態を持つ新しいワークストリームを作成 |
| `/gsd-workstreams switch <name>` | アクティブコンテキストを別のワークストリームに切り替え |
| `/gsd-workstreams list` | すべてのワークストリームとアクティブなものを表示 |
| `/gsd-workstreams complete <name>` | ワークストリームを完了としてマークし、状態をアーカイブ |
### 動作の仕組み
各ワークストリームは独自の `.planning/` ディレクトリサブツリーを維持します。ワークストリームを切り替えると、GSD はアクティブなプランニングコンテキストを入れ替え、`/gsd:progress`、`/gsd:discuss-phase`、`/gsd:plan-phase` などのコマンドがそのワークストリームの状態に対して動作するようにします。
各ワークストリームは独自の `.planning/` ディレクトリサブツリーを維持します。ワークストリームを切り替えると、GSD はアクティブなプランニングコンテキストを入れ替え、`/gsd-progress`、`/gsd-discuss-phase`、`/gsd-plan-phase` などのコマンドがそのワークストリームの状態に対して動作するようにします。
これは `/gsd:new-workspace`(別のリポジトリワークツリーを作成)より軽量です。ワークストリームは同じコードベースと git 履歴を共有しつつ、プランニングアーティファクトを分離します。
これは `/gsd-new-workspace`(別のリポジトリワークツリーを作成)より軽量です。ワークストリームは同じコードベースと git 履歴を共有しつつ、プランニングアーティファクトを分離します。
---
@@ -341,7 +341,7 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ
### 実行ウェーブの調整
```
/gsd:execute-phase N
/gsd-execute-phase N
│
├── Analyze plan dependencies
│
@@ -356,13 +356,13 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ
└── Check codebase against phase goals
│
├── PASS -> VERIFICATION.md (success)
└── FAIL -> Issues logged for /gsd:verify-work
└── FAIL -> Issues logged for /gsd-verify-work
```
### ブラウンフィールドワークフロー(既存コードベース)
```
/gsd:map-codebase
/gsd-map-codebase
│
├── Stack Mapper -> codebase/STACK.md
├── Arch Mapper -> codebase/ARCHITECTURE.md
@@ -370,7 +370,7 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ
└── Concern Mapper -> codebase/CONCERNS.md
│
┌───────▼──────────┐
│ /gsd:new-project │ <- Questions focus on what you're ADDING
│ /gsd-new-project │ <- Questions focus on what you're ADDING
└──────────────────┘
```
@@ -382,80 +382,80 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ
| コマンド | 用途 | 使用タイミング |
|---------|---------|-------------|
| `/gsd:new-project` | フルプロジェクト初期化:質問、リサーチ、要件定義、ロードマップ | 新規プロジェクトの開始時 |
| `/gsd:new-project --auto @idea.md` | ドキュメントからの自動初期化 | PRD やアイデアドキュメントが準備済みの場合 |
| `/gsd:discuss-phase [N]` | 実装上の決定事項を記録 | プランニング前に、構築方法を決定するため |
| `/gsd:ui-phase [N]` | UI デザインコントラクトを生成 | discuss-phase の後、plan-phase の前(フロントエンドフェーズ) |
| `/gsd:plan-phase [N]` | リサーチ + プランニング + 検証 | フェーズ実行前 |
| `/gsd:execute-phase <N>` | すべてのプランを並列ウェーブで実行 | プランニング完了後 |
| `/gsd:verify-work [N]` | 自動診断付き手動 UAT | 実行完了後 |
| `/gsd:ship [N]` | 検証済みの作業から PR を作成 | 検証合格後 |
| `/gsd:fast <text>` | インラインの軽微なタスク — プランニングを完全にスキップ | タイプミス修正、設定変更、小規模リファクタリング |
| `/gsd:next` | 状態を自動検出して次のステップを実行 | いつでも — 「次に何をすべき?」 |
| `/gsd:ui-review [N]` | 遡及的6ピラービジュアル監査 | 実行後または verify-work 後(フロントエンドプロジェクト) |
| `/gsd:audit-milestone` | マイルストーンの完了定義を満たしているか検証 | マイルストーン完了前 |
| `/gsd:complete-milestone` | マイルストーンをアーカイブし、リリースタグを作成 | 全フェーズの検証完了後 |
| `/gsd:new-milestone [name]` | 次のバージョンサイクルを開始 | マイルストーン完了後 |
| `/gsd-new-project` | フルプロジェクト初期化:質問、リサーチ、要件定義、ロードマップ | 新規プロジェクトの開始時 |
| `/gsd-new-project --auto @idea.md` | ドキュメントからの自動初期化 | PRD やアイデアドキュメントが準備済みの場合 |
| `/gsd-discuss-phase [N]` | 実装上の決定事項を記録 | プランニング前に、構築方法を決定するため |
| `/gsd-ui-phase [N]` | UI デザインコントラクトを生成 | discuss-phase の後、plan-phase の前(フロントエンドフェーズ) |
| `/gsd-plan-phase [N]` | リサーチ + プランニング + 検証 | フェーズ実行前 |
| `/gsd-execute-phase <N>` | すべてのプランを並列ウェーブで実行 | プランニング完了後 |
| `/gsd-verify-work [N]` | 自動診断付き手動 UAT | 実行完了後 |
| `/gsd-ship [N]` | 検証済みの作業から PR を作成 | 検証合格後 |
| `/gsd-fast <text>` | インラインの軽微なタスク — プランニングを完全にスキップ | タイプミス修正、設定変更、小規模リファクタリング |
| `/gsd-next` | 状態を自動検出して次のステップを実行 | いつでも — 「次に何をすべき?」 |
| `/gsd-ui-review [N]` | 遡及的6ピラービジュアル監査 | 実行後または verify-work 後(フロントエンドプロジェクト) |
| `/gsd-audit-milestone` | マイルストーンの完了定義を満たしているか検証 | マイルストーン完了前 |
| `/gsd-complete-milestone` | マイルストーンをアーカイブし、リリースタグを作成 | 全フェーズの検証完了後 |
| `/gsd-new-milestone [name]` | 次のバージョンサイクルを開始 | マイルストーン完了後 |
### ナビゲーション
| コマンド | 用途 | 使用タイミング |
|---------|---------|-------------|
| `/gsd:progress` | 状態と次のステップを表示 | いつでも -- 「今どこにいる?」 |
| `/gsd:resume-work` | 前回のセッションからフルコンテキストを復元 | 新しいセッションの開始時 |
| `/gsd:pause-work` | 構造化されたハンドオフを保存(HANDOFF.json + continue-here.md) | フェーズの途中で作業を中断する時 |
| `/gsd:session-report` | 作業内容と成果を含むセッションサマリーを生成 | セッション終了時、ステークホルダーへの共有時 |
| `/gsd:help` | すべてのコマンドを表示 | クイックリファレンス |
| `/gsd:update` | 変更履歴プレビュー付きで GSD を更新 | 新バージョンの確認時 |
| `/gsd:join-discord` | Discord コミュニティの招待リンクを開く | 質問やコミュニティ参加時 |
| `/gsd-progress` | 状態と次のステップを表示 | いつでも -- 「今どこにいる?」 |
| `/gsd-resume-work` | 前回のセッションからフルコンテキストを復元 | 新しいセッションの開始時 |
| `/gsd-pause-work` | 構造化されたハンドオフを保存(HANDOFF.json + continue-here.md) | フェーズの途中で作業を中断する時 |
| `/gsd-session-report` | 作業内容と成果を含むセッションサマリーを生成 | セッション終了時、ステークホルダーへの共有時 |
| `/gsd-help` | すべてのコマンドを表示 | クイックリファレンス |
| `/gsd-update` | 変更履歴プレビュー付きで GSD を更新 | 新バージョンの確認時 |
| `/gsd-join-discord` | Discord コミュニティの招待リンクを開く | 質問やコミュニティ参加時 |
### フェーズ管理
| コマンド | 用途 | 使用タイミング |
|---------|---------|-------------|
| `/gsd:add-phase` | ロードマップに新しいフェーズを追加 | 初期プランニング後にスコープが拡大した場合 |
| `/gsd:insert-phase [N]` | 緊急作業を挿入(小数番号) | マイルストーン中の緊急修正 |
| `/gsd:remove-phase [N]` | 将来のフェーズを削除して番号を振り直す | 機能のスコープ縮小 |
| `/gsd:list-phase-assumptions [N]` | Claude の意図するアプローチをプレビュー | プランニング前に方向性を確認 |
| `/gsd:plan-milestone-gaps` | 監査ギャップに対するフェーズを作成 | 監査で不足項目が見つかった後 |
| `/gsd:research-phase [N]` | エコシステムの深いリサーチのみ | 複雑または不慣れなドメイン |
| `/gsd-add-phase` | ロードマップに新しいフェーズを追加 | 初期プランニング後にスコープが拡大した場合 |
| `/gsd-insert-phase [N]` | 緊急作業を挿入(小数番号) | マイルストーン中の緊急修正 |
| `/gsd-remove-phase [N]` | 将来のフェーズを削除して番号を振り直す | 機能のスコープ縮小 |
| `/gsd-list-phase-assumptions [N]` | Claude の意図するアプローチをプレビュー | プランニング前に方向性を確認 |
| `/gsd-plan-milestone-gaps` | 監査ギャップに対するフェーズを作成 | 監査で不足項目が見つかった後 |
| `/gsd-research-phase [N]` | エコシステムの深いリサーチのみ | 複雑または不慣れなドメイン |
### ブラウンフィールドとユーティリティ
| コマンド | 用途 | 使用タイミング |
|---------|---------|-------------|
| `/gsd:map-codebase` | 既存コードベースを分析 | 既存コードに対する `/gsd:new-project` の前 |
| `/gsd:quick` | GSD 保証付きのアドホックタスク | バグ修正、小機能、設定変更 |
| `/gsd:debug [desc]` | 永続状態を持つ体系的デバッグ | 何かが壊れた時 |
| `/gsd:forensics` | ワークフロー障害の診断レポート | 状態、アーティファクト、git 履歴が破損していると思われる場合 |
| `/gsd:add-todo [desc]` | 後でやるアイデアを記録 | セッション中にアイデアが浮かんだ時 |
| `/gsd:check-todos` | 保留中の TODO を一覧表示 | 記録したアイデアのレビュー |
| `/gsd:settings` | ワークフロートグルとモデルプロファイルを設定 | モデル変更、エージェントのトグル |
| `/gsd:set-profile <profile>` | クイックプロファイル切り替え | コスト/品質トレードオフの変更 |
| `/gsd:reapply-patches` | アップデート後にローカル変更を復元 | ローカル編集がある場合の `/gsd:update` 後 |
| `/gsd-map-codebase` | 既存コードベースを分析 | 既存コードに対する `/gsd-new-project` の前 |
| `/gsd-quick` | GSD 保証付きのアドホックタスク | バグ修正、小機能、設定変更 |
| `/gsd-debug [desc]` | 永続状態を持つ体系的デバッグ | 何かが壊れた時 |
| `/gsd-forensics` | ワークフロー障害の診断レポート | 状態、アーティファクト、git 履歴が破損していると思われる場合 |
| `/gsd-add-todo [desc]` | 後でやるアイデアを記録 | セッション中にアイデアが浮かんだ時 |
| `/gsd-check-todos` | 保留中の TODO を一覧表示 | 記録したアイデアのレビュー |
| `/gsd-settings` | ワークフロートグルとモデルプロファイルを設定 | モデル変更、エージェントのトグル |
| `/gsd-set-profile <profile>` | クイックプロファイル切り替え | コスト/品質トレードオフの変更 |
| `/gsd-reapply-patches` | アップデート後にローカル変更を復元 | ローカル編集がある場合の `/gsd-update` 後 |
### コード品質とレビュー
| コマンド | 用途 | 使用タイミング |
|---------|---------|-------------|
| `/gsd:review --phase N` | 外部 CLI からのクロス AI ピアレビュー | 実行前にプランを検証 |
| `/gsd:pr-branch` | `.planning/` コミットをフィルタリングしたクリーンな PR ブランチ | プランニングフリーの diff で PR を作成する前 |
| `/gsd:audit-uat` | 全フェーズの検証負債を監査 | マイルストーン完了前 |
| `/gsd-review --phase N` | 外部 CLI からのクロス AI ピアレビュー | 実行前にプランを検証 |
| `/gsd-pr-branch` | `.planning/` コミットをフィルタリングしたクリーンな PR ブランチ | プランニングフリーの diff で PR を作成する前 |
| `/gsd-audit-uat` | 全フェーズの検証負債を監査 | マイルストーン完了前 |
### バックログとスレッド
| コマンド | 用途 | 使用タイミング |
|---------|---------|-------------|
| `/gsd:add-backlog <desc>` | バックログパーキングロットにアイデアを追加(999.x) | アクティブなプランニングの準備ができていないアイデア |
| `/gsd:review-backlog` | バックログアイテムのプロモーション/保持/削除 | 新マイルストーン前の優先順位付け |
| `/gsd:plant-seed <idea>` | トリガー条件付きの将来を見据えたアイデア | 将来のマイルストーンで表面化すべきアイデア |
| `/gsd:thread [name]` | 永続コンテキストスレッド | フェーズ構造外のクロスセッション作業 |
| `/gsd-add-backlog <desc>` | バックログパーキングロットにアイデアを追加(999.x) | アクティブなプランニングの準備ができていないアイデア |
| `/gsd-review-backlog` | バックログアイテムのプロモーション/保持/削除 | 新マイルストーン前の優先順位付け |
| `/gsd-plant-seed <idea>` | トリガー条件付きの将来を見据えたアイデア | 将来のマイルストーンで表面化すべきアイデア |
| `/gsd-thread [name]` | 永続コンテキストスレッド | フェーズ構造外のクロスセッション作業 |
---
## 設定リファレンス
GSD はプロジェクト設定を `.planning/config.json` に保存します。`/gsd:new-project` 時に設定するか、後から `/gsd:settings` で更新できます。
GSD はプロジェクト設定を `.planning/config.json` に保存します。`/gsd-new-project` 時に設定するか、後から `/gsd-settings` で更新できます。
### 完全な config.json スキーマ
@@ -519,7 +519,7 @@ GSD はプロジェクト設定を `.planning/config.json` に保存します。
| `workflow.verifier` | `true`, `false` | `true` | 実行後のフェーズ目標に対する検証 |
| `workflow.nyquist_validation` | `true`, `false` | `true` | plan-phase 時のバリデーションアーキテクチャリサーチ、8番目の plan-check 次元 |
| `workflow.ui_phase` | `true`, `false` | `true` | フロントエンドフェーズ用の UI デザインコントラクトを生成 |
| `workflow.ui_safety_gate` | `true`, `false` | `true` | plan-phase 時にフロントエンドフェーズで /gsd:ui-phase の実行を促す |
| `workflow.ui_safety_gate` | `true`, `false` | `true` | plan-phase 時にフロントエンドフェーズで /gsd-ui-phase の実行を促す |
| `workflow.research_before_questions` | `true`, `false` | `false` | ディスカッション質問の後ではなく前にリサーチを実行 |
| `workflow.discuss_mode` | `standard`, `assumptions` | `standard` | ディスカッションスタイル:オープンエンドの質問 vs. コードベース駆動の前提確認 |
| `workflow.skip_discuss` | `true`, `false` | `false` | 自律モードで discuss-phase を完全にスキップ、ROADMAP のフェーズ目標から最小限の CONTEXT.md を作成 |
@@ -540,7 +540,7 @@ GSD はプロジェクト設定を `.planning/config.json` に保存します。
| `git.branching_strategy` | `none`, `phase`, `milestone` | `none` | ブランチ作成のタイミングと方法 |
| `git.phase_branch_template` | テンプレート文字列 | `gsd/phase-{phase}-{slug}` | phase 戦略のブランチ名 |
| `git.milestone_branch_template` | テンプレート文字列 | `gsd/{milestone}-{slug}` | milestone 戦略のブランチ名 |
| `git.quick_branch_template` | テンプレート文字列 または `null` | `null` | `/gsd:quick` タスク用のオプションブランチ名 |
| `git.quick_branch_template` | テンプレート文字列 または `null` | `null` | `/gsd-quick` タスク用のオプションブランチ名 |
**ブランチ戦略の説明:**
@@ -590,60 +590,60 @@ quick タスクのブランチ設定例:
```bash
claude --dangerously-skip-permissions
/gsd:new-project # 質問に回答、設定、ロードマップを承認
/gsd-new-project # 質問に回答、設定、ロードマップを承認
/clear
/gsd:discuss-phase 1 # 好みを確定
/gsd:ui-phase 1 # デザインコントラクト(フロントエンドフェーズ)
/gsd:plan-phase 1 # リサーチ + プラン + 検証
/gsd:execute-phase 1 # 並列実行
/gsd:verify-work 1 # 手動 UAT
/gsd:ship 1 # 検証済み作業から PR を作成
/gsd:ui-review 1 # ビジュアル監査(フロントエンドフェーズ)
/gsd-discuss-phase 1 # 好みを確定
/gsd-ui-phase 1 # デザインコントラクト(フロントエンドフェーズ)
/gsd-plan-phase 1 # リサーチ + プラン + 検証
/gsd-execute-phase 1 # 並列実行
/gsd-verify-work 1 # 手動 UAT
/gsd-ship 1 # 検証済み作業から PR を作成
/gsd-ui-review 1 # ビジュアル監査(フロントエンドフェーズ)
/clear
/gsd:next # 自動検出して次のステップを実行
/gsd-next # 自動検出して次のステップを実行
...
/gsd:audit-milestone # すべて出荷されたか確認
/gsd:complete-milestone # アーカイブ、タグ付け、完了
/gsd:session-report # セッションサマリーを生成
/gsd-audit-milestone # すべて出荷されたか確認
/gsd-complete-milestone # アーカイブ、タグ付け、完了
/gsd-session-report # セッションサマリーを生成
```
### 既存ドキュメントからの新規プロジェクト
```bash
/gsd:new-project --auto @prd.md # ドキュメントからリサーチ/要件/ロードマップを自動実行
/gsd-new-project --auto @prd.md # ドキュメントからリサーチ/要件/ロードマップを自動実行
/clear
/gsd:discuss-phase 1 # ここから通常のフロー
/gsd-discuss-phase 1 # ここから通常のフロー
```
### 既存コードベース
```bash
/gsd:map-codebase # 既存のコードを分析(並列エージェント)
/gsd:new-project # 追加する内容に焦点を当てた質問
/gsd-map-codebase # 既存のコードを分析(並列エージェント)
/gsd-new-project # 追加する内容に焦点を当てた質問
# (ここから通常のフェーズワークフロー)
```
### クイックバグ修正
```bash
/gsd:quick
/gsd-quick
> "Fix the login button not responding on mobile Safari"
```
### 休憩後の再開
```bash
/gsd:progress # 前回の続きと次のステップを確認
/gsd-progress # 前回の続きと次のステップを確認
# または
/gsd:resume-work # 前回のセッションからフルコンテキストを復元
/gsd-resume-work # 前回のセッションからフルコンテキストを復元
```
### リリース準備
```bash
/gsd:audit-milestone # 要件カバレッジを確認、スタブを検出
/gsd:plan-milestone-gaps # 監査でギャップが見つかった場合、フェーズを作成して埋める
/gsd:complete-milestone # アーカイブ、タグ付け、完了
/gsd-audit-milestone # 要件カバレッジを確認、スタブを検出
/gsd-plan-milestone-gaps # 監査でギャップが見つかった場合、フェーズを作成して埋める
/gsd-complete-milestone # アーカイブ、タグ付け、完了
```
### スピード vs 品質プリセット
@@ -654,16 +654,16 @@ claude --dangerously-skip-permissions
| 通常開発 | `interactive` | `standard` | `balanced` | オン | オン | オン |
| プロダクション | `interactive` | `fine` | `quality` | オン | オン | オン |
**自律モードでの discuss-phase スキップ:** `yolo` モードで実行中に、PROJECT.md に既に十分な設定が記録されている場合は、`/gsd:settings` で `workflow.skip_discuss: true` を設定してください。これにより discuss-phase を完全にバイパスし、ROADMAP のフェーズ目標から最小限の CONTEXT.md を作成します。PROJECT.md と規約がディスカッションで新しい情報を追加しないほど包括的な場合に有用です。
**自律モードでの discuss-phase スキップ:** `yolo` モードで実行中に、PROJECT.md に既に十分な設定が記録されている場合は、`/gsd-settings` で `workflow.skip_discuss: true` を設定してください。これにより discuss-phase を完全にバイパスし、ROADMAP のフェーズ目標から最小限の CONTEXT.md を作成します。PROJECT.md と規約がディスカッションで新しい情報を追加しないほど包括的な場合に有用です。
### マイルストーン中のスコープ変更
```bash
/gsd:add-phase # ロードマップに新しいフェーズを追加
/gsd-add-phase # ロードマップに新しいフェーズを追加
# または
/gsd:insert-phase 3 # フェーズ 3 と 4 の間に緊急作業を挿入
/gsd-insert-phase 3 # フェーズ 3 と 4 の間に緊急作業を挿入
# または
/gsd:remove-phase 7 # フェーズ 7 をスコープ外にして番号を振り直す
/gsd-remove-phase 7 # フェーズ 7 をスコープ外にして番号を振り直す
```
### マルチプロジェクトワークスペース
@@ -672,18 +672,18 @@ claude --dangerously-skip-permissions
```bash
# モノレポからリポジトリを含むワークスペースを作成
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
# フィーチャーブランチの分離 — 独自の .planning/ を持つ現在のリポジトリのワークツリー
/gsd:new-workspace --name feature-b --repos .
/gsd-new-workspace --name feature-b --repos .
# ワークスペースに移動して GSD を初期化
cd ~/gsd-workspaces/feature-b
/gsd:new-project
/gsd-new-project
# ワークスペースの一覧と管理
/gsd:list-workspaces
/gsd:remove-workspace feature-b
/gsd-list-workspaces
/gsd-remove-workspace feature-b
```
各ワークスペースには以下が含まれます:
@@ -697,15 +697,15 @@ cd ~/gsd-workspaces/feature-b
### 「Project already initialized」
`/gsd:new-project` を実行したが、`.planning/PROJECT.md` が既に存在しています。これは安全チェックです。やり直したい場合は、まず `.planning/` ディレクトリを削除してください。
`/gsd-new-project` を実行したが、`.planning/PROJECT.md` が既に存在しています。これは安全チェックです。やり直したい場合は、まず `.planning/` ディレクトリを削除してください。
### 長時間セッションでのコンテキスト劣化
主要なコマンド間でコンテキストウィンドウをクリアしてください:Claude Code では `/clear` を使用します。GSD はフレッシュなコンテキストを前提に設計されています — すべてのサブエージェントはクリーンな 200K ウィンドウを取得します。メインセッションで品質が低下している場合は、クリアして `/gsd:resume-work` または `/gsd:progress` で状態を復元してください。
主要なコマンド間でコンテキストウィンドウをクリアしてください:Claude Code では `/clear` を使用します。GSD はフレッシュなコンテキストを前提に設計されています — すべてのサブエージェントはクリーンな 200K ウィンドウを取得します。メインセッションで品質が低下している場合は、クリアして `/gsd-resume-work` または `/gsd-progress` で状態を復元してください。
### プランが誤っている、または方向性がずれている
プランニング前に `/gsd:discuss-phase [N]` を実行してください。プランの品質問題のほとんどは、CONTEXT.md があれば防げたはずの前提を Claude が置いてしまうことに起因します。`/gsd:list-phase-assumptions [N]` を使用して、プランにコミットする前に Claude の意図を確認することもできます。
プランニング前に `/gsd-discuss-phase [N]` を実行してください。プランの品質問題のほとんどは、CONTEXT.md があれば防げたはずの前提を Claude が置いてしまうことに起因します。`/gsd-list-phase-assumptions [N]` を使用して、プランにコミットする前に Claude の意図を確認することもできます。
### 実行が失敗する、またはスタブが生成される
@@ -713,15 +713,15 @@ cd ~/gsd-workspaces/feature-b
### 現在地がわからなくなった
`/gsd:progress` を実行してください。すべての状態ファイルを読み込み、現在地と次にやるべきことを正確に教えてくれます。
`/gsd-progress` を実行してください。すべての状態ファイルを読み込み、現在地と次にやるべきことを正確に教えてくれます。
### 実行後に変更が必要
`/gsd:execute-phase` を再実行しないでください。ターゲットを絞った修正には `/gsd:quick` を使用するか、`/gsd:verify-work` で体系的に問題を特定し UAT を通じて修正してください。
`/gsd-execute-phase` を再実行しないでください。ターゲットを絞った修正には `/gsd-quick` を使用するか、`/gsd-verify-work` で体系的に問題を特定し UAT を通じて修正してください。
### モデルのコストが高すぎる
budget プロファイルに切り替えてください:`/gsd:set-profile budget`。ドメインに慣れている場合(またはClaude が慣れている場合)は、`/gsd:settings` でリサーチエージェントと plan-check エージェントを無効にしてください。
budget プロファイルに切り替えてください:`/gsd-set-profile budget`。ドメインに慣れている場合(またはClaude が慣れている場合)は、`/gsd-settings` でリサーチエージェントと plan-check エージェントを無効にしてください。
### 非 Claude ランタイムの使用(Codex、OpenCode、Gemini CLI、Kilo)
@@ -746,19 +746,19 @@ budget プロファイルに切り替えてください:`/gsd:set-profile budg
### 非 Anthropic プロバイダーでの Claude Code の使用(OpenRouter、ローカル)
GSD サブエージェントが Anthropic モデルを呼び出し、OpenRouter やローカルプロバイダーを通じて支払っている場合は、`inherit` プロファイルに切り替えてください:`/gsd:set-profile inherit`。これにより、すべてのエージェントが特定の Anthropic モデルの代わりに現在のセッションモデルを使用します。`/gsd:settings` → モデルプロファイル → Inherit も参照してください。
GSD サブエージェントが Anthropic モデルを呼び出し、OpenRouter やローカルプロバイダーを通じて支払っている場合は、`inherit` プロファイルに切り替えてください:`/gsd-set-profile inherit`。これにより、すべてのエージェントが特定の Anthropic モデルの代わりに現在のセッションモデルを使用します。`/gsd-settings` → モデルプロファイル → Inherit も参照してください。
### 機密/プライベートプロジェクトでの作業
`/gsd:new-project` 時または `/gsd:settings` で `commit_docs: false` を設定してください。`.planning/` を `.gitignore` に追加してください。プランニングアーティファクトはローカルに保持され、git に含まれません。
`/gsd-new-project` 時または `/gsd-settings` で `commit_docs: false` を設定してください。`.planning/` を `.gitignore` に追加してください。プランニングアーティファクトはローカルに保持され、git に含まれません。
### GSD アップデートがローカル変更を上書きした
v1.17 以降、インストーラーはローカルで変更されたファイルを `gsd-local-patches/` にバックアップします。`/gsd:reapply-patches` を実行して変更をマージし直してください。
v1.17 以降、インストーラーはローカルで変更されたファイルを `gsd-local-patches/` にバックアップします。`/gsd-reapply-patches` を実行して変更をマージし直してください。
### ワークフロー診断 (`/gsd:forensics`)
### ワークフロー診断 (`/gsd-forensics`)
ワークフローが明確でない形で失敗した場合 -- プランが存在しないファイルを参照する、実行が予期しない結果を生成する、状態が破損しているように見える -- `/gsd:forensics` を実行して診断レポートを生成してください。
ワークフローが明確でない形で失敗した場合 -- プランが存在しないファイルを参照する、実行が予期しない結果を生成する、状態が破損しているように見える -- `/gsd-forensics` を実行して診断レポートを生成してください。
**チェック内容:**
- Git 履歴の異常(孤立コミット、予期しないブランチ状態、rebase アーティファクト)
@@ -780,7 +780,7 @@ Claude Code の分類バグに対する既知の回避策があります。GSD
All subagent/executor commits MUST use `--no-verify`.
```
並列実行を完全に無効にするには:`/gsd:settings` → `parallelization.enabled` を `false` に設定。
並列実行を完全に無効にするには:`/gsd-settings` → `parallelization.enabled` を `false` に設定。
### Windows:保護されたディレクトリでインストールがクラッシュする
@@ -792,18 +792,18 @@ Windows でインストーラーが `EPERM: operation not permitted, scandir`
| 問題 | 解決策 |
|---------|----------|
| コンテキストの喪失 / 新セッション | `/gsd:resume-work` または `/gsd:progress` |
| コンテキストの喪失 / 新セッション | `/gsd-resume-work` または `/gsd-progress` |
| フェーズが失敗した | フェーズのコミットを `git revert` して再プランニング |
| スコープ変更が必要 | `/gsd:add-phase`、`/gsd:insert-phase`、または `/gsd:remove-phase` |
| マイルストーン監査でギャップを発見 | `/gsd:plan-milestone-gaps` |
| 何かが壊れた | `/gsd:debug "description"` |
| ワークフロー状態が破損している可能性 | `/gsd:forensics` |
| ターゲットを絞った修正 | `/gsd:quick` |
| プランがビジョンに合わない | `/gsd:discuss-phase [N]` で再プランニング |
| コストが高い | `/gsd:set-profile budget` と `/gsd:settings` でエージェントをオフ |
| アップデートがローカル変更を壊した | `/gsd:reapply-patches` |
| ステークホルダー向けセッションサマリーが欲しい | `/gsd:session-report` |
| 次のステップがわからない | `/gsd:next` |
| スコープ変更が必要 | `/gsd-add-phase`、`/gsd-insert-phase`、または `/gsd-remove-phase` |
| マイルストーン監査でギャップを発見 | `/gsd-plan-milestone-gaps` |
| 何かが壊れた | `/gsd-debug "description"` |
| ワークフロー状態が破損している可能性 | `/gsd-forensics` |
| ターゲットを絞った修正 | `/gsd-quick` |
| プランがビジョンに合わない | `/gsd-discuss-phase [N]` で再プランニング |
| コストが高い | `/gsd-set-profile budget` と `/gsd-settings` でエージェントをオフ |
| アップデートがローカル変更を壊した | `/gsd-reapply-patches` |
| ステークホルダー向けセッションサマリーが欲しい | `/gsd-session-report` |
| 次のステップがわからない | `/gsd-next` |
| 並列実行でビルドエラー | GSD を更新するか `parallelization.enabled: false` を設定 |
---
@@ -820,15 +820,15 @@ Windows でインストーラーが `EPERM: operation not permitted, scandir`
STATE.md # 決定事項、ブロッカー、セッションメモリ
config.json # ワークフロー設定
MILESTONES.md # 完了したマイルストーンのアーカイブ
HANDOFF.json # 構造化セッション引き継ぎ(/gsd:pause-work から)
research/ # /gsd:new-project からのドメインリサーチ
reports/ # セッションレポート(/gsd:session-report から)
HANDOFF.json # 構造化セッション引き継ぎ(/gsd-pause-work から)
research/ # /gsd-new-project からのドメインリサーチ
reports/ # セッションレポート(/gsd-session-report から)
todos/
pending/ # 作業待ちのキャプチャされたアイデア
done/ # 完了した TODO
debug/ # アクティブなデバッグセッション
resolved/ # アーカイブされたデバッグセッション
codebase/ # ブラウンフィールドコードベースマッピング(/gsd:map-codebase から)
codebase/ # ブラウンフィールドコードベースマッピング(/gsd-map-codebase から)
phases/
XX-phase-name/
XX-YY-PLAN.md # アトミック実行プラン
@@ -836,7 +836,7 @@ Windows でインストーラーが `EPERM: operation not permitted, scandir`
CONTEXT.md # 実装の好み
RESEARCH.md # エコシステムリサーチの成果
VERIFICATION.md # 実行後の検証結果
XX-UI-SPEC.md # UI デザインコントラクト(/gsd:ui-phase から)
XX-UI-REVIEW.md # ビジュアル監査スコア(/gsd:ui-review から)
ui-reviews/ # /gsd:ui-review からのスクリーンショット(gitignore 対象)
XX-UI-SPEC.md # UI デザインコントラクト(/gsd-ui-phase から)
XX-UI-REVIEW.md # ビジュアル監査スコア(/gsd-ui-review から)
ui-reviews/ # /gsd-ui-review からのスクリーンショット(gitignore 対象)
```

View File

@@ -19,7 +19,7 @@
|--------|------|------------------|
| Normal | > 35% | 警告なし |
| WARNING | <= 35% | 現在のタスクをまとめ、新しい複雑な作業の開始を避ける |
| CRITICAL | <= 25% | 即座に停止し、状態を保存する(`/gsd:pause-work`) |
| CRITICAL | <= 25% | 即座に停止し、状態を保存する(`/gsd-pause-work`) |
## デバウンス
@@ -56,7 +56,7 @@ additionalContext -> エージェントが警告を確認
## GSD との統合
GSD の `/gsd:pause-work` コマンドは実行状態を保存します。WARNING メッセージはこのコマンドの使用を提案し、CRITICAL メッセージは即座の状態保存を指示します。
GSD の `/gsd-pause-work` コマンドは実行状態を保存します。WARNING メッセージはこのコマンドの使用を提案し、CRITICAL メッセージは即座の状態保存を指示します。
## セットアップ

View File

@@ -2,7 +2,7 @@
> **エージェント型ワーカー向け:** 必須サブスキル: superpowers:subagent-driven-development(推奨)または superpowers:executing-plans を使用して、このプランをタスクごとに実装してください。各ステップはチェックボックス(`- [ ]`)構文で進捗を追跡します。
**目標:** `/gsd:new-project` が `.planning/config.json` を作成する際、ユーザーが選択した6つのキーだけでなく、すべての有効なデフォルト値を含むファイルを生成する。これにより、開発者はソースコードを読まなくてもすべての設定を確認できるようになる。
**目標:** `/gsd-new-project` が `.planning/config.json` を作成する際、ユーザーが選択した6つのキーだけでなく、すべての有効なデフォルト値を含むファイルを生成する。これにより、開発者はソースコードを読まなくてもすべての設定を確認できるようになる。
**アーキテクチャ:** `config.cjs` に単一の JS 関数 `buildNewProjectConfig(cwd, userChoices)` を追加し、新規プロジェクトの完全な設定の唯一の信頼できる情報源とする。これを CLI コマンド `config-new-project` として公開する。`new-project.md` ワークフローを更新し、部分的な JSON をインラインで書き込む代わりにこのコマンドを呼び出すようにする。
@@ -316,7 +316,7 @@ function buildNewProjectConfig(cwd, userChoices) {
/**
* コマンド: 新規プロジェクト用の完全展開された .planning/config.json を作成する。
*
* ユーザーが選択した設定を JSON 文字列として受け取る(/gsd:new-project 時に
* ユーザーが選択した設定を JSON 文字列として受け取る(/gsd-new-project 時に
* ユーザーが明示的に設定したキー)。残りのキーはハードコードされたデフォルトと
* オプションの ~/.gsd/defaults.json から補完される。
*
@@ -661,7 +661,7 @@ node --test tests/ 2>&1 | grep -E "pass|fail|error" | tail -5
feat: materialize all config defaults at new-project initialization
**問題:**
`/gsd:new-project` はオンボーディング時にユーザーが明示的に選択した6つのキーのみで
`/gsd-new-project` はオンボーディング時にユーザーが明示的に選択した6つのキーのみで
`.planning/config.json` を作成する。5つの追加キー
(`search_gitignored`、`brave_search`、`git.branching_strategy`、
`git.phase_branch_template`、`git.milestone_branch_template`)は実行時に
@@ -670,7 +670,7 @@ feat: materialize all config defaults at new-project initialization
これにより2つの問題が生じる:
1. **発見可能性**: ユーザーがソースコードを読まない限り `git.branching_strategy` を
確認・理解できない — 設定ファイルに表示されない。
2. **暗黙的な拡張**: `/gsd:settings` や `config-set` が初めて設定に書き込む際にも、
2. **暗黙的な拡張**: `/gsd-settings` や `config-set` が初めて設定に書き込む際にも、
これらのキーは追加されない。設定ファイルは実効設定のごく一部しか反映しない。
**解決策:**

View File

@@ -1,4 +1,4 @@
# マルチプロジェクトワークスペース (`/gsd:new-workspace`)
# マルチプロジェクトワークスペース (`/gsd-new-workspace`)
**Issue:** #1241
**Date:** 2026-03-20
@@ -18,13 +18,13 @@ GSD は作業ディレクトリごとに1つの `.planning/` ディレクトリ
## コマンド
### `/gsd:new-workspace`
### `/gsd-new-workspace`
リポジトリのコピーと独自の `.planning/` を持つワークスペースディレクトリを作成します。
```
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI --path ~/workspaces/feature-b
/gsd:new-workspace --name feature-b --repos . --strategy worktree # same-repo isolation
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI --path ~/workspaces/feature-b
/gsd-new-workspace --name feature-b --repos . --strategy worktree # same-repo isolation
```
**引数:**
@@ -38,11 +38,11 @@ GSD は作業ディレクトリごとに1つの `.planning/` ディレクトリ
| `--branch` | いいえ | `workspace/<name>` | チェックアウトするブランチ |
| `--auto` | いいえ | false | 対話的な質問をスキップし、デフォルト値を使用 |
### `/gsd:list-workspaces`
### `/gsd-list-workspaces`
`~/gsd-workspaces/*/WORKSPACE.md` をスキャンしてワークスペースマニフェストを検索します。名前、パス、リポジトリ数、GSD ステータス(PROJECT.md の有無、現在のフェーズ)をテーブル形式で表示します。
### `/gsd:remove-workspace`
### `/gsd-remove-workspace`
確認後にワークスペースディレクトリを削除します。worktree 戦略の場合、まず各メンバーリポジトリに対して `git worktree remove` を実行します。コミットされていない変更があるリポジトリがある場合は削除を拒否します。
@@ -52,7 +52,7 @@ GSD は作業ディレクトリごとに1つの `.planning/` ディレクトリ
~/gsd-workspaces/feature-b/ # workspace root
├── WORKSPACE.md # manifest
├── .planning/ # independent GSD planning directory
│ ├── PROJECT.md # (if user ran /gsd:new-project)
│ ├── PROJECT.md # (if user ran /gsd-new-project)
│ ├── STATE.md
│ └── config.json
├── hr-ui/ # git worktree of source repo
@@ -89,7 +89,7 @@ Strategy: worktree
## ワークフロー
### `/gsd:new-workspace` のワークフロー手順
### `/gsd-new-workspace` のワークフロー手順
1. **セットアップ** — `init new-workspace` を呼び出し、JSON コンテキストを解析する
2. **入力の収集** — `--name`/`--repos`/`--path` が指定されていない場合、対話的に質問する。リポジトリの選択時は、カレントディレクトリ内の子 `.git` ディレクトリを選択肢として表示する
@@ -100,7 +100,7 @@ Strategy: worktree
- Clone: `git clone <source> <workspace>/<repo-name>`
6. **WORKSPACE.md の書き込み** — ソースパス、戦略、ブランチを含むマニフェスト
7. **.planning/ の初期化** — `mkdir -p <workspace>/.planning`
8. **/gsd:new-project の提案** — 新しいワークスペースでプロジェクト初期化を実行するか確認する
8. **/gsd-new-project の提案** — 新しいワークスペースでプロジェクト初期化を実行するか確認する
9. **コミット** — commit_docs が有効な場合、WORKSPACE.md のアトミックコミット
10. **完了** — ワークスペースのパスと次のステップを表示する