merge: sync main into PR #3114 and keep canonical next/profile commands
This commit is contained in:
Tom Boucher
@@ -411,7 +411,7 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
│ ├── pending/ # キャプチャされたアイデア
|
||||
│ └── done/ # 完了済みtodo
|
||||
├── threads/ # 永続コンテキストスレッド（/gsd-thread から）
|
||||
├── seeds/ # 将来に向けたアイデア（/gsd-plant-seed から）
|
||||
├── seeds/ # 将来に向けたアイデア（/gsd-capture --seed から）
|
||||
├── debug/ # アクティブなデバッグセッション
|
||||
│ ├── *.md # アクティブセッション
|
||||
│ ├── resolved/ # アーカイブ済みセッション
|
||||
|
||||
@@ -59,7 +59,7 @@
|
||||
|
||||
---
|
||||
|
||||
### `/gsd-list-workspaces`
|
||||
### `/gsd-workspace --list`
|
||||
|
||||
アクティブなGSDワークスペースとそのステータスを一覧表示します。
|
||||
|
||||
@@ -67,12 +67,12 @@
|
||||
**表示内容:** 名前、リポジトリ数、戦略、GSDプロジェクトのステータス
|
||||
|
||||
```bash
|
||||
/gsd-list-workspaces
|
||||
/gsd-workspace --list
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd-remove-workspace`
|
||||
### `/gsd-workspace --remove`
|
||||
|
||||
ワークスペースを削除し、git worktreeをクリーンアップします。
|
||||
|
||||
@@ -83,7 +83,7 @@
|
||||
**安全性:** コミットされていない変更があるリポジトリの削除を拒否します。名前の確認が必要です。
|
||||
|
||||
```bash
|
||||
/gsd-remove-workspace feature-b
|
||||
/gsd-workspace --remove feature-b
|
||||
```
|
||||
|
||||
---
|
||||
@@ -368,15 +368,15 @@
|
||||
|
||||
## フェーズ管理コマンド
|
||||
|
||||
### `/gsd-add-phase`
|
||||
### `/gsd-phase`
|
||||
|
||||
ロードマップに新しいフェーズを追加します。
|
||||
|
||||
```bash
|
||||
/gsd-add-phase # 対話型 — フェーズの説明を入力
|
||||
/gsd-phase # 対話型 — フェーズの説明を入力
|
||||
```
|
||||
|
||||
### `/gsd-insert-phase`
|
||||
### `/gsd-phase --insert`
|
||||
|
||||
小数番号を使用して、フェーズ間に緊急の作業を挿入します。
|
||||
|
||||
@@ -385,10 +385,10 @@
|
||||
| `N` | いいえ | このフェーズ番号の後に挿入 |
|
||||
|
||||
```bash
|
||||
/gsd-insert-phase 3 # フェーズ3と4の間に挿入 → 3.1を作成
|
||||
/gsd-phase --insert 3 # フェーズ3と4の間に挿入 → 3.1を作成
|
||||
```
|
||||
|
||||
### `/gsd-remove-phase`
|
||||
### `/gsd-phase --remove`
|
||||
|
||||
将来のフェーズを削除し、後続のフェーズの番号を振り直します。
|
||||
|
||||
@@ -397,7 +397,7 @@
|
||||
| `N` | いいえ | 削除するフェーズ番号 |
|
||||
|
||||
```bash
|
||||
/gsd-remove-phase 7 # フェーズ7を削除、8→7、9→8等に番号振り直し
|
||||
/gsd-phase --remove 7 # フェーズ7を削除、8→7、9→8等に番号振り直し
|
||||
```
|
||||
|
||||
### `/gsd-list-phase-assumptions`
|
||||
@@ -591,7 +591,7 @@ GSDの保証付きでアドホックタスクを実行します。
|
||||
/gsd-debug --diagnose "API returning 500 on /users endpoint"
|
||||
```
|
||||
|
||||
### `/gsd-add-todo`
|
||||
### `/gsd-capture`
|
||||
|
||||
後で取り組むアイデアやタスクをキャプチャします。
|
||||
|
||||
@@ -600,7 +600,7 @@ GSDの保証付きでアドホックタスクを実行します。
|
||||
| `description` | いいえ | Todoの説明 |
|
||||
|
||||
```bash
|
||||
/gsd-add-todo "Consider adding dark mode support"
|
||||
/gsd-capture "Consider adding dark mode support"
|
||||
```
|
||||
|
||||
### `/gsd-capture --list`
|
||||
@@ -745,7 +745,7 @@ Claude Codeのセッション分析から8つの次元（コミュニケーシ
|
||||
/gsd-settings # 対話型設定
|
||||
```
|
||||
|
||||
### `/gsd-set-profile`
|
||||
### `/gsd-config --profile`
|
||||
|
||||
クイックプロファイル切り替え。
|
||||
|
||||
@@ -754,8 +754,8 @@ Claude Codeのセッション分析から8つの次元（コミュニケーシ
|
||||
| `profile` | **はい** | `quality`、`balanced`、`budget`、または `inherit` |
|
||||
|
||||
```bash
|
||||
/gsd-set-profile budget # budgetプロファイルに切り替え
|
||||
/gsd-set-profile quality # qualityプロファイルに切り替え
|
||||
/gsd-config --profile budget # budgetプロファイルに切り替え
|
||||
/gsd-config --profile quality # qualityプロファイルに切り替え
|
||||
```
|
||||
|
||||
---
|
||||
@@ -878,7 +878,7 @@ GSDアップデート後にローカルの変更を復元します。
|
||||
|
||||
## バックログ＆スレッドコマンド
|
||||
|
||||
### `/gsd-add-backlog`
|
||||
### `/gsd-capture --backlog`
|
||||
|
||||
999.x番号付けを使用して、バックログのパーキングロットにアイデアを追加します。
|
||||
|
||||
@@ -889,8 +889,8 @@ GSDアップデート後にローカルの変更を復元します。
|
||||
**999.x番号付け**により、バックログ項目はアクティブなフェーズシーケンスの外に保持されます。フェーズディレクトリは即座に作成されるため、`/gsd-discuss-phase` や `/gsd-plan-phase` がそれらに対して動作します。
|
||||
|
||||
```bash
|
||||
/gsd-add-backlog "GraphQL API layer"
|
||||
/gsd-add-backlog "Mobile responsive redesign"
|
||||
/gsd-capture --backlog "GraphQL API layer"
|
||||
/gsd-capture --backlog "Mobile responsive redesign"
|
||||
```
|
||||
|
||||
---
|
||||
@@ -907,7 +907,7 @@ GSDアップデート後にローカルの変更を復元します。
|
||||
|
||||
---
|
||||
|
||||
### `/gsd-plant-seed`
|
||||
### `/gsd-capture --seed`
|
||||
|
||||
トリガー条件付きの将来のアイデアをキャプチャ — 適切なマイルストーンで自動的に表面化します。
|
||||
|
||||
@@ -921,7 +921,7 @@ GSDアップデート後にローカルの変更を復元します。
|
||||
**利用先:** `/gsd-new-milestone`（シードをスキャンしてマッチするものを提示）
|
||||
|
||||
```bash
|
||||
/gsd-plant-seed "Add real-time collaboration when WebSocket infra is in place"
|
||||
/gsd-capture --seed "Add real-time collaboration when WebSocket infra is in place"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@@ -393,7 +393,7 @@
|
||||
|
||||
### 9. フェーズ管理
|
||||
|
||||
**コマンド:** `/gsd-add-phase`、`/gsd-insert-phase [N]`、`/gsd-remove-phase [N]`
|
||||
**コマンド:** `/gsd-phase`、`/gsd-phase --insert [N]`、`/gsd-phase --remove [N]`
|
||||
|
||||
**目的:** 開発中のロードマップの動的な変更。
|
||||
|
||||
@@ -680,7 +680,7 @@
|
||||
|
||||
### 26. モデルプロファイル
|
||||
|
||||
**コマンド:** `/gsd-set-profile <quality|balanced|budget|inherit>`
|
||||
**コマンド:** `/gsd-config --profile <quality|balanced|budget|inherit>`
|
||||
|
||||
**目的:** 各エージェントが使用する AI モデルを制御し、品質とコストのバランスを取ります。
|
||||
|
||||
@@ -762,7 +762,7 @@
|
||||
|
||||
### 29. Todo 管理
|
||||
|
||||
**コマンド:** `/gsd-add-todo [desc]`、`/gsd-capture --list`
|
||||
**コマンド:** `/gsd-capture [desc]`、`/gsd-capture --list`
|
||||
|
||||
**目的:** セッション中にアイデアやタスクをキャプチャし、後で作業できるようにします。
|
||||
|
||||
@@ -1065,7 +1065,7 @@ fix(03-01): correct auth token expiry
|
||||
|
||||
### 43. バックログパーキングロット
|
||||
|
||||
**コマンド:** `/gsd-add-backlog <description>`、`/gsd-review-backlog`、`/gsd-plant-seed <idea>`
|
||||
**コマンド:** `/gsd-capture --backlog <description>`、`/gsd-review-backlog`、`/gsd-capture --seed <idea>`
|
||||
|
||||
**目的:** アクティブなプランニングの準備ができていないアイデアをキャプチャします。バックログ項目は 999.x の番号付けを使用して、アクティブなフェーズシーケンスの外に留まります。シードは、適切なマイルストーンで自動的に表面化するトリガー条件を持つ、将来を見据えたアイデアです。
|
||||
|
||||
|
||||
@@ -18,7 +18,7 @@ Get Shit Done（GSD）フレームワークの包括的なドキュメントで
|
||||
|
||||
## クイックリンク
|
||||
|
||||
- **v1.39 の新機能:** `--minimal` インストールプロファイル（≥94% コールドスタート削減）、`/gsd-edit-phase`、マージ後ビルド & テストゲート、`review.models.<cli>` ランタイム別レビューモデル、ワークストリーム設定の継承、手動カナリアリリースワークフロー、スキル統合（86 → 59）
|
||||
- **v1.39 の新機能:** `--minimal` インストールプロファイル（≥94% コールドスタート削減）、`/gsd-phase --edit`、マージ後ビルド & テストゲート、`review.models.<cli>` ランタイム別レビューモデル、ワークストリーム設定の継承、手動カナリアリリースワークフロー、スキル統合（86 → 59）
|
||||
- **はじめに:** [README](../README.md) → インストール → `/gsd-new-project`
|
||||
- **ワークフロー完全ガイド:** [ユーザーガイド](USER-GUIDE.md)
|
||||
- **コマンド一覧:** [コマンドリファレンス](COMMANDS.md)
|
||||
|
||||
@@ -256,8 +256,8 @@ 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-capture --backlog "GraphQL API layer" # Creates 999.1-graphql-api-layer/
|
||||
/gsd-capture --backlog "Mobile responsive" # Creates 999.2-mobile-responsive/
|
||||
```
|
||||
|
||||
バックログアイテムは完全なフェーズディレクトリを取得するため、`/gsd-discuss-phase 999.1` でアイデアをさらに探索したり、準備が整ったら `/gsd-plan-phase 999.1` を使用できます。
|
||||
@@ -269,7 +269,7 @@ React/Next.js/Vite プロジェクトの場合、UI リサーチャーは `compo
|
||||
シードは、トリガー条件を持つ将来を見据えたアイデアです。バックログアイテムとは異なり、適切なマイルストーンが到来すると自動的に表面化されます。
|
||||
|
||||
```
|
||||
/gsd-plant-seed "Add real-time collab when WebSocket infra is in place"
|
||||
/gsd-capture --seed "Add real-time collab when WebSocket infra is in place"
|
||||
```
|
||||
|
||||
シードは完全な WHY と表面化タイミングを保持します。`/gsd-new-milestone` はすべてのシードをスキャンし、一致するものを提示します。
|
||||
@@ -288,7 +288,7 @@ React/Next.js/Vite プロジェクトの場合、UI リサーチャーは `compo
|
||||
|
||||
スレッドは `/gsd-pause-work` より軽量です — フェーズ状態やプランコンテキストはありません。各スレッドファイルには Goal、Context、References、Next Steps セクションが含まれます。
|
||||
|
||||
スレッドは成熟した段階でフェーズ (`/gsd-add-phase`) やバックログアイテム (`/gsd-add-backlog`) にプロモーションできます。
|
||||
スレッドは成熟した段階でフェーズ (`/gsd-phase`) やバックログアイテム (`/gsd-capture --backlog`) にプロモーションできます。
|
||||
|
||||
**保存場所：** `.planning/threads/{slug}.md`
|
||||
|
||||
@@ -413,9 +413,9 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ
|
||||
|
||||
| コマンド | 用途 | 使用タイミング |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd-add-phase` | ロードマップに新しいフェーズを追加 | 初期プランニング後にスコープが拡大した場合 |
|
||||
| `/gsd-insert-phase [N]` | 緊急作業を挿入（小数番号） | マイルストーン中の緊急修正 |
|
||||
| `/gsd-remove-phase [N]` | 将来のフェーズを削除して番号を振り直す | 機能のスコープ縮小 |
|
||||
| `/gsd-phase` | ロードマップに新しいフェーズを追加 | 初期プランニング後にスコープが拡大した場合 |
|
||||
| `/gsd-phase --insert [N]` | 緊急作業を挿入（小数番号） | マイルストーン中の緊急修正 |
|
||||
| `/gsd-phase --remove [N]` | 将来のフェーズを削除して番号を振り直す | 機能のスコープ縮小 |
|
||||
| `/gsd-list-phase-assumptions [N]` | Claude の意図するアプローチをプレビュー | プランニング前に方向性を確認 |
|
||||
| `/gsd-plan-phase --research-phase [N]` | エコシステムの深いリサーチのみ | 複雑または不慣れなドメイン |
|
||||
|
||||
@@ -427,10 +427,10 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ
|
||||
| `/gsd-quick` | GSD 保証付きのアドホックタスク | バグ修正、小機能、設定変更 |
|
||||
| `/gsd-debug [desc]` | 永続状態を持つ体系的デバッグ | 何かが壊れた時 |
|
||||
| `/gsd-forensics` | ワークフロー障害の診断レポート | 状態、アーティファクト、git 履歴が破損していると思われる場合 |
|
||||
| `/gsd-add-todo [desc]` | 後でやるアイデアを記録 | セッション中にアイデアが浮かんだ時 |
|
||||
| `/gsd-capture [desc]` | 後でやるアイデアを記録 | セッション中にアイデアが浮かんだ時 |
|
||||
| `/gsd-capture --list` | 保留中の TODO を一覧表示 | 記録したアイデアのレビュー |
|
||||
| `/gsd-settings` | ワークフロートグルとモデルプロファイルを設定 | モデル変更、エージェントのトグル |
|
||||
| `/gsd-set-profile <profile>` | クイックプロファイル切り替え | コスト/品質トレードオフの変更 |
|
||||
| `/gsd-config --profile <profile>` | クイックプロファイル切り替え | コスト/品質トレードオフの変更 |
|
||||
| `/gsd-update --reapply` | アップデート後にローカル変更を復元 | ローカル編集がある場合の `/gsd-update` 後 |
|
||||
|
||||
### コード品質とレビュー
|
||||
@@ -445,9 +445,9 @@ GSD はマークダウンファイルを生成し、それが LLM のシステ
|
||||
|
||||
| コマンド | 用途 | 使用タイミング |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd-add-backlog <desc>` | バックログパーキングロットにアイデアを追加（999.x） | アクティブなプランニングの準備ができていないアイデア |
|
||||
| `/gsd-capture --backlog <desc>` | バックログパーキングロットにアイデアを追加（999.x） | アクティブなプランニングの準備ができていないアイデア |
|
||||
| `/gsd-review-backlog` | バックログアイテムのプロモーション/保持/削除 | 新マイルストーン前の優先順位付け |
|
||||
| `/gsd-plant-seed <idea>` | トリガー条件付きの将来を見据えたアイデア | 将来のマイルストーンで表面化すべきアイデア |
|
||||
| `/gsd-capture --seed <idea>` | トリガー条件付きの将来を見据えたアイデア | 将来のマイルストーンで表面化すべきアイデア |
|
||||
| `/gsd-thread [name]` | 永続コンテキストスレッド | フェーズ構造外のクロスセッション作業 |
|
||||
|
||||
---
|
||||
@@ -657,11 +657,11 @@ claude --dangerously-skip-permissions
|
||||
### マイルストーン中のスコープ変更
|
||||
|
||||
```bash
|
||||
/gsd-add-phase # ロードマップに新しいフェーズを追加
|
||||
/gsd-phase # ロードマップに新しいフェーズを追加
|
||||
# または
|
||||
/gsd-insert-phase 3 # フェーズ 3 と 4 の間に緊急作業を挿入
|
||||
/gsd-phase --insert 3 # フェーズ 3 と 4 の間に緊急作業を挿入
|
||||
# または
|
||||
/gsd-remove-phase 7 # フェーズ 7 をスコープ外にして番号を振り直す
|
||||
/gsd-phase --remove 7 # フェーズ 7 をスコープ外にして番号を振り直す
|
||||
```
|
||||
|
||||
### マルチプロジェクトワークスペース
|
||||
@@ -680,8 +680,8 @@ cd ~/gsd-workspaces/feature-b
|
||||
/gsd-new-project
|
||||
|
||||
# ワークスペースの一覧と管理
|
||||
/gsd-list-workspaces
|
||||
/gsd-remove-workspace feature-b
|
||||
/gsd-workspace --list
|
||||
/gsd-workspace --remove feature-b
|
||||
```
|
||||
|
||||
各ワークスペースには以下が含まれます：
|
||||
@@ -719,7 +719,7 @@ cd ~/gsd-workspaces/feature-b
|
||||
|
||||
### モデルのコストが高すぎる
|
||||
|
||||
budget プロファイルに切り替えてください：`/gsd-set-profile budget`。ドメインに慣れている場合（またはClaude が慣れている場合）は、`/gsd-settings` でリサーチエージェントと plan-check エージェントを無効にしてください。
|
||||
budget プロファイルに切り替えてください：`/gsd-config --profile budget`。ドメインに慣れている場合（またはClaude が慣れている場合）は、`/gsd-settings` でリサーチエージェントと plan-check エージェントを無効にしてください。
|
||||
|
||||
### 非 Claude ランタイムの使用（Codex、OpenCode、Gemini CLI、Kilo）
|
||||
|
||||
@@ -744,7 +744,7 @@ 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-config --profile inherit`。これにより、すべてのエージェントが特定の Anthropic モデルの代わりに現在のセッションモデルを使用します。`/gsd-settings` → モデルプロファイル → Inherit も参照してください。
|
||||
|
||||
### 機密/プライベートプロジェクトでの作業
|
||||
|
||||
@@ -792,12 +792,12 @@ Windows でインストーラーが `EPERM: operation not permitted, scandir`
|
||||
|---------|----------|
|
||||
| コンテキストの喪失 / 新セッション | `/gsd-resume-work` または `/gsd-progress` |
|
||||
| フェーズが失敗した | フェーズのコミットを `git revert` して再プランニング |
|
||||
| スコープ変更が必要 | `/gsd-add-phase`、`/gsd-insert-phase`、または `/gsd-remove-phase` |
|
||||
| スコープ変更が必要 | `/gsd-phase`、`/gsd-phase --insert`、または `/gsd-phase --remove` |
|
||||
| 何かが壊れた | `/gsd-debug "description"` |
|
||||
| ワークフロー状態が破損している可能性 | `/gsd-forensics` |
|
||||
| ターゲットを絞った修正 | `/gsd-quick` |
|
||||
| プランがビジョンに合わない | `/gsd-discuss-phase [N]` で再プランニング |
|
||||
| コストが高い | `/gsd-set-profile budget` と `/gsd-settings` でエージェントをオフ |
|
||||
| コストが高い | `/gsd-config --profile budget` と `/gsd-settings` でエージェントをオフ |
|
||||
| アップデートがローカル変更を壊した | `/gsd-update --reapply` |
|
||||
| ステークホルダー向けセッションサマリーが欲しい | `/gsd-session-report` |
|
||||
| 次のステップがわからない | `/gsd-progress --next` |
|
||||
|
||||
Reference in New Issue
Block a user