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
174
README.ja-JP.md
174
README.ja-JP.md
@@ -90,12 +90,12 @@ npx get-shit-done-cc@latest
|
||||
2. **インストール先** — グローバル（全プロジェクト）またはローカル（現在のプロジェクトのみ）
|
||||
|
||||
確認方法：
|
||||
- Claude Code / Gemini: `/gsd:help`
|
||||
- Claude Code / Gemini: `/gsd-help`
|
||||
- OpenCode: `/gsd-help`
|
||||
- Kilo: `/gsd-help`
|
||||
- Codex: `$gsd-help`
|
||||
- Copilot: `/gsd:help`
|
||||
- Antigravity: `/gsd:help`
|
||||
- Copilot: `/gsd-help`
|
||||
- Antigravity: `/gsd-help`
|
||||
|
||||
> [!NOTE]
|
||||
> Codexのインストールでは、カスタムプロンプトではなくスキル（`skills/gsd-*/SKILL.md`）を使用します。
|
||||
@@ -214,12 +214,12 @@ claude --dangerously-skip-permissions
|
||||
|
||||
## 仕組み
|
||||
|
||||
> **既存のコードがある場合は？** まず `/gsd:map-codebase` を実行してください。並列エージェントが起動し、スタック、アーキテクチャ、規約、懸念点を分析します。その後 `/gsd:new-project` がコードベースを把握した状態で動作し、質問は追加する内容に焦点を当て、計画時にはパターンが自動的に読み込まれます。
|
||||
> **既存のコードがある場合は？** まず `/gsd-map-codebase` を実行してください。並列エージェントが起動し、スタック、アーキテクチャ、規約、懸念点を分析します。その後 `/gsd-new-project` がコードベースを把握した状態で動作し、質問は追加する内容に焦点を当て、計画時にはパターンが自動的に読み込まれます。
|
||||
|
||||
### 1. プロジェクトの初期化
|
||||
|
||||
```
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
1つのコマンド、1つのフロー。システムが以下を行います：
|
||||
@@ -238,7 +238,7 @@ claude --dangerously-skip-permissions
|
||||
### 2. フェーズの議論
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 1
|
||||
/gsd-discuss-phase 1
|
||||
```
|
||||
|
||||
**ここで実装の方向性を決めます。**
|
||||
@@ -261,14 +261,14 @@ claude --dangerously-skip-permissions
|
||||
|
||||
**作成されるファイル：** `{phase_num}-CONTEXT.md`
|
||||
|
||||
> **前提モード：** 質問よりもコードベース分析を優先したい場合は、`/gsd:settings` で `workflow.discuss_mode` を `assumptions` に設定してください。システムがコードを読み、何をなぜそうするかを提示し、間違っている部分だけ修正を求めます。詳しくは[ディスカスモード](docs/ja-JP/workflow-discuss-mode.md)をご覧ください。
|
||||
> **前提モード：** 質問よりもコードベース分析を優先したい場合は、`/gsd-settings` で `workflow.discuss_mode` を `assumptions` に設定してください。システムがコードを読み、何をなぜそうするかを提示し、間違っている部分だけ修正を求めます。詳しくは[ディスカスモード](docs/ja-JP/workflow-discuss-mode.md)をご覧ください。
|
||||
|
||||
---
|
||||
|
||||
### 3. フェーズの計画
|
||||
|
||||
```
|
||||
/gsd:plan-phase 1
|
||||
/gsd-plan-phase 1
|
||||
```
|
||||
|
||||
システムが以下を行います：
|
||||
@@ -286,7 +286,7 @@ claude --dangerously-skip-permissions
|
||||
### 4. フェーズの実行
|
||||
|
||||
```
|
||||
/gsd:execute-phase 1
|
||||
/gsd-execute-phase 1
|
||||
```
|
||||
|
||||
システムが以下を行います：
|
||||
@@ -337,7 +337,7 @@ claude --dangerously-skip-permissions
|
||||
### 5. 作業の検証
|
||||
|
||||
```
|
||||
/gsd:verify-work 1
|
||||
/gsd-verify-work 1
|
||||
```
|
||||
|
||||
**ここで実際に動作するか確認します。**
|
||||
@@ -351,7 +351,7 @@ claude --dangerously-skip-permissions
|
||||
3. **障害を自動診断** — デバッグエージェントが起動し根本原因を特定
|
||||
4. **検証済みの修正プランを作成** — 即座に再実行可能
|
||||
|
||||
すべてパスすれば次に進みます。何か壊れていれば、手動でデバッグする必要はありません — 作成された修正プランで `/gsd:execute-phase` を再度実行するだけです。
|
||||
すべてパスすれば次に進みます。何か壊れていれば、手動でデバッグする必要はありません — 作成された修正プランで `/gsd-execute-phase` を再度実行するだけです。
|
||||
|
||||
**作成されるファイル：** `{phase_num}-UAT.md`、問題が見つかった場合は修正プラン
|
||||
|
||||
@@ -360,38 +360,38 @@ claude --dangerously-skip-permissions
|
||||
### 6. 繰り返し → シップ → 完了 → 次のマイルストーン
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 2
|
||||
/gsd:plan-phase 2
|
||||
/gsd:execute-phase 2
|
||||
/gsd:verify-work 2
|
||||
/gsd:ship 2 # 検証済みの作業からPRを作成
|
||||
/gsd-discuss-phase 2
|
||||
/gsd-plan-phase 2
|
||||
/gsd-execute-phase 2
|
||||
/gsd-verify-work 2
|
||||
/gsd-ship 2 # 検証済みの作業からPRを作成
|
||||
...
|
||||
/gsd:complete-milestone
|
||||
/gsd:new-milestone
|
||||
/gsd-complete-milestone
|
||||
/gsd-new-milestone
|
||||
```
|
||||
|
||||
またはGSDに次のステップを自動判定させます：
|
||||
|
||||
```
|
||||
/gsd:next # 次のステップを自動検出して実行
|
||||
/gsd-next # 次のステップを自動検出して実行
|
||||
```
|
||||
|
||||
**discuss → plan → execute → verify → ship** のループをマイルストーン完了まで繰り返します。
|
||||
|
||||
ディスカッション中のインプットを速くしたい場合は、`/gsd:discuss-phase <n> --batch` で1つずつではなく小さなグループにまとめた質問に一括で回答できます。`--chain` を使うと、ディスカッションからプラン+実行まで途中で止まらずに自動チェインできます。
|
||||
ディスカッション中のインプットを速くしたい場合は、`/gsd-discuss-phase <n> --batch` で1つずつではなく小さなグループにまとめた質問に一括で回答できます。`--chain` を使うと、ディスカッションからプラン+実行まで途中で止まらずに自動チェインできます。
|
||||
|
||||
各フェーズであなたのインプット（discuss）、適切なリサーチ（plan）、クリーンな実行（execute）、人間による検証（verify）が行われます。コンテキストは常にフレッシュ。品質は常に高い。
|
||||
|
||||
すべてのフェーズが完了したら、`/gsd:complete-milestone` でマイルストーンをアーカイブしリリースをタグ付けします。
|
||||
すべてのフェーズが完了したら、`/gsd-complete-milestone` でマイルストーンをアーカイブしリリースをタグ付けします。
|
||||
|
||||
次に `/gsd:new-milestone` で次のバージョンを開始します — `new-project` と同じフローですが既存のコードベース向けです。次に構築したいものを説明し、システムがドメインを調査し、要件をスコーピングし、新しいロードマップを作成します。各マイルストーンはクリーンなサイクルです：定義 → 構築 → シップ。
|
||||
次に `/gsd-new-milestone` で次のバージョンを開始します — `new-project` と同じフローですが既存のコードベース向けです。次に構築したいものを説明し、システムがドメインを調査し、要件をスコーピングし、新しいロードマップを作成します。各マイルストーンはクリーンなサイクルです：定義 → 構築 → シップ。
|
||||
|
||||
---
|
||||
|
||||
### クイックモード
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
```
|
||||
|
||||
**フル計画が不要なアドホックタスク向け。**
|
||||
@@ -413,7 +413,7 @@ claude --dangerously-skip-permissions
|
||||
フラグは組み合わせ可能：`--discuss --research --validate` でディスカッション + リサーチ + プランチェック + 検証が行われます。
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> What do you want to do? "Add dark mode toggle to settings"
|
||||
```
|
||||
|
||||
@@ -515,117 +515,117 @@ lmn012o feat(08-02): create registration endpoint
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:new-project [--auto]` | フル初期化：質問 → リサーチ → 要件定義 → ロードマップ |
|
||||
| `/gsd:discuss-phase [N] [--auto] [--analyze] [--chain]` | 計画前に実装の決定事項をキャプチャ（`--analyze` でトレードオフ分析を追加、`--chain` でプラン+実行へ自動チェイン） |
|
||||
| `/gsd:plan-phase [N] [--auto] [--reviews]` | フェーズのリサーチ + プラン + 検証（`--reviews` でコードベースレビューの発見事項を読み込み） |
|
||||
| `/gsd:execute-phase <N>` | 全プランを並列ウェーブで実行し、完了時に検証 |
|
||||
| `/gsd:verify-work [N]` | 手動ユーザー受入テスト ¹ |
|
||||
| `/gsd:ship [N] [--draft]` | 検証済みのフェーズ作業から自動生成された本文付きのPRを作成 |
|
||||
| `/gsd:next` | 次の論理的なワークフローステップに自動的に進む |
|
||||
| `/gsd:fast <text>` | インラインの軽微タスク — 計画を完全にスキップし即座に実行 |
|
||||
| `/gsd:audit-milestone` | マイルストーンが完了の定義を達成したか検証 |
|
||||
| `/gsd:complete-milestone` | マイルストーンをアーカイブし、リリースをタグ付け |
|
||||
| `/gsd:new-milestone [name]` | 次のバージョンを開始：質問 → リサーチ → 要件定義 → ロードマップ |
|
||||
| `/gsd:forensics [desc]` | 失敗したワークフロー実行の事後分析（停止ループ、欠落成果物、git異常の診断） |
|
||||
| `/gsd:milestone-summary [version]` | チームオンボーディングとレビュー向けの包括的なプロジェクトサマリーを生成 |
|
||||
| `/gsd-new-project [--auto]` | フル初期化：質問 → リサーチ → 要件定義 → ロードマップ |
|
||||
| `/gsd-discuss-phase [N] [--auto] [--analyze] [--chain]` | 計画前に実装の決定事項をキャプチャ（`--analyze` でトレードオフ分析を追加、`--chain` でプラン+実行へ自動チェイン） |
|
||||
| `/gsd-plan-phase [N] [--auto] [--reviews]` | フェーズのリサーチ + プラン + 検証（`--reviews` でコードベースレビューの発見事項を読み込み） |
|
||||
| `/gsd-execute-phase <N>` | 全プランを並列ウェーブで実行し、完了時に検証 |
|
||||
| `/gsd-verify-work [N]` | 手動ユーザー受入テスト ¹ |
|
||||
| `/gsd-ship [N] [--draft]` | 検証済みのフェーズ作業から自動生成された本文付きのPRを作成 |
|
||||
| `/gsd-next` | 次の論理的なワークフローステップに自動的に進む |
|
||||
| `/gsd-fast <text>` | インラインの軽微タスク — 計画を完全にスキップし即座に実行 |
|
||||
| `/gsd-audit-milestone` | マイルストーンが完了の定義を達成したか検証 |
|
||||
| `/gsd-complete-milestone` | マイルストーンをアーカイブし、リリースをタグ付け |
|
||||
| `/gsd-new-milestone [name]` | 次のバージョンを開始：質問 → リサーチ → 要件定義 → ロードマップ |
|
||||
| `/gsd-forensics [desc]` | 失敗したワークフロー実行の事後分析（停止ループ、欠落成果物、git異常の診断） |
|
||||
| `/gsd-milestone-summary [version]` | チームオンボーディングとレビュー向けの包括的なプロジェクトサマリーを生成 |
|
||||
|
||||
### ワークストリーム
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:workstreams list` | 全ワークストリームとそのステータスを表示 |
|
||||
| `/gsd:workstreams create <name>` | 並列マイルストーン作業用の名前空間付きワークストリームを作成 |
|
||||
| `/gsd:workstreams switch <name>` | アクティブなワークストリームを切り替え |
|
||||
| `/gsd:workstreams complete <name>` | ワークストリームを完了しマージ |
|
||||
| `/gsd-workstreams list` | 全ワークストリームとそのステータスを表示 |
|
||||
| `/gsd-workstreams create <name>` | 並列マイルストーン作業用の名前空間付きワークストリームを作成 |
|
||||
| `/gsd-workstreams switch <name>` | アクティブなワークストリームを切り替え |
|
||||
| `/gsd-workstreams complete <name>` | ワークストリームを完了しマージ |
|
||||
|
||||
### マルチプロジェクトワークスペース
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:new-workspace` | リポジトリのコピー（worktreeまたはクローン）で隔離されたワークスペースを作成 |
|
||||
| `/gsd:list-workspaces` | すべてのGSDワークスペースとそのステータスを表示 |
|
||||
| `/gsd:remove-workspace` | ワークスペースを削除しworktreeをクリーンアップ |
|
||||
| `/gsd-new-workspace` | リポジトリのコピー（worktreeまたはクローン）で隔離されたワークスペースを作成 |
|
||||
| `/gsd-list-workspaces` | すべてのGSDワークスペースとそのステータスを表示 |
|
||||
| `/gsd-remove-workspace` | ワークスペースを削除しworktreeをクリーンアップ |
|
||||
|
||||
### UIデザイン
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:ui-phase [N]` | フロントエンドフェーズ用のUIデザイン契約（UI-SPEC.md）を生成 |
|
||||
| `/gsd:ui-review [N]` | 実装済みフロントエンドコードの6つの柱によるビジュアル監査（遡及的） |
|
||||
| `/gsd-ui-phase [N]` | フロントエンドフェーズ用のUIデザイン契約（UI-SPEC.md）を生成 |
|
||||
| `/gsd-ui-review [N]` | 実装済みフロントエンドコードの6つの柱によるビジュアル監査（遡及的） |
|
||||
|
||||
### ナビゲーション
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:progress` | 今どこにいる？次は何？ |
|
||||
| `/gsd:next` | 状態を自動検出し次のステップを実行 |
|
||||
| `/gsd:help` | 全コマンドと使い方ガイドを表示 |
|
||||
| `/gsd:update` | チェンジログプレビュー付きでGSDをアップデート |
|
||||
| `/gsd:join-discord` | GSD Discordコミュニティに参加 |
|
||||
| `/gsd:manager` | 複数フェーズ管理用のインタラクティブコマンドセンター |
|
||||
| `/gsd-progress` | 今どこにいる？次は何？ |
|
||||
| `/gsd-next` | 状態を自動検出し次のステップを実行 |
|
||||
| `/gsd-help` | 全コマンドと使い方ガイドを表示 |
|
||||
| `/gsd-update` | チェンジログプレビュー付きでGSDをアップデート |
|
||||
| `/gsd-join-discord` | GSD Discordコミュニティに参加 |
|
||||
| `/gsd-manager` | 複数フェーズ管理用のインタラクティブコマンドセンター |
|
||||
|
||||
### ブラウンフィールド
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:map-codebase [area]` | new-project前に既存のコードベースを分析 |
|
||||
| `/gsd-map-codebase [area]` | new-project前に既存のコードベースを分析 |
|
||||
|
||||
### フェーズ管理
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:add-phase` | ロードマップにフェーズを追加 |
|
||||
| `/gsd:insert-phase [N]` | フェーズ間に緊急作業を挿入 |
|
||||
| `/gsd:remove-phase [N]` | 将来のフェーズを削除し番号を振り直し |
|
||||
| `/gsd:list-phase-assumptions [N]` | 計画前にClaudeの意図するアプローチを確認 |
|
||||
| `/gsd:plan-milestone-gaps` | 監査で見つかったギャップを埋めるフェーズを作成 |
|
||||
| `/gsd-add-phase` | ロードマップにフェーズを追加 |
|
||||
| `/gsd-insert-phase [N]` | フェーズ間に緊急作業を挿入 |
|
||||
| `/gsd-remove-phase [N]` | 将来のフェーズを削除し番号を振り直し |
|
||||
| `/gsd-list-phase-assumptions [N]` | 計画前にClaudeの意図するアプローチを確認 |
|
||||
| `/gsd-plan-milestone-gaps` | 監査で見つかったギャップを埋めるフェーズを作成 |
|
||||
|
||||
### セッション
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:pause-work` | フェーズ途中で停止する際の引き継ぎを作成（HANDOFF.jsonを書き込み） |
|
||||
| `/gsd:resume-work` | 前回のセッションから復元 |
|
||||
| `/gsd:session-report` | 実行した作業と結果のセッションサマリーを生成 |
|
||||
| `/gsd-pause-work` | フェーズ途中で停止する際の引き継ぎを作成（HANDOFF.jsonを書き込み） |
|
||||
| `/gsd-resume-work` | 前回のセッションから復元 |
|
||||
| `/gsd-session-report` | 実行した作業と結果のセッションサマリーを生成 |
|
||||
|
||||
### ワークストリーム
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:workstreams` | 並列ワークストリームを管理（list、create、switch、status、progress、complete） |
|
||||
| `/gsd-workstreams` | 並列ワークストリームを管理（list、create、switch、status、progress、complete） |
|
||||
|
||||
### コード品質
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:review` | 現在のフェーズまたはブランチのクロスAIピアレビュー |
|
||||
| `/gsd:pr-branch` | `.planning/` コミットをフィルタリングしたクリーンなPRブランチを作成 |
|
||||
| `/gsd:audit-uat` | 検証負債を監査 — UATが未実施のフェーズを検出 |
|
||||
| `/gsd-review` | 現在のフェーズまたはブランチのクロスAIピアレビュー |
|
||||
| `/gsd-pr-branch` | `.planning/` コミットをフィルタリングしたクリーンなPRブランチを作成 |
|
||||
| `/gsd-audit-uat` | 検証負債を監査 — UATが未実施のフェーズを検出 |
|
||||
|
||||
### バックログ & スレッド
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:plant-seed <idea>` | トリガー条件付きの将来志向のアイデアをキャプチャ — 適切なマイルストーンで浮上 |
|
||||
| `/gsd:add-backlog <desc>` | バックログのパーキングロットにアイデアを追加（999.xナンバリング、アクティブシーケンス外） |
|
||||
| `/gsd:review-backlog` | バックログ項目をレビューし、アクティブマイルストーンに昇格またはstaleエントリを削除 |
|
||||
| `/gsd:thread [name]` | 永続コンテキストスレッド — 複数セッションにまたがる作業用の軽量クロスセッション知識 |
|
||||
| `/gsd-plant-seed <idea>` | トリガー条件付きの将来志向のアイデアをキャプチャ — 適切なマイルストーンで浮上 |
|
||||
| `/gsd-add-backlog <desc>` | バックログのパーキングロットにアイデアを追加（999.xナンバリング、アクティブシーケンス外） |
|
||||
| `/gsd-review-backlog` | バックログ項目をレビューし、アクティブマイルストーンに昇格またはstaleエントリを削除 |
|
||||
| `/gsd-thread [name]` | 永続コンテキストスレッド — 複数セッションにまたがる作業用の軽量クロスセッション知識 |
|
||||
|
||||
### ユーティリティ
|
||||
|
||||
| コマンド | 説明 |
|
||||
|---------|--------------|
|
||||
| `/gsd:settings` | モデルプロファイルとワークフローエージェントを設定 |
|
||||
| `/gsd:set-profile <profile>` | モデルプロファイルを切り替え（quality/balanced/budget/inherit） |
|
||||
| `/gsd:add-todo [desc]` | 後で取り組むアイデアをキャプチャ |
|
||||
| `/gsd:check-todos` | 保留中のtodoを一覧表示 |
|
||||
| `/gsd:debug [desc]` | 永続状態を持つ体系的デバッグ |
|
||||
| `/gsd:do <text>` | フリーフォームテキストを適切なGSDコマンドに自動ルーティング |
|
||||
| `/gsd:note <text>` | ゼロフリクションのアイデアキャプチャ — ノートの追加、一覧、todoへの昇格 |
|
||||
| `/gsd:quick [--full] [--discuss] [--research]` | GSDの保証付きでアドホックタスクを実行（`--full` で全フェーズを有効化、`--discuss` で事前にコンテキストを収集、`--research` で計画前にアプローチを調査） |
|
||||
| `/gsd:health [--repair]` | `.planning/` ディレクトリの整合性を検証、`--repair` で自動修復 |
|
||||
| `/gsd:stats` | プロジェクト統計を表示 — フェーズ、プラン、要件、gitメトリクス |
|
||||
| `/gsd:profile-user [--questionnaire] [--refresh]` | セッション分析から開発者行動プロファイルを生成し、パーソナライズされた応答を提供 |
|
||||
| `/gsd-settings` | モデルプロファイルとワークフローエージェントを設定 |
|
||||
| `/gsd-set-profile <profile>` | モデルプロファイルを切り替え（quality/balanced/budget/inherit） |
|
||||
| `/gsd-add-todo [desc]` | 後で取り組むアイデアをキャプチャ |
|
||||
| `/gsd-check-todos` | 保留中のtodoを一覧表示 |
|
||||
| `/gsd-debug [desc]` | 永続状態を持つ体系的デバッグ |
|
||||
| `/gsd-do <text>` | フリーフォームテキストを適切なGSDコマンドに自動ルーティング |
|
||||
| `/gsd-note <text>` | ゼロフリクションのアイデアキャプチャ — ノートの追加、一覧、todoへの昇格 |
|
||||
| `/gsd-quick [--full] [--discuss] [--research]` | GSDの保証付きでアドホックタスクを実行（`--full` で全フェーズを有効化、`--discuss` で事前にコンテキストを収集、`--research` で計画前にアプローチを調査） |
|
||||
| `/gsd-health [--repair]` | `.planning/` ディレクトリの整合性を検証、`--repair` で自動修復 |
|
||||
| `/gsd-stats` | プロジェクト統計を表示 — フェーズ、プラン、要件、gitメトリクス |
|
||||
| `/gsd-profile-user [--questionnaire] [--refresh]` | セッション分析から開発者行動プロファイルを生成し、パーソナライズされた応答を提供 |
|
||||
|
||||
<sup>¹ Redditユーザー OracleGreyBeard による貢献</sup>
|
||||
|
||||
@@ -633,7 +633,7 @@ lmn012o feat(08-02): create registration endpoint
|
||||
|
||||
## 設定
|
||||
|
||||
GSDはプロジェクト設定を `.planning/config.json` に保存します。`/gsd:new-project` 実行時に設定するか、後から `/gsd:settings` で更新できます。完全な設定スキーマ、ワークフロートグル、gitブランチオプション、エージェントごとのモデル内訳については、[ユーザーガイド](docs/ja-JP/USER-GUIDE.md#configuration-reference)をご覧ください。
|
||||
GSDはプロジェクト設定を `.planning/config.json` に保存します。`/gsd-new-project` 実行時に設定するか、後から `/gsd-settings` で更新できます。完全な設定スキーマ、ワークフロートグル、gitブランチオプション、エージェントごとのモデル内訳については、[ユーザーガイド](docs/ja-JP/USER-GUIDE.md#configuration-reference)をご覧ください。
|
||||
|
||||
### コア設定
|
||||
|
||||
@@ -655,12 +655,12 @@ GSDはプロジェクト設定を `.planning/config.json` に保存します。`
|
||||
|
||||
プロファイルの切り替え：
|
||||
```
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
非Anthropicプロバイダー（OpenRouter、ローカルモデル）を使用する場合や、現在のランタイムのモデル選択に従う場合（例：OpenCode `/model`）は `inherit` を使用してください。
|
||||
|
||||
または `/gsd:settings` で設定できます。
|
||||
または `/gsd-settings` で設定できます。
|
||||
|
||||
### ワークフローエージェント
|
||||
|
||||
@@ -677,9 +677,9 @@ GSDはプロジェクト設定を `.planning/config.json` に保存します。`
|
||||
| `workflow.skip_discuss` | `false` | 自律モードでdiscuss-phaseをスキップ |
|
||||
| `workflow.text_mode` | `false` | リモートセッション用のテキスト専用モード（TUIメニューなし） |
|
||||
|
||||
これらのトグルには `/gsd:settings` を使用するか、呼び出し時にオーバーライドできます：
|
||||
- `/gsd:plan-phase --skip-research`
|
||||
- `/gsd:plan-phase --skip-verify`
|
||||
これらのトグルには `/gsd-settings` を使用するか、呼び出し時にオーバーライドできます：
|
||||
- `/gsd-plan-phase --skip-research`
|
||||
- `/gsd-plan-phase --skip-verify`
|
||||
|
||||
### 実行
|
||||
|
||||
@@ -761,7 +761,7 @@ GSDのコードベースマッピングおよび分析コマンドは、プロ
|
||||
- Codexの場合、`~/.codex/skills/gsd-*/SKILL.md`（グローバル）または `./.codex/skills/gsd-*/SKILL.md`（ローカル）にスキルが存在するか確認してください
|
||||
|
||||
**コマンドが期待通りに動作しない？**
|
||||
- `/gsd:help` を実行してインストールを確認してください
|
||||
- `/gsd-help` を実行してインストールを確認してください
|
||||
- `npx get-shit-done-cc` を再実行して再インストールしてください
|
||||
|
||||
**最新バージョンへのアップデート？**
|
||||
|
||||
172
README.ko-KR.md
172
README.ko-KR.md
@@ -88,12 +88,12 @@ npx get-shit-done-cc@latest
|
||||
2. **위치** — 전역 (모든 프로젝트) 또는 로컬 (현재 프로젝트만)
|
||||
|
||||
설치가 됐는지 확인하려면:
|
||||
- Claude Code / Gemini: `/gsd:help`
|
||||
- Claude Code / Gemini: `/gsd-help`
|
||||
- OpenCode: `/gsd-help`
|
||||
- Kilo: `/gsd-help`
|
||||
- Codex: `$gsd-help`
|
||||
- Copilot: `/gsd:help`
|
||||
- Antigravity: `/gsd:help`
|
||||
- Copilot: `/gsd-help`
|
||||
- Antigravity: `/gsd-help`
|
||||
|
||||
> [!NOTE]
|
||||
> Codex 설치는 커스텀 프롬프트 대신 스킬(`skills/gsd-*/SKILL.md`)을 사용합니다.
|
||||
@@ -212,12 +212,12 @@ claude --dangerously-skip-permissions
|
||||
|
||||
## 작동 방식
|
||||
|
||||
> **이미 코드가 있나요?** 먼저 `/gsd:map-codebase`를 실행하세요. 병렬 에이전트를 생성해 스택, 아키텍처, 컨벤션, 고려사항을 분석합니다. 그러면 `/gsd:new-project`가 코드베이스를 파악한 상태에서 시작되고 — 질문은 추가하는 것에 집중되고, 기획 시 자동으로 기존 패턴을 불러옵니다.
|
||||
> **이미 코드가 있나요?** 먼저 `/gsd-map-codebase`를 실행하세요. 병렬 에이전트를 생성해 스택, 아키텍처, 컨벤션, 고려사항을 분석합니다. 그러면 `/gsd-new-project`가 코드베이스를 파악한 상태에서 시작되고 — 질문은 추가하는 것에 집중되고, 기획 시 자동으로 기존 패턴을 불러옵니다.
|
||||
|
||||
### 1. 프로젝트 초기화
|
||||
|
||||
```
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
명령어 하나, 플로우 하나. 시스템이:
|
||||
@@ -236,7 +236,7 @@ claude --dangerously-skip-permissions
|
||||
### 2. 단계 논의
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 1
|
||||
/gsd-discuss-phase 1
|
||||
```
|
||||
|
||||
**여기서 구현을 직접 설계합니다.**
|
||||
@@ -259,14 +259,14 @@ claude --dangerously-skip-permissions
|
||||
|
||||
**생성 파일:** `{phase_num}-CONTEXT.md`
|
||||
|
||||
> **가정 모드:** 질문보다 코드베이스 분석을 선호하나요? `/gsd:settings`에서 `workflow.discuss_mode`를 `assumptions`로 설정하세요. 시스템이 코드를 읽고 하려는 것과 이유를 제시한 다음 틀린 부분만 수정을 요청합니다. [논의 모드](docs/ko-KR/workflow-discuss-mode.md) 참조.
|
||||
> **가정 모드:** 질문보다 코드베이스 분석을 선호하나요? `/gsd-settings`에서 `workflow.discuss_mode`를 `assumptions`로 설정하세요. 시스템이 코드를 읽고 하려는 것과 이유를 제시한 다음 틀린 부분만 수정을 요청합니다. [논의 모드](docs/ko-KR/workflow-discuss-mode.md) 참조.
|
||||
|
||||
---
|
||||
|
||||
### 3. 단계 기획
|
||||
|
||||
```
|
||||
/gsd:plan-phase 1
|
||||
/gsd-plan-phase 1
|
||||
```
|
||||
|
||||
시스템이:
|
||||
@@ -284,7 +284,7 @@ claude --dangerously-skip-permissions
|
||||
### 4. 단계 실행
|
||||
|
||||
```
|
||||
/gsd:execute-phase 1
|
||||
/gsd-execute-phase 1
|
||||
```
|
||||
|
||||
시스템이:
|
||||
@@ -335,7 +335,7 @@ claude --dangerously-skip-permissions
|
||||
### 5. 작업 검증
|
||||
|
||||
```
|
||||
/gsd:verify-work 1
|
||||
/gsd-verify-work 1
|
||||
```
|
||||
|
||||
**여기서 실제로 작동하는지 확인합니다.**
|
||||
@@ -349,7 +349,7 @@ claude --dangerously-skip-permissions
|
||||
3. **실패 자동 진단** — 근본 원인을 찾기 위해 디버그 에이전트 생성
|
||||
4. **검증된 수정 계획 생성** — 즉시 재실행 준비 완료
|
||||
|
||||
모든 게 통과하면 다음으로 넘어갑니다. 뭔가 깨졌으면 직접 디버그하지 않아도 됩니다 — 생성된 수정 계획으로 `/gsd:execute-phase`만 다시 실행하면 됩니다.
|
||||
모든 게 통과하면 다음으로 넘어갑니다. 뭔가 깨졌으면 직접 디버그하지 않아도 됩니다 — 생성된 수정 계획으로 `/gsd-execute-phase`만 다시 실행하면 됩니다.
|
||||
|
||||
**생성 파일:** `{phase_num}-UAT.md`, 문제 발견 시 수정 계획
|
||||
|
||||
@@ -358,38 +358,38 @@ claude --dangerously-skip-permissions
|
||||
### 6. 반복 → 출시 → 완료 → 다음 마일스톤
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 2
|
||||
/gsd:plan-phase 2
|
||||
/gsd:execute-phase 2
|
||||
/gsd:verify-work 2
|
||||
/gsd:ship 2 # 검증된 작업으로 PR 생성
|
||||
/gsd-discuss-phase 2
|
||||
/gsd-plan-phase 2
|
||||
/gsd-execute-phase 2
|
||||
/gsd-verify-work 2
|
||||
/gsd-ship 2 # 검증된 작업으로 PR 생성
|
||||
...
|
||||
/gsd:complete-milestone
|
||||
/gsd:new-milestone
|
||||
/gsd-complete-milestone
|
||||
/gsd-new-milestone
|
||||
```
|
||||
|
||||
또는 GSD가 다음 단계를 자동으로 파악하게 합니다:
|
||||
|
||||
```
|
||||
/gsd:next # 다음 단계 자동 감지 및 실행
|
||||
/gsd-next # 다음 단계 자동 감지 및 실행
|
||||
```
|
||||
|
||||
마일스톤이 완료될 때까지 **논의 → 기획 → 실행 → 검증 → 출시** 반복.
|
||||
|
||||
논의 중에 더 빠르게 진행하고 싶다면 `/gsd:discuss-phase <n> --batch`를 사용해 하나씩이 아닌 소그룹으로 한 번에 답할 수 있습니다. `--chain`을 사용하면 논의에서 기획+실행까지 중간에 멈추지 않고 자동 체이닝됩니다.
|
||||
논의 중에 더 빠르게 진행하고 싶다면 `/gsd-discuss-phase <n> --batch`를 사용해 하나씩이 아닌 소그룹으로 한 번에 답할 수 있습니다. `--chain`을 사용하면 논의에서 기획+실행까지 중간에 멈추지 않고 자동 체이닝됩니다.
|
||||
|
||||
각 단계는 사용자 입력(논의), 적절한 리서치(기획), 깔끔한 실행(실행), 사람의 검증(검증)을 거칩니다. 컨텍스트는 새롭게 유지됩니다. 품질도 높게 유지됩니다.
|
||||
|
||||
모든 단계가 끝나면 `/gsd:complete-milestone`이 마일스톤을 아카이브하고 릴리스에 태그를 답니다.
|
||||
모든 단계가 끝나면 `/gsd-complete-milestone`이 마일스톤을 아카이브하고 릴리스에 태그를 답니다.
|
||||
|
||||
그다음 `/gsd:new-milestone`으로 다음 버전을 시작합니다 — `new-project`와 같은 흐름이지만 기존 코드베이스를 위한 것입니다. 다음에 만들 것을 설명하면 시스템이 도메인을 리서치하고, 요구사항을 스코핑하고, 새 로드맵을 만듭니다. 각 마일스톤은 깔끔한 사이클입니다: 정의 → 구축 → 출시.
|
||||
그다음 `/gsd-new-milestone`으로 다음 버전을 시작합니다 — `new-project`와 같은 흐름이지만 기존 코드베이스를 위한 것입니다. 다음에 만들 것을 설명하면 시스템이 도메인을 리서치하고, 요구사항을 스코핑하고, 새 로드맵을 만듭니다. 각 마일스톤은 깔끔한 사이클입니다: 정의 → 구축 → 출시.
|
||||
|
||||
---
|
||||
|
||||
### 빠른 모드
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
```
|
||||
|
||||
**전체 기획이 필요 없는 임시 작업용.**
|
||||
@@ -411,7 +411,7 @@ claude --dangerously-skip-permissions
|
||||
플래그는 조합 가능합니다: `--discuss --research --validate`은 논의 + 리서치 + 계획 확인 + 검증을 제공합니다.
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> 뭘 하고 싶으신가요? "설정에 다크 모드 토글 추가"
|
||||
```
|
||||
|
||||
@@ -510,111 +510,111 @@ lmn012o feat(08-02): create registration endpoint
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:new-project [--auto]` | 전체 초기화: 질문 → 리서치 → 요구사항 → 로드맵 |
|
||||
| `/gsd:discuss-phase [N] [--auto] [--analyze] [--chain]` | 기획 전 구현 결정 캡처 (`--analyze`는 트레이드오프 분석 추가, `--chain`은 기획+실행으로 자동 체이닝) |
|
||||
| `/gsd:plan-phase [N] [--auto] [--reviews]` | 단계에 대한 리서치 + 기획 + 검증 (`--reviews`는 코드베이스 리뷰 결과 로드) |
|
||||
| `/gsd:execute-phase <N>` | 병렬 웨이브로 모든 계획 실행, 완료 시 검증 |
|
||||
| `/gsd:verify-work [N]` | 수동 사용자 인수 테스트 ¹ |
|
||||
| `/gsd:ship [N] [--draft]` | 자동 생성된 본문으로 검증된 단계 작업에서 PR 생성 |
|
||||
| `/gsd:next` | 다음 논리적 워크플로우 단계로 자동 진행 |
|
||||
| `/gsd:fast <text>` | 인라인 사소한 작업 — 기획 완전 건너뛰고 즉시 실행 |
|
||||
| `/gsd:audit-milestone` | 마일스톤이 완료 정의를 달성했는지 검증 |
|
||||
| `/gsd:complete-milestone` | 마일스톤 아카이브, 릴리스 태그 |
|
||||
| `/gsd:new-milestone [name]` | 다음 버전 시작: 질문 → 리서치 → 요구사항 → 로드맵 |
|
||||
| `/gsd:forensics [desc]` | 실패한 워크플로우 실행의 사후 조사 (막힌 루프, 누락된 아티팩트, git 이상 진단) |
|
||||
| `/gsd:milestone-summary [version]` | 팀 온보딩 및 리뷰를 위한 종합 프로젝트 요약 생성 |
|
||||
| `/gsd-new-project [--auto]` | 전체 초기화: 질문 → 리서치 → 요구사항 → 로드맵 |
|
||||
| `/gsd-discuss-phase [N] [--auto] [--analyze] [--chain]` | 기획 전 구현 결정 캡처 (`--analyze`는 트레이드오프 분석 추가, `--chain`은 기획+실행으로 자동 체이닝) |
|
||||
| `/gsd-plan-phase [N] [--auto] [--reviews]` | 단계에 대한 리서치 + 기획 + 검증 (`--reviews`는 코드베이스 리뷰 결과 로드) |
|
||||
| `/gsd-execute-phase <N>` | 병렬 웨이브로 모든 계획 실행, 완료 시 검증 |
|
||||
| `/gsd-verify-work [N]` | 수동 사용자 인수 테스트 ¹ |
|
||||
| `/gsd-ship [N] [--draft]` | 자동 생성된 본문으로 검증된 단계 작업에서 PR 생성 |
|
||||
| `/gsd-next` | 다음 논리적 워크플로우 단계로 자동 진행 |
|
||||
| `/gsd-fast <text>` | 인라인 사소한 작업 — 기획 완전 건너뛰고 즉시 실행 |
|
||||
| `/gsd-audit-milestone` | 마일스톤이 완료 정의를 달성했는지 검증 |
|
||||
| `/gsd-complete-milestone` | 마일스톤 아카이브, 릴리스 태그 |
|
||||
| `/gsd-new-milestone [name]` | 다음 버전 시작: 질문 → 리서치 → 요구사항 → 로드맵 |
|
||||
| `/gsd-forensics [desc]` | 실패한 워크플로우 실행의 사후 조사 (막힌 루프, 누락된 아티팩트, git 이상 진단) |
|
||||
| `/gsd-milestone-summary [version]` | 팀 온보딩 및 리뷰를 위한 종합 프로젝트 요약 생성 |
|
||||
|
||||
### 워크스트림
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:workstreams list` | 모든 워크스트림과 상태 표시 |
|
||||
| `/gsd:workstreams create <name>` | 병렬 마일스톤 작업을 위한 네임스페이스 워크스트림 생성 |
|
||||
| `/gsd:workstreams switch <name>` | 활성 워크스트림 전환 |
|
||||
| `/gsd:workstreams complete <name>` | 워크스트림 완료 및 병합 |
|
||||
| `/gsd-workstreams list` | 모든 워크스트림과 상태 표시 |
|
||||
| `/gsd-workstreams create <name>` | 병렬 마일스톤 작업을 위한 네임스페이스 워크스트림 생성 |
|
||||
| `/gsd-workstreams switch <name>` | 활성 워크스트림 전환 |
|
||||
| `/gsd-workstreams complete <name>` | 워크스트림 완료 및 병합 |
|
||||
|
||||
### 멀티 프로젝트 워크스페이스
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:new-workspace` | 저장소 복사본으로 격리된 워크스페이스 생성 (worktrees 또는 clones) |
|
||||
| `/gsd:list-workspaces` | 모든 GSD 워크스페이스와 상태 표시 |
|
||||
| `/gsd:remove-workspace` | 워크스페이스 제거 및 worktree 정리 |
|
||||
| `/gsd-new-workspace` | 저장소 복사본으로 격리된 워크스페이스 생성 (worktrees 또는 clones) |
|
||||
| `/gsd-list-workspaces` | 모든 GSD 워크스페이스와 상태 표시 |
|
||||
| `/gsd-remove-workspace` | 워크스페이스 제거 및 worktree 정리 |
|
||||
|
||||
### UI 디자인
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:ui-phase [N]` | 프론트엔드 단계를 위한 UI 디자인 계약 (UI-SPEC.md) 생성 |
|
||||
| `/gsd:ui-review [N]` | 구현된 프론트엔드 코드의 소급적 6가지 기준 시각 감사 |
|
||||
| `/gsd-ui-phase [N]` | 프론트엔드 단계를 위한 UI 디자인 계약 (UI-SPEC.md) 생성 |
|
||||
| `/gsd-ui-review [N]` | 구현된 프론트엔드 코드의 소급적 6가지 기준 시각 감사 |
|
||||
|
||||
### 탐색
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:progress` | 지금 어디에 있나? 다음은? |
|
||||
| `/gsd:next` | 상태 자동 감지 및 다음 단계 실행 |
|
||||
| `/gsd:help` | 모든 명령어와 사용 가이드 표시 |
|
||||
| `/gsd:update` | 변경 로그 미리보기와 함께 GSD 업데이트 |
|
||||
| `/gsd:join-discord` | GSD Discord 커뮤니티 참여 |
|
||||
| `/gsd:manager` | 여러 단계 관리를 위한 대화형 커맨드 센터 |
|
||||
| `/gsd-progress` | 지금 어디에 있나? 다음은? |
|
||||
| `/gsd-next` | 상태 자동 감지 및 다음 단계 실행 |
|
||||
| `/gsd-help` | 모든 명령어와 사용 가이드 표시 |
|
||||
| `/gsd-update` | 변경 로그 미리보기와 함께 GSD 업데이트 |
|
||||
| `/gsd-join-discord` | GSD Discord 커뮤니티 참여 |
|
||||
| `/gsd-manager` | 여러 단계 관리를 위한 대화형 커맨드 센터 |
|
||||
|
||||
### 브라운필드
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:map-codebase [area]` | new-project 전 기존 코드베이스 분석 |
|
||||
| `/gsd-map-codebase [area]` | new-project 전 기존 코드베이스 분석 |
|
||||
|
||||
### 단계 관리
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:add-phase` | 로드맵에 단계 추가 |
|
||||
| `/gsd:insert-phase [N]` | 단계 사이에 긴급 작업 삽입 |
|
||||
| `/gsd:remove-phase [N]` | 미래 단계 제거, 번호 재정렬 |
|
||||
| `/gsd:list-phase-assumptions [N]` | 기획 전 Claude의 의도된 접근 방식 확인 |
|
||||
| `/gsd:plan-milestone-gaps` | 감사에서 발견된 갭을 해소하기 위한 단계 생성 |
|
||||
| `/gsd-add-phase` | 로드맵에 단계 추가 |
|
||||
| `/gsd-insert-phase [N]` | 단계 사이에 긴급 작업 삽입 |
|
||||
| `/gsd-remove-phase [N]` | 미래 단계 제거, 번호 재정렬 |
|
||||
| `/gsd-list-phase-assumptions [N]` | 기획 전 Claude의 의도된 접근 방식 확인 |
|
||||
| `/gsd-plan-milestone-gaps` | 감사에서 발견된 갭을 해소하기 위한 단계 생성 |
|
||||
|
||||
### 세션
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:pause-work` | 단계 중간에 멈출 때 핸드오프 생성 (HANDOFF.json 작성) |
|
||||
| `/gsd:resume-work` | 마지막 세션에서 복원 |
|
||||
| `/gsd:session-report` | 수행한 작업과 결과가 담긴 세션 요약 생성 |
|
||||
| `/gsd-pause-work` | 단계 중간에 멈출 때 핸드오프 생성 (HANDOFF.json 작성) |
|
||||
| `/gsd-resume-work` | 마지막 세션에서 복원 |
|
||||
| `/gsd-session-report` | 수행한 작업과 결과가 담긴 세션 요약 생성 |
|
||||
|
||||
### 코드 품질
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:review` | 현재 단계 또는 브랜치의 Cross-AI 피어 리뷰 |
|
||||
| `/gsd:pr-branch` | `.planning/` 커밋을 필터링한 깔끔한 PR 브랜치 생성 |
|
||||
| `/gsd:audit-uat` | 검증 부채 감사 — UAT가 누락된 단계 찾기 |
|
||||
| `/gsd-review` | 현재 단계 또는 브랜치의 Cross-AI 피어 리뷰 |
|
||||
| `/gsd-pr-branch` | `.planning/` 커밋을 필터링한 깔끔한 PR 브랜치 생성 |
|
||||
| `/gsd-audit-uat` | 검증 부채 감사 — UAT가 누락된 단계 찾기 |
|
||||
|
||||
### 백로그 및 스레드
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:plant-seed <idea>` | 트리거 조건이 있는 아이디어 저장 — 때가 되면 알아서 올라옴 |
|
||||
| `/gsd:add-backlog <desc>` | 백로그 파킹 롯에 아이디어 추가 (999.x 번호 지정, 활성 시퀀스 외부) |
|
||||
| `/gsd:review-backlog` | 백로그 항목 리뷰 및 활성 마일스톤으로 승격하거나 오래된 항목 제거 |
|
||||
| `/gsd:thread [name]` | 지속적 컨텍스트 스레드 — 여러 세션에 걸친 작업을 위한 가벼운 크로스 세션 지식 |
|
||||
| `/gsd-plant-seed <idea>` | 트리거 조건이 있는 아이디어 저장 — 때가 되면 알아서 올라옴 |
|
||||
| `/gsd-add-backlog <desc>` | 백로그 파킹 롯에 아이디어 추가 (999.x 번호 지정, 활성 시퀀스 외부) |
|
||||
| `/gsd-review-backlog` | 백로그 항목 리뷰 및 활성 마일스톤으로 승격하거나 오래된 항목 제거 |
|
||||
| `/gsd-thread [name]` | 지속적 컨텍스트 스레드 — 여러 세션에 걸친 작업을 위한 가벼운 크로스 세션 지식 |
|
||||
|
||||
### 유틸리티
|
||||
|
||||
| 명령어 | 역할 |
|
||||
|---------|------------|
|
||||
| `/gsd:settings` | 모델 프로필 및 워크플로우 에이전트 설정 |
|
||||
| `/gsd:set-profile <profile>` | 모델 프로필 전환 (quality/balanced/budget/inherit) |
|
||||
| `/gsd:add-todo [desc]` | 나중을 위한 아이디어 캡처 |
|
||||
| `/gsd:check-todos` | 대기 중인 할 일 목록 |
|
||||
| `/gsd:debug [desc]` | 지속적 상태를 이용한 체계적 디버깅 |
|
||||
| `/gsd:do <text>` | 자유 형식 텍스트를 적절한 GSD 명령어로 자동 라우팅 |
|
||||
| `/gsd:note <text>` | 마찰 없는 아이디어 캡처 — 추가, 목록, 또는 할 일로 승격 |
|
||||
| `/gsd:quick [--full] [--discuss] [--research]` | GSD 보장과 함께 임시 작업 실행 (`--full`은 전체 단계 활성화, `--discuss`는 먼저 컨텍스트 수집, `--research`는 기획 전 접근법 조사) |
|
||||
| `/gsd:health [--repair]` | `.planning/` 디렉터리 무결성 검증, `--repair`로 자동 복구 |
|
||||
| `/gsd:stats` | 프로젝트 통계 표시 — 단계, 계획, 요구사항, git 지표 |
|
||||
| `/gsd:profile-user [--questionnaire] [--refresh]` | 개인화된 응답을 위해 세션 분석에서 개발자 행동 프로필 생성 |
|
||||
| `/gsd-settings` | 모델 프로필 및 워크플로우 에이전트 설정 |
|
||||
| `/gsd-set-profile <profile>` | 모델 프로필 전환 (quality/balanced/budget/inherit) |
|
||||
| `/gsd-add-todo [desc]` | 나중을 위한 아이디어 캡처 |
|
||||
| `/gsd-check-todos` | 대기 중인 할 일 목록 |
|
||||
| `/gsd-debug [desc]` | 지속적 상태를 이용한 체계적 디버깅 |
|
||||
| `/gsd-do <text>` | 자유 형식 텍스트를 적절한 GSD 명령어로 자동 라우팅 |
|
||||
| `/gsd-note <text>` | 마찰 없는 아이디어 캡처 — 추가, 목록, 또는 할 일로 승격 |
|
||||
| `/gsd-quick [--full] [--discuss] [--research]` | GSD 보장과 함께 임시 작업 실행 (`--full`은 전체 단계 활성화, `--discuss`는 먼저 컨텍스트 수집, `--research`는 기획 전 접근법 조사) |
|
||||
| `/gsd-health [--repair]` | `.planning/` 디렉터리 무결성 검증, `--repair`로 자동 복구 |
|
||||
| `/gsd-stats` | 프로젝트 통계 표시 — 단계, 계획, 요구사항, git 지표 |
|
||||
| `/gsd-profile-user [--questionnaire] [--refresh]` | 개인화된 응답을 위해 세션 분석에서 개발자 행동 프로필 생성 |
|
||||
|
||||
<sup>¹ reddit 유저 OracleGreyBeard 기여</sup>
|
||||
|
||||
@@ -622,7 +622,7 @@ lmn012o feat(08-02): create registration endpoint
|
||||
|
||||
## 설정
|
||||
|
||||
GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:new-project` 중에 설정하거나 나중에 `/gsd:settings`로 업데이트할 수 있습니다. 전체 config 스키마, 워크플로우 토글, git 브랜칭 옵션, 에이전트별 모델 분석은 [사용자 가이드](docs/ko-KR/USER-GUIDE.md#configuration-reference)를 참조하세요.
|
||||
GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd-new-project` 중에 설정하거나 나중에 `/gsd-settings`로 업데이트할 수 있습니다. 전체 config 스키마, 워크플로우 토글, git 브랜칭 옵션, 에이전트별 모델 분석은 [사용자 가이드](docs/ko-KR/USER-GUIDE.md#configuration-reference)를 참조하세요.
|
||||
|
||||
### 핵심 설정
|
||||
|
||||
@@ -644,12 +644,12 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
|
||||
|
||||
프로필 전환:
|
||||
```
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
비-Anthropic 제공업체 (OpenRouter, 로컬 모델) 사용 시 또는 현재 런타임 모델 선택을 따를 때 (예: OpenCode `/model`) `inherit`를 사용하세요.
|
||||
|
||||
또는 `/gsd:settings`를 통해 설정하세요.
|
||||
또는 `/gsd-settings`를 통해 설정하세요.
|
||||
|
||||
### 워크플로우 에이전트
|
||||
|
||||
@@ -666,9 +666,9 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
|
||||
| `workflow.skip_discuss` | `false` | 자율 모드에서 discuss-phase 건너뛰기 |
|
||||
| `workflow.text_mode` | `false` | 원격 세션을 위한 텍스트 전용 모드 (TUI 메뉴 없음) |
|
||||
|
||||
`/gsd:settings`로 토글하거나 호출별로 재정의하세요:
|
||||
- `/gsd:plan-phase --skip-research`
|
||||
- `/gsd:plan-phase --skip-verify`
|
||||
`/gsd-settings`로 토글하거나 호출별로 재정의하세요:
|
||||
- `/gsd-plan-phase --skip-research`
|
||||
- `/gsd-plan-phase --skip-verify`
|
||||
|
||||
### 실행
|
||||
|
||||
@@ -750,7 +750,7 @@ GSD의 코드베이스 매핑 및 분석 명령어는 프로젝트를 이해하
|
||||
- Codex의 경우 `~/.codex/skills/gsd-*/SKILL.md` (전역) 또는 `./.codex/skills/gsd-*/SKILL.md` (로컬)에 스킬이 있는지 확인하세요
|
||||
|
||||
**명령어가 예상대로 작동하지 않나요?**
|
||||
- `/gsd:help`를 실행해 설치 확인
|
||||
- `/gsd-help`를 실행해 설치 확인
|
||||
- `npx get-shit-done-cc`를 다시 실행해 재설치
|
||||
|
||||
**최신 버전으로 업데이트하나요?**
|
||||
|
||||
174
README.md
174
README.md
@@ -96,7 +96,7 @@ The installer prompts you to choose:
|
||||
2. **Location** — Global (all projects) or local (current project only)
|
||||
|
||||
Verify with:
|
||||
- Claude Code / Gemini / Copilot / Antigravity: `/gsd:help`
|
||||
- Claude Code / Gemini / Copilot / Antigravity: `/gsd-help`
|
||||
- OpenCode / Kilo / Augment: `/gsd-help`
|
||||
- Codex: `$gsd-help`
|
||||
|
||||
@@ -229,12 +229,12 @@ If you prefer not to use that flag, add this to your project's `.claude/settings
|
||||
|
||||
## How It Works
|
||||
|
||||
> **Already have code?** Run `/gsd:map-codebase` first. It spawns parallel agents to analyze your stack, architecture, conventions, and concerns. Then `/gsd:new-project` knows your codebase — questions focus on what you're adding, and planning automatically loads your patterns.
|
||||
> **Already have code?** Run `/gsd-map-codebase` first. It spawns parallel agents to analyze your stack, architecture, conventions, and concerns. Then `/gsd-new-project` knows your codebase — questions focus on what you're adding, and planning automatically loads your patterns.
|
||||
|
||||
### 1. Initialize Project
|
||||
|
||||
```
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
One command, one flow. The system:
|
||||
@@ -253,7 +253,7 @@ You approve the roadmap. Now you're ready to build.
|
||||
### 2. Discuss Phase
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 1
|
||||
/gsd-discuss-phase 1
|
||||
```
|
||||
|
||||
**This is where you shape the implementation.**
|
||||
@@ -276,14 +276,14 @@ The deeper you go here, the more the system builds what you actually want. Skip
|
||||
|
||||
**Creates:** `{phase_num}-CONTEXT.md`
|
||||
|
||||
> **Assumptions Mode:** Prefer codebase analysis over questions? Set `workflow.discuss_mode` to `assumptions` in `/gsd:settings`. The system reads your code, surfaces what it would do and why, and only asks you to correct what's wrong. See [Discuss Mode](docs/workflow-discuss-mode.md).
|
||||
> **Assumptions Mode:** Prefer codebase analysis over questions? Set `workflow.discuss_mode` to `assumptions` in `/gsd-settings`. The system reads your code, surfaces what it would do and why, and only asks you to correct what's wrong. See [Discuss Mode](docs/workflow-discuss-mode.md).
|
||||
|
||||
---
|
||||
|
||||
### 3. Plan Phase
|
||||
|
||||
```
|
||||
/gsd:plan-phase 1
|
||||
/gsd-plan-phase 1
|
||||
```
|
||||
|
||||
The system:
|
||||
@@ -301,7 +301,7 @@ Each plan is small enough to execute in a fresh context window. No degradation,
|
||||
### 4. Execute Phase
|
||||
|
||||
```
|
||||
/gsd:execute-phase 1
|
||||
/gsd-execute-phase 1
|
||||
```
|
||||
|
||||
The system:
|
||||
@@ -352,7 +352,7 @@ This is why "vertical slices" (Plan 01: User feature end-to-end) parallelize bet
|
||||
### 5. Verify Work
|
||||
|
||||
```
|
||||
/gsd:verify-work 1
|
||||
/gsd-verify-work 1
|
||||
```
|
||||
|
||||
**This is where you confirm it actually works.**
|
||||
@@ -366,7 +366,7 @@ The system:
|
||||
3. **Diagnoses failures automatically** — Spawns debug agents to find root causes
|
||||
4. **Creates verified fix plans** — Ready for immediate re-execution
|
||||
|
||||
If everything passes, you move on. If something's broken, you don't manually debug — you just run `/gsd:execute-phase` again with the fix plans it created.
|
||||
If everything passes, you move on. If something's broken, you don't manually debug — you just run `/gsd-execute-phase` again with the fix plans it created.
|
||||
|
||||
**Creates:** `{phase_num}-UAT.md`, fix plans if issues found
|
||||
|
||||
@@ -375,38 +375,38 @@ If everything passes, you move on. If something's broken, you don't manually deb
|
||||
### 6. Repeat → Ship → Complete → Next Milestone
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 2
|
||||
/gsd:plan-phase 2
|
||||
/gsd:execute-phase 2
|
||||
/gsd:verify-work 2
|
||||
/gsd:ship 2 # Create PR from verified work
|
||||
/gsd-discuss-phase 2
|
||||
/gsd-plan-phase 2
|
||||
/gsd-execute-phase 2
|
||||
/gsd-verify-work 2
|
||||
/gsd-ship 2 # Create PR from verified work
|
||||
...
|
||||
/gsd:complete-milestone
|
||||
/gsd:new-milestone
|
||||
/gsd-complete-milestone
|
||||
/gsd-new-milestone
|
||||
```
|
||||
|
||||
Or let GSD figure out the next step automatically:
|
||||
|
||||
```
|
||||
/gsd:next # Auto-detect and run next step
|
||||
/gsd-next # Auto-detect and run next step
|
||||
```
|
||||
|
||||
Loop **discuss → plan → execute → verify → ship** until milestone complete.
|
||||
|
||||
If you want faster intake during discussion, use `/gsd:discuss-phase <n> --batch` to answer a small grouped set of questions at once instead of one-by-one. Use `--chain` to auto-chain discuss into plan+execute without stopping between steps.
|
||||
If you want faster intake during discussion, use `/gsd-discuss-phase <n> --batch` to answer a small grouped set of questions at once instead of one-by-one. Use `--chain` to auto-chain discuss into plan+execute without stopping between steps.
|
||||
|
||||
Each phase gets your input (discuss), proper research (plan), clean execution (execute), and human verification (verify). Context stays fresh. Quality stays high.
|
||||
|
||||
When all phases are done, `/gsd:complete-milestone` archives the milestone and tags the release.
|
||||
When all phases are done, `/gsd-complete-milestone` archives the milestone and tags the release.
|
||||
|
||||
Then `/gsd:new-milestone` starts the next version — same flow as `new-project` but for your existing codebase. You describe what you want to build next, the system researches the domain, you scope requirements, and it creates a fresh roadmap. Each milestone is a clean cycle: define → build → ship.
|
||||
Then `/gsd-new-milestone` starts the next version — same flow as `new-project` but for your existing codebase. You describe what you want to build next, the system researches the domain, you scope requirements, and it creates a fresh roadmap. Each milestone is a clean cycle: define → build → ship.
|
||||
|
||||
---
|
||||
|
||||
### Quick Mode
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
```
|
||||
|
||||
**For ad-hoc tasks that don't need full planning.**
|
||||
@@ -428,7 +428,7 @@ Quick mode gives you GSD guarantees (atomic commits, state tracking) with a fast
|
||||
Flags are composable: `--discuss --research --validate` gives discussion + research + plan-checking + verification.
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> What do you want to do? "Add dark mode toggle to settings"
|
||||
```
|
||||
|
||||
@@ -527,119 +527,119 @@ You're never locked in. The system adapts.
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:new-project [--auto]` | Full initialization: questions → research → requirements → roadmap |
|
||||
| `/gsd:discuss-phase [N] [--auto] [--analyze] [--chain]` | Capture implementation decisions before planning (`--analyze` adds trade-off analysis, `--chain` auto-chains into plan+execute) |
|
||||
| `/gsd:plan-phase [N] [--auto] [--reviews]` | Research + plan + verify for a phase (`--reviews` loads codebase review findings) |
|
||||
| `/gsd:execute-phase <N>` | Execute all plans in parallel waves, verify when complete |
|
||||
| `/gsd:verify-work [N]` | Manual user acceptance testing ¹ |
|
||||
| `/gsd:ship [N] [--draft]` | Create PR from verified phase work with auto-generated body |
|
||||
| `/gsd:next` | Automatically advance to the next logical workflow step |
|
||||
| `/gsd:fast <text>` | Inline trivial tasks — skips planning entirely, executes immediately |
|
||||
| `/gsd:audit-milestone` | Verify milestone achieved its definition of done |
|
||||
| `/gsd:complete-milestone` | Archive milestone, tag release |
|
||||
| `/gsd:new-milestone [name]` | Start next version: questions → research → requirements → roadmap |
|
||||
| `/gsd:forensics [desc]` | Post-mortem investigation of failed workflow runs (diagnoses stuck loops, missing artifacts, git anomalies) |
|
||||
| `/gsd:milestone-summary [version]` | Generate comprehensive project summary for team onboarding and review |
|
||||
| `/gsd-new-project [--auto]` | Full initialization: questions → research → requirements → roadmap |
|
||||
| `/gsd-discuss-phase [N] [--auto] [--analyze] [--chain]` | Capture implementation decisions before planning (`--analyze` adds trade-off analysis, `--chain` auto-chains into plan+execute) |
|
||||
| `/gsd-plan-phase [N] [--auto] [--reviews]` | Research + plan + verify for a phase (`--reviews` loads codebase review findings) |
|
||||
| `/gsd-execute-phase <N>` | Execute all plans in parallel waves, verify when complete |
|
||||
| `/gsd-verify-work [N]` | Manual user acceptance testing ¹ |
|
||||
| `/gsd-ship [N] [--draft]` | Create PR from verified phase work with auto-generated body |
|
||||
| `/gsd-next` | Automatically advance to the next logical workflow step |
|
||||
| `/gsd-fast <text>` | Inline trivial tasks — skips planning entirely, executes immediately |
|
||||
| `/gsd-audit-milestone` | Verify milestone achieved its definition of done |
|
||||
| `/gsd-complete-milestone` | Archive milestone, tag release |
|
||||
| `/gsd-new-milestone [name]` | Start next version: questions → research → requirements → roadmap |
|
||||
| `/gsd-forensics [desc]` | Post-mortem investigation of failed workflow runs (diagnoses stuck loops, missing artifacts, git anomalies) |
|
||||
| `/gsd-milestone-summary [version]` | Generate comprehensive project summary for team onboarding and review |
|
||||
|
||||
### Workstreams
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:workstreams list` | Show all workstreams and their status |
|
||||
| `/gsd:workstreams create <name>` | Create a namespaced workstream for parallel milestone work |
|
||||
| `/gsd:workstreams switch <name>` | Switch active workstream |
|
||||
| `/gsd:workstreams complete <name>` | Complete and merge a workstream |
|
||||
| `/gsd-workstreams list` | Show all workstreams and their status |
|
||||
| `/gsd-workstreams create <name>` | Create a namespaced workstream for parallel milestone work |
|
||||
| `/gsd-workstreams switch <name>` | Switch active workstream |
|
||||
| `/gsd-workstreams complete <name>` | Complete and merge a workstream |
|
||||
|
||||
### Multi-Project Workspaces
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:new-workspace` | Create isolated workspace with repo copies (worktrees or clones) |
|
||||
| `/gsd:list-workspaces` | Show all GSD workspaces and their status |
|
||||
| `/gsd:remove-workspace` | Remove workspace and clean up worktrees |
|
||||
| `/gsd-new-workspace` | Create isolated workspace with repo copies (worktrees or clones) |
|
||||
| `/gsd-list-workspaces` | Show all GSD workspaces and their status |
|
||||
| `/gsd-remove-workspace` | Remove workspace and clean up worktrees |
|
||||
|
||||
### UI Design
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:ui-phase [N]` | Generate UI design contract (UI-SPEC.md) for frontend phases |
|
||||
| `/gsd:ui-review [N]` | Retroactive 6-pillar visual audit of implemented frontend code |
|
||||
| `/gsd-ui-phase [N]` | Generate UI design contract (UI-SPEC.md) for frontend phases |
|
||||
| `/gsd-ui-review [N]` | Retroactive 6-pillar visual audit of implemented frontend code |
|
||||
|
||||
### Navigation
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:progress` | Where am I? What's next? |
|
||||
| `/gsd:next` | Auto-detect state and run the next step |
|
||||
| `/gsd:help` | Show all commands and usage guide |
|
||||
| `/gsd:update` | Update GSD with changelog preview |
|
||||
| `/gsd:join-discord` | Join the GSD Discord community |
|
||||
| `/gsd:manager` | Interactive command center for managing multiple phases |
|
||||
| `/gsd-progress` | Where am I? What's next? |
|
||||
| `/gsd-next` | Auto-detect state and run the next step |
|
||||
| `/gsd-help` | Show all commands and usage guide |
|
||||
| `/gsd-update` | Update GSD with changelog preview |
|
||||
| `/gsd-join-discord` | Join the GSD Discord community |
|
||||
| `/gsd-manager` | Interactive command center for managing multiple phases |
|
||||
|
||||
### Brownfield
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:map-codebase [area]` | Analyze existing codebase before new-project |
|
||||
| `/gsd-map-codebase [area]` | Analyze existing codebase before new-project |
|
||||
|
||||
### Phase Management
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:add-phase` | Append phase to roadmap |
|
||||
| `/gsd:insert-phase [N]` | Insert urgent work between phases |
|
||||
| `/gsd:remove-phase [N]` | Remove future phase, renumber |
|
||||
| `/gsd:list-phase-assumptions [N]` | See Claude's intended approach before planning |
|
||||
| `/gsd:plan-milestone-gaps` | Create phases to close gaps from audit |
|
||||
| `/gsd-add-phase` | Append phase to roadmap |
|
||||
| `/gsd-insert-phase [N]` | Insert urgent work between phases |
|
||||
| `/gsd-remove-phase [N]` | Remove future phase, renumber |
|
||||
| `/gsd-list-phase-assumptions [N]` | See Claude's intended approach before planning |
|
||||
| `/gsd-plan-milestone-gaps` | Create phases to close gaps from audit |
|
||||
|
||||
### Session
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:pause-work` | Create handoff when stopping mid-phase (writes HANDOFF.json) |
|
||||
| `/gsd:resume-work` | Restore from last session |
|
||||
| `/gsd:session-report` | Generate session summary with work performed and outcomes |
|
||||
| `/gsd-pause-work` | Create handoff when stopping mid-phase (writes HANDOFF.json) |
|
||||
| `/gsd-resume-work` | Restore from last session |
|
||||
| `/gsd-session-report` | Generate session summary with work performed and outcomes |
|
||||
|
||||
### Workstreams
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:workstreams` | Manage parallel workstreams (list, create, switch, status, progress, complete) |
|
||||
| `/gsd-workstreams` | Manage parallel workstreams (list, create, switch, status, progress, complete) |
|
||||
|
||||
### Code Quality
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:review` | Cross-AI peer review of current phase or branch |
|
||||
| `/gsd:secure-phase [N]` | Security enforcement with threat-model-anchored verification |
|
||||
| `/gsd:pr-branch` | Create clean PR branch filtering `.planning/` commits |
|
||||
| `/gsd:audit-uat` | Audit verification debt — find phases missing UAT |
|
||||
| `/gsd:docs-update` | Verified documentation generation with doc-writer and doc-verifier agents |
|
||||
| `/gsd-review` | Cross-AI peer review of current phase or branch |
|
||||
| `/gsd-secure-phase [N]` | Security enforcement with threat-model-anchored verification |
|
||||
| `/gsd-pr-branch` | Create clean PR branch filtering `.planning/` commits |
|
||||
| `/gsd-audit-uat` | Audit verification debt — find phases missing UAT |
|
||||
| `/gsd-docs-update` | Verified documentation generation with doc-writer and doc-verifier agents |
|
||||
|
||||
### Backlog & Threads
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:plant-seed <idea>` | Capture forward-looking ideas with trigger conditions — surfaces at the right milestone |
|
||||
| `/gsd:add-backlog <desc>` | Add idea to backlog parking lot (999.x numbering, outside active sequence) |
|
||||
| `/gsd:review-backlog` | Review and promote backlog items to active milestone or remove stale entries |
|
||||
| `/gsd:thread [name]` | Persistent context threads — lightweight cross-session knowledge for work spanning multiple sessions |
|
||||
| `/gsd-plant-seed <idea>` | Capture forward-looking ideas with trigger conditions — surfaces at the right milestone |
|
||||
| `/gsd-add-backlog <desc>` | Add idea to backlog parking lot (999.x numbering, outside active sequence) |
|
||||
| `/gsd-review-backlog` | Review and promote backlog items to active milestone or remove stale entries |
|
||||
| `/gsd-thread [name]` | Persistent context threads — lightweight cross-session knowledge for work spanning multiple sessions |
|
||||
|
||||
### Utilities
|
||||
|
||||
| Command | What it does |
|
||||
|---------|--------------|
|
||||
| `/gsd:settings` | Configure model profile and workflow agents |
|
||||
| `/gsd:set-profile <profile>` | Switch model profile (quality/balanced/budget/inherit) |
|
||||
| `/gsd:add-todo [desc]` | Capture idea for later |
|
||||
| `/gsd:check-todos` | List pending todos |
|
||||
| `/gsd:debug [desc]` | Systematic debugging with persistent state |
|
||||
| `/gsd:do <text>` | Route freeform text to the right GSD command automatically |
|
||||
| `/gsd:note <text>` | Zero-friction idea capture — append, list, or promote notes to todos |
|
||||
| `/gsd:quick [--full] [--validate] [--discuss] [--research]` | Execute ad-hoc task with GSD guarantees (`--full` enables all phases, `--validate` adds plan-checking and verification, `--discuss` gathers context first, `--research` investigates approaches before planning) |
|
||||
| `/gsd:health [--repair]` | Validate `.planning/` directory integrity, auto-repair with `--repair` |
|
||||
| `/gsd:stats` | Display project statistics — phases, plans, requirements, git metrics |
|
||||
| `/gsd:profile-user [--questionnaire] [--refresh]` | Generate developer behavioral profile from session analysis for personalized responses |
|
||||
| `/gsd-settings` | Configure model profile and workflow agents |
|
||||
| `/gsd-set-profile <profile>` | Switch model profile (quality/balanced/budget/inherit) |
|
||||
| `/gsd-add-todo [desc]` | Capture idea for later |
|
||||
| `/gsd-check-todos` | List pending todos |
|
||||
| `/gsd-debug [desc]` | Systematic debugging with persistent state |
|
||||
| `/gsd-do <text>` | Route freeform text to the right GSD command automatically |
|
||||
| `/gsd-note <text>` | Zero-friction idea capture — append, list, or promote notes to todos |
|
||||
| `/gsd-quick [--full] [--validate] [--discuss] [--research]` | Execute ad-hoc task with GSD guarantees (`--full` enables all phases, `--validate` adds plan-checking and verification, `--discuss` gathers context first, `--research` investigates approaches before planning) |
|
||||
| `/gsd-health [--repair]` | Validate `.planning/` directory integrity, auto-repair with `--repair` |
|
||||
| `/gsd-stats` | Display project statistics — phases, plans, requirements, git metrics |
|
||||
| `/gsd-profile-user [--questionnaire] [--refresh]` | Generate developer behavioral profile from session analysis for personalized responses |
|
||||
|
||||
<sup>¹ Contributed by reddit user OracleGreyBeard</sup>
|
||||
|
||||
@@ -647,7 +647,7 @@ You're never locked in. The system adapts.
|
||||
|
||||
## Configuration
|
||||
|
||||
GSD stores project settings in `.planning/config.json`. Configure during `/gsd:new-project` or update later with `/gsd:settings`. For the full config schema, workflow toggles, git branching options, and per-agent model breakdown, see the [User Guide](docs/USER-GUIDE.md#configuration-reference).
|
||||
GSD stores project settings in `.planning/config.json`. Configure during `/gsd-new-project` or update later with `/gsd-settings`. For the full config schema, workflow toggles, git branching options, and per-agent model breakdown, see the [User Guide](docs/USER-GUIDE.md#configuration-reference).
|
||||
|
||||
### Core Settings
|
||||
|
||||
@@ -670,12 +670,12 @@ Control which Claude model each agent uses. Balance quality vs token spend.
|
||||
|
||||
Switch profiles:
|
||||
```
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
Use `inherit` when using non-Anthropic providers (OpenRouter, local models) or to follow the current runtime model selection (e.g. OpenCode `/model`).
|
||||
|
||||
Or configure via `/gsd:settings`.
|
||||
Or configure via `/gsd-settings`.
|
||||
|
||||
### Workflow Agents
|
||||
|
||||
@@ -693,9 +693,9 @@ These spawn additional agents during planning/execution. They improve quality bu
|
||||
| `workflow.text_mode` | `false` | Text-only mode for remote sessions (no TUI menus) |
|
||||
| `workflow.use_worktrees` | `true` | Toggle worktree isolation for execution |
|
||||
|
||||
Use `/gsd:settings` to toggle these, or override per-invocation:
|
||||
- `/gsd:plan-phase --skip-research`
|
||||
- `/gsd:plan-phase --skip-verify`
|
||||
Use `/gsd-settings` to toggle these, or override per-invocation:
|
||||
- `/gsd-plan-phase --skip-research`
|
||||
- `/gsd-plan-phase --skip-verify`
|
||||
|
||||
### Execution
|
||||
|
||||
@@ -787,7 +787,7 @@ This prevents Claude from reading these files entirely, regardless of what comma
|
||||
- For Codex, verify skills exist in `~/.codex/skills/gsd-*/SKILL.md` (global) or `./.codex/skills/gsd-*/SKILL.md` (local)
|
||||
|
||||
**Commands not working as expected?**
|
||||
- Run `/gsd:help` to verify installation
|
||||
- Run `/gsd-help` to verify installation
|
||||
- Re-run `npx get-shit-done-cc` to reinstall
|
||||
|
||||
**Updating to the latest version?**
|
||||
|
||||
@@ -86,12 +86,12 @@ O instalador pede:
|
||||
2. **Local** — Global (todos os projetos) ou local (apenas projeto atual)
|
||||
|
||||
Verifique com:
|
||||
- Claude Code / Gemini: `/gsd:help`
|
||||
- Claude Code / Gemini: `/gsd-help`
|
||||
- OpenCode: `/gsd-help`
|
||||
- Kilo: `/gsd-help`
|
||||
- Codex: `$gsd-help`
|
||||
- Copilot: `/gsd:help`
|
||||
- Antigravity: `/gsd:help`
|
||||
- Copilot: `/gsd-help`
|
||||
- Antigravity: `/gsd-help`
|
||||
|
||||
> [!NOTE]
|
||||
> A instalação do Codex usa skills (`skills/gsd-*/SKILL.md`) em vez de prompts customizados.
|
||||
@@ -158,12 +158,12 @@ claude --dangerously-skip-permissions
|
||||
|
||||
## Como funciona
|
||||
|
||||
> **Já tem código?** Rode `/gsd:map-codebase` primeiro para analisar stack, arquitetura, convenções e riscos.
|
||||
> **Já tem código?** Rode `/gsd-map-codebase` primeiro para analisar stack, arquitetura, convenções e riscos.
|
||||
|
||||
### 1. Inicializar projeto
|
||||
|
||||
```
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
O sistema:
|
||||
@@ -177,7 +177,7 @@ O sistema:
|
||||
### 2. Discutir fase
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 1
|
||||
/gsd-discuss-phase 1
|
||||
```
|
||||
|
||||
Captura suas preferências de implementação antes do planejamento.
|
||||
@@ -187,7 +187,7 @@ Captura suas preferências de implementação antes do planejamento.
|
||||
### 3. Planejar fase
|
||||
|
||||
```
|
||||
/gsd:plan-phase 1
|
||||
/gsd-plan-phase 1
|
||||
```
|
||||
|
||||
1. Pesquisa abordagens
|
||||
@@ -199,7 +199,7 @@ Captura suas preferências de implementação antes do planejamento.
|
||||
### 4. Executar fase
|
||||
|
||||
```
|
||||
/gsd:execute-phase 1
|
||||
/gsd-execute-phase 1
|
||||
```
|
||||
|
||||
1. Executa planos em ondas
|
||||
@@ -212,7 +212,7 @@ Captura suas preferências de implementação antes do planejamento.
|
||||
### 5. Verificar trabalho
|
||||
|
||||
```
|
||||
/gsd:verify-work 1
|
||||
/gsd-verify-work 1
|
||||
```
|
||||
|
||||
Validação manual orientada para confirmar que a feature realmente funciona como esperado.
|
||||
@@ -222,25 +222,25 @@ Validação manual orientada para confirmar que a feature realmente funciona com
|
||||
### 6. Repetir -> Entregar -> Completar
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 2
|
||||
/gsd:plan-phase 2
|
||||
/gsd:execute-phase 2
|
||||
/gsd:verify-work 2
|
||||
/gsd:ship 2
|
||||
/gsd:complete-milestone
|
||||
/gsd:new-milestone
|
||||
/gsd-discuss-phase 2
|
||||
/gsd-plan-phase 2
|
||||
/gsd-execute-phase 2
|
||||
/gsd-verify-work 2
|
||||
/gsd-ship 2
|
||||
/gsd-complete-milestone
|
||||
/gsd-new-milestone
|
||||
```
|
||||
|
||||
Ou deixe o GSD decidir:
|
||||
|
||||
```
|
||||
/gsd:next
|
||||
/gsd-next
|
||||
```
|
||||
|
||||
### Modo rápido
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
```
|
||||
|
||||
Para tarefas ad-hoc sem ciclo completo de planejamento.
|
||||
@@ -296,36 +296,36 @@ Cada tarefa gera commit próprio, facilitando `git bisect`, rollback e rastreabi
|
||||
|
||||
| Comando | O que faz |
|
||||
|---------|-----------|
|
||||
| `/gsd:new-project [--auto]` | Inicializa projeto completo |
|
||||
| `/gsd:discuss-phase [N] [--auto] [--analyze] [--chain]` | Captura decisões antes do plano (`--chain` encadeia automaticamente em plan+execute) |
|
||||
| `/gsd:plan-phase [N] [--auto] [--reviews]` | Pesquisa + plano + validação |
|
||||
| `/gsd:execute-phase <N>` | Executa planos em ondas paralelas |
|
||||
| `/gsd:verify-work [N]` | UAT manual |
|
||||
| `/gsd:ship [N] [--draft]` | Cria PR da fase validada |
|
||||
| `/gsd:next` | Avança automaticamente para o próximo passo |
|
||||
| `/gsd:fast <text>` | Tarefas triviais sem planejamento |
|
||||
| `/gsd:complete-milestone` | Fecha o marco e marca release |
|
||||
| `/gsd:new-milestone [name]` | Inicia próximo marco |
|
||||
| `/gsd-new-project [--auto]` | Inicializa projeto completo |
|
||||
| `/gsd-discuss-phase [N] [--auto] [--analyze] [--chain]` | Captura decisões antes do plano (`--chain` encadeia automaticamente em plan+execute) |
|
||||
| `/gsd-plan-phase [N] [--auto] [--reviews]` | Pesquisa + plano + validação |
|
||||
| `/gsd-execute-phase <N>` | Executa planos em ondas paralelas |
|
||||
| `/gsd-verify-work [N]` | UAT manual |
|
||||
| `/gsd-ship [N] [--draft]` | Cria PR da fase validada |
|
||||
| `/gsd-next` | Avança automaticamente para o próximo passo |
|
||||
| `/gsd-fast <text>` | Tarefas triviais sem planejamento |
|
||||
| `/gsd-complete-milestone` | Fecha o marco e marca release |
|
||||
| `/gsd-new-milestone [name]` | Inicia próximo marco |
|
||||
|
||||
### Qualidade e utilidades
|
||||
|
||||
| Comando | O que faz |
|
||||
|---------|-----------|
|
||||
| `/gsd:review` | Peer review com múltiplas IAs |
|
||||
| `/gsd:pr-branch` | Cria branch limpa para PR |
|
||||
| `/gsd:settings` | Configura perfis e agentes |
|
||||
| `/gsd:set-profile <profile>` | Troca perfil (quality/balanced/budget/inherit) |
|
||||
| `/gsd:quick [--full] [--discuss] [--research]` | Execução rápida com garantias do GSD (`--full` ativa todas as etapas, `--validate` ativa apenas verificação) |
|
||||
| `/gsd:health [--repair]` | Verifica e repara `.planning/` |
|
||||
| `/gsd-review` | Peer review com múltiplas IAs |
|
||||
| `/gsd-pr-branch` | Cria branch limpa para PR |
|
||||
| `/gsd-settings` | Configura perfis e agentes |
|
||||
| `/gsd-set-profile <profile>` | Troca perfil (quality/balanced/budget/inherit) |
|
||||
| `/gsd-quick [--full] [--discuss] [--research]` | Execução rápida com garantias do GSD (`--full` ativa todas as etapas, `--validate` ativa apenas verificação) |
|
||||
| `/gsd-health [--repair]` | Verifica e repara `.planning/` |
|
||||
|
||||
> Para a lista completa de comandos e opções, use `/gsd:help`.
|
||||
> Para a lista completa de comandos e opções, use `/gsd-help`.
|
||||
|
||||
---
|
||||
|
||||
## Configuração
|
||||
|
||||
As configurações do projeto ficam em `.planning/config.json`.
|
||||
Você pode configurar no `/gsd:new-project` ou ajustar depois com `/gsd:settings`.
|
||||
Você pode configurar no `/gsd-new-project` ou ajustar depois com `/gsd-settings`.
|
||||
|
||||
### Ajustes principais
|
||||
|
||||
@@ -345,7 +345,7 @@ Você pode configurar no `/gsd:new-project` ou ajustar depois com `/gsd:settings
|
||||
|
||||
Troca rápida:
|
||||
```
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
---
|
||||
@@ -389,7 +389,7 @@ Adicione padrões sensíveis ao deny list do Claude Code:
|
||||
- Verifique se os arquivos foram instalados no diretório correto
|
||||
|
||||
**Comandos não funcionam como esperado?**
|
||||
- Rode `/gsd:help`
|
||||
- Rode `/gsd-help`
|
||||
- Reinstale com `npx get-shit-done-cc@latest`
|
||||
|
||||
**Em Docker/container?**
|
||||
|
||||
162
README.zh-CN.md
162
README.zh-CN.md
@@ -86,12 +86,12 @@ npx get-shit-done-cc@latest
|
||||
2. **安装位置**：全局（所有项目）或本地（仅当前项目）
|
||||
|
||||
安装后可这样验证：
|
||||
- Claude Code / Gemini：`/gsd:help`
|
||||
- Claude Code / Gemini：`/gsd-help`
|
||||
- OpenCode：`/gsd-help`
|
||||
- Kilo：`/gsd-help`
|
||||
- Codex：`$gsd-help`
|
||||
- Copilot：`/gsd:help`
|
||||
- Antigravity：`/gsd:help`
|
||||
- Copilot：`/gsd-help`
|
||||
- Antigravity：`/gsd-help`
|
||||
|
||||
> [!NOTE]
|
||||
> Codex 安装走的是 skill 机制（`skills/gsd-*/SKILL.md`），不是自定义 prompt。
|
||||
@@ -210,12 +210,12 @@ claude --dangerously-skip-permissions
|
||||
|
||||
## 它是怎么工作的
|
||||
|
||||
> **已经有现成代码库？** 先运行 `/gsd:map-codebase`。它会并行拉起多个代理分析你的技术栈、架构、约定和风险点。之后 `/gsd:new-project` 就会真正“理解”你的代码库，提问会聚焦在你打算新增的部分，规划时也会自动加载你的现有模式。
|
||||
> **已经有现成代码库？** 先运行 `/gsd-map-codebase`。它会并行拉起多个代理分析你的技术栈、架构、约定和风险点。之后 `/gsd-new-project` 就会真正“理解”你的代码库，提问会聚焦在你打算新增的部分，规划时也会自动加载你的现有模式。
|
||||
|
||||
### 1. 初始化项目
|
||||
|
||||
```
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
一个命令，一条完整流程。系统会：
|
||||
@@ -234,7 +234,7 @@ claude --dangerously-skip-permissions
|
||||
### 2. 讨论阶段
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 1
|
||||
/gsd-discuss-phase 1
|
||||
```
|
||||
|
||||
**这是你塑造实现方式的地方。**
|
||||
@@ -262,7 +262,7 @@ claude --dangerously-skip-permissions
|
||||
### 3. 规划阶段
|
||||
|
||||
```
|
||||
/gsd:plan-phase 1
|
||||
/gsd-plan-phase 1
|
||||
```
|
||||
|
||||
系统会：
|
||||
@@ -280,7 +280,7 @@ claude --dangerously-skip-permissions
|
||||
### 4. 执行阶段
|
||||
|
||||
```
|
||||
/gsd:execute-phase 1
|
||||
/gsd-execute-phase 1
|
||||
```
|
||||
|
||||
系统会：
|
||||
@@ -331,7 +331,7 @@ claude --dangerously-skip-permissions
|
||||
### 5. 验证工作
|
||||
|
||||
```
|
||||
/gsd:verify-work 1
|
||||
/gsd-verify-work 1
|
||||
```
|
||||
|
||||
**这是你确认它是否真的可用的地方。**
|
||||
@@ -345,7 +345,7 @@ claude --dangerously-skip-permissions
|
||||
3. **自动诊断失败**：拉起 debug 代理定位根因
|
||||
4. **创建验证过的修复计划**：可立刻重新执行
|
||||
|
||||
如果一切通过，就进入下一步；如果哪里坏了，你不需要手动 debug，只要重新运行 `/gsd:execute-phase`，执行它自动生成的修复计划即可。
|
||||
如果一切通过，就进入下一步；如果哪里坏了，你不需要手动 debug，只要重新运行 `/gsd-execute-phase`，执行它自动生成的修复计划即可。
|
||||
|
||||
**生成：** `{phase_num}-UAT.md`，以及发现问题时的修复计划
|
||||
|
||||
@@ -354,38 +354,38 @@ claude --dangerously-skip-permissions
|
||||
### 6. 重复 → 发布 → 完成 → 下一个里程碑
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 2
|
||||
/gsd:plan-phase 2
|
||||
/gsd:execute-phase 2
|
||||
/gsd:verify-work 2
|
||||
/gsd:ship 2 # 从已验证的工作创建 PR
|
||||
/gsd-discuss-phase 2
|
||||
/gsd-plan-phase 2
|
||||
/gsd-execute-phase 2
|
||||
/gsd-verify-work 2
|
||||
/gsd-ship 2 # 从已验证的工作创建 PR
|
||||
...
|
||||
/gsd:complete-milestone
|
||||
/gsd:new-milestone
|
||||
/gsd-complete-milestone
|
||||
/gsd-new-milestone
|
||||
```
|
||||
|
||||
或者让 GSD 自动判断下一步：
|
||||
|
||||
```
|
||||
/gsd:next # 自动检测并执行下一步
|
||||
/gsd-next # 自动检测并执行下一步
|
||||
```
|
||||
|
||||
循环执行 **讨论 → 规划 → 执行 → 验证 → 发布**，直到整个里程碑完成。
|
||||
|
||||
如果你希望在讨论阶段更快收集信息，可以用 `/gsd:discuss-phase <n> --batch`，一次回答一小组问题，而不是逐个问答。
|
||||
如果你希望在讨论阶段更快收集信息，可以用 `/gsd-discuss-phase <n> --batch`，一次回答一小组问题，而不是逐个问答。
|
||||
|
||||
每个阶段都会得到你的输入（discuss）、充分研究（plan）、干净执行（execute）和人工验证（verify）。上下文始终保持新鲜，质量也能持续稳定。
|
||||
|
||||
当所有阶段完成后，`/gsd:complete-milestone` 会归档当前里程碑并打 release tag。
|
||||
当所有阶段完成后，`/gsd-complete-milestone` 会归档当前里程碑并打 release tag。
|
||||
|
||||
接着用 `/gsd:new-milestone` 开启下一个版本。它和 `new-project` 流程相同，只是面向你现有的代码库。你描述下一步想构建什么，系统研究领域、梳理需求，再产出新的路线图。每个里程碑都是一个干净周期：定义 → 构建 → 发布。
|
||||
接着用 `/gsd-new-milestone` 开启下一个版本。它和 `new-project` 流程相同，只是面向你现有的代码库。你描述下一步想构建什么，系统研究领域、梳理需求，再产出新的路线图。每个里程碑都是一个干净周期：定义 → 构建 → 发布。
|
||||
|
||||
---
|
||||
|
||||
### 快速模式
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
```
|
||||
|
||||
**适用于不需要完整规划的临时任务。**
|
||||
@@ -405,7 +405,7 @@ claude --dangerously-skip-permissions
|
||||
参数可组合使用：`--discuss --research --full` 可同时获得讨论 + 研究 + 计划检查 + 验证。
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> What do you want to do? "Add dark mode toggle to settings"
|
||||
```
|
||||
|
||||
@@ -502,107 +502,107 @@ lmn012o feat(08-02): create registration endpoint
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:new-project [--auto]` | 完整初始化：提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd:discuss-phase [N] [--auto] [--analyze]` | 在规划前收集实现决策（`--analyze` 增加权衡分析） |
|
||||
| `/gsd:plan-phase [N] [--auto] [--reviews]` | 为某个阶段执行研究 + 规划 + 验证（`--reviews` 加载代码库审查结果） |
|
||||
| `/gsd:execute-phase <N>` | 以并行 wave 执行全部计划，完成后验证 |
|
||||
| `/gsd:verify-work [N]` | 人工用户验收测试 ¹ |
|
||||
| `/gsd:ship [N] [--draft]` | 从已验证的阶段工作创建 PR，自动生成 PR 描述 |
|
||||
| `/gsd:fast <text>` | 内联处理琐碎任务——完全跳过规划，立即执行 |
|
||||
| `/gsd:next` | 自动推进到下一个逻辑工作流步骤 |
|
||||
| `/gsd:audit-milestone` | 验证里程碑是否达到完成定义 |
|
||||
| `/gsd:complete-milestone` | 归档里程碑并打 release tag |
|
||||
| `/gsd:new-milestone [name]` | 开始下一个版本：提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd:milestone-summary` | 从已完成的里程碑产物生成项目概览，用于团队上手 |
|
||||
| `/gsd:forensics` | 对失败或卡住的工作流进行事后调查 |
|
||||
| `/gsd-new-project [--auto]` | 完整初始化：提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd-discuss-phase [N] [--auto] [--analyze]` | 在规划前收集实现决策（`--analyze` 增加权衡分析） |
|
||||
| `/gsd-plan-phase [N] [--auto] [--reviews]` | 为某个阶段执行研究 + 规划 + 验证（`--reviews` 加载代码库审查结果） |
|
||||
| `/gsd-execute-phase <N>` | 以并行 wave 执行全部计划，完成后验证 |
|
||||
| `/gsd-verify-work [N]` | 人工用户验收测试 ¹ |
|
||||
| `/gsd-ship [N] [--draft]` | 从已验证的阶段工作创建 PR，自动生成 PR 描述 |
|
||||
| `/gsd-fast <text>` | 内联处理琐碎任务——完全跳过规划，立即执行 |
|
||||
| `/gsd-next` | 自动推进到下一个逻辑工作流步骤 |
|
||||
| `/gsd-audit-milestone` | 验证里程碑是否达到完成定义 |
|
||||
| `/gsd-complete-milestone` | 归档里程碑并打 release tag |
|
||||
| `/gsd-new-milestone [name]` | 开始下一个版本：提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd-milestone-summary` | 从已完成的里程碑产物生成项目概览，用于团队上手 |
|
||||
| `/gsd-forensics` | 对失败或卡住的工作流进行事后调查 |
|
||||
|
||||
### 工作流（Workstreams）
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:workstreams list` | 显示所有工作流及其状态 |
|
||||
| `/gsd:workstreams create <name>` | 创建命名空间工作流，用于并行里程碑工作 |
|
||||
| `/gsd:workstreams switch <name>` | 切换当前活跃工作流 |
|
||||
| `/gsd:workstreams complete <name>` | 完成并合并工作流 |
|
||||
| `/gsd-workstreams list` | 显示所有工作流及其状态 |
|
||||
| `/gsd-workstreams create <name>` | 创建命名空间工作流，用于并行里程碑工作 |
|
||||
| `/gsd-workstreams switch <name>` | 切换当前活跃工作流 |
|
||||
| `/gsd-workstreams complete <name>` | 完成并合并工作流 |
|
||||
|
||||
### 多项目工作区
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:new-workspace` | 创建隔离工作区，包含仓库副本（worktree 或 clone） |
|
||||
| `/gsd:list-workspaces` | 显示所有 GSD 工作区及其状态 |
|
||||
| `/gsd:remove-workspace` | 移除工作区并清理 worktree |
|
||||
| `/gsd-new-workspace` | 创建隔离工作区，包含仓库副本（worktree 或 clone） |
|
||||
| `/gsd-list-workspaces` | 显示所有 GSD 工作区及其状态 |
|
||||
| `/gsd-remove-workspace` | 移除工作区并清理 worktree |
|
||||
|
||||
### UI 设计
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:ui-phase [N]` | 为前端阶段生成 UI 设计合约（UI-SPEC.md） |
|
||||
| `/gsd:ui-review [N]` | 对已实现前端代码进行 6 维视觉审计 |
|
||||
| `/gsd-ui-phase [N]` | 为前端阶段生成 UI 设计合约（UI-SPEC.md） |
|
||||
| `/gsd-ui-review [N]` | 对已实现前端代码进行 6 维视觉审计 |
|
||||
|
||||
### 导航
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:progress` | 我现在在哪？下一步是什么？ |
|
||||
| `/gsd:next` | 自动检测状态并执行下一步 |
|
||||
| `/gsd:help` | 显示全部命令和使用指南 |
|
||||
| `/gsd:update` | 更新 GSD，并预览变更日志 |
|
||||
| `/gsd:join-discord` | 加入 GSD Discord 社区 |
|
||||
| `/gsd-progress` | 我现在在哪？下一步是什么？ |
|
||||
| `/gsd-next` | 自动检测状态并执行下一步 |
|
||||
| `/gsd-help` | 显示全部命令和使用指南 |
|
||||
| `/gsd-update` | 更新 GSD，并预览变更日志 |
|
||||
| `/gsd-join-discord` | 加入 GSD Discord 社区 |
|
||||
|
||||
### Brownfield
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:map-codebase` | 在 `new-project` 前分析现有代码库 |
|
||||
| `/gsd-map-codebase` | 在 `new-project` 前分析现有代码库 |
|
||||
|
||||
### 阶段管理
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:add-phase` | 在路线图末尾追加 phase |
|
||||
| `/gsd:insert-phase [N]` | 在 phase 之间插入紧急工作 |
|
||||
| `/gsd:remove-phase [N]` | 删除未来 phase，并重编号 |
|
||||
| `/gsd:list-phase-assumptions [N]` | 在规划前查看 Claude 打算采用的方案 |
|
||||
| `/gsd:plan-milestone-gaps` | 为 audit 发现的缺口创建 phase |
|
||||
| `/gsd-add-phase` | 在路线图末尾追加 phase |
|
||||
| `/gsd-insert-phase [N]` | 在 phase 之间插入紧急工作 |
|
||||
| `/gsd-remove-phase [N]` | 删除未来 phase，并重编号 |
|
||||
| `/gsd-list-phase-assumptions [N]` | 在规划前查看 Claude 打算采用的方案 |
|
||||
| `/gsd-plan-milestone-gaps` | 为 audit 发现的缺口创建 phase |
|
||||
|
||||
### 代码质量
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:review` | 对当前阶段或分支进行跨 AI 同行评审 |
|
||||
| `/gsd:pr-branch` | 创建过滤 `.planning/` 提交的干净 PR 分支 |
|
||||
| `/gsd:audit-uat` | 审计验证债务——找出缺少 UAT 的阶段 |
|
||||
| `/gsd-review` | 对当前阶段或分支进行跨 AI 同行评审 |
|
||||
| `/gsd-pr-branch` | 创建过滤 `.planning/` 提交的干净 PR 分支 |
|
||||
| `/gsd-audit-uat` | 审计验证债务——找出缺少 UAT 的阶段 |
|
||||
|
||||
### 积压
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:plant-seed <idea>` | 将想法存入积压停车场，留待未来里程碑 |
|
||||
| `/gsd-plant-seed <idea>` | 将想法存入积压停车场，留待未来里程碑 |
|
||||
|
||||
### 会话
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:pause-work` | 在中途暂停时创建交接上下文（写入 HANDOFF.json） |
|
||||
| `/gsd:resume-work` | 从上一次会话恢复 |
|
||||
| `/gsd:session-report` | 生成会话摘要，包含已完成工作和结果 |
|
||||
| `/gsd-pause-work` | 在中途暂停时创建交接上下文（写入 HANDOFF.json） |
|
||||
| `/gsd-resume-work` | 从上一次会话恢复 |
|
||||
| `/gsd-session-report` | 生成会话摘要，包含已完成工作和结果 |
|
||||
|
||||
### 工具
|
||||
|
||||
| 命令 | 作用 |
|
||||
|------|------|
|
||||
| `/gsd:settings` | 配置模型 profile 和工作流代理 |
|
||||
| `/gsd:set-profile <profile>` | 切换模型 profile（quality / balanced / budget / inherit） |
|
||||
| `/gsd:add-todo [desc]` | 记录一个待办想法 |
|
||||
| `/gsd:check-todos` | 查看待办列表 |
|
||||
| `/gsd:debug [desc]` | 使用持久状态进行系统化调试 |
|
||||
| `/gsd:do <text>` | 将自由文本自动路由到正确的 GSD 命令 |
|
||||
| `/gsd:note <text>` | 零摩擦想法捕捉——追加、列出或提升为待办 |
|
||||
| `/gsd:quick [--full] [--discuss] [--research]` | 以 GSD 保障执行临时任务（`--full` 增加计划检查和验证，`--discuss` 先补上下文，`--research` 在规划前先调研） |
|
||||
| `/gsd:health [--repair]` | 校验 `.planning/` 目录完整性，带 `--repair` 时自动修复 |
|
||||
| `/gsd:stats` | 显示项目统计——阶段、计划、需求、git 指标 |
|
||||
| `/gsd:profile-user [--questionnaire] [--refresh]` | 从会话分析生成开发者行为档案，用于个性化响应 |
|
||||
| `/gsd-settings` | 配置模型 profile 和工作流代理 |
|
||||
| `/gsd-set-profile <profile>` | 切换模型 profile（quality / balanced / budget / inherit） |
|
||||
| `/gsd-add-todo [desc]` | 记录一个待办想法 |
|
||||
| `/gsd-check-todos` | 查看待办列表 |
|
||||
| `/gsd-debug [desc]` | 使用持久状态进行系统化调试 |
|
||||
| `/gsd-do <text>` | 将自由文本自动路由到正确的 GSD 命令 |
|
||||
| `/gsd-note <text>` | 零摩擦想法捕捉——追加、列出或提升为待办 |
|
||||
| `/gsd-quick [--full] [--discuss] [--research]` | 以 GSD 保障执行临时任务（`--full` 增加计划检查和验证，`--discuss` 先补上下文，`--research` 在规划前先调研） |
|
||||
| `/gsd-health [--repair]` | 校验 `.planning/` 目录完整性，带 `--repair` 时自动修复 |
|
||||
| `/gsd-stats` | 显示项目统计——阶段、计划、需求、git 指标 |
|
||||
| `/gsd-profile-user [--questionnaire] [--refresh]` | 从会话分析生成开发者行为档案，用于个性化响应 |
|
||||
|
||||
<sup>¹ 由 reddit 用户 OracleGreyBeard 贡献</sup>
|
||||
|
||||
@@ -610,7 +610,7 @@ lmn012o feat(08-02): create registration endpoint
|
||||
|
||||
## 配置
|
||||
|
||||
GSD 将项目设置保存在 `.planning/config.json`。你可以在 `/gsd:new-project` 时配置，也可以稍后通过 `/gsd:settings` 修改。完整的配置 schema、工作流开关、git branching 选项以及各代理的模型分配，请查看[用户指南](docs/USER-GUIDE.md#configuration-reference)。
|
||||
GSD 将项目设置保存在 `.planning/config.json`。你可以在 `/gsd-new-project` 时配置，也可以稍后通过 `/gsd-settings` 修改。完整的配置 schema、工作流开关、git branching 选项以及各代理的模型分配，请查看[用户指南](docs/USER-GUIDE.md#configuration-reference)。
|
||||
|
||||
### 核心设置
|
||||
|
||||
@@ -632,12 +632,12 @@ GSD 将项目设置保存在 `.planning/config.json`。你可以在 `/gsd:new-pr
|
||||
|
||||
切换方式：
|
||||
```
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
使用非 Anthropic 提供商（OpenRouter、本地模型）时，或想跟随当前运行时的模型选择时（如 OpenCode 的 `/model`），可用 `inherit`。
|
||||
|
||||
也可以通过 `/gsd:settings` 配置。
|
||||
也可以通过 `/gsd-settings` 配置。
|
||||
|
||||
### 工作流代理
|
||||
|
||||
@@ -653,9 +653,9 @@ GSD 将项目设置保存在 `.planning/config.json`。你可以在 `/gsd:new-pr
|
||||
| `workflow.skip_discuss` | `false` | 在自主模式下完全跳过讨论阶段 |
|
||||
| `workflow.discuss_mode` | `null` | 控制讨论阶段行为（`assumptions` 使用推断默认值） |
|
||||
|
||||
可以用 `/gsd:settings` 开关这些项，也可以在单次命令里覆盖：
|
||||
- `/gsd:plan-phase --skip-research`
|
||||
- `/gsd:plan-phase --skip-verify`
|
||||
可以用 `/gsd-settings` 开关这些项，也可以在单次命令里覆盖：
|
||||
- `/gsd-plan-phase --skip-research`
|
||||
- `/gsd-plan-phase --skip-verify`
|
||||
|
||||
### 执行
|
||||
|
||||
@@ -723,7 +723,7 @@ GSD 的代码库映射和分析命令会读取文件来理解你的项目。**
|
||||
- 对 Codex，检查 skills 是否存在于 `~/.codex/skills/gsd-*/SKILL.md`（全局）或 `./.codex/skills/gsd-*/SKILL.md`（本地）
|
||||
|
||||
**命令行为不符合预期？**
|
||||
- 运行 `/gsd:help` 确认安装成功
|
||||
- 运行 `/gsd-help` 确认安装成功
|
||||
- 重新执行 `npx get-shit-done-cc` 进行重装
|
||||
|
||||
**想更新到最新版本？**
|
||||
|
||||
@@ -14,7 +14,7 @@ color: cyan
|
||||
<role>
|
||||
You are a GSD codebase mapper. You explore a codebase for a specific focus area and write analysis documents directly to `.planning/codebase/`.
|
||||
|
||||
You are spawned by `/gsd:map-codebase` with one of four focus areas:
|
||||
You are spawned by `/gsd-map-codebase` with one of four focus areas:
|
||||
- **tech**: Analyze technology stack and external integrations → write STACK.md and INTEGRATIONS.md
|
||||
- **arch**: Analyze architecture and file structure → write ARCHITECTURE.md and STRUCTURE.md
|
||||
- **quality**: Analyze coding conventions and testing patterns → write CONVENTIONS.md and TESTING.md
|
||||
@@ -29,7 +29,7 @@ If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool t
|
||||
<why_this_matters>
|
||||
**These documents are consumed by other GSD commands:**
|
||||
|
||||
**`/gsd:plan-phase`** loads relevant codebase docs when creating implementation plans:
|
||||
**`/gsd-plan-phase`** loads relevant codebase docs when creating implementation plans:
|
||||
| Phase Type | Documents Loaded |
|
||||
|------------|------------------|
|
||||
| UI, frontend, components | CONVENTIONS.md, STRUCTURE.md |
|
||||
@@ -40,7 +40,7 @@ If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool t
|
||||
| refactor, cleanup | CONCERNS.md, ARCHITECTURE.md |
|
||||
| setup, config | STACK.md, STRUCTURE.md |
|
||||
|
||||
**`/gsd:execute-phase`** references codebase docs to:
|
||||
**`/gsd-execute-phase`** references codebase docs to:
|
||||
- Follow existing conventions when writing code
|
||||
- Know where to place new files (STRUCTURE.md)
|
||||
- Match testing patterns (TESTING.md)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-debugger
|
||||
description: Investigates bugs using scientific method, manages debug sessions, handles checkpoints. Spawned by /gsd:debug orchestrator.
|
||||
description: Investigates bugs using scientific method, manages debug sessions, handles checkpoints. Spawned by /gsd-debug orchestrator.
|
||||
tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
|
||||
color: orange
|
||||
# hooks:
|
||||
@@ -16,7 +16,7 @@ You are a GSD debugger. You investigate bugs using systematic scientific method,
|
||||
|
||||
You are spawned by:
|
||||
|
||||
- `/gsd:debug` command (interactive debugging)
|
||||
- `/gsd-debug` command (interactive debugging)
|
||||
- `diagnose-issues` workflow (parallel UAT diagnosis)
|
||||
|
||||
Your job: Find the root cause through hypothesis testing, maintain debug file state, optionally fix and verify (depending on mode).
|
||||
@@ -991,7 +991,7 @@ Gather symptoms through questioning. Update file after EACH answer.
|
||||
- Otherwise -> proceed to fix_and_verify
|
||||
- **ELIMINATED:** Append to Eliminated section, form new hypothesis, return to Phase 2
|
||||
|
||||
**Context management:** After 5+ evidence entries, ensure Current Focus is updated. Suggest "/clear - run /gsd:debug to resume" if context filling up.
|
||||
**Context management:** After 5+ evidence entries, ensure Current Focus is updated. Suggest "/clear - run /gsd-debug to resume" if context filling up.
|
||||
</step>
|
||||
|
||||
<step name="resume_from_file">
|
||||
|
||||
@@ -14,7 +14,7 @@ color: orange
|
||||
<role>
|
||||
You are a GSD doc verifier. You check factual claims in project documentation against the live codebase.
|
||||
|
||||
You are spawned by the `/gsd:docs-update` workflow. Each spawn receives a `<verify_assignment>` XML block containing:
|
||||
You are spawned by the `/gsd-docs-update` workflow. Each spawn receives a `<verify_assignment>` XML block containing:
|
||||
- `doc_path`: path to the doc file to verify (relative to project_root)
|
||||
- `project_root`: absolute path to project root
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ color: purple
|
||||
<role>
|
||||
You are a GSD doc writer. You write and update project documentation files for a target project.
|
||||
|
||||
You are spawned by `/gsd:docs-update` workflow. Each spawn receives a `<doc_assignment>` XML block in the prompt containing:
|
||||
You are spawned by `/gsd-docs-update` workflow. Each spawn receives a `<doc_assignment>` XML block in the prompt containing:
|
||||
- `type`: one of `readme`, `architecture`, `getting_started`, `development`, `testing`, `api`, `configuration`, `deployment`, `contributing`, or `custom`
|
||||
- `mode`: `create` (new doc from scratch), `update` (revise existing GSD-generated doc), `supplement` (append missing sections to a hand-written doc), or `fix` (correct specific claims flagged by gsd-doc-verifier)
|
||||
- `project_context`: JSON from docs-init output (project_root, project_type, doc_tooling, etc.)
|
||||
@@ -579,8 +579,8 @@ change — only location and metadata change.
|
||||
|
||||
<critical_rules>
|
||||
|
||||
1. NEVER include GSD methodology content in generated docs — no references to phases, plans, `/gsd:` commands, PLAN.md, ROADMAP.md, or any GSD workflow concepts. Generated docs describe the TARGET PROJECT exclusively.
|
||||
2. NEVER touch CHANGELOG.md — it is managed by `/gsd:ship` and is out of scope.
|
||||
1. NEVER include GSD methodology content in generated docs — no references to phases, plans, `/gsd-` commands, PLAN.md, ROADMAP.md, or any GSD workflow concepts. Generated docs describe the TARGET PROJECT exclusively.
|
||||
2. NEVER touch CHANGELOG.md — it is managed by `/gsd-ship` and is out of scope.
|
||||
3. ALWAYS include the GSD marker `<!-- generated-by: gsd-doc-writer -->` as the first line of every generated doc file (except supplement mode — see rule 7).
|
||||
4. ALWAYS explore the actual codebase before writing — never fabricate file paths, function names, endpoints, or configuration values.
|
||||
8. **ALWAYS use the Write tool to create files** — never use `Bash(cat << 'EOF')` or heredoc commands for file creation.
|
||||
|
||||
@@ -14,7 +14,7 @@ color: yellow
|
||||
<role>
|
||||
You are a GSD plan executor. You execute PLAN.md files atomically, creating per-task commits, handling deviations automatically, pausing at checkpoints, and producing SUMMARY.md files.
|
||||
|
||||
Spawned by `/gsd:execute-phase` orchestrator.
|
||||
Spawned by `/gsd-execute-phase` orchestrator.
|
||||
|
||||
Your job: Execute the plan completely, commit each task, create SUMMARY.md, update STATE.md.
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@ color: "#8B5CF6"
|
||||
---
|
||||
|
||||
<role>
|
||||
GSD Nyquist auditor. Spawned by /gsd:validate-phase to fill validation gaps in completed phases.
|
||||
GSD Nyquist auditor. Spawned by /gsd-validate-phase to fill validation gaps in completed phases.
|
||||
|
||||
For each gap in `<gaps>`: generate minimal behavioral test, run it, debug if failing (max 3 iterations), report results.
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-phase-researcher
|
||||
description: Researches how to implement a phase before planning. Produces RESEARCH.md consumed by gsd-planner. Spawned by /gsd:plan-phase orchestrator.
|
||||
description: Researches how to implement a phase before planning. Produces RESEARCH.md consumed by gsd-planner. Spawned by /gsd-plan-phase orchestrator.
|
||||
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*
|
||||
color: cyan
|
||||
# hooks:
|
||||
@@ -14,7 +14,7 @@ color: cyan
|
||||
<role>
|
||||
You are a GSD phase researcher. You answer "What do I need to know to PLAN this phase well?" and produce a single RESEARCH.md that the planner consumes.
|
||||
|
||||
Spawned by `/gsd:plan-phase` (integrated) or `/gsd:research-phase` (standalone).
|
||||
Spawned by `/gsd-plan-phase` (integrated) or `/gsd-research-phase` (standalone).
|
||||
|
||||
**CRITICAL: Mandatory Initial Read**
|
||||
If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool to load every file listed there before performing any other actions. This is your primary context.
|
||||
@@ -52,7 +52,7 @@ This ensures research aligns with project-specific conventions and libraries.
|
||||
</project_context>
|
||||
|
||||
<upstream_input>
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd:discuss-phase`
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd-discuss-phase`
|
||||
|
||||
| Section | How You Use It |
|
||||
|---------|----------------|
|
||||
@@ -404,7 +404,7 @@ Verified patterns from official sources:
|
||||
### Sampling Rate
|
||||
- **Per task commit:** `{quick run command}`
|
||||
- **Per wave merge:** `{full suite command}`
|
||||
- **Phase gate:** Full suite green before `/gsd:verify-work`
|
||||
- **Phase gate:** Full suite green before `/gsd-verify-work`
|
||||
|
||||
### Wave 0 Gaps
|
||||
- [ ] `{tests/test_file.py}` — covers REQ-{XX}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-plan-checker
|
||||
description: Verifies plans will achieve phase goal before execution. Goal-backward analysis of plan quality. Spawned by /gsd:plan-phase orchestrator.
|
||||
description: Verifies plans will achieve phase goal before execution. Goal-backward analysis of plan quality. Spawned by /gsd-plan-phase orchestrator.
|
||||
tools: Read, Bash, Glob, Grep
|
||||
color: green
|
||||
---
|
||||
@@ -8,7 +8,7 @@ color: green
|
||||
<role>
|
||||
You are a GSD plan checker. Verify that plans WILL achieve the phase goal, not just that they look complete.
|
||||
|
||||
Spawned by `/gsd:plan-phase` orchestrator (after planner creates PLAN.md) or re-verification (after planner revises).
|
||||
Spawned by `/gsd-plan-phase` orchestrator (after planner creates PLAN.md) or re-verification (after planner revises).
|
||||
|
||||
Goal-backward verification of PLANS before execution. Start from what the phase SHOULD deliver, verify plans address it.
|
||||
|
||||
@@ -42,7 +42,7 @@ This ensures verification checks that plans follow project-specific conventions.
|
||||
</project_context>
|
||||
|
||||
<upstream_input>
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd:discuss-phase`
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd-discuss-phase`
|
||||
|
||||
| Section | How You Use It |
|
||||
|---------|----------------|
|
||||
@@ -271,7 +271,7 @@ issue:
|
||||
|
||||
## Dimension 7: Context Compliance (if CONTEXT.md exists)
|
||||
|
||||
**Question:** Do plans honor user decisions from /gsd:discuss-phase?
|
||||
**Question:** Do plans honor user decisions from /gsd-discuss-phase?
|
||||
|
||||
**Only check if CONTEXT.md was provided in the verification context.**
|
||||
|
||||
@@ -369,7 +369,7 @@ Before running checks 8a-8d, verify VALIDATION.md exists:
|
||||
ls "${PHASE_DIR}"/*-VALIDATION.md 2>/dev/null
|
||||
```
|
||||
|
||||
**If missing:** **BLOCKING FAIL** — "VALIDATION.md not found for phase {N}. Re-run `/gsd:plan-phase {N} --research` to regenerate."
|
||||
**If missing:** **BLOCKING FAIL** — "VALIDATION.md not found for phase {N}. Re-run `/gsd-plan-phase {N} --research` to regenerate."
|
||||
Skip checks 8a-8d entirely. Report Dimension 8 as FAIL with this single issue.
|
||||
|
||||
**If exists:** Proceed to checks 8a-8d.
|
||||
@@ -775,7 +775,7 @@ Return all issues as a structured `issues:` YAML list (see dimension examples fo
|
||||
| 01 | 3 | 5 | 1 | Valid |
|
||||
| 02 | 2 | 4 | 2 | Valid |
|
||||
|
||||
Plans verified. Run `/gsd:execute-phase {phase}` to proceed.
|
||||
Plans verified. Run `/gsd-execute-phase {phase}` to proceed.
|
||||
```
|
||||
|
||||
## ISSUES FOUND
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-planner
|
||||
description: Creates executable phase plans with task breakdown, dependency analysis, and goal-backward verification. Spawned by /gsd:plan-phase orchestrator.
|
||||
description: Creates executable phase plans with task breakdown, dependency analysis, and goal-backward verification. Spawned by /gsd-plan-phase orchestrator.
|
||||
tools: Read, Write, Bash, Glob, Grep, WebFetch, mcp__context7__*
|
||||
color: green
|
||||
# hooks:
|
||||
@@ -15,10 +15,10 @@ color: green
|
||||
You are a GSD planner. You create executable phase plans with task breakdown, dependency analysis, and goal-backward verification.
|
||||
|
||||
Spawned by:
|
||||
- `/gsd:plan-phase` orchestrator (standard phase planning)
|
||||
- `/gsd:plan-phase --gaps` orchestrator (gap closure from verification failures)
|
||||
- `/gsd:plan-phase` in revision mode (updating plans based on checker feedback)
|
||||
- `/gsd:plan-phase --reviews` orchestrator (replanning with cross-AI review feedback)
|
||||
- `/gsd-plan-phase` orchestrator (standard phase planning)
|
||||
- `/gsd-plan-phase --gaps` orchestrator (gap closure from verification failures)
|
||||
- `/gsd-plan-phase` in revision mode (updating plans based on checker feedback)
|
||||
- `/gsd-plan-phase --reviews` orchestrator (replanning with cross-AI review feedback)
|
||||
|
||||
Your job: Produce PLAN.md files that Claude executors can implement without interpretation. Plans are prompts, not documents that become prompts.
|
||||
|
||||
@@ -60,7 +60,7 @@ This ensures task actions reference the correct patterns and libraries for this
|
||||
<context_fidelity>
|
||||
## CRITICAL: User Decision Fidelity
|
||||
|
||||
The orchestrator provides user decisions in `<user_decisions>` tags from `/gsd:discuss-phase`.
|
||||
The orchestrator provides user decisions in `<user_decisions>` tags from `/gsd-discuss-phase`.
|
||||
|
||||
**Before creating ANY task, verify:**
|
||||
|
||||
@@ -194,7 +194,7 @@ Discovery is MANDATORY unless you can prove current context exists.
|
||||
- Level 2+: New library not in package.json, external API, "choose/select/evaluate" in description
|
||||
- Level 3: "architecture/design/system", multiple external services, data modeling, auth design
|
||||
|
||||
For niche domains (3D, games, audio, shaders, ML), suggest `/gsd:research-phase` before plan-phase.
|
||||
For niche domains (3D, games, audio, shaders, ML), suggest `/gsd-research-phase` before plan-phase.
|
||||
|
||||
</discovery_levels>
|
||||
|
||||
@@ -1011,8 +1011,8 @@ Read the most recent milestone retrospective and cross-milestone trends. Extract
|
||||
Use `phase_dir` from init context (already loaded in load_project_state).
|
||||
|
||||
```bash
|
||||
cat "$phase_dir"/*-CONTEXT.md 2>/dev/null # From /gsd:discuss-phase
|
||||
cat "$phase_dir"/*-RESEARCH.md 2>/dev/null # From /gsd:research-phase
|
||||
cat "$phase_dir"/*-CONTEXT.md 2>/dev/null # From /gsd-discuss-phase
|
||||
cat "$phase_dir"/*-RESEARCH.md 2>/dev/null # From /gsd-research-phase
|
||||
cat "$phase_dir"/*-DISCOVERY.md 2>/dev/null # From mandatory discovery
|
||||
```
|
||||
|
||||
@@ -1214,7 +1214,7 @@ Return structured planning outcome to orchestrator.
|
||||
|
||||
### Next Steps
|
||||
|
||||
Execute: `/gsd:execute-phase {phase}`
|
||||
Execute: `/gsd-execute-phase {phase}`
|
||||
|
||||
<sub>`/clear` first - fresh context window</sub>
|
||||
```
|
||||
@@ -1235,7 +1235,7 @@ Execute: `/gsd:execute-phase {phase}`
|
||||
|
||||
### Next Steps
|
||||
|
||||
Execute: `/gsd:execute-phase {phase} --gaps-only`
|
||||
Execute: `/gsd-execute-phase {phase} --gaps-only`
|
||||
```
|
||||
|
||||
## Checkpoint Reached / Revision Complete
|
||||
@@ -1278,6 +1278,6 @@ Planning complete when:
|
||||
- [ ] PLAN file(s) exist with gap_closure: true
|
||||
- [ ] Each plan: tasks derived from gap.missing items
|
||||
- [ ] PLAN file(s) committed to git
|
||||
- [ ] User knows to run `/gsd:execute-phase {X}` next
|
||||
- [ ] User knows to run `/gsd-execute-phase {X}` next
|
||||
|
||||
</success_criteria>
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-project-researcher
|
||||
description: Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /gsd:new-project or /gsd:new-milestone orchestrators.
|
||||
description: Researches domain ecosystem before roadmap creation. Produces files in .planning/research/ consumed during roadmap creation. Spawned by /gsd-new-project or /gsd-new-milestone orchestrators.
|
||||
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*
|
||||
color: cyan
|
||||
# hooks:
|
||||
@@ -12,7 +12,7 @@ color: cyan
|
||||
---
|
||||
|
||||
<role>
|
||||
You are a GSD project researcher spawned by `/gsd:new-project` or `/gsd:new-milestone` (Phase 6: Research).
|
||||
You are a GSD project researcher spawned by `/gsd-new-project` or `/gsd-new-milestone` (Phase 6: Research).
|
||||
|
||||
Answer "What does this domain ecosystem look like?" Write research files in `.planning/research/` that inform roadmap creation.
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-research-synthesizer
|
||||
description: Synthesizes research outputs from parallel researcher agents into SUMMARY.md. Spawned by /gsd:new-project after 4 researcher agents complete.
|
||||
description: Synthesizes research outputs from parallel researcher agents into SUMMARY.md. Spawned by /gsd-new-project after 4 researcher agents complete.
|
||||
tools: Read, Write, Bash
|
||||
color: purple
|
||||
# hooks:
|
||||
@@ -16,7 +16,7 @@ You are a GSD research synthesizer. You read the outputs from 4 parallel researc
|
||||
|
||||
You are spawned by:
|
||||
|
||||
- `/gsd:new-project` orchestrator (after STACK, FEATURES, ARCHITECTURE, PITFALLS research completes)
|
||||
- `/gsd-new-project` orchestrator (after STACK, FEATURES, ARCHITECTURE, PITFALLS research completes)
|
||||
|
||||
Your job: Create a unified research summary that informs roadmap creation. Extract key findings, identify patterns across research files, and produce roadmap implications.
|
||||
|
||||
@@ -112,7 +112,7 @@ This is the most important section. Based on combined research:
|
||||
- Which pitfalls it must avoid
|
||||
|
||||
**Add research flags:**
|
||||
- Which phases likely need `/gsd:research-phase` during planning?
|
||||
- Which phases likely need `/gsd-research-phase` during planning?
|
||||
- Which phases have well-documented patterns (skip research)?
|
||||
|
||||
## Step 5: Assess Confidence
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-roadmapper
|
||||
description: Creates project roadmaps with phase breakdown, requirement mapping, success criteria derivation, and coverage validation. Spawned by /gsd:new-project orchestrator.
|
||||
description: Creates project roadmaps with phase breakdown, requirement mapping, success criteria derivation, and coverage validation. Spawned by /gsd-new-project orchestrator.
|
||||
tools: Read, Write, Bash, Glob, Grep
|
||||
color: purple
|
||||
# hooks:
|
||||
@@ -16,7 +16,7 @@ You are a GSD roadmapper. You create project roadmaps that map requirements to p
|
||||
|
||||
You are spawned by:
|
||||
|
||||
- `/gsd:new-project` orchestrator (unified project initialization)
|
||||
- `/gsd-new-project` orchestrator (unified project initialization)
|
||||
|
||||
Your job: Transform requirements into a phase structure that delivers the project. Every v1 requirement maps to exactly one phase. Every phase has observable success criteria.
|
||||
|
||||
@@ -33,7 +33,7 @@ If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool t
|
||||
</role>
|
||||
|
||||
<downstream_consumer>
|
||||
Your ROADMAP.md is consumed by `/gsd:plan-phase` which uses it to:
|
||||
Your ROADMAP.md is consumed by `/gsd-plan-phase` which uses it to:
|
||||
|
||||
| Output | How Plan-Phase Uses It |
|
||||
|--------|------------------------|
|
||||
@@ -191,7 +191,7 @@ Track coverage as you go.
|
||||
**Integer phases (1, 2, 3):** Planned milestone work.
|
||||
|
||||
**Decimal phases (2.1, 2.2):** Urgent insertions after planning.
|
||||
- Created via `/gsd:insert-phase`
|
||||
- Created via `/gsd-insert-phase`
|
||||
- Execute between integers: 1 → 1.1 → 1.2 → 2
|
||||
|
||||
**Starting number:**
|
||||
@@ -352,7 +352,7 @@ Svelte, Next.js, Nuxt
|
||||
**UI hint**: yes
|
||||
```
|
||||
|
||||
This annotation is consumed by downstream workflows (`new-project`, `progress`) to suggest `/gsd:ui-phase` at the right time. Phases without UI indicators omit the annotation entirely.
|
||||
This annotation is consumed by downstream workflows (`new-project`, `progress`) to suggest `/gsd-ui-phase` at the right time. Phases without UI indicators omit the annotation entirely.
|
||||
|
||||
### 3. Progress Table
|
||||
|
||||
@@ -589,7 +589,7 @@ After incorporating user feedback and updating files:
|
||||
|
||||
### Ready for Planning
|
||||
|
||||
Next: `/gsd:plan-phase 1`
|
||||
Next: `/gsd-plan-phase 1`
|
||||
```
|
||||
|
||||
## Roadmap Blocked
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-security-auditor
|
||||
description: Verifies threat mitigations from PLAN.md threat model exist in implemented code. Produces SECURITY.md. Spawned by /gsd:secure-phase.
|
||||
description: Verifies threat mitigations from PLAN.md threat model exist in implemented code. Produces SECURITY.md. Spawned by /gsd-secure-phase.
|
||||
tools:
|
||||
- Read
|
||||
- Write
|
||||
@@ -12,7 +12,7 @@ color: "#EF4444"
|
||||
---
|
||||
|
||||
<role>
|
||||
GSD security auditor. Spawned by /gsd:secure-phase to verify that threat mitigations declared in PLAN.md are present in implemented code.
|
||||
GSD security auditor. Spawned by /gsd-secure-phase to verify that threat mitigations declared in PLAN.md are present in implemented code.
|
||||
|
||||
Does NOT scan blindly for new vulnerabilities. Verifies each threat in `<threat_model>` by its declared disposition (mitigate / accept / transfer). Reports gaps. Writes SECURITY.md.
|
||||
|
||||
@@ -96,7 +96,7 @@ SECURITY.md: {path}
|
||||
|-----------|----------|---------------------|----------------|
|
||||
| {id} | {category} | {pattern not found} | {file paths} |
|
||||
|
||||
Next: Implement mitigations or document as accepted in SECURITY.md accepted risks log, then re-run /gsd:secure-phase.
|
||||
Next: Implement mitigations or document as accepted in SECURITY.md accepted risks log, then re-run /gsd-secure-phase.
|
||||
|
||||
SECURITY.md: {path}
|
||||
```
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-ui-auditor
|
||||
description: Retroactive 6-pillar visual audit of implemented frontend code. Produces scored UI-REVIEW.md. Spawned by /gsd:ui-review orchestrator.
|
||||
description: Retroactive 6-pillar visual audit of implemented frontend code. Produces scored UI-REVIEW.md. Spawned by /gsd-ui-review orchestrator.
|
||||
tools: Read, Write, Bash, Grep, Glob
|
||||
color: "#F472B6"
|
||||
# hooks:
|
||||
@@ -14,7 +14,7 @@ color: "#F472B6"
|
||||
<role>
|
||||
You are a GSD UI auditor. You conduct retroactive visual and interaction audits of implemented frontend code and produce a scored UI-REVIEW.md.
|
||||
|
||||
Spawned by `/gsd:ui-review` orchestrator.
|
||||
Spawned by `/gsd-ui-review` orchestrator.
|
||||
|
||||
**CRITICAL: Mandatory Initial Read**
|
||||
If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool to load every file listed there before performing any other actions. This is your primary context.
|
||||
@@ -39,7 +39,7 @@ Before auditing, discover project context:
|
||||
</project_context>
|
||||
|
||||
<upstream_input>
|
||||
**UI-SPEC.md** (if exists) — Design contract from `/gsd:ui-phase`
|
||||
**UI-SPEC.md** (if exists) — Design contract from `/gsd-ui-phase`
|
||||
|
||||
| Section | How You Use It |
|
||||
|---------|----------------|
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-ui-checker
|
||||
description: Validates UI-SPEC.md design contracts against 6 quality dimensions. Produces BLOCK/FLAG/PASS verdicts. Spawned by /gsd:ui-phase orchestrator.
|
||||
description: Validates UI-SPEC.md design contracts against 6 quality dimensions. Produces BLOCK/FLAG/PASS verdicts. Spawned by /gsd-ui-phase orchestrator.
|
||||
tools: Read, Bash, Glob, Grep
|
||||
color: "#22D3EE"
|
||||
---
|
||||
@@ -8,7 +8,7 @@ color: "#22D3EE"
|
||||
<role>
|
||||
You are a GSD UI checker. Verify that UI-SPEC.md contracts are complete, consistent, and implementable before planning begins.
|
||||
|
||||
Spawned by `/gsd:ui-phase` orchestrator (after gsd-ui-researcher creates UI-SPEC.md) or re-verification (after researcher revises).
|
||||
Spawned by `/gsd-ui-phase` orchestrator (after gsd-ui-researcher creates UI-SPEC.md) or re-verification (after researcher revises).
|
||||
|
||||
**CRITICAL: Mandatory Initial Read**
|
||||
If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool to load every file listed there before performing any other actions. This is your primary context.
|
||||
@@ -41,7 +41,7 @@ This ensures verification respects project-specific design conventions.
|
||||
<upstream_input>
|
||||
**UI-SPEC.md** — Design contract from gsd-ui-researcher (primary input)
|
||||
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd:discuss-phase`
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd-discuss-phase`
|
||||
|
||||
| Section | How You Use It |
|
||||
|---------|----------------|
|
||||
@@ -181,7 +181,7 @@ fix_hint: "Use 8px or 12px instead"
|
||||
dimension: 6
|
||||
severity: BLOCK
|
||||
description: "Third-party registry 'magic-ui' listed with Safety Gate 'shadcn view + diff required' — this is intent, not evidence of actual vetting"
|
||||
fix_hint: "Re-run /gsd:ui-phase to trigger the registry vetting gate, or manually run 'npx shadcn view {block} --registry {url}' and record results"
|
||||
fix_hint: "Re-run /gsd-ui-phase to trigger the registry vetting gate, or manually run 'npx shadcn view {block} --registry {url}' and record results"
|
||||
```
|
||||
```yaml
|
||||
dimension: 6
|
||||
@@ -272,7 +272,7 @@ UI-SPEC approved. Planner can use as design context.
|
||||
- **Dimension {N} — {name}:** {description} (non-blocking)
|
||||
|
||||
### Action Required
|
||||
Fix blocking issues in UI-SPEC.md and re-run `/gsd:ui-phase`.
|
||||
Fix blocking issues in UI-SPEC.md and re-run `/gsd-ui-phase`.
|
||||
```
|
||||
|
||||
</structured_returns>
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd-ui-researcher
|
||||
description: Produces UI-SPEC.md design contract for frontend phases. Reads upstream artifacts, detects design system state, asks only unanswered questions. Spawned by /gsd:ui-phase orchestrator.
|
||||
description: Produces UI-SPEC.md design contract for frontend phases. Reads upstream artifacts, detects design system state, asks only unanswered questions. Spawned by /gsd-ui-phase orchestrator.
|
||||
tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*, mcp__firecrawl__*, mcp__exa__*
|
||||
color: "#E879F9"
|
||||
# hooks:
|
||||
@@ -14,7 +14,7 @@ color: "#E879F9"
|
||||
<role>
|
||||
You are a GSD UI researcher. You answer "What visual and interaction contracts does this phase need?" and produce a single UI-SPEC.md that the planner and executor consume.
|
||||
|
||||
Spawned by `/gsd:ui-phase` orchestrator.
|
||||
Spawned by `/gsd-ui-phase` orchestrator.
|
||||
|
||||
**CRITICAL: Mandatory Initial Read**
|
||||
If the prompt contains a `<files_to_read>` block, you MUST use the `Read` tool to load every file listed there before performing any other actions. This is your primary context.
|
||||
@@ -43,7 +43,7 @@ This ensures the design contract aligns with project-specific conventions and li
|
||||
</project_context>
|
||||
|
||||
<upstream_input>
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd:discuss-phase`
|
||||
**CONTEXT.md** (if exists) — User decisions from `/gsd-discuss-phase`
|
||||
|
||||
| Section | How You Use It |
|
||||
|---------|----------------|
|
||||
@@ -51,7 +51,7 @@ This ensures the design contract aligns with project-specific conventions and li
|
||||
| `## Claude's Discretion` | Your freedom areas — research and recommend |
|
||||
| `## Deferred Ideas` | Out of scope — ignore completely |
|
||||
|
||||
**RESEARCH.md** (if exists) — Technical findings from `/gsd:plan-phase`
|
||||
**RESEARCH.md** (if exists) — Technical findings from `/gsd-plan-phase`
|
||||
|
||||
| Section | How You Use It |
|
||||
|---------|----------------|
|
||||
|
||||
@@ -492,7 +492,7 @@ Parse the JSON to extract all phases. Identify phases with `number > current_pha
|
||||
|
||||
Before writing VERIFICATION.md, verify that the status field matches the decision tree from Step 9 — in particular, confirm that status is not `passed` when human verification items exist.
|
||||
|
||||
Structure gaps in YAML frontmatter for `/gsd:plan-phase --gaps`:
|
||||
Structure gaps in YAML frontmatter for `/gsd-plan-phase --gaps`:
|
||||
|
||||
```yaml
|
||||
gaps:
|
||||
@@ -661,7 +661,7 @@ All must-haves verified. Phase goal achieved. Ready to proceed.
|
||||
1. **{Truth 1}** — {reason}
|
||||
- Missing: {what needs to be added}
|
||||
|
||||
Structured gaps in VERIFICATION.md frontmatter for `/gsd:plan-phase --gaps`.
|
||||
Structured gaps in VERIFICATION.md frontmatter for `/gsd-plan-phase --gaps`.
|
||||
|
||||
{If human_needed:}
|
||||
### Human Verification Required
|
||||
@@ -682,7 +682,7 @@ Automated checks passed. Awaiting human verification.
|
||||
|
||||
**DO NOT skip key link verification.** 80% of stubs hide here — pieces exist but aren't connected.
|
||||
|
||||
**Structure gaps in YAML frontmatter** for `/gsd:plan-phase --gaps`.
|
||||
**Structure gaps in YAML frontmatter** for `/gsd-plan-phase --gaps`.
|
||||
|
||||
**DO flag for human verification when uncertain** (visual, real-time, external service).
|
||||
|
||||
|
||||
@@ -4912,7 +4912,7 @@ function reportLocalPatches(configDir, runtime = 'claude') {
|
||||
? '$gsd-reapply-patches'
|
||||
: runtime === 'cursor'
|
||||
? 'gsd-reapply-patches (mention the skill name)'
|
||||
: '/gsd:reapply-patches';
|
||||
: '/gsd-reapply-patches';
|
||||
console.log('');
|
||||
console.log(' ' + yellow + 'Local patches detected' + reset + ' (from v' + meta.from_version + '):');
|
||||
for (const f of meta.files) {
|
||||
|
||||
@@ -46,7 +46,7 @@ the normal phase sequence and accumulate context over time.
|
||||
**Plans:** 0 plans
|
||||
|
||||
Plans:
|
||||
- [ ] TBD (promote with /gsd:review-backlog when ready)
|
||||
- [ ] TBD (promote with /gsd-review-backlog when ready)
|
||||
```
|
||||
|
||||
5. **Commit:**
|
||||
@@ -62,15 +62,15 @@ the normal phase sequence and accumulate context over time.
|
||||
Directory: .planning/phases/{NEXT}-{slug}/
|
||||
|
||||
This item lives in the backlog parking lot.
|
||||
Use /gsd:discuss-phase {NEXT} to explore it further.
|
||||
Use /gsd:review-backlog to promote items to active milestone.
|
||||
Use /gsd-discuss-phase {NEXT} to explore it further.
|
||||
Use /gsd-review-backlog to promote items to active milestone.
|
||||
```
|
||||
|
||||
</process>
|
||||
|
||||
<notes>
|
||||
- 999.x numbering keeps backlog items out of the active phase sequence
|
||||
- Phase directories are created immediately, so /gsd:discuss-phase and /gsd:plan-phase work on them
|
||||
- Phase directories are created immediately, so /gsd-discuss-phase and /gsd-plan-phase work on them
|
||||
- No `Depends on:` field — backlog items are unsequenced by definition
|
||||
- Sparse numbering is fine (999.1, 999.3) — always uses next-decimal
|
||||
</notes>
|
||||
|
||||
@@ -13,8 +13,8 @@ allowed-tools:
|
||||
- AskUserQuestion
|
||||
argument-instructions: |
|
||||
Parse the argument as a phase number (integer, decimal, or letter-suffix), plus optional free-text instructions.
|
||||
Example: /gsd:add-tests 12
|
||||
Example: /gsd:add-tests 12 focus on edge cases in the pricing module
|
||||
Example: /gsd-add-tests 12
|
||||
Example: /gsd-add-tests 12 focus on edge cases in the pricing module
|
||||
---
|
||||
<objective>
|
||||
Generate unit and E2E tests for a completed phase, using its SUMMARY.md, CONTEXT.md, and VERIFICATION.md as specifications.
|
||||
|
||||
@@ -42,19 +42,19 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
||||
0. **Check for audit:**
|
||||
|
||||
- Look for `.planning/v{{version}}-MILESTONE-AUDIT.md`
|
||||
- If missing or stale: recommend `/gsd:audit-milestone` first
|
||||
- If audit status is `gaps_found`: recommend `/gsd:plan-milestone-gaps` first
|
||||
- If missing or stale: recommend `/gsd-audit-milestone` first
|
||||
- If audit status is `gaps_found`: recommend `/gsd-plan-milestone-gaps` first
|
||||
- If audit status is `passed`: proceed to step 1
|
||||
|
||||
```markdown
|
||||
## Pre-flight Check
|
||||
|
||||
{If no v{{version}}-MILESTONE-AUDIT.md:}
|
||||
⚠ No milestone audit found. Run `/gsd:audit-milestone` first to verify
|
||||
⚠ No milestone audit found. Run `/gsd-audit-milestone` first to verify
|
||||
requirements coverage, cross-phase integration, and E2E flows.
|
||||
|
||||
{If audit has gaps:}
|
||||
⚠ Milestone audit found gaps. Run `/gsd:plan-milestone-gaps` to create
|
||||
⚠ Milestone audit found gaps. Run `/gsd-plan-milestone-gaps` to create
|
||||
phases that close the gaps, or proceed anyway to accept as tech debt.
|
||||
|
||||
{If audit passed:}
|
||||
@@ -108,7 +108,7 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
||||
- Ask about pushing tag
|
||||
|
||||
8. **Offer next steps:**
|
||||
- `/gsd:new-milestone` — start next milestone (questioning → research → requirements → roadmap)
|
||||
- `/gsd-new-milestone` — start next milestone (questioning → research → requirements → roadmap)
|
||||
|
||||
</process>
|
||||
|
||||
@@ -132,5 +132,5 @@ Output: Milestone archived (roadmap + requirements), PROJECT.md evolved, git tag
|
||||
- **Archive before deleting:** Always create archive files before updating/deleting originals
|
||||
- **One-line summary:** Collapsed milestone in ROADMAP.md should be single line with link
|
||||
- **Context efficiency:** Archive keeps ROADMAP.md and REQUIREMENTS.md constant size per milestone
|
||||
- **Fresh requirements:** Next milestone starts with `/gsd:new-milestone` which includes requirements definition
|
||||
- **Fresh requirements:** Next milestone starts with `/gsd-new-milestone` which includes requirements definition
|
||||
</critical_rules>
|
||||
|
||||
@@ -117,13 +117,13 @@ Task(
|
||||
- Display root cause, confidence level, files involved, and suggested fix strategies
|
||||
- Offer options:
|
||||
- "Fix now" — spawn a continuation agent with `goal: find_and_fix` to apply the fix (see step 5)
|
||||
- "Plan fix" — suggest `/gsd:plan-phase --gaps`
|
||||
- "Plan fix" — suggest `/gsd-plan-phase --gaps`
|
||||
- "Manual fix" — done
|
||||
|
||||
**If `## DEBUG COMPLETE` (find_and_fix mode):**
|
||||
- Display root cause and fix summary
|
||||
- Offer options:
|
||||
- "Plan fix" — suggest `/gsd:plan-phase --gaps` if further work needed
|
||||
- "Plan fix" — suggest `/gsd-plan-phase --gaps` if further work needed
|
||||
- "Done" — mark resolved
|
||||
|
||||
**If `## CHECKPOINT REACHED`:**
|
||||
|
||||
@@ -12,7 +12,7 @@ Analyze freeform natural language input and dispatch to the most appropriate GSD
|
||||
|
||||
Acts as a smart dispatcher — never does the work itself. Matches intent to the best GSD command using routing rules, confirms the match, then hands off.
|
||||
|
||||
Use when you know what you want but don't know which `/gsd:*` command to run.
|
||||
Use when you know what you want but don't know which `/gsd-*` command to run.
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
|
||||
@@ -16,8 +16,8 @@ Execute a trivial task directly in the current context without spawning subagent
|
||||
or generating PLAN.md files. For tasks too small to justify planning overhead:
|
||||
typo fixes, config changes, small refactors, forgotten commits, simple additions.
|
||||
|
||||
This is NOT a replacement for /gsd:quick — use /gsd:quick for anything that
|
||||
needs research, multi-step planning, or verification. /gsd:fast is for tasks
|
||||
This is NOT a replacement for /gsd-quick — use /gsd-quick for anything that
|
||||
needs research, multi-step planning, or verification. /gsd-fast is for tasks
|
||||
you could describe in one sentence and execute in under 2 minutes.
|
||||
</objective>
|
||||
|
||||
|
||||
@@ -30,8 +30,8 @@ Focus area: $ARGUMENTS (optional - if provided, tells agents to focus on specifi
|
||||
Check for .planning/STATE.md - loads context if project already initialized
|
||||
|
||||
**This command can run:**
|
||||
- Before /gsd:new-project (brownfield codebases) - creates codebase map first
|
||||
- After /gsd:new-project (greenfield codebases) - updates codebase map as code evolves
|
||||
- Before /gsd-new-project (brownfield codebases) - creates codebase map first
|
||||
- After /gsd-new-project (greenfield codebases) - updates codebase map as code evolves
|
||||
- Anytime to refresh codebase understanding
|
||||
</context>
|
||||
|
||||
@@ -59,7 +59,7 @@ Check for .planning/STATE.md - loads context if project already initialized
|
||||
4. Wait for agents to complete, collect confirmations (NOT document contents)
|
||||
5. Verify all 7 documents exist with line counts
|
||||
6. Commit codebase map
|
||||
7. Offer next steps (typically: /gsd:new-project or /gsd:plan-phase)
|
||||
7. Offer next steps (typically: /gsd-new-project or /gsd-plan-phase)
|
||||
</process>
|
||||
|
||||
<success_criteria>
|
||||
|
||||
@@ -21,7 +21,7 @@ Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Ga
|
||||
- `.planning/ROADMAP.md` — phase structure (continues numbering)
|
||||
- `.planning/STATE.md` — reset for new milestone
|
||||
|
||||
**After:** `/gsd:plan-phase [N]` to start execution.
|
||||
**After:** `/gsd-plan-phase [N]` to start execution.
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
|
||||
@@ -29,7 +29,7 @@ Initialize a new project through unified flow: questioning → research (optiona
|
||||
- `.planning/ROADMAP.md` — phase structure
|
||||
- `.planning/STATE.md` — project memory
|
||||
|
||||
**After this command:** Run `/gsd:plan-phase 1` to start execution.
|
||||
**After this command:** Run `/gsd-plan-phase 1` to start execution.
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
|
||||
@@ -30,7 +30,7 @@ Create a physical workspace directory containing copies of specified git repos (
|
||||
- `<path>/.planning/` — independent planning directory
|
||||
- `<path>/<repo>/` — git worktree or clone for each specified repo
|
||||
|
||||
**After this command:** `cd` into the workspace and run `/gsd:new-project` to initialize GSD.
|
||||
**After this command:** `cd` into the workspace and run `/gsd-new-project` to initialize GSD.
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
|
||||
@@ -10,11 +10,11 @@ allowed-tools:
|
||||
- AskUserQuestion
|
||||
---
|
||||
<objective>
|
||||
Create all phases necessary to close gaps identified by `/gsd:audit-milestone`.
|
||||
Create all phases necessary to close gaps identified by `/gsd-audit-milestone`.
|
||||
|
||||
Reads MILESTONE-AUDIT.md, groups gaps into logical phases, creates phase entries in ROADMAP.md, and offers to plan each phase.
|
||||
|
||||
One command creates all fix phases — no manual `/gsd:add-phase` per gap.
|
||||
One command creates all fix phases — no manual `/gsd-add-phase` per gap.
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
|
||||
@@ -40,7 +40,7 @@ Phase number: $ARGUMENTS (optional — auto-detects next unplanned phase if omit
|
||||
- `--gaps` — Gap closure mode (reads VERIFICATION.md, skips research)
|
||||
- `--skip-verify` — Skip verification loop
|
||||
- `--prd <file>` — Use a PRD/acceptance criteria file instead of discuss-phase. Parses requirements into CONTEXT.md automatically. Skips discuss-phase entirely.
|
||||
- `--reviews` — Replan incorporating cross-AI review feedback from REVIEWS.md (produced by `/gsd:review`)
|
||||
- `--reviews` — Replan incorporating cross-AI review feedback from REVIEWS.md (produced by `/gsd-review`)
|
||||
- `--text` — Use plain-text numbered lists instead of TUI menus (required for `/rc` remote sessions)
|
||||
|
||||
Normalize phase input in step 2 before any directory lookups.
|
||||
|
||||
@@ -16,7 +16,7 @@ milestone arrives. Seeds solve context rot: instead of a one-liner in Deferred t
|
||||
reads, a seed preserves the full WHY, WHEN to surface, and breadcrumbs to details.
|
||||
|
||||
Creates: .planning/seeds/SEED-NNN-slug.md
|
||||
Consumed by: /gsd:new-milestone (scans seeds and presents matches)
|
||||
Consumed by: /gsd-new-milestone (scans seeds and presents matches)
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
|
||||
@@ -13,7 +13,7 @@ allowed-tools:
|
||||
---
|
||||
|
||||
<objective>
|
||||
Generate a developer behavioral profile from session analysis (or questionnaire) and produce artifacts (USER-PROFILE.md, /gsd:dev-preferences, CLAUDE.md section) that personalize Claude's responses.
|
||||
Generate a developer behavioral profile from session analysis (or questionnaire) and produce artifacts (USER-PROFILE.md, /gsd-dev-preferences, CLAUDE.md section) that personalize Claude's responses.
|
||||
|
||||
Routes to the profile-user workflow which orchestrates the full flow: consent gate, session analysis or questionnaire fallback, profile generation, result display, and artifact selection.
|
||||
</objective>
|
||||
|
||||
@@ -115,7 +115,7 @@ Read `backup-meta.json` from the patches directory.
|
||||
```
|
||||
No local patches found. Nothing to reapply.
|
||||
|
||||
Local patches are automatically saved when you run /gsd:update
|
||||
Local patches are automatically saved when you run /gsd-update
|
||||
after modifying any GSD workflow, command, or agent files.
|
||||
```
|
||||
Exit.
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: gsd:research-phase
|
||||
description: Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)
|
||||
description: Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
|
||||
argument-hint: "[phase]"
|
||||
allowed-tools:
|
||||
- Read
|
||||
@@ -11,7 +11,7 @@ allowed-tools:
|
||||
<objective>
|
||||
Research how to implement a phase. Spawns gsd-phase-researcher agent with phase context.
|
||||
|
||||
**Note:** This is a standalone research command. For most workflows, use `/gsd:plan-phase` which integrates research automatically.
|
||||
**Note:** This is a standalone research command. For most workflows, use `/gsd-plan-phase` which integrates research automatically.
|
||||
|
||||
**Use this command when:**
|
||||
- You want to research without planning yet
|
||||
@@ -115,7 +115,7 @@ Mode: ecosystem
|
||||
</additional_context>
|
||||
|
||||
<downstream_consumer>
|
||||
Your RESEARCH.md will be loaded by `/gsd:plan-phase` which uses specific sections:
|
||||
Your RESEARCH.md will be loaded by `/gsd-plan-phase` which uses specific sections:
|
||||
- `## Standard Stack` → Plans use these libraries
|
||||
- `## Architecture Patterns` → Task structure follows these
|
||||
- `## Don't Hand-Roll` → Tasks NEVER build custom solutions for listed problems
|
||||
|
||||
@@ -13,7 +13,7 @@ allowed-tools:
|
||||
<objective>
|
||||
Invoke external AI CLIs (Gemini, Claude, Codex, OpenCode) to independently review phase plans.
|
||||
Produces a structured REVIEWS.md with per-reviewer feedback that can be fed back into
|
||||
planning via /gsd:plan-phase --reviews.
|
||||
planning via /gsd-plan-phase --reviews.
|
||||
|
||||
**Flow:** Detect CLIs → Build review prompt → Invoke each CLI → Collect responses → Write REVIEWS.md
|
||||
</objective>
|
||||
|
||||
@@ -11,7 +11,7 @@ allowed-tools:
|
||||
- AskUserQuestion
|
||||
---
|
||||
<objective>
|
||||
Bridge local completion → merged PR. After /gsd:verify-work passes, ship the work: push branch, create PR with auto-generated body, optionally trigger review, and track the merge.
|
||||
Bridge local completion → merged PR. After /gsd-verify-work passes, ship the work: push branch, create PR with auto-generated body, optionally trigger review, and track the merge.
|
||||
|
||||
Closes the plan → execute → verify → ship loop.
|
||||
</objective>
|
||||
|
||||
@@ -39,7 +39,7 @@ For each thread, read the first few lines to show title and status:
|
||||
|
||||
If no threads exist, show:
|
||||
```
|
||||
No threads found. Create one with: /gsd:thread <description>
|
||||
No threads found. Create one with: /gsd-thread <description>
|
||||
```
|
||||
</mode_list>
|
||||
|
||||
@@ -111,7 +111,7 @@ Create a new thread:
|
||||
Thread: {slug}
|
||||
File: .planning/threads/{slug}.md
|
||||
|
||||
Resume anytime with: /gsd:thread {slug}
|
||||
Resume anytime with: /gsd-thread {slug}
|
||||
```
|
||||
</mode_create>
|
||||
|
||||
@@ -119,9 +119,9 @@ Create a new thread:
|
||||
|
||||
<notes>
|
||||
- Threads are NOT phase-scoped — they exist independently of the roadmap
|
||||
- Lighter weight than /gsd:pause-work — no phase state, no plan context
|
||||
- Lighter weight than /gsd-pause-work — no phase state, no plan context
|
||||
- The value is in Context and Next Steps — a cold-start session can pick up immediately
|
||||
- Threads can be promoted to phases or backlog items when they mature:
|
||||
/gsd:add-phase or /gsd:add-backlog with context from the thread
|
||||
/gsd-add-phase or /gsd-add-backlog with context from the thread
|
||||
- Thread files live in .planning/threads/ — no collision with phases or other GSD structures
|
||||
</notes>
|
||||
|
||||
@@ -16,7 +16,7 @@ Validate built features through conversational testing with persistent state.
|
||||
|
||||
Purpose: Confirm what Claude built actually works from user's perspective. One test at a time, plain text responses, no interrogation. When issues are found, automatically diagnose, plan fixes, and prepare for execution.
|
||||
|
||||
Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd:execute-phase
|
||||
Output: {phase_num}-UAT.md tracking all test results. If issues found: diagnosed gaps, verified fix plans ready for /gsd-execute-phase
|
||||
</objective>
|
||||
|
||||
<execution_context>
|
||||
|
||||
@@ -6,13 +6,13 @@ allowed-tools:
|
||||
- Bash
|
||||
---
|
||||
|
||||
# /gsd:workstreams
|
||||
# /gsd-workstreams
|
||||
|
||||
Manage parallel workstreams for concurrent milestone work.
|
||||
|
||||
## Usage
|
||||
|
||||
`/gsd:workstreams [subcommand] [args]`
|
||||
`/gsd-workstreams [subcommand] [args]`
|
||||
|
||||
### Subcommands
|
||||
|
||||
@@ -40,7 +40,7 @@ Display the workstreams in a table format showing name, status, current phase, a
|
||||
### create
|
||||
Run: `node "$GSD_TOOLS" workstream create <name> --raw --cwd "$CWD"`
|
||||
After creation, display the new workstream path and suggest next steps:
|
||||
- `/gsd:new-milestone --ws <name>` to set up the milestone
|
||||
- `/gsd-new-milestone --ws <name>` to set up the milestone
|
||||
|
||||
### status
|
||||
Run: `node "$GSD_TOOLS" workstream status <name> --raw --cwd "$CWD"`
|
||||
@@ -61,7 +61,7 @@ Run: `node "$GSD_TOOLS" workstream complete <name> --raw --cwd "$CWD"`
|
||||
Archive the workstream to milestones/.
|
||||
|
||||
### resume
|
||||
Set the workstream as active and suggest `/gsd:resume-work --ws <name>`.
|
||||
Set the workstream as active and suggest `/gsd-resume-work --ws <name>`.
|
||||
|
||||
## Step 3: Display Results
|
||||
|
||||
|
||||
@@ -34,7 +34,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:new-project`, `/gsd:new-milestone` |
|
||||
| **Spawned by** | `/gsd-new-project`, `/gsd-new-milestone` |
|
||||
| **Parallelism** | 4 instances (stack, features, architecture, pitfalls) |
|
||||
| **Tools** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -53,7 +53,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:plan-phase` |
|
||||
| **Spawned by** | `/gsd-plan-phase` |
|
||||
| **Parallelism** | 4 instances (same focus areas as project researcher) |
|
||||
| **Tools** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -72,7 +72,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:ui-phase` |
|
||||
| **Spawned by** | `/gsd-ui-phase` |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp (context7) |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -138,7 +138,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:new-project` (after 4 researchers complete) |
|
||||
| **Spawned by** | `/gsd-new-project` (after 4 researchers complete) |
|
||||
| **Parallelism** | Single instance (sequential after researchers) |
|
||||
| **Tools** | Read, Write, Bash |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -153,7 +153,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:plan-phase`, `/gsd:quick` |
|
||||
| **Spawned by** | `/gsd-plan-phase`, `/gsd-quick` |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Write, Bash, Glob, Grep, WebFetch, mcp (context7) |
|
||||
| **Model (balanced)** | Opus |
|
||||
@@ -175,7 +175,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:new-project` |
|
||||
| **Spawned by** | `/gsd-new-project` |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Write, Bash, Glob, Grep |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -196,7 +196,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:execute-phase`, `/gsd:quick` |
|
||||
| **Spawned by** | `/gsd-execute-phase`, `/gsd-quick` |
|
||||
| **Parallelism** | Multiple (parallel within waves, sequential across waves) |
|
||||
| **Tools** | Read, Write, Edit, Bash, Grep, Glob |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -219,7 +219,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:plan-phase` (verification loop, max 3 iterations) |
|
||||
| **Spawned by** | `/gsd-plan-phase` (verification loop, max 3 iterations) |
|
||||
| **Parallelism** | Single instance (iterative) |
|
||||
| **Tools** | Read, Bash, Glob, Grep |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -244,7 +244,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:audit-milestone` |
|
||||
| **Spawned by** | `/gsd-audit-milestone` |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Bash, Grep, Glob |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -259,7 +259,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:ui-phase` (validation loop, max 2 iterations) |
|
||||
| **Spawned by** | `/gsd-ui-phase` (validation loop, max 2 iterations) |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Bash, Glob, Grep |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -274,7 +274,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:execute-phase` (after all executors complete) |
|
||||
| **Spawned by** | `/gsd-execute-phase` (after all executors complete) |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Write, Bash, Grep, Glob |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -284,7 +284,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
**Key behaviors:**
|
||||
- Checks codebase against phase goals, not just task completion
|
||||
- PASS/FAIL with specific evidence
|
||||
- Logs issues for `/gsd:verify-work` to address
|
||||
- Logs issues for `/gsd-verify-work` to address
|
||||
|
||||
---
|
||||
|
||||
@@ -294,7 +294,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:validate-phase` |
|
||||
| **Spawned by** | `/gsd-validate-phase` |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Write, Edit, Bash, Grep, Glob |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -313,7 +313,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:ui-review` |
|
||||
| **Spawned by** | `/gsd-ui-review` |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read, Write, Bash, Grep, Glob |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -336,7 +336,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:map-codebase` |
|
||||
| **Spawned by** | `/gsd-map-codebase` |
|
||||
| **Parallelism** | 4 instances (tech, architecture, quality, concerns) |
|
||||
| **Tools** | Read, Bash, Grep, Glob, Write |
|
||||
| **Model (balanced)** | Haiku |
|
||||
@@ -356,7 +356,7 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:debug`, `/gsd:verify-work` (for failures) |
|
||||
| **Spawned by** | `/gsd-debug`, `/gsd-verify-work` (for failures) |
|
||||
| **Parallelism** | Single instance (interactive) |
|
||||
| **Tools** | Read, Write, Edit, Bash, Grep, Glob, WebSearch |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
@@ -381,12 +381,12 @@ GSD uses a multi-agent architecture where thin orchestrators (workflow files) sp
|
||||
|
||||
| Property | Value |
|
||||
|----------|-------|
|
||||
| **Spawned by** | `/gsd:profile-user` |
|
||||
| **Spawned by** | `/gsd-profile-user` |
|
||||
| **Parallelism** | Single instance |
|
||||
| **Tools** | Read |
|
||||
| **Model (balanced)** | Sonnet |
|
||||
| **Color** | Magenta |
|
||||
| **Produces** | `USER-PROFILE.md`, `/gsd:dev-preferences`, `CLAUDE.md` profile section |
|
||||
| **Produces** | `USER-PROFILE.md`, `/gsd-dev-preferences`, `CLAUDE.md` profile section |
|
||||
|
||||
**Behavioral Dimensions:**
|
||||
Communication style, decision patterns, debugging approach, UX preferences, vendor choices, frustration triggers, learning style, explanation depth.
|
||||
|
||||
@@ -31,7 +31,7 @@ GSD is a **meta-prompting framework** that sits between the user and AI coding a
|
||||
```
|
||||
┌──────────────────────────────────────────────────────┐
|
||||
│ USER │
|
||||
│ /gsd:command [args] │
|
||||
│ /gsd-command [args] │
|
||||
└─────────────────────┬────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────▼────────────────────────────────┐
|
||||
@@ -107,10 +107,10 @@ Multiple layers prevent common failure modes:
|
||||
### Commands (`commands/gsd/*.md`)
|
||||
|
||||
User-facing entry points. Each file contains YAML frontmatter (name, description, allowed-tools) and a prompt body that bootstraps the workflow. Commands are installed as:
|
||||
- **Claude Code:** Custom slash commands (`/gsd:command-name`)
|
||||
- **Claude Code:** Custom slash commands (`/gsd-command-name`)
|
||||
- **OpenCode / Kilo:** Slash commands (`/gsd-command-name`)
|
||||
- **Codex:** Skills (`$gsd-command-name`)
|
||||
- **Copilot:** Slash commands (`/gsd:command-name`)
|
||||
- **Copilot:** Slash commands (`/gsd-command-name`)
|
||||
- **Antigravity:** Skills
|
||||
|
||||
**Total commands:** 44
|
||||
@@ -378,13 +378,13 @@ Equivalent paths for other runtimes:
|
||||
├── STATE.md # Living memory: position, decisions, blockers, metrics
|
||||
├── config.json # Workflow configuration
|
||||
├── MILESTONES.md # Completed milestone archive
|
||||
├── research/ # Domain research from /gsd:new-project
|
||||
├── research/ # Domain research from /gsd-new-project
|
||||
│ ├── SUMMARY.md
|
||||
│ ├── STACK.md
|
||||
│ ├── FEATURES.md
|
||||
│ ├── ARCHITECTURE.md
|
||||
│ └── PITFALLS.md
|
||||
├── codebase/ # Brownfield mapping (from /gsd:map-codebase)
|
||||
├── codebase/ # Brownfield mapping (from /gsd-map-codebase)
|
||||
│ ├── STACK.md
|
||||
│ ├── ARCHITECTURE.md
|
||||
│ ├── CONVENTIONS.md
|
||||
@@ -410,13 +410,13 @@ Equivalent paths for other runtimes:
|
||||
├── todos/
|
||||
│ ├── pending/ # Captured ideas
|
||||
│ └── done/ # Completed todos
|
||||
├── threads/ # Persistent context threads (from /gsd:thread)
|
||||
├── seeds/ # Forward-looking ideas (from /gsd:plant-seed)
|
||||
├── threads/ # Persistent context threads (from /gsd-thread)
|
||||
├── seeds/ # Forward-looking ideas (from /gsd-plant-seed)
|
||||
├── debug/ # Active debug sessions
|
||||
│ ├── *.md # Active sessions
|
||||
│ ├── resolved/ # Archived sessions
|
||||
│ └── knowledge-base.md # Persistent debug learnings
|
||||
├── ui-reviews/ # Screenshots from /gsd:ui-review (gitignored)
|
||||
├── ui-reviews/ # Screenshots from /gsd-ui-review (gitignored)
|
||||
└── continue-here.md # Context handoff (from pause-work)
|
||||
```
|
||||
|
||||
@@ -439,7 +439,7 @@ The installer (`bin/install.js`, ~3,000 lines) handles:
|
||||
- Antigravity: Skills-first with Google model equivalents
|
||||
5. **Path normalization** — Replaces `~/.claude/` paths with runtime-specific paths
|
||||
6. **Settings integration** — Registers hooks in runtime's `settings.json`
|
||||
7. **Patch backup** — Since v1.17, backs up locally modified files to `gsd-local-patches/` for `/gsd:reapply-patches`
|
||||
7. **Patch backup** — Since v1.17, backs up locally modified files to `gsd-local-patches/` for `/gsd-reapply-patches`
|
||||
8. **Manifest tracking** — Writes `gsd-file-manifest.json` for clean uninstall
|
||||
9. **Uninstall mode** — `--uninstall` removes all GSD files, hooks, and settings
|
||||
|
||||
@@ -499,8 +499,8 @@ Debounce: 5 tool uses between repeated warnings. Severity escalation (WARNING→
|
||||
|
||||
**Workflow Guard** (`gsd-workflow-guard.js`):
|
||||
- Triggers on Write/Edit to non-`.planning/` files
|
||||
- Detects edits outside GSD workflow context (no active `/gsd:` command or Task subagent)
|
||||
- Advises using `/gsd:quick` or `/gsd:fast` for state-tracked changes
|
||||
- Detects edits outside GSD workflow context (no active `/gsd-` command or Task subagent)
|
||||
- Advises using `/gsd-quick` or `/gsd-fast` for state-tracked changes
|
||||
- Opt-in via `hooks.workflow_guard: true` (default: false)
|
||||
|
||||
---
|
||||
@@ -511,12 +511,12 @@ GSD supports multiple AI coding runtimes through a unified command/workflow arch
|
||||
|
||||
| Runtime | Command Format | Agent System | Config Location |
|
||||
|---------|---------------|--------------|-----------------|
|
||||
| Claude Code | `/gsd:command` | Task spawning | `~/.claude/` |
|
||||
| Claude Code | `/gsd-command` | Task spawning | `~/.claude/` |
|
||||
| OpenCode | `/gsd-command` | Subagent mode | `~/.config/opencode/` |
|
||||
| Kilo | `/gsd-command` | Subagent mode | `~/.config/kilo/` |
|
||||
| Gemini CLI | `/gsd:command` | Task spawning | `~/.gemini/` |
|
||||
| Gemini CLI | `/gsd-command` | Task spawning | `~/.gemini/` |
|
||||
| Codex | `$gsd-command` | Skills | `~/.codex/` |
|
||||
| Copilot | `/gsd:command` | Agent delegation | `~/.github/` |
|
||||
| Copilot | `/gsd-command` | Agent delegation | `~/.github/` |
|
||||
| Antigravity | Skills | Skills | `~/.gemini/antigravity/` |
|
||||
|
||||
### Abstraction Points
|
||||
|
||||
346
docs/COMMANDS.md
346
docs/COMMANDS.md
@@ -6,7 +6,7 @@
|
||||
|
||||
## Command Syntax
|
||||
|
||||
- **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 @@
|
||||
|
||||
## Core Workflow Commands
|
||||
|
||||
### `/gsd:new-project`
|
||||
### `/gsd-new-project`
|
||||
|
||||
Initialize a new project with deep context gathering.
|
||||
|
||||
@@ -26,13 +26,13 @@ Initialize a new project with deep context gathering.
|
||||
**Produces:** `PROJECT.md`, `REQUIREMENTS.md`, `ROADMAP.md`, `STATE.md`, `config.json`, `research/`, `CLAUDE.md`
|
||||
|
||||
```bash
|
||||
/gsd:new-project # Interactive mode
|
||||
/gsd:new-project --auto @prd.md # Auto-extract from PRD
|
||||
/gsd-new-project # Interactive mode
|
||||
/gsd-new-project --auto @prd.md # Auto-extract from PRD
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:new-workspace`
|
||||
### `/gsd-new-workspace`
|
||||
|
||||
Create an isolated workspace with repo copies and independent `.planning/` directory.
|
||||
|
||||
@@ -52,14 +52,14 @@ Create an isolated workspace with repo copies and independent `.planning/` direc
|
||||
**Produces:** `WORKSPACE.md`, `.planning/`, repo copies (worktrees or clones)
|
||||
|
||||
```bash
|
||||
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
/gsd:new-workspace --name feature-b --repos . --strategy worktree # Same-repo isolation
|
||||
/gsd:new-workspace --name spike --repos api,web --strategy clone # Full clones
|
||||
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
/gsd-new-workspace --name feature-b --repos . --strategy worktree # Same-repo isolation
|
||||
/gsd-new-workspace --name spike --repos api,web --strategy clone # Full clones
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:list-workspaces`
|
||||
### `/gsd-list-workspaces`
|
||||
|
||||
List active GSD workspaces and their status.
|
||||
|
||||
@@ -67,12 +67,12 @@ List active GSD workspaces and their status.
|
||||
**Shows:** Name, repo count, strategy, GSD project status
|
||||
|
||||
```bash
|
||||
/gsd:list-workspaces
|
||||
/gsd-list-workspaces
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:remove-workspace`
|
||||
### `/gsd-remove-workspace`
|
||||
|
||||
Remove a workspace and clean up git worktrees.
|
||||
|
||||
@@ -83,12 +83,12 @@ Remove a workspace and clean up git worktrees.
|
||||
**Safety:** Refuses removal if any repo has uncommitted changes. Requires name confirmation.
|
||||
|
||||
```bash
|
||||
/gsd:remove-workspace feature-b
|
||||
/gsd-remove-workspace feature-b
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:discuss-phase`
|
||||
### `/gsd-discuss-phase`
|
||||
|
||||
Capture implementation decisions before planning.
|
||||
|
||||
@@ -106,15 +106,15 @@ Capture implementation decisions before planning.
|
||||
**Produces:** `{phase}-CONTEXT.md`, `{phase}-DISCUSSION-LOG.md` (audit trail)
|
||||
|
||||
```bash
|
||||
/gsd:discuss-phase 1 # Interactive discussion for phase 1
|
||||
/gsd:discuss-phase 3 --auto # Auto-select defaults for phase 3
|
||||
/gsd:discuss-phase --batch # Batch mode for current phase
|
||||
/gsd:discuss-phase 2 --analyze # Discussion with trade-off analysis
|
||||
/gsd-discuss-phase 1 # Interactive discussion for phase 1
|
||||
/gsd-discuss-phase 3 --auto # Auto-select defaults for phase 3
|
||||
/gsd-discuss-phase --batch # Batch mode for current phase
|
||||
/gsd-discuss-phase 2 --analyze # Discussion with trade-off analysis
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:ui-phase`
|
||||
### `/gsd-ui-phase`
|
||||
|
||||
Generate UI design contract for frontend phases.
|
||||
|
||||
@@ -126,12 +126,12 @@ Generate UI design contract for frontend phases.
|
||||
**Produces:** `{phase}-UI-SPEC.md`
|
||||
|
||||
```bash
|
||||
/gsd:ui-phase 2 # Design contract for phase 2
|
||||
/gsd-ui-phase 2 # Design contract for phase 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:plan-phase`
|
||||
### `/gsd-plan-phase`
|
||||
|
||||
Research, plan, and verify a phase.
|
||||
|
||||
@@ -153,14 +153,14 @@ Research, plan, and verify a phase.
|
||||
**Produces:** `{phase}-RESEARCH.md`, `{phase}-{N}-PLAN.md`, `{phase}-VALIDATION.md`
|
||||
|
||||
```bash
|
||||
/gsd:plan-phase 1 # Research + plan + verify phase 1
|
||||
/gsd:plan-phase 3 --skip-research # Plan without research (familiar domain)
|
||||
/gsd:plan-phase --auto # Non-interactive planning
|
||||
/gsd-plan-phase 1 # Research + plan + verify phase 1
|
||||
/gsd-plan-phase 3 --skip-research # Plan without research (familiar domain)
|
||||
/gsd-plan-phase --auto # Non-interactive planning
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:execute-phase`
|
||||
### `/gsd-execute-phase`
|
||||
|
||||
Execute all plans in a phase with wave-based parallelization, or run a specific wave.
|
||||
|
||||
@@ -173,13 +173,13 @@ Execute all plans in a phase with wave-based parallelization, or run a specific
|
||||
**Produces:** per-plan `{phase}-{N}-SUMMARY.md`, git commits, and `{phase}-VERIFICATION.md` when the phase is fully complete
|
||||
|
||||
```bash
|
||||
/gsd:execute-phase 1 # Execute phase 1
|
||||
/gsd:execute-phase 1 --wave 2 # Execute only Wave 2
|
||||
/gsd-execute-phase 1 # Execute phase 1
|
||||
/gsd-execute-phase 1 --wave 2 # Execute only Wave 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:verify-work`
|
||||
### `/gsd-verify-work`
|
||||
|
||||
User acceptance testing with auto-diagnosis.
|
||||
|
||||
@@ -191,31 +191,31 @@ User acceptance testing with auto-diagnosis.
|
||||
**Produces:** `{phase}-UAT.md`, fix plans if issues found
|
||||
|
||||
```bash
|
||||
/gsd:verify-work 1 # UAT for phase 1
|
||||
/gsd-verify-work 1 # UAT for phase 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:next`
|
||||
### `/gsd-next`
|
||||
|
||||
Automatically advance to the next logical workflow step. Reads project state and runs the appropriate command.
|
||||
|
||||
**Prerequisites:** `.planning/` directory exists
|
||||
**Behavior:**
|
||||
- No project → suggests `/gsd:new-project`
|
||||
- Phase needs discussion → runs `/gsd:discuss-phase`
|
||||
- Phase needs planning → runs `/gsd:plan-phase`
|
||||
- Phase needs execution → runs `/gsd:execute-phase`
|
||||
- Phase needs verification → runs `/gsd:verify-work`
|
||||
- All phases complete → suggests `/gsd:complete-milestone`
|
||||
- No project → suggests `/gsd-new-project`
|
||||
- Phase needs discussion → runs `/gsd-discuss-phase`
|
||||
- Phase needs planning → runs `/gsd-plan-phase`
|
||||
- Phase needs execution → runs `/gsd-execute-phase`
|
||||
- Phase needs verification → runs `/gsd-verify-work`
|
||||
- All phases complete → suggests `/gsd-complete-milestone`
|
||||
|
||||
```bash
|
||||
/gsd:next # Auto-detect and run next step
|
||||
/gsd-next # Auto-detect and run next step
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:session-report`
|
||||
### `/gsd-session-report`
|
||||
|
||||
Generate a session report with work summary, outcomes, and estimated resource usage.
|
||||
|
||||
@@ -223,7 +223,7 @@ Generate a session report with work summary, outcomes, and estimated resource us
|
||||
**Produces:** `.planning/reports/SESSION_REPORT.md`
|
||||
|
||||
```bash
|
||||
/gsd:session-report # Generate post-session summary
|
||||
/gsd-session-report # Generate post-session summary
|
||||
```
|
||||
|
||||
**Report includes:**
|
||||
@@ -235,7 +235,7 @@ Generate a session report with work summary, outcomes, and estimated resource us
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:ship`
|
||||
### `/gsd-ship`
|
||||
|
||||
Create PR from completed phase work with auto-generated body.
|
||||
|
||||
@@ -244,12 +244,12 @@ Create PR from completed phase work with auto-generated body.
|
||||
| `N` | No | Phase number or milestone version (e.g., `4` or `v1.0`) |
|
||||
| `--draft` | No | Create as draft PR |
|
||||
|
||||
**Prerequisites:** Phase verified (`/gsd:verify-work` passed), `gh` CLI installed and authenticated
|
||||
**Prerequisites:** Phase verified (`/gsd-verify-work` passed), `gh` CLI installed and authenticated
|
||||
**Produces:** GitHub PR with rich body from planning artifacts, STATE.md updated
|
||||
|
||||
```bash
|
||||
/gsd:ship 4 # Ship phase 4
|
||||
/gsd:ship 4 --draft # Ship as draft PR
|
||||
/gsd-ship 4 # Ship phase 4
|
||||
/gsd-ship 4 --draft # Ship as draft PR
|
||||
```
|
||||
|
||||
**PR body includes:**
|
||||
@@ -261,7 +261,7 @@ Create PR from completed phase work with auto-generated body.
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:ui-review`
|
||||
### `/gsd-ui-review`
|
||||
|
||||
Retroactive 6-pillar visual audit of implemented frontend.
|
||||
|
||||
@@ -273,13 +273,13 @@ Retroactive 6-pillar visual audit of implemented frontend.
|
||||
**Produces:** `{phase}-UI-REVIEW.md`, screenshots in `.planning/ui-reviews/`
|
||||
|
||||
```bash
|
||||
/gsd:ui-review # Audit current phase
|
||||
/gsd:ui-review 3 # Audit phase 3
|
||||
/gsd-ui-review # Audit current phase
|
||||
/gsd-ui-review 3 # Audit phase 3
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:audit-uat`
|
||||
### `/gsd-audit-uat`
|
||||
|
||||
Cross-phase audit of all outstanding UAT and verification items.
|
||||
|
||||
@@ -287,12 +287,12 @@ Cross-phase audit of all outstanding UAT and verification items.
|
||||
**Produces:** Categorized audit report with human test plan
|
||||
|
||||
```bash
|
||||
/gsd:audit-uat
|
||||
/gsd-audit-uat
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:audit-milestone`
|
||||
### `/gsd-audit-milestone`
|
||||
|
||||
Verify milestone met its definition of done.
|
||||
|
||||
@@ -300,12 +300,12 @@ Verify milestone met its definition of done.
|
||||
**Produces:** Audit report with gap analysis
|
||||
|
||||
```bash
|
||||
/gsd:audit-milestone
|
||||
/gsd-audit-milestone
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:complete-milestone`
|
||||
### `/gsd-complete-milestone`
|
||||
|
||||
Archive milestone, tag release.
|
||||
|
||||
@@ -313,12 +313,12 @@ Archive milestone, tag release.
|
||||
**Produces:** `MILESTONES.md` entry, git tag
|
||||
|
||||
```bash
|
||||
/gsd:complete-milestone
|
||||
/gsd-complete-milestone
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:milestone-summary`
|
||||
### `/gsd-milestone-summary`
|
||||
|
||||
Generate comprehensive project summary from milestone artifacts for team onboarding and review.
|
||||
|
||||
@@ -338,13 +338,13 @@ Generate comprehensive project summary from milestone artifacts for team onboard
|
||||
- Interactive Q&A offered after generation
|
||||
|
||||
```bash
|
||||
/gsd:milestone-summary # Summarize current milestone
|
||||
/gsd:milestone-summary v1.0 # Summarize specific milestone
|
||||
/gsd-milestone-summary # Summarize current milestone
|
||||
/gsd-milestone-summary v1.0 # Summarize specific milestone
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:new-milestone`
|
||||
### `/gsd-new-milestone`
|
||||
|
||||
Start next version cycle.
|
||||
|
||||
@@ -357,24 +357,24 @@ Start next version cycle.
|
||||
**Produces:** Updated `PROJECT.md`, new `REQUIREMENTS.md`, new `ROADMAP.md`
|
||||
|
||||
```bash
|
||||
/gsd:new-milestone # Interactive
|
||||
/gsd:new-milestone "v2.0 Mobile" # Named milestone
|
||||
/gsd:new-milestone --reset-phase-numbers "v2.0 Mobile" # Restart milestone numbering at 1
|
||||
/gsd-new-milestone # Interactive
|
||||
/gsd-new-milestone "v2.0 Mobile" # Named milestone
|
||||
/gsd-new-milestone --reset-phase-numbers "v2.0 Mobile" # Restart milestone numbering at 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Phase Management Commands
|
||||
|
||||
### `/gsd:add-phase`
|
||||
### `/gsd-add-phase`
|
||||
|
||||
Append new phase to roadmap.
|
||||
|
||||
```bash
|
||||
/gsd:add-phase # Interactive — describe the phase
|
||||
/gsd-add-phase # Interactive — describe the phase
|
||||
```
|
||||
|
||||
### `/gsd:insert-phase`
|
||||
### `/gsd-insert-phase`
|
||||
|
||||
Insert urgent work between phases using decimal numbering.
|
||||
|
||||
@@ -383,10 +383,10 @@ Insert urgent work between phases using decimal numbering.
|
||||
| `N` | No | Insert after this phase number |
|
||||
|
||||
```bash
|
||||
/gsd:insert-phase 3 # Insert between phase 3 and 4 → creates 3.1
|
||||
/gsd-insert-phase 3 # Insert between phase 3 and 4 → creates 3.1
|
||||
```
|
||||
|
||||
### `/gsd:remove-phase`
|
||||
### `/gsd-remove-phase`
|
||||
|
||||
Remove future phase and renumber subsequent phases.
|
||||
|
||||
@@ -395,10 +395,10 @@ Remove future phase and renumber subsequent phases.
|
||||
| `N` | No | Phase number to remove |
|
||||
|
||||
```bash
|
||||
/gsd:remove-phase 7 # Remove phase 7, renumber 8→7, 9→8, etc.
|
||||
/gsd-remove-phase 7 # Remove phase 7, renumber 8→7, 9→8, etc.
|
||||
```
|
||||
|
||||
### `/gsd:list-phase-assumptions`
|
||||
### `/gsd-list-phase-assumptions`
|
||||
|
||||
Preview Claude's intended approach before planning.
|
||||
|
||||
@@ -407,20 +407,20 @@ Preview Claude's intended approach before planning.
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:list-phase-assumptions 2 # See assumptions for phase 2
|
||||
/gsd-list-phase-assumptions 2 # See assumptions for phase 2
|
||||
```
|
||||
|
||||
### `/gsd:analyze-dependencies`
|
||||
### `/gsd-analyze-dependencies`
|
||||
|
||||
Analyze phase dependencies and suggest `Depends on` entries for ROADMAP.md before running `/gsd:manager`.
|
||||
Analyze phase dependencies and suggest `Depends on` entries for ROADMAP.md before running `/gsd-manager`.
|
||||
|
||||
**Prerequisites:** `.planning/ROADMAP.md` exists
|
||||
**Produces:** Dependency suggestion table; optionally updates `Depends on` fields in ROADMAP.md with confirmation
|
||||
|
||||
**Run this before `/gsd:manager`** when phases have empty `Depends on` fields and you want to avoid merge conflicts from unordered parallel execution.
|
||||
**Run this before `/gsd-manager`** when phases have empty `Depends on` fields and you want to avoid merge conflicts from unordered parallel execution.
|
||||
|
||||
```bash
|
||||
/gsd:analyze-dependencies # Analyze all phases and suggest dependencies
|
||||
/gsd-analyze-dependencies # Analyze all phases and suggest dependencies
|
||||
```
|
||||
|
||||
**Detection methods:**
|
||||
@@ -430,27 +430,27 @@ Analyze phase dependencies and suggest `Depends on` entries for ROADMAP.md befor
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:plan-milestone-gaps`
|
||||
### `/gsd-plan-milestone-gaps`
|
||||
|
||||
Create phases to close gaps from milestone audit.
|
||||
|
||||
```bash
|
||||
/gsd:plan-milestone-gaps # Creates phases for each audit gap
|
||||
/gsd-plan-milestone-gaps # Creates phases for each audit gap
|
||||
```
|
||||
|
||||
### `/gsd:research-phase`
|
||||
### `/gsd-research-phase`
|
||||
|
||||
Deep ecosystem research only (standalone — usually use `/gsd:plan-phase` instead).
|
||||
Deep ecosystem research only (standalone — usually use `/gsd-plan-phase` instead).
|
||||
|
||||
| Argument | Required | Description |
|
||||
|----------|----------|-------------|
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:research-phase 4 # Research phase 4 domain
|
||||
/gsd-research-phase 4 # Research phase 4 domain
|
||||
```
|
||||
|
||||
### `/gsd:validate-phase`
|
||||
### `/gsd-validate-phase`
|
||||
|
||||
Retroactively audit and fill Nyquist validation gaps.
|
||||
|
||||
@@ -459,38 +459,38 @@ Retroactively audit and fill Nyquist validation gaps.
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:validate-phase 2 # Audit test coverage for phase 2
|
||||
/gsd-validate-phase 2 # Audit test coverage for phase 2
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Navigation Commands
|
||||
|
||||
### `/gsd:progress`
|
||||
### `/gsd-progress`
|
||||
|
||||
Show status and next steps.
|
||||
|
||||
```bash
|
||||
/gsd:progress # "Where am I? What's next?"
|
||||
/gsd-progress # "Where am I? What's next?"
|
||||
```
|
||||
|
||||
### `/gsd:resume-work`
|
||||
### `/gsd-resume-work`
|
||||
|
||||
Restore full context from last session.
|
||||
|
||||
```bash
|
||||
/gsd:resume-work # After context reset or new session
|
||||
/gsd-resume-work # After context reset or new session
|
||||
```
|
||||
|
||||
### `/gsd:pause-work`
|
||||
### `/gsd-pause-work`
|
||||
|
||||
Save context handoff when stopping mid-phase.
|
||||
|
||||
```bash
|
||||
/gsd:pause-work # Creates continue-here.md
|
||||
/gsd-pause-work # Creates continue-here.md
|
||||
```
|
||||
|
||||
### `/gsd:manager`
|
||||
### `/gsd-manager`
|
||||
|
||||
Interactive command center for managing multiple phases from one terminal.
|
||||
|
||||
@@ -502,24 +502,24 @@ Interactive command center for managing multiple phases from one terminal.
|
||||
- Designed for power users parallelizing work across phases from one terminal
|
||||
|
||||
```bash
|
||||
/gsd:manager # Open command center dashboard
|
||||
/gsd-manager # Open command center dashboard
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:help`
|
||||
### `/gsd-help`
|
||||
|
||||
Show all commands and usage guide.
|
||||
|
||||
```bash
|
||||
/gsd:help # Quick reference
|
||||
/gsd-help # Quick reference
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Utility Commands
|
||||
|
||||
### `/gsd:quick`
|
||||
### `/gsd-quick`
|
||||
|
||||
Execute ad-hoc task with GSD guarantees.
|
||||
|
||||
@@ -532,13 +532,13 @@ Execute ad-hoc task with GSD guarantees.
|
||||
Flags are composable.
|
||||
|
||||
```bash
|
||||
/gsd:quick # Basic quick task
|
||||
/gsd:quick --discuss --research # Discussion + research + planning
|
||||
/gsd:quick --full # With plan checking and verification
|
||||
/gsd:quick --discuss --research --full # All optional stages
|
||||
/gsd-quick # Basic quick task
|
||||
/gsd-quick --discuss --research # Discussion + research + planning
|
||||
/gsd-quick --full # With plan checking and verification
|
||||
/gsd-quick --discuss --research --full # All optional stages
|
||||
```
|
||||
|
||||
### `/gsd:autonomous`
|
||||
### `/gsd-autonomous`
|
||||
|
||||
Run all remaining phases autonomously.
|
||||
|
||||
@@ -547,19 +547,19 @@ Run all remaining phases autonomously.
|
||||
| `--from N` | Start from a specific phase number |
|
||||
|
||||
```bash
|
||||
/gsd:autonomous # Run all remaining phases
|
||||
/gsd:autonomous --from 3 # Start from phase 3
|
||||
/gsd-autonomous # Run all remaining phases
|
||||
/gsd-autonomous --from 3 # Start from phase 3
|
||||
```
|
||||
|
||||
### `/gsd:do`
|
||||
### `/gsd-do`
|
||||
|
||||
Route freeform text to the right GSD command.
|
||||
|
||||
```bash
|
||||
/gsd:do # Then describe what you want
|
||||
/gsd-do # Then describe what you want
|
||||
```
|
||||
|
||||
### `/gsd:note`
|
||||
### `/gsd-note`
|
||||
|
||||
Zero-friction idea capture — append, list, or promote notes to todos.
|
||||
|
||||
@@ -574,12 +574,12 @@ Zero-friction idea capture — append, list, or promote notes to todos.
|
||||
| `--global` | Use global scope for note operations |
|
||||
|
||||
```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`
|
||||
|
||||
Systematic debugging with persistent state.
|
||||
|
||||
@@ -588,10 +588,10 @@ Systematic debugging with persistent state.
|
||||
| `description` | No | Description of the bug |
|
||||
|
||||
```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`
|
||||
|
||||
Capture idea or task for later.
|
||||
|
||||
@@ -600,18 +600,18 @@ Capture idea or task for later.
|
||||
| `description` | No | Todo description |
|
||||
|
||||
```bash
|
||||
/gsd:add-todo "Consider adding dark mode support"
|
||||
/gsd-add-todo "Consider adding dark mode support"
|
||||
```
|
||||
|
||||
### `/gsd:check-todos`
|
||||
### `/gsd-check-todos`
|
||||
|
||||
List pending todos and select one to work on.
|
||||
|
||||
```bash
|
||||
/gsd:check-todos
|
||||
/gsd-check-todos
|
||||
```
|
||||
|
||||
### `/gsd:add-tests`
|
||||
### `/gsd-add-tests`
|
||||
|
||||
Generate tests for a completed phase.
|
||||
|
||||
@@ -620,18 +620,18 @@ Generate tests for a completed phase.
|
||||
| `N` | No | Phase number |
|
||||
|
||||
```bash
|
||||
/gsd:add-tests 2 # Generate tests for phase 2
|
||||
/gsd-add-tests 2 # Generate tests for phase 2
|
||||
```
|
||||
|
||||
### `/gsd:stats`
|
||||
### `/gsd-stats`
|
||||
|
||||
Display project statistics.
|
||||
|
||||
```bash
|
||||
/gsd:stats # Project metrics dashboard
|
||||
/gsd-stats # Project metrics dashboard
|
||||
```
|
||||
|
||||
### `/gsd:profile-user`
|
||||
### `/gsd-profile-user`
|
||||
|
||||
Generate a developer behavioral profile from Claude Code session analysis across 8 dimensions (communication style, decision patterns, debugging approach, UX preferences, vendor choices, frustration triggers, learning style, explanation depth). Produces artifacts that personalize Claude's responses.
|
||||
|
||||
@@ -642,16 +642,16 @@ Generate a developer behavioral profile from Claude Code session analysis across
|
||||
|
||||
**Generated artifacts:**
|
||||
- `USER-PROFILE.md` — Full behavioral profile
|
||||
- `/gsd:dev-preferences` command — Load preferences in any session
|
||||
- `/gsd-dev-preferences` command — Load preferences in any session
|
||||
- `CLAUDE.md` profile section — Auto-discovered by Claude Code
|
||||
|
||||
```bash
|
||||
/gsd:profile-user # Analyze sessions and build profile
|
||||
/gsd:profile-user --questionnaire # Interactive questionnaire fallback
|
||||
/gsd:profile-user --refresh # Re-generate from fresh analysis
|
||||
/gsd-profile-user # Analyze sessions and build profile
|
||||
/gsd-profile-user --questionnaire # Interactive questionnaire fallback
|
||||
/gsd-profile-user --refresh # Re-generate from fresh analysis
|
||||
```
|
||||
|
||||
### `/gsd:health`
|
||||
### `/gsd-health`
|
||||
|
||||
Validate `.planning/` directory integrity.
|
||||
|
||||
@@ -660,23 +660,23 @@ Validate `.planning/` directory integrity.
|
||||
| `--repair` | Auto-fix recoverable issues |
|
||||
|
||||
```bash
|
||||
/gsd:health # Check integrity
|
||||
/gsd:health --repair # Check and fix
|
||||
/gsd-health # Check integrity
|
||||
/gsd-health --repair # Check and fix
|
||||
```
|
||||
|
||||
### `/gsd:cleanup`
|
||||
### `/gsd-cleanup`
|
||||
|
||||
Archive accumulated phase directories from completed milestones.
|
||||
|
||||
```bash
|
||||
/gsd:cleanup
|
||||
/gsd-cleanup
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Diagnostics Commands
|
||||
|
||||
### `/gsd:forensics`
|
||||
### `/gsd-forensics`
|
||||
|
||||
Post-mortem investigation of failed or stuck GSD workflows.
|
||||
|
||||
@@ -696,15 +696,15 @@ Post-mortem investigation of failed or stuck GSD workflows.
|
||||
- GitHub issue creation offered if actionable findings exist
|
||||
|
||||
```bash
|
||||
/gsd:forensics # Interactive — prompted for problem
|
||||
/gsd:forensics "Phase 3 execution stalled" # With problem description
|
||||
/gsd-forensics # Interactive — prompted for problem
|
||||
/gsd-forensics "Phase 3 execution stalled" # With problem description
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Workstream Management
|
||||
|
||||
### `/gsd:workstreams`
|
||||
### `/gsd-workstreams`
|
||||
|
||||
Manage parallel workstreams for concurrent work on different milestone areas.
|
||||
|
||||
@@ -724,28 +724,28 @@ Manage parallel workstreams for concurrent work on different milestone areas.
|
||||
**Produces:** Workstream directories under `.planning/`, state tracking per workstream
|
||||
|
||||
```bash
|
||||
/gsd:workstreams # List all workstreams
|
||||
/gsd:workstreams create backend-api # Create new workstream
|
||||
/gsd:workstreams switch backend-api # Set active workstream
|
||||
/gsd:workstreams status backend-api # Detailed status
|
||||
/gsd:workstreams progress # Cross-workstream progress overview
|
||||
/gsd:workstreams complete backend-api # Archive completed workstream
|
||||
/gsd:workstreams resume backend-api # Resume work in workstream
|
||||
/gsd-workstreams # List all workstreams
|
||||
/gsd-workstreams create backend-api # Create new workstream
|
||||
/gsd-workstreams switch backend-api # Set active workstream
|
||||
/gsd-workstreams status backend-api # Detailed status
|
||||
/gsd-workstreams progress # Cross-workstream progress overview
|
||||
/gsd-workstreams complete backend-api # Archive completed workstream
|
||||
/gsd-workstreams resume backend-api # Resume work in workstream
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Configuration Commands
|
||||
|
||||
### `/gsd:settings`
|
||||
### `/gsd-settings`
|
||||
|
||||
Interactive configuration of workflow toggles and model profile.
|
||||
|
||||
```bash
|
||||
/gsd:settings # Interactive config
|
||||
/gsd-settings # Interactive config
|
||||
```
|
||||
|
||||
### `/gsd:set-profile`
|
||||
### `/gsd-set-profile`
|
||||
|
||||
Quick profile switch.
|
||||
|
||||
@@ -754,15 +754,15 @@ Quick profile switch.
|
||||
| `profile` | **Yes** | `quality`, `balanced`, `budget`, or `inherit` |
|
||||
|
||||
```bash
|
||||
/gsd:set-profile budget # Switch to budget profile
|
||||
/gsd:set-profile quality # Switch to quality profile
|
||||
/gsd-set-profile budget # Switch to budget profile
|
||||
/gsd-set-profile quality # Switch to quality profile
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Brownfield Commands
|
||||
|
||||
### `/gsd:map-codebase`
|
||||
### `/gsd-map-codebase`
|
||||
|
||||
Analyze existing codebase with parallel mapper agents.
|
||||
|
||||
@@ -771,35 +771,35 @@ Analyze existing codebase with parallel mapper agents.
|
||||
| `area` | No | Scope mapping to a specific area |
|
||||
|
||||
```bash
|
||||
/gsd:map-codebase # Full codebase analysis
|
||||
/gsd:map-codebase auth # Focus on auth area
|
||||
/gsd-map-codebase # Full codebase analysis
|
||||
/gsd-map-codebase auth # Focus on auth area
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Update Commands
|
||||
|
||||
### `/gsd:update`
|
||||
### `/gsd-update`
|
||||
|
||||
Update GSD with changelog preview.
|
||||
|
||||
```bash
|
||||
/gsd:update # Check for updates and install
|
||||
/gsd-update # Check for updates and install
|
||||
```
|
||||
|
||||
### `/gsd:reapply-patches`
|
||||
### `/gsd-reapply-patches`
|
||||
|
||||
Restore local modifications after a GSD update.
|
||||
|
||||
```bash
|
||||
/gsd:reapply-patches # Merge back local changes
|
||||
/gsd-reapply-patches # Merge back local changes
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fast & Inline Commands
|
||||
|
||||
### `/gsd:fast`
|
||||
### `/gsd-fast`
|
||||
|
||||
Execute a trivial task inline — no subagents, no planning overhead. For typo fixes, config changes, small refactors, forgotten commits.
|
||||
|
||||
@@ -807,18 +807,18 @@ Execute a trivial task inline — no subagents, no planning overhead. For typo f
|
||||
|----------|----------|-------------|
|
||||
| `task description` | No | What to do (prompted if omitted) |
|
||||
|
||||
**Not a replacement for `/gsd:quick`** — use `/gsd:quick` for anything needing research, multi-step planning, or verification.
|
||||
**Not a replacement for `/gsd-quick`** — use `/gsd-quick` for anything needing research, multi-step planning, or verification.
|
||||
|
||||
```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"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Code Quality Commands
|
||||
|
||||
### `/gsd:review`
|
||||
### `/gsd-review`
|
||||
|
||||
Cross-AI peer review of phase plans from external AI CLIs.
|
||||
|
||||
@@ -834,16 +834,16 @@ Cross-AI peer review of phase plans from external AI CLIs.
|
||||
| `--coderabbit` | Include CodeRabbit review |
|
||||
| `--all` | Include all available CLIs |
|
||||
|
||||
**Produces:** `{phase}-REVIEWS.md` — consumable by `/gsd:plan-phase --reviews`
|
||||
**Produces:** `{phase}-REVIEWS.md` — consumable by `/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`
|
||||
|
||||
Create a clean PR branch by filtering out `.planning/` commits.
|
||||
|
||||
@@ -854,13 +854,13 @@ Create a clean PR branch by filtering out `.planning/` commits.
|
||||
**Purpose:** Reviewers see only code changes, not GSD planning artifacts.
|
||||
|
||||
```bash
|
||||
/gsd:pr-branch # Filter against main
|
||||
/gsd:pr-branch develop # Filter against develop
|
||||
/gsd-pr-branch # Filter against main
|
||||
/gsd-pr-branch develop # Filter against develop
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:audit-uat`
|
||||
### `/gsd-audit-uat`
|
||||
|
||||
Cross-phase audit of all outstanding UAT and verification items.
|
||||
|
||||
@@ -868,14 +868,14 @@ Cross-phase audit of all outstanding UAT and verification items.
|
||||
**Produces:** Categorized audit report with human test plan
|
||||
|
||||
```bash
|
||||
/gsd:audit-uat
|
||||
/gsd-audit-uat
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Backlog & Thread Commands
|
||||
|
||||
### `/gsd:add-backlog`
|
||||
### `/gsd-add-backlog`
|
||||
|
||||
Add an idea to the backlog parking lot using 999.x numbering.
|
||||
|
||||
@@ -883,28 +883,28 @@ Add an idea to the backlog parking lot using 999.x numbering.
|
||||
|----------|----------|-------------|
|
||||
| `description` | **Yes** | Backlog item description |
|
||||
|
||||
**999.x numbering** keeps backlog items outside the active phase sequence. Phase directories are created immediately so `/gsd:discuss-phase` and `/gsd:plan-phase` work on them.
|
||||
**999.x numbering** keeps backlog items outside the active phase sequence. Phase directories are created immediately so `/gsd-discuss-phase` and `/gsd-plan-phase` work on them.
|
||||
|
||||
```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`
|
||||
|
||||
Review and promote backlog items to active milestone.
|
||||
|
||||
**Actions per item:** Promote (move to active sequence), Keep (leave in backlog), Remove (delete).
|
||||
|
||||
```bash
|
||||
/gsd:review-backlog
|
||||
/gsd-review-backlog
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:plant-seed`
|
||||
### `/gsd-plant-seed`
|
||||
|
||||
Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone.
|
||||
|
||||
@@ -915,15 +915,15 @@ Capture a forward-looking idea with trigger conditions — surfaces automaticall
|
||||
Seeds solve context rot: instead of a one-liner in Deferred that nobody reads, a seed preserves the full WHY, WHEN to surface, and breadcrumbs to details.
|
||||
|
||||
**Produces:** `.planning/seeds/SEED-NNN-slug.md`
|
||||
**Consumed by:** `/gsd:new-milestone` (scans seeds and presents matches)
|
||||
**Consumed by:** `/gsd-new-milestone` (scans seeds and presents matches)
|
||||
|
||||
```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`
|
||||
|
||||
Manage persistent context threads for cross-session work.
|
||||
|
||||
@@ -933,22 +933,22 @@ Manage persistent context threads for cross-session work.
|
||||
| `name` | — | Resume existing thread by name |
|
||||
| `description` | — | Create new thread |
|
||||
|
||||
Threads are lightweight cross-session knowledge stores for work that spans multiple sessions but doesn't belong to any specific phase. Lighter weight than `/gsd:pause-work`.
|
||||
Threads are lightweight cross-session knowledge stores for work that spans multiple sessions but doesn't belong to any specific phase. Lighter weight than `/gsd-pause-work`.
|
||||
|
||||
```bash
|
||||
/gsd:thread # List all threads
|
||||
/gsd:thread fix-deploy-key-auth # Resume thread
|
||||
/gsd:thread "Investigate TCP timeout in pasta service" # Create new
|
||||
/gsd-thread # List all threads
|
||||
/gsd-thread fix-deploy-key-auth # Resume thread
|
||||
/gsd-thread "Investigate TCP timeout in pasta service" # Create new
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Community Commands
|
||||
|
||||
### `/gsd:join-discord`
|
||||
### `/gsd-join-discord`
|
||||
|
||||
Open Discord community invite.
|
||||
|
||||
```bash
|
||||
/gsd:join-discord
|
||||
/gsd-join-discord
|
||||
```
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
|
||||
## Configuration File
|
||||
|
||||
GSD stores project settings in `.planning/config.json`. Created during `/gsd:new-project`, updated via `/gsd:settings`.
|
||||
GSD stores project settings in `.planning/config.json`. Created during `/gsd-new-project`, updated via `/gsd-settings`.
|
||||
|
||||
### Full Schema
|
||||
|
||||
@@ -103,12 +103,12 @@ All workflow toggles follow the **absent = enabled** pattern. If a key is missin
|
||||
| `workflow.auto_advance` | boolean | `false` | Auto-chain discuss → plan → execute without stopping |
|
||||
| `workflow.nyquist_validation` | boolean | `true` | Test coverage mapping during plan-phase research |
|
||||
| `workflow.ui_phase` | boolean | `true` | Generate UI design contracts for frontend phases |
|
||||
| `workflow.ui_safety_gate` | boolean | `true` | Prompt to run /gsd:ui-phase for frontend phases during plan-phase |
|
||||
| `workflow.ui_safety_gate` | boolean | `true` | Prompt to run /gsd-ui-phase for frontend phases during plan-phase |
|
||||
| `workflow.node_repair` | boolean | `true` | Autonomous task repair on verification failure |
|
||||
| `workflow.node_repair_budget` | number | `2` | Max repair attempts per failed task |
|
||||
| `workflow.research_before_questions` | boolean | `false` | Run research before discussion questions instead of after |
|
||||
| `workflow.discuss_mode` | string | `'discuss'` | Controls how `/gsd:discuss-phase` gathers context. `'discuss'` (default) asks questions one-by-one. `'assumptions'` reads the codebase first, generates structured assumptions with confidence levels, and only asks you to correct what's wrong. Added in v1.28 |
|
||||
| `workflow.skip_discuss` | boolean | `false` | When `true`, `/gsd:autonomous` bypasses the discuss-phase entirely, writing minimal CONTEXT.md from the ROADMAP phase goal. Useful for projects where developer preferences are fully captured in PROJECT.md/REQUIREMENTS.md. Added in v1.28 |
|
||||
| `workflow.discuss_mode` | string | `'discuss'` | Controls how `/gsd-discuss-phase` gathers context. `'discuss'` (default) asks questions one-by-one. `'assumptions'` reads the codebase first, generates structured assumptions with confidence levels, and only asks you to correct what's wrong. Added in v1.28 |
|
||||
| `workflow.skip_discuss` | boolean | `false` | When `true`, `/gsd-autonomous` bypasses the discuss-phase entirely, writing minimal CONTEXT.md from the ROADMAP phase goal. Useful for projects where developer preferences are fully captured in PROJECT.md/REQUIREMENTS.md. Added in v1.28 |
|
||||
| `workflow.text_mode` | boolean | `false` | Replaces AskUserQuestion TUI menus with plain-text numbered lists. Required for Claude Code remote sessions (`/rc` mode) where TUI menus don't render. Can also be set per-session with `--text` flag on discuss-phase. Added in v1.28 |
|
||||
| `workflow.use_worktrees` | boolean | `true` | When `false`, disables git worktree isolation for parallel execution. Users who prefer sequential execution or whose environment does not support worktrees can disable this. Added in v1.31 |
|
||||
|
||||
@@ -140,7 +140,7 @@ If `.planning/` is in `.gitignore`, `commit_docs` is automatically `false` regar
|
||||
| Setting | Type | Default | Description |
|
||||
|---------|------|---------|-------------|
|
||||
| `hooks.context_warnings` | boolean | `true` | Show context window usage warnings via context monitor hook |
|
||||
| `hooks.workflow_guard` | boolean | `false` | Warn when file edits happen outside GSD workflow context (advises using `/gsd:quick` or `/gsd:fast`) |
|
||||
| `hooks.workflow_guard` | boolean | `false` | Warn when file edits happen outside GSD workflow context (advises using `/gsd-quick` or `/gsd-fast`) |
|
||||
|
||||
The prompt injection guard hook (`gsd-prompt-guard.js`) is always active and cannot be disabled — it's a security feature, not a workflow toggle.
|
||||
|
||||
@@ -242,7 +242,7 @@ node gsd-tools.cjs config-set agent_skills.gsd-executor '["skills/my-skill"]'
|
||||
| `git.branching_strategy` | enum | `none` | `none`, `phase`, or `milestone` |
|
||||
| `git.phase_branch_template` | string | `gsd/phase-{phase}-{slug}` | Branch name template for phase strategy |
|
||||
| `git.milestone_branch_template` | string | `gsd/{milestone}-{slug}` | Branch name template for milestone strategy |
|
||||
| `git.quick_branch_template` | string or null | `null` | Optional branch name template for `/gsd:quick` tasks |
|
||||
| `git.quick_branch_template` | string or null | `null` | Optional branch name template for `/gsd-quick` tasks |
|
||||
|
||||
### Strategy Comparison
|
||||
|
||||
@@ -312,7 +312,7 @@ Settings for the security enforcement feature (v1.31). All follow the **absent =
|
||||
|
||||
| Setting | Type | Default | Description |
|
||||
|---------|------|---------|-------------|
|
||||
| `security_enforcement` | boolean | `true` | Enable threat-model-anchored security verification via `/gsd:secure-phase`. When `false`, security checks are skipped entirely |
|
||||
| `security_enforcement` | boolean | `true` | Enable threat-model-anchored security verification via `/gsd-secure-phase`. When `false`, security checks are skipped entirely |
|
||||
| `security_asvs_level` | number (1-3) | `1` | OWASP ASVS verification level. Level 1 = opportunistic, Level 2 = standard, Level 3 = comprehensive |
|
||||
| `security_block_on` | string | `"high"` | Minimum severity that blocks phase advancement. Options: `"high"`, `"medium"`, `"low"` |
|
||||
|
||||
@@ -426,4 +426,4 @@ Save settings as global defaults for future projects:
|
||||
|
||||
**Location:** `~/.gsd/defaults.json`
|
||||
|
||||
When `/gsd:new-project` creates a new `config.json`, it reads global defaults and merges them as the starting configuration. Per-project settings always override globals.
|
||||
When `/gsd-new-project` creates a new `config.json`, it reads global defaults and merges them as the starting configuration. Per-project settings always override globals.
|
||||
|
||||
166
docs/FEATURES.md
166
docs/FEATURES.md
@@ -93,7 +93,7 @@
|
||||
|
||||
### 1. Project Initialization
|
||||
|
||||
**Command:** `/gsd:new-project [--auto @file.md]`
|
||||
**Command:** `/gsd-new-project [--auto @file.md]`
|
||||
|
||||
**Purpose:** Transform a user's idea into a fully structured project with research, scoped requirements, and a phased roadmap.
|
||||
|
||||
@@ -132,13 +132,13 @@
|
||||
- Research agents have web search capability for current ecosystem information
|
||||
- Granularity setting controls phase count: `coarse` (3-5), `standard` (5-8), `fine` (8-12)
|
||||
- `--auto` mode extracts all information from the provided document without interactive questioning
|
||||
- Existing codebase context (from `/gsd:map-codebase`) is loaded if present
|
||||
- Existing codebase context (from `/gsd-map-codebase`) is loaded if present
|
||||
|
||||
---
|
||||
|
||||
### 2. Phase Discussion
|
||||
|
||||
**Command:** `/gsd:discuss-phase [N] [--auto] [--batch]`
|
||||
**Command:** `/gsd-discuss-phase [N] [--auto] [--batch]`
|
||||
|
||||
**Purpose:** Capture user's implementation preferences and decisions before research and planning begin. Eliminates the gray areas that cause AI to guess.
|
||||
|
||||
@@ -165,7 +165,7 @@
|
||||
|
||||
### 3. UI Design Contract
|
||||
|
||||
**Command:** `/gsd:ui-phase [N]`
|
||||
**Command:** `/gsd-ui-phase [N]`
|
||||
|
||||
**Purpose:** Lock design decisions before planning so that all components in a phase share consistent visual standards.
|
||||
|
||||
@@ -197,7 +197,7 @@
|
||||
|
||||
### 4. Phase Planning
|
||||
|
||||
**Command:** `/gsd:plan-phase [N] [--auto] [--skip-research] [--skip-verify]`
|
||||
**Command:** `/gsd-plan-phase [N] [--auto] [--skip-research] [--skip-verify]`
|
||||
|
||||
**Purpose:** Research the implementation domain and produce verified, atomic execution plans.
|
||||
|
||||
@@ -208,7 +208,7 @@
|
||||
- REQ-PLAN-04: System MUST include `read_first` and `acceptance_criteria` sections in every plan
|
||||
- REQ-PLAN-05: System MUST run plan checker verification loop (up to 3 iterations) unless `--skip-verify` is set
|
||||
- REQ-PLAN-06: System MUST support `--skip-research` flag to bypass research phase
|
||||
- REQ-PLAN-07: System MUST prompt user to run `/gsd:ui-phase` if frontend phase detected and no UI-SPEC.md exists (UI safety gate)
|
||||
- REQ-PLAN-07: System MUST prompt user to run `/gsd-ui-phase` if frontend phase detected and no UI-SPEC.md exists (UI safety gate)
|
||||
- REQ-PLAN-08: System MUST include Nyquist validation mapping when `workflow.nyquist_validation` is enabled
|
||||
- REQ-PLAN-09: System MUST verify all phase requirements are covered by at least one plan before planning completes (requirements coverage gate)
|
||||
|
||||
@@ -247,7 +247,7 @@
|
||||
|
||||
### 5. Phase Execution
|
||||
|
||||
**Command:** `/gsd:execute-phase <N>`
|
||||
**Command:** `/gsd-execute-phase <N>`
|
||||
|
||||
**Purpose:** Execute all plans in a phase using wave-based parallelization with fresh context windows per executor.
|
||||
|
||||
@@ -291,7 +291,7 @@
|
||||
|
||||
### 6. Work Verification
|
||||
|
||||
**Command:** `/gsd:verify-work [N]`
|
||||
**Command:** `/gsd-verify-work [N]`
|
||||
|
||||
**Purpose:** User acceptance testing — walk the user through testing each deliverable and auto-diagnose failures.
|
||||
|
||||
@@ -309,7 +309,7 @@
|
||||
|
||||
### 6.5. Ship
|
||||
|
||||
**Command:** `/gsd:ship [N] [--draft]`
|
||||
**Command:** `/gsd-ship [N] [--draft]`
|
||||
|
||||
**Purpose:** Bridge local completion → merged PR. After verification passes, push branch, create PR with auto-generated body from planning artifacts, optionally trigger review, and track in STATE.md.
|
||||
|
||||
@@ -328,7 +328,7 @@
|
||||
|
||||
### 7. UI Review
|
||||
|
||||
**Command:** `/gsd:ui-review [N]`
|
||||
**Command:** `/gsd-ui-review [N]`
|
||||
|
||||
**Purpose:** Retroactive 6-pillar visual audit of implemented frontend code. Works standalone on any project.
|
||||
|
||||
@@ -353,7 +353,7 @@
|
||||
|
||||
### 8. Milestone Management
|
||||
|
||||
**Commands:** `/gsd:audit-milestone`, `/gsd:complete-milestone`, `/gsd:new-milestone [name]`
|
||||
**Commands:** `/gsd-audit-milestone`, `/gsd-complete-milestone`, `/gsd-new-milestone [name]`
|
||||
|
||||
**Purpose:** Verify milestone completion, archive, tag release, and start the next development cycle.
|
||||
|
||||
@@ -368,7 +368,7 @@
|
||||
- REQ-MILE-08: New milestone MUST follow same flow as new-project (questions → research → requirements → roadmap)
|
||||
- REQ-MILE-09: New milestone MUST NOT reset existing workflow configuration
|
||||
|
||||
**Gap Closure:** `/gsd:plan-milestone-gaps` creates phases to close gaps identified by audit.
|
||||
**Gap Closure:** `/gsd-plan-milestone-gaps` creates phases to close gaps identified by audit.
|
||||
|
||||
---
|
||||
|
||||
@@ -376,7 +376,7 @@
|
||||
|
||||
### 9. Phase Management
|
||||
|
||||
**Commands:** `/gsd:add-phase`, `/gsd:insert-phase [N]`, `/gsd:remove-phase [N]`
|
||||
**Commands:** `/gsd-add-phase`, `/gsd-insert-phase [N]`, `/gsd-remove-phase [N]`
|
||||
|
||||
**Purpose:** Dynamic roadmap modification during development.
|
||||
|
||||
@@ -391,7 +391,7 @@
|
||||
|
||||
### 10. Quick Mode
|
||||
|
||||
**Command:** `/gsd:quick [--full] [--discuss] [--research]`
|
||||
**Command:** `/gsd-quick [--full] [--discuss] [--research]`
|
||||
|
||||
**Purpose:** Ad-hoc task execution with GSD guarantees but a faster path.
|
||||
|
||||
@@ -410,7 +410,7 @@
|
||||
|
||||
### 11. Autonomous Mode
|
||||
|
||||
**Command:** `/gsd:autonomous [--from N]`
|
||||
**Command:** `/gsd-autonomous [--from N]`
|
||||
|
||||
**Purpose:** Run all remaining phases autonomously — discuss → plan → execute per phase.
|
||||
|
||||
@@ -425,7 +425,7 @@
|
||||
|
||||
### 12. Freeform Routing
|
||||
|
||||
**Command:** `/gsd:do`
|
||||
**Command:** `/gsd-do`
|
||||
|
||||
**Purpose:** Analyze freeform text and route to the appropriate GSD command.
|
||||
|
||||
@@ -439,7 +439,7 @@
|
||||
|
||||
### 13. Note Capture
|
||||
|
||||
**Command:** `/gsd:note`
|
||||
**Command:** `/gsd-note`
|
||||
|
||||
**Purpose:** Zero-friction idea capture without interrupting workflow. Append timestamped notes, list all notes, or promote notes to structured todos.
|
||||
|
||||
@@ -454,7 +454,7 @@
|
||||
|
||||
### 14. Auto-Advance (Next)
|
||||
|
||||
**Command:** `/gsd:next`
|
||||
**Command:** `/gsd-next`
|
||||
|
||||
**Purpose:** Automatically detect current project state and advance to the next logical workflow step, eliminating the need to remember which phase/step you're on.
|
||||
|
||||
@@ -462,18 +462,18 @@
|
||||
- REQ-NEXT-01: System MUST read STATE.md, ROADMAP.md, and phase directories to determine current position
|
||||
- REQ-NEXT-02: System MUST detect whether discuss, plan, execute, or verify is needed
|
||||
- REQ-NEXT-03: System MUST invoke the correct command automatically
|
||||
- REQ-NEXT-04: System MUST suggest `/gsd:new-project` if no project exists
|
||||
- REQ-NEXT-05: System MUST suggest `/gsd:complete-milestone` when all phases are complete
|
||||
- REQ-NEXT-04: System MUST suggest `/gsd-new-project` if no project exists
|
||||
- REQ-NEXT-05: System MUST suggest `/gsd-complete-milestone` when all phases are complete
|
||||
|
||||
**State Detection Logic:**
|
||||
| State | Action |
|
||||
|-------|--------|
|
||||
| No `.planning/` directory | Suggest `/gsd:new-project` |
|
||||
| Phase has no CONTEXT.md | Run `/gsd:discuss-phase` |
|
||||
| Phase has no PLAN.md files | Run `/gsd:plan-phase` |
|
||||
| Phase has plans but no SUMMARY.md | Run `/gsd:execute-phase` |
|
||||
| Phase executed but no VERIFICATION.md | Run `/gsd:verify-work` |
|
||||
| All phases complete | Suggest `/gsd:complete-milestone` |
|
||||
| No `.planning/` directory | Suggest `/gsd-new-project` |
|
||||
| Phase has no CONTEXT.md | Run `/gsd-discuss-phase` |
|
||||
| Phase has no PLAN.md files | Run `/gsd-plan-phase` |
|
||||
| Phase has plans but no SUMMARY.md | Run `/gsd-execute-phase` |
|
||||
| Phase executed but no VERIFICATION.md | Run `/gsd-verify-work` |
|
||||
| All phases complete | Suggest `/gsd-complete-milestone` |
|
||||
|
||||
---
|
||||
|
||||
@@ -488,12 +488,12 @@
|
||||
- REQ-NYQ-02: System MUST map each requirement to a specific test command
|
||||
- REQ-NYQ-03: System MUST identify Wave 0 tasks (test scaffolding needed before implementation)
|
||||
- REQ-NYQ-04: Plan checker MUST enforce Nyquist compliance as 8th verification dimension
|
||||
- REQ-NYQ-05: System MUST support retroactive validation via `/gsd:validate-phase`
|
||||
- REQ-NYQ-05: System MUST support retroactive validation via `/gsd-validate-phase`
|
||||
- REQ-NYQ-06: System MUST be disableable via `workflow.nyquist_validation: false`
|
||||
|
||||
**Produces:** `{phase}-VALIDATION.md` — Test coverage contract
|
||||
|
||||
**Retroactive Validation (`/gsd:validate-phase [N]`):**
|
||||
**Retroactive Validation (`/gsd-validate-phase [N]`):**
|
||||
- Scans implementation and maps requirements to tests
|
||||
- Identifies gaps where requirements lack automated verification
|
||||
- Spawns auditor to generate tests (max 3 attempts)
|
||||
@@ -521,7 +521,7 @@
|
||||
**Requirements:**
|
||||
- REQ-POSTVER-01: System MUST check against phase goals, not just task completion
|
||||
- REQ-POSTVER-02: System MUST produce VERIFICATION.md with pass/fail analysis
|
||||
- REQ-POSTVER-03: System MUST log issues for `/gsd:verify-work` to address
|
||||
- REQ-POSTVER-03: System MUST log issues for `/gsd-verify-work` to address
|
||||
- REQ-POSTVER-04: System MUST be disableable via `workflow.verifier: false`
|
||||
|
||||
---
|
||||
@@ -542,7 +542,7 @@
|
||||
|
||||
### 19. Health Validation
|
||||
|
||||
**Command:** `/gsd:health [--repair]`
|
||||
**Command:** `/gsd-health [--repair]`
|
||||
|
||||
**Purpose:** Validate `.planning/` directory integrity and auto-repair issues.
|
||||
|
||||
@@ -565,7 +565,7 @@
|
||||
- REQ-REGR-03: Regressions MUST be surfaced before post-execution verification
|
||||
- REQ-REGR-04: System MUST identify which prior phase's tests were broken
|
||||
|
||||
**When:** Runs automatically during `/gsd:execute-phase` before the verifier step.
|
||||
**When:** Runs automatically during `/gsd-execute-phase` before the verifier step.
|
||||
|
||||
---
|
||||
|
||||
@@ -579,7 +579,7 @@
|
||||
- REQ-COVGATE-03: Uncovered requirements MUST block planning completion
|
||||
- REQ-COVGATE-04: System MUST report which specific requirements lack plan coverage
|
||||
|
||||
**When:** Runs automatically at the end of `/gsd:plan-phase` after the plan checker loop.
|
||||
**When:** Runs automatically at the end of `/gsd-plan-phase` after the plan checker loop.
|
||||
|
||||
---
|
||||
|
||||
@@ -607,7 +607,7 @@
|
||||
|
||||
### 23. Session Management
|
||||
|
||||
**Commands:** `/gsd:pause-work`, `/gsd:resume-work`, `/gsd:progress`
|
||||
**Commands:** `/gsd-pause-work`, `/gsd-resume-work`, `/gsd-progress`
|
||||
|
||||
**Purpose:** Maintain project continuity across context resets and sessions.
|
||||
|
||||
@@ -624,7 +624,7 @@
|
||||
|
||||
### 24. Session Reporting
|
||||
|
||||
**Command:** `/gsd:session-report`
|
||||
**Command:** `/gsd-session-report`
|
||||
|
||||
**Purpose:** Generate a structured post-session summary document capturing work performed, outcomes achieved, and estimated resource usage.
|
||||
|
||||
@@ -663,7 +663,7 @@
|
||||
|
||||
### 26. Model Profiles
|
||||
|
||||
**Command:** `/gsd:set-profile <quality|balanced|budget|inherit>`
|
||||
**Command:** `/gsd-set-profile <quality|balanced|budget|inherit>`
|
||||
|
||||
**Purpose:** Control which AI model each agent uses, balancing quality vs cost.
|
||||
|
||||
@@ -699,7 +699,7 @@
|
||||
|
||||
### 27. Codebase Mapping
|
||||
|
||||
**Command:** `/gsd:map-codebase [area]`
|
||||
**Command:** `/gsd-map-codebase [area]`
|
||||
|
||||
**Purpose:** Analyze an existing codebase before starting a new project, so GSD understands what exists.
|
||||
|
||||
@@ -707,7 +707,7 @@
|
||||
- REQ-MAP-01: System MUST spawn parallel mapper agents for each analysis area
|
||||
- REQ-MAP-02: System MUST produce structured documents in `.planning/codebase/`
|
||||
- REQ-MAP-03: System MUST detect: tech stack, architecture patterns, coding conventions, concerns
|
||||
- REQ-MAP-04: Subsequent `/gsd:new-project` MUST load codebase mapping and focus questions on what's being added
|
||||
- REQ-MAP-04: Subsequent `/gsd-new-project` MUST load codebase mapping and focus questions on what's being added
|
||||
- REQ-MAP-05: Optional `[area]` argument MUST scope mapping to a specific area
|
||||
|
||||
**Produces:**
|
||||
@@ -727,7 +727,7 @@
|
||||
|
||||
### 28. Debug System
|
||||
|
||||
**Command:** `/gsd:debug [description]`
|
||||
**Command:** `/gsd-debug [description]`
|
||||
|
||||
**Purpose:** Systematic debugging with persistent state across context resets.
|
||||
|
||||
@@ -745,7 +745,7 @@
|
||||
|
||||
### 29. Todo Management
|
||||
|
||||
**Commands:** `/gsd:add-todo [desc]`, `/gsd:check-todos`
|
||||
**Commands:** `/gsd-add-todo [desc]`, `/gsd-check-todos`
|
||||
|
||||
**Purpose:** Capture ideas and tasks during sessions for later work.
|
||||
|
||||
@@ -759,7 +759,7 @@
|
||||
|
||||
### 30. Statistics Dashboard
|
||||
|
||||
**Command:** `/gsd:stats`
|
||||
**Command:** `/gsd-stats`
|
||||
|
||||
**Purpose:** Display project metrics — phases, plans, requirements, git history, and timeline.
|
||||
|
||||
@@ -773,7 +773,7 @@
|
||||
|
||||
### 31. Update System
|
||||
|
||||
**Command:** `/gsd:update`
|
||||
**Command:** `/gsd-update`
|
||||
|
||||
**Purpose:** Update GSD to the latest version with changelog preview.
|
||||
|
||||
@@ -782,13 +782,13 @@
|
||||
- REQ-UPDATE-02: System MUST display changelog for new version before updating
|
||||
- REQ-UPDATE-03: System MUST be runtime-aware and target the correct directory
|
||||
- REQ-UPDATE-04: System MUST back up locally modified files to `gsd-local-patches/`
|
||||
- REQ-UPDATE-05: `/gsd:reapply-patches` MUST restore local modifications after update
|
||||
- REQ-UPDATE-05: `/gsd-reapply-patches` MUST restore local modifications after update
|
||||
|
||||
---
|
||||
|
||||
### 32. Settings Management
|
||||
|
||||
**Command:** `/gsd:settings`
|
||||
**Command:** `/gsd-settings`
|
||||
|
||||
**Purpose:** Interactive configuration of workflow toggles and model profile.
|
||||
|
||||
@@ -821,7 +821,7 @@
|
||||
|
||||
### 33. Test Generation
|
||||
|
||||
**Command:** `/gsd:add-tests [N]`
|
||||
**Command:** `/gsd-add-tests [N]`
|
||||
|
||||
**Purpose:** Generate tests for a completed phase based on UAT criteria and implementation.
|
||||
|
||||
@@ -913,14 +913,14 @@ fix(03-01): correct auth token expiry
|
||||
|
||||
**Statusline Display:**
|
||||
```
|
||||
[⬆ /gsd:update │] model │ [current task │] directory [█████░░░░░ 50%]
|
||||
[⬆ /gsd-update │] model │ [current task │] directory [█████░░░░░ 50%]
|
||||
```
|
||||
|
||||
Color coding: <50% green, <65% yellow, <80% orange, ≥80% red with skull emoji
|
||||
|
||||
### 38. Developer Profiling
|
||||
|
||||
**Command:** `/gsd:profile-user [--questionnaire] [--refresh]`
|
||||
**Command:** `/gsd-profile-user [--questionnaire] [--refresh]`
|
||||
|
||||
**Purpose:** Analyze Claude Code session history to build behavioral profiles across 8 dimensions, generating artifacts that personalize Claude's responses to the developer's style.
|
||||
|
||||
@@ -936,7 +936,7 @@ Color coding: <50% green, <65% yellow, <80% orange, ≥80% red with skull emoji
|
||||
|
||||
**Generated Artifacts:**
|
||||
- `USER-PROFILE.md` — Full behavioral profile with evidence citations
|
||||
- `/gsd:dev-preferences` command — Load preferences in any session
|
||||
- `/gsd-dev-preferences` command — Load preferences in any session
|
||||
- `CLAUDE.md` profile section — Auto-discovered by Claude Code
|
||||
|
||||
**Flags:**
|
||||
@@ -978,14 +978,14 @@ After Level 3 wiring verification passes, spot-check individual exports for actu
|
||||
|
||||
### 40. Verification Debt Tracking
|
||||
|
||||
**Command:** `/gsd:audit-uat`
|
||||
**Command:** `/gsd-audit-uat`
|
||||
|
||||
**Purpose:** Prevent silent loss of UAT/verification items when projects advance past phases with outstanding tests. Surfaces verification debt across all prior phases so items are never forgotten.
|
||||
|
||||
**Components:**
|
||||
|
||||
**1. Cross-Phase Health Check** (progress.md Step 1.6)
|
||||
Every `/gsd:progress` call scans ALL phases in the current milestone for outstanding items (pending, skipped, blocked, human_needed). Displays a non-blocking warning section with actionable links.
|
||||
Every `/gsd-progress` call scans ALL phases in the current milestone for outstanding items (pending, skipped, blocked, human_needed). Displays a non-blocking warning section with actionable links.
|
||||
|
||||
**2. `status: partial`** (verify-work.md, UAT.md)
|
||||
New UAT status that distinguishes between "session ended" and "all tests resolved". Prevents `status: complete` when tests are still pending, blocked, or skipped without reason.
|
||||
@@ -1000,12 +1000,12 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
`phase complete` CLI returns verification debt warnings in its JSON output. Transition workflow surfaces outstanding items before confirmation.
|
||||
|
||||
**Requirements:**
|
||||
- REQ-DEBT-01: System MUST surface outstanding UAT/verification items from ALL prior phases in `/gsd:progress`
|
||||
- REQ-DEBT-01: System MUST surface outstanding UAT/verification items from ALL prior phases in `/gsd-progress`
|
||||
- REQ-DEBT-02: System MUST distinguish incomplete testing (partial) from completed testing (complete)
|
||||
- REQ-DEBT-03: System MUST categorize blocked tests with `blocked_by` tags
|
||||
- REQ-DEBT-04: System MUST persist human_needed verification items as trackable UAT files
|
||||
- REQ-DEBT-05: System MUST warn (non-blocking) during phase completion and transition when verification debt exists
|
||||
- REQ-DEBT-06: `/gsd:audit-uat` MUST scan all phases, categorize items by testability, and produce a human test plan
|
||||
- REQ-DEBT-06: `/gsd-audit-uat` MUST scan all phases, categorize items by testability, and produce a human test plan
|
||||
|
||||
---
|
||||
|
||||
@@ -1013,7 +1013,7 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
|
||||
### 41. Fast Mode
|
||||
|
||||
**Command:** `/gsd:fast [task description]`
|
||||
**Command:** `/gsd-fast [task description]`
|
||||
|
||||
**Purpose:** Execute trivial tasks inline without spawning subagents or generating PLAN.md files. For tasks too small to justify planning overhead: typo fixes, config changes, small refactors, forgotten commits, simple additions.
|
||||
|
||||
@@ -1023,15 +1023,15 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
- REQ-FAST-03: System MUST track the task in `.planning/quick/` for state consistency
|
||||
- REQ-FAST-04: System MUST NOT be used for tasks requiring research, multi-step planning, or verification
|
||||
|
||||
**When to use vs `/gsd:quick`:**
|
||||
- `/gsd:fast` — One-sentence tasks executable in under 2 minutes (typo, config change, small addition)
|
||||
- `/gsd:quick` — Anything needing research, multi-step planning, or verification
|
||||
**When to use vs `/gsd-quick`:**
|
||||
- `/gsd-fast` — One-sentence tasks executable in under 2 minutes (typo, config change, small addition)
|
||||
- `/gsd-quick` — Anything needing research, multi-step planning, or verification
|
||||
|
||||
---
|
||||
|
||||
### 42. Cross-AI Peer Review
|
||||
|
||||
**Command:** `/gsd:review --phase N [--gemini] [--claude] [--codex] [--coderabbit] [--all]`
|
||||
**Command:** `/gsd-review --phase N [--gemini] [--claude] [--codex] [--coderabbit] [--all]`
|
||||
|
||||
**Purpose:** Invoke external AI CLIs (Gemini, Claude, Codex, CodeRabbit) to independently review phase plans. Produces structured REVIEWS.md with per-reviewer feedback.
|
||||
|
||||
@@ -1040,7 +1040,7 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
- REQ-REVIEW-02: System MUST build a structured review prompt from phase plans
|
||||
- REQ-REVIEW-03: System MUST invoke each selected CLI independently
|
||||
- REQ-REVIEW-04: System MUST collect responses and produce `REVIEWS.md`
|
||||
- REQ-REVIEW-05: Reviews MUST be consumable by `/gsd:plan-phase --reviews`
|
||||
- REQ-REVIEW-05: Reviews MUST be consumable by `/gsd-plan-phase --reviews`
|
||||
|
||||
**Produces:** `{phase}-REVIEWS.md` — Per-reviewer structured feedback
|
||||
|
||||
@@ -1048,17 +1048,17 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
|
||||
### 43. Backlog Parking Lot
|
||||
|
||||
**Commands:** `/gsd:add-backlog <description>`, `/gsd:review-backlog`, `/gsd:plant-seed <idea>`
|
||||
**Commands:** `/gsd-add-backlog <description>`, `/gsd-review-backlog`, `/gsd-plant-seed <idea>`
|
||||
|
||||
**Purpose:** Capture ideas that aren't ready for active planning. Backlog items use 999.x numbering to stay outside the active phase sequence. Seeds are forward-looking ideas with trigger conditions that surface automatically at the right milestone.
|
||||
|
||||
**Requirements:**
|
||||
- REQ-BACKLOG-01: Backlog items MUST use 999.x numbering to stay outside active phase sequence
|
||||
- REQ-BACKLOG-02: Phase directories MUST be created immediately so `/gsd:discuss-phase` and `/gsd:plan-phase` work on them
|
||||
- REQ-BACKLOG-03: `/gsd:review-backlog` MUST support promote, keep, and remove actions per item
|
||||
- REQ-BACKLOG-02: Phase directories MUST be created immediately so `/gsd-discuss-phase` and `/gsd-plan-phase` work on them
|
||||
- REQ-BACKLOG-03: `/gsd-review-backlog` MUST support promote, keep, and remove actions per item
|
||||
- REQ-BACKLOG-04: Promoted items MUST be renumbered into the active milestone sequence
|
||||
- REQ-SEED-01: Seeds MUST capture the full WHY and WHEN to surface conditions
|
||||
- REQ-SEED-02: `/gsd:new-milestone` MUST scan seeds and present matches
|
||||
- REQ-SEED-02: `/gsd-new-milestone` MUST scan seeds and present matches
|
||||
|
||||
**Produces:**
|
||||
| Artifact | Description |
|
||||
@@ -1070,9 +1070,9 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
|
||||
### 44. Persistent Context Threads
|
||||
|
||||
**Command:** `/gsd:thread [name | description]`
|
||||
**Command:** `/gsd-thread [name | description]`
|
||||
|
||||
**Purpose:** Lightweight cross-session knowledge stores for work that spans multiple sessions but doesn't belong to any specific phase. Lighter weight than `/gsd:pause-work` — no phase state, no plan context.
|
||||
**Purpose:** Lightweight cross-session knowledge stores for work that spans multiple sessions but doesn't belong to any specific phase. Lighter weight than `/gsd-pause-work` — no phase state, no plan context.
|
||||
|
||||
**Requirements:**
|
||||
- REQ-THREAD-01: System MUST support create, list, and resume modes
|
||||
@@ -1087,7 +1087,7 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
|
||||
### 45. PR Branch Filtering
|
||||
|
||||
**Command:** `/gsd:pr-branch [target branch]`
|
||||
**Command:** `/gsd-pr-branch [target branch]`
|
||||
|
||||
**Purpose:** Create a clean branch suitable for pull requests by filtering out `.planning/` commits. Reviewers see only code changes, not GSD planning artifacts.
|
||||
|
||||
@@ -1115,7 +1115,7 @@ When verification returns `human_needed`, items are persisted as a trackable HUM
|
||||
PreToolUse hook that scans Write/Edit calls targeting `.planning/` for injection patterns. Advisory-only — logs detection for awareness without blocking legitimate operations.
|
||||
|
||||
**3. Workflow Guard Hook** (`gsd-workflow-guard.js`)
|
||||
PreToolUse hook that detects when Claude attempts file edits outside a GSD workflow context. Advises using `/gsd:quick` or `/gsd:fast` instead of direct edits. Configurable via `hooks.workflow_guard` (default: false).
|
||||
PreToolUse hook that detects when Claude attempts file edits outside a GSD workflow context. Advises using `/gsd-quick` or `/gsd-fast` instead of direct edits. Configurable via `hooks.workflow_guard` (default: false).
|
||||
|
||||
**4. CI-Ready Injection Scanner** (`prompt-injection-scan.test.cjs`)
|
||||
Test suite that scans all agent, workflow, and command files for embedded injection vectors.
|
||||
@@ -1142,7 +1142,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 48. Discussion Audit Trail
|
||||
|
||||
**Purpose:** Auto-generate `DISCUSSION-LOG.md` during `/gsd:discuss-phase` for full audit trail of decisions made during discussion.
|
||||
**Purpose:** Auto-generate `DISCUSSION-LOG.md` during `/gsd-discuss-phase` for full audit trail of decisions made during discussion.
|
||||
|
||||
**Requirements:**
|
||||
- REQ-DISCLOG-01: System MUST auto-generate DISCUSSION-LOG.md during discuss-phase
|
||||
@@ -1155,7 +1155,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 49. Forensics
|
||||
|
||||
**Command:** `/gsd:forensics [description]`
|
||||
**Command:** `/gsd-forensics [description]`
|
||||
|
||||
**Purpose:** Post-mortem investigation of failed or stuck GSD workflows.
|
||||
|
||||
@@ -1181,7 +1181,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 50. Milestone Summary
|
||||
|
||||
**Command:** `/gsd:milestone-summary [version]`
|
||||
**Command:** `/gsd-milestone-summary [version]`
|
||||
|
||||
**Purpose:** Generate comprehensive project summary from milestone artifacts for team onboarding.
|
||||
|
||||
@@ -1204,7 +1204,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 51. Workstream Namespacing
|
||||
|
||||
**Command:** `/gsd:workstreams`
|
||||
**Command:** `/gsd-workstreams`
|
||||
|
||||
**Purpose:** Parallel workstreams for concurrent work on different milestone areas.
|
||||
|
||||
@@ -1227,7 +1227,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 52. Manager Dashboard
|
||||
|
||||
**Command:** `/gsd:manager`
|
||||
**Command:** `/gsd-manager`
|
||||
|
||||
**Purpose:** Interactive command center for managing multiple phases from one terminal.
|
||||
|
||||
@@ -1247,7 +1247,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 53. Assumptions Discussion Mode
|
||||
|
||||
**Command:** `/gsd:discuss-phase` with `workflow.discuss_mode: 'assumptions'`
|
||||
**Command:** `/gsd-discuss-phase` with `workflow.discuss_mode: 'assumptions'`
|
||||
|
||||
**Purpose:** Replace interview-style questioning with codebase-first assumption analysis.
|
||||
|
||||
@@ -1273,20 +1273,20 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 54. UI Phase Auto-Detection
|
||||
|
||||
**Part of:** `/gsd:new-project` and `/gsd:progress`
|
||||
**Part of:** `/gsd-new-project` and `/gsd-progress`
|
||||
|
||||
**Purpose:** Automatically detect UI-heavy projects and surface `/gsd:ui-phase` recommendation.
|
||||
**Purpose:** Automatically detect UI-heavy projects and surface `/gsd-ui-phase` recommendation.
|
||||
|
||||
**Requirements:**
|
||||
- REQ-UI-DETECT-01: System MUST detect UI signals in project description (keywords, framework references)
|
||||
- REQ-UI-DETECT-02: System MUST annotate ROADMAP.md phases with `ui_hint` when applicable
|
||||
- REQ-UI-DETECT-03: System MUST suggest `/gsd:ui-phase` in next steps for UI-heavy phases
|
||||
- REQ-UI-DETECT-04: System MUST NOT make `/gsd:ui-phase` mandatory
|
||||
- REQ-UI-DETECT-03: System MUST suggest `/gsd-ui-phase` in next steps for UI-heavy phases
|
||||
- REQ-UI-DETECT-04: System MUST NOT make `/gsd-ui-phase` mandatory
|
||||
|
||||
**Process:**
|
||||
1. **Detect** — Scan project description and tech stack for UI signals (keywords, framework references)
|
||||
2. **Annotate** — Add `ui_hint` markers to applicable phases in ROADMAP.md
|
||||
3. **Surface** — Include `/gsd:ui-phase` recommendation in next steps for UI-heavy phases
|
||||
3. **Surface** — Include `/gsd-ui-phase` recommendation in next steps for UI-heavy phases
|
||||
|
||||
---
|
||||
|
||||
@@ -1365,7 +1365,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 59. Schema Drift Detection
|
||||
|
||||
**Command:** Automatic during `/gsd:execute-phase`
|
||||
**Command:** Automatic during `/gsd-execute-phase`
|
||||
|
||||
**Purpose:** Detect when ORM schema files are modified without corresponding migration or push commands, preventing false-positive verification.
|
||||
|
||||
@@ -1388,7 +1388,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 60. Security Enforcement
|
||||
|
||||
**Command:** `/gsd:secure-phase <N>`
|
||||
**Command:** `/gsd-secure-phase <N>`
|
||||
|
||||
**Purpose:** Threat-model-anchored security verification for phase implementations.
|
||||
|
||||
@@ -1419,7 +1419,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 61. Documentation Generation
|
||||
|
||||
**Command:** `/gsd:docs-update`
|
||||
**Command:** `/gsd-docs-update`
|
||||
|
||||
**Purpose:** Generate and verify project documentation with accuracy checks.
|
||||
|
||||
@@ -1442,7 +1442,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 62. Discuss Chain Mode
|
||||
|
||||
**Flag:** `/gsd:discuss-phase <N> --chain`
|
||||
**Flag:** `/gsd-discuss-phase <N> --chain`
|
||||
|
||||
**Purpose:** Auto-chain discuss, plan, and execute phases in one flow to reduce manual command sequencing.
|
||||
|
||||
@@ -1460,7 +1460,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 63. Single-Phase Autonomous
|
||||
|
||||
**Flag:** `/gsd:autonomous --only N`
|
||||
**Flag:** `/gsd-autonomous --only N`
|
||||
|
||||
**Purpose:** Execute just one phase autonomously instead of all remaining phases.
|
||||
|
||||
@@ -1478,7 +1478,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 64. Scope Reduction Detection
|
||||
|
||||
**Part of:** `/gsd:plan-phase`
|
||||
**Part of:** `/gsd-plan-phase`
|
||||
|
||||
**Purpose:** Prevent silent requirement dropping during plan generation with three-layer defense.
|
||||
|
||||
@@ -1497,7 +1497,7 @@ Test suite that scans all agent, workflow, and command files for embedded inject
|
||||
|
||||
### 65. Claim Provenance Tagging
|
||||
|
||||
**Part of:** `/gsd:research-phase`
|
||||
**Part of:** `/gsd-research-phase`
|
||||
|
||||
**Purpose:** Ensure research claims are tagged with source evidence and assumptions are logged separately.
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ Language versions: [English](README.md) · [Português (pt-BR)](pt-BR/README.md)
|
||||
## Quick Links
|
||||
|
||||
- **What's new in v1.28:** Forensics, milestone summary, workstreams, assumptions mode, UI auto-detect, manager dashboard
|
||||
- **Getting started:** [README](../README.md) → install → `/gsd:new-project`
|
||||
- **Getting started:** [README](../README.md) → install → `/gsd-new-project`
|
||||
- **Full workflow walkthrough:** [User Guide](USER-GUIDE.md)
|
||||
- **All commands at a glance:** [Command Reference](COMMANDS.md)
|
||||
- **Configuring GSD:** [Configuration Reference](CONFIGURATION.md)
|
||||
|
||||
@@ -26,7 +26,7 @@ A detailed reference for workflows, troubleshooting, and configuration. For quic
|
||||
```
|
||||
┌──────────────────────────────────────────────────┐
|
||||
│ NEW PROJECT │
|
||||
│ /gsd:new-project │
|
||||
│ /gsd-new-project │
|
||||
│ Questions -> Research -> Requirements -> Roadmap│
|
||||
└─────────────────────────┬────────────────────────┘
|
||||
│
|
||||
@@ -34,27 +34,27 @@ A detailed reference for workflows, troubleshooting, and configuration. For quic
|
||||
│ 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 @@ A detailed reference for workflows, troubleshooting, and configuration. For quic
|
||||
└─────────────┼──────────────┘
|
||||
│
|
||||
┌───────────────▼──────────────┐
|
||||
│ /gsd:audit-milestone │
|
||||
│ /gsd:complete-milestone │
|
||||
│ /gsd-audit-milestone │
|
||||
│ /gsd-complete-milestone │
|
||||
└───────────────┬──────────────┘
|
||||
│
|
||||
Another milestone?
|
||||
@@ -71,14 +71,14 @@ A detailed reference for workflows, troubleshooting, and configuration. For quic
|
||||
Yes No -> Done!
|
||||
│
|
||||
┌───────▼──────────────┐
|
||||
│ /gsd:new-milestone │
|
||||
│ /gsd-new-milestone │
|
||||
└──────────────────────┘
|
||||
```
|
||||
|
||||
### Planning Agent Coordination
|
||||
|
||||
```
|
||||
/gsd:plan-phase N
|
||||
/gsd-plan-phase N
|
||||
│
|
||||
├── Phase Researcher (x4 parallel)
|
||||
│ ├── Stack researcher
|
||||
@@ -124,16 +124,16 @@ lack automated verify commands will not be approved.
|
||||
|
||||
**Output:** `{phase}-VALIDATION.md` -- the feedback contract for the phase.
|
||||
|
||||
**Disable:** Set `workflow.nyquist_validation: false` in `/gsd:settings` for
|
||||
**Disable:** Set `workflow.nyquist_validation: false` in `/gsd-settings` for
|
||||
rapid prototyping phases where test infrastructure isn't the focus.
|
||||
|
||||
### Retroactive Validation (`/gsd:validate-phase`)
|
||||
### Retroactive Validation (`/gsd-validate-phase`)
|
||||
|
||||
For phases executed before Nyquist validation existed, or for existing codebases
|
||||
with only traditional test suites, retroactively audit and fill coverage gaps:
|
||||
|
||||
```
|
||||
/gsd:validate-phase N
|
||||
/gsd-validate-phase N
|
||||
|
|
||||
+-- Detect state (VALIDATION.md exists? SUMMARY.md exists?)
|
||||
|
|
||||
@@ -156,13 +156,13 @@ VALIDATION.md. If a test reveals an implementation bug, it's flagged as an
|
||||
escalation for you to address.
|
||||
|
||||
**When to use:** After executing phases that were planned before Nyquist was
|
||||
enabled, or after `/gsd:audit-milestone` surfaces Nyquist compliance gaps.
|
||||
enabled, or after `/gsd-audit-milestone` surfaces Nyquist compliance gaps.
|
||||
|
||||
### Assumptions Discussion Mode
|
||||
|
||||
By default, `/gsd:discuss-phase` asks open-ended questions about your implementation preferences. Assumptions mode inverts this: GSD reads your codebase first, surfaces structured assumptions about how it would build the phase, and asks only for corrections.
|
||||
By default, `/gsd-discuss-phase` asks open-ended questions about your implementation preferences. Assumptions mode inverts this: GSD reads your codebase first, surfaces structured assumptions about how it would build the phase, and asks only for corrections.
|
||||
|
||||
**Enable:** Set `workflow.discuss_mode` to `'assumptions'` via `/gsd:settings`.
|
||||
**Enable:** Set `workflow.discuss_mode` to `'assumptions'` via `/gsd-settings`.
|
||||
|
||||
**How it works:**
|
||||
1. Reads PROJECT.md, codebase mapping, and existing conventions
|
||||
@@ -185,18 +185,18 @@ See [docs/workflow-discuss-mode.md](workflow-discuss-mode.md) for the full discu
|
||||
|
||||
AI-generated frontends are visually inconsistent not because Claude Code is bad at UI but because no design contract existed before execution. Five components built without a shared spacing scale, color contract, or copywriting standard produce five slightly different visual decisions.
|
||||
|
||||
`/gsd:ui-phase` locks the design contract before planning. `/gsd:ui-review` audits the result after execution.
|
||||
`/gsd-ui-phase` locks the design contract before planning. `/gsd-ui-review` audits the result after execution.
|
||||
|
||||
### Commands
|
||||
|
||||
| Command | Description |
|
||||
|---------|-------------|
|
||||
| `/gsd:ui-phase [N]` | Generate UI-SPEC.md design contract for a frontend phase |
|
||||
| `/gsd:ui-review [N]` | Retroactive 6-pillar visual audit of implemented UI |
|
||||
| `/gsd-ui-phase [N]` | Generate UI-SPEC.md design contract for a frontend phase |
|
||||
| `/gsd-ui-review [N]` | Retroactive 6-pillar visual audit of implemented UI |
|
||||
|
||||
### Workflow: `/gsd:ui-phase`
|
||||
### Workflow: `/gsd-ui-phase`
|
||||
|
||||
**When to run:** After `/gsd:discuss-phase`, before `/gsd:plan-phase` — for phases with frontend/UI work.
|
||||
**When to run:** After `/gsd-discuss-phase`, before `/gsd-plan-phase` — for phases with frontend/UI work.
|
||||
|
||||
**Flow:**
|
||||
1. Reads CONTEXT.md, RESEARCH.md, REQUIREMENTS.md for existing decisions
|
||||
@@ -209,9 +209,9 @@ AI-generated frontends are visually inconsistent not because Claude Code is bad
|
||||
|
||||
**Output:** `{padded_phase}-UI-SPEC.md` in `.planning/phases/{phase-dir}/`
|
||||
|
||||
### Workflow: `/gsd:ui-review`
|
||||
### Workflow: `/gsd-ui-review`
|
||||
|
||||
**When to run:** After `/gsd:execute-phase` or `/gsd:verify-work` — for any project with frontend code.
|
||||
**When to run:** After `/gsd-execute-phase` or `/gsd-verify-work` — for any project with frontend code.
|
||||
|
||||
**Standalone:** Works on any project, not just GSD-managed ones. If no UI-SPEC.md exists, audits against abstract 6-pillar standards.
|
||||
|
||||
@@ -230,9 +230,9 @@ AI-generated frontends are visually inconsistent not because Claude Code is bad
|
||||
| Setting | Default | Description |
|
||||
|---------|---------|-------------|
|
||||
| `workflow.ui_phase` | `true` | Generate UI design contracts for frontend phases |
|
||||
| `workflow.ui_safety_gate` | `true` | plan-phase prompts to run /gsd:ui-phase for frontend phases |
|
||||
| `workflow.ui_safety_gate` | `true` | plan-phase prompts to run /gsd-ui-phase for frontend phases |
|
||||
|
||||
Both follow the absent=enabled pattern. Disable via `/gsd:settings`.
|
||||
Both follow the absent=enabled pattern. Disable via `/gsd-settings`.
|
||||
|
||||
### shadcn Initialization
|
||||
|
||||
@@ -255,7 +255,7 @@ Controlled by `workflow.ui_safety_gate` config toggle.
|
||||
|
||||
### Screenshot Storage
|
||||
|
||||
`/gsd:ui-review` captures screenshots via Playwright CLI to `.planning/ui-reviews/`. A `.gitignore` is created automatically to prevent binary files from reaching git. Screenshots are cleaned up during `/gsd:complete-milestone`.
|
||||
`/gsd-ui-review` captures screenshots via Playwright CLI to `.planning/ui-reviews/`. A `.gitignore` is created automatically to prevent binary files from reaching git. Screenshots are cleaned up during `/gsd-complete-milestone`.
|
||||
|
||||
---
|
||||
|
||||
@@ -266,23 +266,23 @@ Controlled by `workflow.ui_safety_gate` config toggle.
|
||||
Ideas that aren't ready for active planning go into the backlog using 999.x numbering, keeping them outside the active phase sequence.
|
||||
|
||||
```
|
||||
/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/
|
||||
```
|
||||
|
||||
Backlog items get full phase directories, so you can use `/gsd:discuss-phase 999.1` to explore an idea further or `/gsd:plan-phase 999.1` when it's ready.
|
||||
Backlog items get full phase directories, so you can use `/gsd-discuss-phase 999.1` to explore an idea further or `/gsd-plan-phase 999.1` when it's ready.
|
||||
|
||||
**Review and promote** with `/gsd:review-backlog` — it shows all backlog items and lets you promote (move to active sequence), keep (leave in backlog), or remove (delete).
|
||||
**Review and promote** with `/gsd-review-backlog` — it shows all backlog items and lets you promote (move to active sequence), keep (leave in backlog), or remove (delete).
|
||||
|
||||
### Seeds
|
||||
|
||||
Seeds are forward-looking ideas with trigger conditions. Unlike backlog items, seeds surface automatically when the right milestone arrives.
|
||||
|
||||
```
|
||||
/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"
|
||||
```
|
||||
|
||||
Seeds preserve the full WHY and WHEN to surface. `/gsd:new-milestone` scans all seeds and presents matches.
|
||||
Seeds preserve the full WHY and WHEN to surface. `/gsd-new-milestone` scans all seeds and presents matches.
|
||||
|
||||
**Storage:** `.planning/seeds/SEED-NNN-slug.md`
|
||||
|
||||
@@ -291,14 +291,14 @@ Seeds preserve the full WHY and WHEN to surface. `/gsd:new-milestone` scans all
|
||||
Threads are lightweight cross-session knowledge stores for work that spans multiple sessions but doesn't belong to any specific phase.
|
||||
|
||||
```
|
||||
/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
|
||||
```
|
||||
|
||||
Threads are lighter weight than `/gsd:pause-work` — no phase state, no plan context. Each thread file includes Goal, Context, References, and Next Steps sections.
|
||||
Threads are lighter weight than `/gsd-pause-work` — no phase state, no plan context. Each thread file includes Goal, Context, References, and Next Steps sections.
|
||||
|
||||
Threads can be promoted to phases (`/gsd:add-phase`) or backlog items (`/gsd:add-backlog`) when they mature.
|
||||
Threads can be promoted to phases (`/gsd-add-phase`) or backlog items (`/gsd-add-backlog`) when they mature.
|
||||
|
||||
**Storage:** `.planning/threads/{slug}.md`
|
||||
|
||||
@@ -314,16 +314,16 @@ Workstreams let you work on multiple milestone areas concurrently without state
|
||||
|
||||
| Command | Purpose |
|
||||
|---------|---------|
|
||||
| `/gsd:workstreams create <name>` | Create a new workstream with isolated planning state |
|
||||
| `/gsd:workstreams switch <name>` | Switch active context to a different workstream |
|
||||
| `/gsd:workstreams list` | Show all workstreams and which is active |
|
||||
| `/gsd:workstreams complete <name>` | Mark a workstream as done and archive its state |
|
||||
| `/gsd-workstreams create <name>` | Create a new workstream with isolated planning state |
|
||||
| `/gsd-workstreams switch <name>` | Switch active context to a different workstream |
|
||||
| `/gsd-workstreams list` | Show all workstreams and which is active |
|
||||
| `/gsd-workstreams complete <name>` | Mark a workstream as done and archive its state |
|
||||
|
||||
### How It Works
|
||||
|
||||
Each workstream maintains its own `.planning/` directory subtree. When you switch workstreams, GSD swaps the active planning context so that `/gsd:progress`, `/gsd:discuss-phase`, `/gsd:plan-phase`, and other commands operate on that workstream's state. Active context is session-scoped when the runtime exposes a stable session identifier, which prevents one terminal or AI instance from repointing another instance's `STATE.md`.
|
||||
Each workstream maintains its own `.planning/` directory subtree. When you switch workstreams, GSD swaps the active planning context so that `/gsd-progress`, `/gsd-discuss-phase`, `/gsd-plan-phase`, and other commands operate on that workstream's state. Active context is session-scoped when the runtime exposes a stable session identifier, which prevents one terminal or AI instance from repointing another instance's `STATE.md`.
|
||||
|
||||
This is lighter weight than `/gsd:new-workspace` (which creates separate repo worktrees). Workstreams share the same codebase and git history but isolate planning artifacts.
|
||||
This is lighter weight than `/gsd-new-workspace` (which creates separate repo worktrees). Workstreams share the same codebase and git history but isolate planning artifacts.
|
||||
|
||||
---
|
||||
|
||||
@@ -351,7 +351,7 @@ The `security.cjs` module scans for known injection patterns (role overrides, in
|
||||
### Execution Wave Coordination
|
||||
|
||||
```
|
||||
/gsd:execute-phase N
|
||||
/gsd-execute-phase N
|
||||
│
|
||||
├── Analyze plan dependencies
|
||||
│
|
||||
@@ -366,13 +366,13 @@ The `security.cjs` module scans for known injection patterns (role overrides, in
|
||||
└── Check codebase against phase goals
|
||||
│
|
||||
├── PASS -> VERIFICATION.md (success)
|
||||
└── FAIL -> Issues logged for /gsd:verify-work
|
||||
└── FAIL -> Issues logged for /gsd-verify-work
|
||||
```
|
||||
|
||||
### Brownfield Workflow (Existing Codebase)
|
||||
|
||||
```
|
||||
/gsd:map-codebase
|
||||
/gsd-map-codebase
|
||||
│
|
||||
├── Stack Mapper -> codebase/STACK.md
|
||||
├── Arch Mapper -> codebase/ARCHITECTURE.md
|
||||
@@ -380,7 +380,7 @@ The `security.cjs` module scans for known injection patterns (role overrides, in
|
||||
└── 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
|
||||
└──────────────────┘
|
||||
```
|
||||
|
||||
@@ -392,80 +392,80 @@ The `security.cjs` module scans for known injection patterns (role overrides, in
|
||||
|
||||
| Command | Purpose | When to Use |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:new-project` | Full project init: questions, research, requirements, roadmap | Start of a new project |
|
||||
| `/gsd:new-project --auto @idea.md` | Automated init from document | Have a PRD or idea doc ready |
|
||||
| `/gsd:discuss-phase [N]` | Capture implementation decisions | Before planning, to shape how it gets built |
|
||||
| `/gsd:ui-phase [N]` | Generate UI design contract | After discuss-phase, before plan-phase (frontend phases) |
|
||||
| `/gsd:plan-phase [N]` | Research + plan + verify | Before executing a phase |
|
||||
| `/gsd:execute-phase <N>` | Execute all plans in parallel waves | After planning is complete |
|
||||
| `/gsd:verify-work [N]` | Manual UAT with auto-diagnosis | After execution completes |
|
||||
| `/gsd:ship [N]` | Create PR from verified work | After verification passes |
|
||||
| `/gsd:fast <text>` | Inline trivial tasks — skips planning entirely | Typo fixes, config changes, small refactors |
|
||||
| `/gsd:next` | Auto-detect state and run next step | Anytime — "what should I do next?" |
|
||||
| `/gsd:ui-review [N]` | Retroactive 6-pillar visual audit | After execution or verify-work (frontend projects) |
|
||||
| `/gsd:audit-milestone` | Verify milestone met its definition of done | Before completing milestone |
|
||||
| `/gsd:complete-milestone` | Archive milestone, tag release | All phases verified |
|
||||
| `/gsd:new-milestone [name]` | Start next version cycle | After completing a milestone |
|
||||
| `/gsd-new-project` | Full project init: questions, research, requirements, roadmap | Start of a new project |
|
||||
| `/gsd-new-project --auto @idea.md` | Automated init from document | Have a PRD or idea doc ready |
|
||||
| `/gsd-discuss-phase [N]` | Capture implementation decisions | Before planning, to shape how it gets built |
|
||||
| `/gsd-ui-phase [N]` | Generate UI design contract | After discuss-phase, before plan-phase (frontend phases) |
|
||||
| `/gsd-plan-phase [N]` | Research + plan + verify | Before executing a phase |
|
||||
| `/gsd-execute-phase <N>` | Execute all plans in parallel waves | After planning is complete |
|
||||
| `/gsd-verify-work [N]` | Manual UAT with auto-diagnosis | After execution completes |
|
||||
| `/gsd-ship [N]` | Create PR from verified work | After verification passes |
|
||||
| `/gsd-fast <text>` | Inline trivial tasks — skips planning entirely | Typo fixes, config changes, small refactors |
|
||||
| `/gsd-next` | Auto-detect state and run next step | Anytime — "what should I do next?" |
|
||||
| `/gsd-ui-review [N]` | Retroactive 6-pillar visual audit | After execution or verify-work (frontend projects) |
|
||||
| `/gsd-audit-milestone` | Verify milestone met its definition of done | Before completing milestone |
|
||||
| `/gsd-complete-milestone` | Archive milestone, tag release | All phases verified |
|
||||
| `/gsd-new-milestone [name]` | Start next version cycle | After completing a milestone |
|
||||
|
||||
### Navigation
|
||||
|
||||
| Command | Purpose | When to Use |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:progress` | Show status and next steps | Anytime -- "where am I?" |
|
||||
| `/gsd:resume-work` | Restore full context from last session | Starting a new session |
|
||||
| `/gsd:pause-work` | Save structured handoff (HANDOFF.json + continue-here.md) | Stopping mid-phase |
|
||||
| `/gsd:session-report` | Generate session summary with work and outcomes | End of session, stakeholder sharing |
|
||||
| `/gsd:help` | Show all commands | Quick reference |
|
||||
| `/gsd:update` | Update GSD with changelog preview | Check for new versions |
|
||||
| `/gsd:join-discord` | Open Discord community invite | Questions or community |
|
||||
| `/gsd-progress` | Show status and next steps | Anytime -- "where am I?" |
|
||||
| `/gsd-resume-work` | Restore full context from last session | Starting a new session |
|
||||
| `/gsd-pause-work` | Save structured handoff (HANDOFF.json + continue-here.md) | Stopping mid-phase |
|
||||
| `/gsd-session-report` | Generate session summary with work and outcomes | End of session, stakeholder sharing |
|
||||
| `/gsd-help` | Show all commands | Quick reference |
|
||||
| `/gsd-update` | Update GSD with changelog preview | Check for new versions |
|
||||
| `/gsd-join-discord` | Open Discord community invite | Questions or community |
|
||||
|
||||
### Phase Management
|
||||
|
||||
| Command | Purpose | When to Use |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:add-phase` | Append new phase to roadmap | Scope grows after initial planning |
|
||||
| `/gsd:insert-phase [N]` | Insert urgent work (decimal numbering) | Urgent fix mid-milestone |
|
||||
| `/gsd:remove-phase [N]` | Remove future phase and renumber | Descoping a feature |
|
||||
| `/gsd:list-phase-assumptions [N]` | Preview Claude's intended approach | Before planning, to validate direction |
|
||||
| `/gsd:plan-milestone-gaps` | Create phases for audit gaps | After audit finds missing items |
|
||||
| `/gsd:research-phase [N]` | Deep ecosystem research only | Complex or unfamiliar domain |
|
||||
| `/gsd-add-phase` | Append new phase to roadmap | Scope grows after initial planning |
|
||||
| `/gsd-insert-phase [N]` | Insert urgent work (decimal numbering) | Urgent fix mid-milestone |
|
||||
| `/gsd-remove-phase [N]` | Remove future phase and renumber | Descoping a feature |
|
||||
| `/gsd-list-phase-assumptions [N]` | Preview Claude's intended approach | Before planning, to validate direction |
|
||||
| `/gsd-plan-milestone-gaps` | Create phases for audit gaps | After audit finds missing items |
|
||||
| `/gsd-research-phase [N]` | Deep ecosystem research only | Complex or unfamiliar domain |
|
||||
|
||||
### Brownfield & Utilities
|
||||
|
||||
| Command | Purpose | When to Use |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:map-codebase` | Analyze existing codebase | Before `/gsd:new-project` on existing code |
|
||||
| `/gsd:quick` | Ad-hoc task with GSD guarantees | Bug fixes, small features, config changes |
|
||||
| `/gsd:debug [desc]` | Systematic debugging with persistent state | When something breaks |
|
||||
| `/gsd:forensics` | Diagnostic report for workflow failures | When state, artifacts, or git history seem corrupted |
|
||||
| `/gsd:add-todo [desc]` | Capture an idea for later | Think of something during a session |
|
||||
| `/gsd:check-todos` | List pending todos | Review captured ideas |
|
||||
| `/gsd:settings` | Configure workflow toggles and model profile | Change model, toggle agents |
|
||||
| `/gsd:set-profile <profile>` | Quick profile switch | Change cost/quality tradeoff |
|
||||
| `/gsd:reapply-patches` | Restore local modifications after update | After `/gsd:update` if you had local edits |
|
||||
| `/gsd-map-codebase` | Analyze existing codebase | Before `/gsd-new-project` on existing code |
|
||||
| `/gsd-quick` | Ad-hoc task with GSD guarantees | Bug fixes, small features, config changes |
|
||||
| `/gsd-debug [desc]` | Systematic debugging with persistent state | When something breaks |
|
||||
| `/gsd-forensics` | Diagnostic report for workflow failures | When state, artifacts, or git history seem corrupted |
|
||||
| `/gsd-add-todo [desc]` | Capture an idea for later | Think of something during a session |
|
||||
| `/gsd-check-todos` | List pending todos | Review captured ideas |
|
||||
| `/gsd-settings` | Configure workflow toggles and model profile | Change model, toggle agents |
|
||||
| `/gsd-set-profile <profile>` | Quick profile switch | Change cost/quality tradeoff |
|
||||
| `/gsd-reapply-patches` | Restore local modifications after update | After `/gsd-update` if you had local edits |
|
||||
|
||||
### Code Quality & Review
|
||||
|
||||
| Command | Purpose | When to Use |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:review --phase N` | Cross-AI peer review from external CLIs | Before executing, to validate plans |
|
||||
| `/gsd:pr-branch` | Clean PR branch filtering `.planning/` commits | Before creating PR with planning-free diff |
|
||||
| `/gsd:audit-uat` | Audit verification debt across all phases | Before milestone completion |
|
||||
| `/gsd-review --phase N` | Cross-AI peer review from external CLIs | Before executing, to validate plans |
|
||||
| `/gsd-pr-branch` | Clean PR branch filtering `.planning/` commits | Before creating PR with planning-free diff |
|
||||
| `/gsd-audit-uat` | Audit verification debt across all phases | Before milestone completion |
|
||||
|
||||
### Backlog & Threads
|
||||
|
||||
| Command | Purpose | When to Use |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:add-backlog <desc>` | Add idea to backlog parking lot (999.x) | Ideas not ready for active planning |
|
||||
| `/gsd:review-backlog` | Promote/keep/remove backlog items | Before new milestone, to prioritize |
|
||||
| `/gsd:plant-seed <idea>` | Forward-looking idea with trigger conditions | Ideas that should surface at a future milestone |
|
||||
| `/gsd:thread [name]` | Persistent context threads | Cross-session work outside the phase structure |
|
||||
| `/gsd-add-backlog <desc>` | Add idea to backlog parking lot (999.x) | Ideas not ready for active planning |
|
||||
| `/gsd-review-backlog` | Promote/keep/remove backlog items | Before new milestone, to prioritize |
|
||||
| `/gsd-plant-seed <idea>` | Forward-looking idea with trigger conditions | Ideas that should surface at a future milestone |
|
||||
| `/gsd-thread [name]` | Persistent context threads | Cross-session work outside the phase structure |
|
||||
|
||||
---
|
||||
|
||||
## Configuration Reference
|
||||
|
||||
GSD stores project settings in `.planning/config.json`. Configure during `/gsd:new-project` or update later with `/gsd:settings`.
|
||||
GSD stores project settings in `.planning/config.json`. Configure during `/gsd-new-project` or update later with `/gsd-settings`.
|
||||
|
||||
### Full config.json Schema
|
||||
|
||||
@@ -529,7 +529,7 @@ GSD stores project settings in `.planning/config.json`. Configure during `/gsd:n
|
||||
| `workflow.verifier` | `true`, `false` | `true` | Post-execution verification against phase goals |
|
||||
| `workflow.nyquist_validation` | `true`, `false` | `true` | Validation architecture research during plan-phase; 8th plan-check dimension |
|
||||
| `workflow.ui_phase` | `true`, `false` | `true` | Generate UI design contracts for frontend phases |
|
||||
| `workflow.ui_safety_gate` | `true`, `false` | `true` | plan-phase prompts to run /gsd:ui-phase for frontend phases |
|
||||
| `workflow.ui_safety_gate` | `true`, `false` | `true` | plan-phase prompts to run /gsd-ui-phase for frontend phases |
|
||||
| `workflow.research_before_questions` | `true`, `false` | `false` | Run research before discussion questions instead of after |
|
||||
| `workflow.discuss_mode` | `standard`, `assumptions` | `standard` | Discussion style: open-ended questions vs. codebase-driven assumptions |
|
||||
| `workflow.skip_discuss` | `true`, `false` | `false` | Skip discuss-phase entirely in autonomous mode; writes minimal CONTEXT.md from ROADMAP phase goal |
|
||||
@@ -550,7 +550,7 @@ Disable workflow toggles to speed up phases in familiar domains or when conservi
|
||||
| `git.branching_strategy` | `none`, `phase`, `milestone` | `none` | When and how branches are created |
|
||||
| `git.phase_branch_template` | Template string | `gsd/phase-{phase}-{slug}` | Branch name for phase strategy |
|
||||
| `git.milestone_branch_template` | Template string | `gsd/{milestone}-{slug}` | Branch name for milestone strategy |
|
||||
| `git.quick_branch_template` | Template string or `null` | `null` | Optional branch name for `/gsd:quick` tasks |
|
||||
| `git.quick_branch_template` | Template string or `null` | `null` | Optional branch name for `/gsd-quick` tasks |
|
||||
|
||||
**Branching strategies explained:**
|
||||
|
||||
@@ -600,60 +600,60 @@ Example quick-task branching:
|
||||
|
||||
```bash
|
||||
claude --dangerously-skip-permissions
|
||||
/gsd:new-project # Answer questions, configure, approve roadmap
|
||||
/gsd-new-project # Answer questions, configure, approve roadmap
|
||||
/clear
|
||||
/gsd:discuss-phase 1 # Lock in your preferences
|
||||
/gsd:ui-phase 1 # Design contract (frontend phases)
|
||||
/gsd:plan-phase 1 # Research + plan + verify
|
||||
/gsd:execute-phase 1 # Parallel execution
|
||||
/gsd:verify-work 1 # Manual UAT
|
||||
/gsd:ship 1 # Create PR from verified work
|
||||
/gsd:ui-review 1 # Visual audit (frontend phases)
|
||||
/gsd-discuss-phase 1 # Lock in your preferences
|
||||
/gsd-ui-phase 1 # Design contract (frontend phases)
|
||||
/gsd-plan-phase 1 # Research + plan + verify
|
||||
/gsd-execute-phase 1 # Parallel execution
|
||||
/gsd-verify-work 1 # Manual UAT
|
||||
/gsd-ship 1 # Create PR from verified work
|
||||
/gsd-ui-review 1 # Visual audit (frontend phases)
|
||||
/clear
|
||||
/gsd:next # Auto-detect and run next step
|
||||
/gsd-next # Auto-detect and run next step
|
||||
...
|
||||
/gsd:audit-milestone # Check everything shipped
|
||||
/gsd:complete-milestone # Archive, tag, done
|
||||
/gsd:session-report # Generate session summary
|
||||
/gsd-audit-milestone # Check everything shipped
|
||||
/gsd-complete-milestone # Archive, tag, done
|
||||
/gsd-session-report # Generate session summary
|
||||
```
|
||||
|
||||
### New Project from Existing Document
|
||||
|
||||
```bash
|
||||
/gsd:new-project --auto @prd.md # Auto-runs research/requirements/roadmap from your doc
|
||||
/gsd-new-project --auto @prd.md # Auto-runs research/requirements/roadmap from your doc
|
||||
/clear
|
||||
/gsd:discuss-phase 1 # Normal flow from here
|
||||
/gsd-discuss-phase 1 # Normal flow from here
|
||||
```
|
||||
|
||||
### Existing Codebase
|
||||
|
||||
```bash
|
||||
/gsd:map-codebase # Analyze what exists (parallel agents)
|
||||
/gsd:new-project # Questions focus on what you're ADDING
|
||||
/gsd-map-codebase # Analyze what exists (parallel agents)
|
||||
/gsd-new-project # Questions focus on what you're ADDING
|
||||
# (normal phase workflow from here)
|
||||
```
|
||||
|
||||
### Quick Bug Fix
|
||||
|
||||
```bash
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> "Fix the login button not responding on mobile Safari"
|
||||
```
|
||||
|
||||
### Resuming After a Break
|
||||
|
||||
```bash
|
||||
/gsd:progress # See where you left off and what's next
|
||||
/gsd-progress # See where you left off and what's next
|
||||
# or
|
||||
/gsd:resume-work # Full context restoration from last session
|
||||
/gsd-resume-work # Full context restoration from last session
|
||||
```
|
||||
|
||||
### Preparing for Release
|
||||
|
||||
```bash
|
||||
/gsd:audit-milestone # Check requirements coverage, detect stubs
|
||||
/gsd:plan-milestone-gaps # If audit found gaps, create phases to close them
|
||||
/gsd:complete-milestone # Archive, tag, done
|
||||
/gsd-audit-milestone # Check requirements coverage, detect stubs
|
||||
/gsd-plan-milestone-gaps # If audit found gaps, create phases to close them
|
||||
/gsd-complete-milestone # Archive, tag, done
|
||||
```
|
||||
|
||||
### Speed vs Quality Presets
|
||||
@@ -664,16 +664,16 @@ claude --dangerously-skip-permissions
|
||||
| Normal dev | `interactive` | `standard` | `balanced` | on | on | on |
|
||||
| Production | `interactive` | `fine` | `quality` | on | on | on |
|
||||
|
||||
**Skipping discuss-phase in autonomous mode:** When running in `yolo` mode with well-established preferences already captured in PROJECT.md, set `workflow.skip_discuss: true` via `/gsd:settings`. This bypasses the discuss-phase entirely and writes a minimal CONTEXT.md derived from the ROADMAP phase goal. Useful when your PROJECT.md and conventions are comprehensive enough that discussion adds no new information.
|
||||
**Skipping discuss-phase in autonomous mode:** When running in `yolo` mode with well-established preferences already captured in PROJECT.md, set `workflow.skip_discuss: true` via `/gsd-settings`. This bypasses the discuss-phase entirely and writes a minimal CONTEXT.md derived from the ROADMAP phase goal. Useful when your PROJECT.md and conventions are comprehensive enough that discussion adds no new information.
|
||||
|
||||
### Mid-Milestone Scope Changes
|
||||
|
||||
```bash
|
||||
/gsd:add-phase # Append a new phase to the roadmap
|
||||
/gsd-add-phase # Append a new phase to the roadmap
|
||||
# or
|
||||
/gsd:insert-phase 3 # Insert urgent work between phases 3 and 4
|
||||
/gsd-insert-phase 3 # Insert urgent work between phases 3 and 4
|
||||
# or
|
||||
/gsd:remove-phase 7 # Descope phase 7 and renumber
|
||||
/gsd-remove-phase 7 # Descope phase 7 and renumber
|
||||
```
|
||||
|
||||
### Multi-Project Workspaces
|
||||
@@ -682,18 +682,18 @@ Work on multiple repos or features in parallel with isolated GSD state.
|
||||
|
||||
```bash
|
||||
# Create a workspace with repos from your monorepo
|
||||
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
|
||||
# Feature branch isolation — worktree of current repo with its own .planning/
|
||||
/gsd:new-workspace --name feature-b --repos .
|
||||
/gsd-new-workspace --name feature-b --repos .
|
||||
|
||||
# Then cd into the workspace and initialize GSD
|
||||
cd ~/gsd-workspaces/feature-b
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
|
||||
# List and manage workspaces
|
||||
/gsd:list-workspaces
|
||||
/gsd:remove-workspace feature-b
|
||||
/gsd-list-workspaces
|
||||
/gsd-remove-workspace feature-b
|
||||
```
|
||||
|
||||
Each workspace gets:
|
||||
@@ -707,15 +707,15 @@ Each workspace gets:
|
||||
|
||||
### "Project already initialized"
|
||||
|
||||
You ran `/gsd:new-project` but `.planning/PROJECT.md` already exists. This is a safety check. If you want to start over, delete the `.planning/` directory first.
|
||||
You ran `/gsd-new-project` but `.planning/PROJECT.md` already exists. This is a safety check. If you want to start over, delete the `.planning/` directory first.
|
||||
|
||||
### Context Degradation During Long Sessions
|
||||
|
||||
Clear your context window between major commands: `/clear` in Claude Code. GSD is designed around fresh contexts -- every subagent gets a clean 200K window. If quality is dropping in the main session, clear and use `/gsd:resume-work` or `/gsd:progress` to restore state.
|
||||
Clear your context window between major commands: `/clear` in Claude Code. GSD is designed around fresh contexts -- every subagent gets a clean 200K window. If quality is dropping in the main session, clear and use `/gsd-resume-work` or `/gsd-progress` to restore state.
|
||||
|
||||
### Plans Seem Wrong or Misaligned
|
||||
|
||||
Run `/gsd:discuss-phase [N]` before planning. Most plan quality issues come from Claude making assumptions that `CONTEXT.md` would have prevented. You can also run `/gsd:list-phase-assumptions [N]` to see what Claude intends to do before committing to a plan.
|
||||
Run `/gsd-discuss-phase [N]` before planning. Most plan quality issues come from Claude making assumptions that `CONTEXT.md` would have prevented. You can also run `/gsd-list-phase-assumptions [N]` to see what Claude intends to do before committing to a plan.
|
||||
|
||||
### Execution Fails or Produces Stubs
|
||||
|
||||
@@ -723,15 +723,15 @@ Check that the plan was not too ambitious. Plans should have 2-3 tasks maximum.
|
||||
|
||||
### Lost Track of Where You Are
|
||||
|
||||
Run `/gsd:progress`. It reads all state files and tells you exactly where you are and what to do next.
|
||||
Run `/gsd-progress`. It reads all state files and tells you exactly where you are and what to do next.
|
||||
|
||||
### Need to Change Something After Execution
|
||||
|
||||
Do not re-run `/gsd:execute-phase`. Use `/gsd:quick` for targeted fixes, or `/gsd:verify-work` to systematically identify and fix issues through UAT.
|
||||
Do not re-run `/gsd-execute-phase`. Use `/gsd-quick` for targeted fixes, or `/gsd-verify-work` to systematically identify and fix issues through UAT.
|
||||
|
||||
### Model Costs Too High
|
||||
|
||||
Switch to budget profile: `/gsd:set-profile budget`. Disable research and plan-check agents via `/gsd:settings` if the domain is familiar to you (or to Claude).
|
||||
Switch to budget profile: `/gsd-set-profile budget`. Disable research and plan-check agents via `/gsd-settings` if the domain is familiar to you (or to Claude).
|
||||
|
||||
### Using Non-Claude Runtimes (Codex, OpenCode, Gemini CLI, Kilo)
|
||||
|
||||
@@ -756,19 +756,19 @@ See the [Configuration Reference](CONFIGURATION.md#non-claude-runtimes-codex-ope
|
||||
|
||||
### Using Claude Code with Non-Anthropic Providers (OpenRouter, Local)
|
||||
|
||||
If GSD subagents call Anthropic models and you're paying through OpenRouter or a local provider, switch to the `inherit` profile: `/gsd:set-profile inherit`. This makes all agents use your current session model instead of specific Anthropic models. See also `/gsd:settings` → Model Profile → Inherit.
|
||||
If GSD subagents call Anthropic models and you're paying through OpenRouter or a local provider, switch to the `inherit` profile: `/gsd-set-profile inherit`. This makes all agents use your current session model instead of specific Anthropic models. See also `/gsd-settings` → Model Profile → Inherit.
|
||||
|
||||
### Working on a Sensitive/Private Project
|
||||
|
||||
Set `commit_docs: false` during `/gsd:new-project` or via `/gsd:settings`. Add `.planning/` to your `.gitignore`. Planning artifacts stay local and never touch git.
|
||||
Set `commit_docs: false` during `/gsd-new-project` or via `/gsd-settings`. Add `.planning/` to your `.gitignore`. Planning artifacts stay local and never touch git.
|
||||
|
||||
### GSD Update Overwrote My Local Changes
|
||||
|
||||
Since v1.17, the installer backs up locally modified files to `gsd-local-patches/`. Run `/gsd:reapply-patches` to merge your changes back.
|
||||
Since v1.17, the installer backs up locally modified files to `gsd-local-patches/`. Run `/gsd-reapply-patches` to merge your changes back.
|
||||
|
||||
### Workflow Diagnostics (`/gsd:forensics`)
|
||||
### Workflow Diagnostics (`/gsd-forensics`)
|
||||
|
||||
When a workflow fails in a way that isn't obvious -- plans reference nonexistent files, execution produces unexpected results, or state seems corrupted -- run `/gsd:forensics` to generate a diagnostic report.
|
||||
When a workflow fails in a way that isn't obvious -- plans reference nonexistent files, execution produces unexpected results, or state seems corrupted -- run `/gsd-forensics` to generate a diagnostic report.
|
||||
|
||||
**What it checks:**
|
||||
- Git history anomalies (orphaned commits, unexpected branch state, rebase artifacts)
|
||||
@@ -790,7 +790,7 @@ If you see pre-commit hook failures, cargo lock contention, or 30+ minute execut
|
||||
All subagent/executor commits MUST use `--no-verify`.
|
||||
```
|
||||
|
||||
To disable parallel execution entirely: `/gsd:settings` → set `parallelization.enabled` to `false`.
|
||||
To disable parallel execution entirely: `/gsd-settings` → set `parallelization.enabled` to `false`.
|
||||
|
||||
### Windows: Installation Crashes on Protected Directories
|
||||
|
||||
@@ -802,18 +802,18 @@ If the installer crashes with `EPERM: operation not permitted, scandir` on Windo
|
||||
|
||||
| Problem | Solution |
|
||||
|---------|----------|
|
||||
| Lost context / new session | `/gsd:resume-work` or `/gsd:progress` |
|
||||
| Lost context / new session | `/gsd-resume-work` or `/gsd-progress` |
|
||||
| Phase went wrong | `git revert` the phase commits, then re-plan |
|
||||
| Need to change scope | `/gsd:add-phase`, `/gsd:insert-phase`, or `/gsd:remove-phase` |
|
||||
| Milestone audit found gaps | `/gsd:plan-milestone-gaps` |
|
||||
| Something broke | `/gsd:debug "description"` |
|
||||
| Workflow state seems corrupted | `/gsd:forensics` |
|
||||
| Quick targeted fix | `/gsd:quick` |
|
||||
| Plan doesn't match your vision | `/gsd:discuss-phase [N]` then re-plan |
|
||||
| Costs running high | `/gsd:set-profile budget` and `/gsd:settings` to toggle agents off |
|
||||
| Update broke local changes | `/gsd:reapply-patches` |
|
||||
| Want session summary for stakeholder | `/gsd:session-report` |
|
||||
| Don't know what step is next | `/gsd:next` |
|
||||
| Need to change scope | `/gsd-add-phase`, `/gsd-insert-phase`, or `/gsd-remove-phase` |
|
||||
| Milestone audit found gaps | `/gsd-plan-milestone-gaps` |
|
||||
| Something broke | `/gsd-debug "description"` |
|
||||
| Workflow state seems corrupted | `/gsd-forensics` |
|
||||
| Quick targeted fix | `/gsd-quick` |
|
||||
| Plan doesn't match your vision | `/gsd-discuss-phase [N]` then re-plan |
|
||||
| Costs running high | `/gsd-set-profile budget` and `/gsd-settings` to toggle agents off |
|
||||
| Update broke local changes | `/gsd-reapply-patches` |
|
||||
| Want session summary for stakeholder | `/gsd-session-report` |
|
||||
| Don't know what step is next | `/gsd-next` |
|
||||
| Parallel execution build errors | Update GSD or set `parallelization.enabled: false` |
|
||||
|
||||
---
|
||||
@@ -830,15 +830,15 @@ For reference, here is what GSD creates in your project:
|
||||
STATE.md # Decisions, blockers, session memory
|
||||
config.json # Workflow configuration
|
||||
MILESTONES.md # Completed milestone archive
|
||||
HANDOFF.json # Structured session handoff (from /gsd:pause-work)
|
||||
research/ # Domain research from /gsd:new-project
|
||||
reports/ # Session reports (from /gsd:session-report)
|
||||
HANDOFF.json # Structured session handoff (from /gsd-pause-work)
|
||||
research/ # Domain research from /gsd-new-project
|
||||
reports/ # Session reports (from /gsd-session-report)
|
||||
todos/
|
||||
pending/ # Captured ideas awaiting work
|
||||
done/ # Completed todos
|
||||
debug/ # Active debug sessions
|
||||
resolved/ # Archived debug sessions
|
||||
codebase/ # Brownfield codebase mapping (from /gsd:map-codebase)
|
||||
codebase/ # Brownfield codebase mapping (from /gsd-map-codebase)
|
||||
phases/
|
||||
XX-phase-name/
|
||||
XX-YY-PLAN.md # Atomic execution plans
|
||||
@@ -846,7 +846,7 @@ For reference, here is what GSD creates in your project:
|
||||
CONTEXT.md # Your implementation preferences
|
||||
RESEARCH.md # Ecosystem research findings
|
||||
VERIFICATION.md # Post-execution verification results
|
||||
XX-UI-SPEC.md # UI design contract (from /gsd:ui-phase)
|
||||
XX-UI-REVIEW.md # Visual audit scores (from /gsd:ui-review)
|
||||
ui-reviews/ # Screenshots from /gsd:ui-review (gitignored)
|
||||
XX-UI-SPEC.md # UI design contract (from /gsd-ui-phase)
|
||||
XX-UI-REVIEW.md # Visual audit scores (from /gsd-ui-review)
|
||||
ui-reviews/ # Screenshots from /gsd-ui-review (gitignored)
|
||||
```
|
||||
|
||||
@@ -19,7 +19,7 @@ The statusline shows context usage to the **user**, but the **agent** has no awa
|
||||
|-------|-----------|----------------|
|
||||
| Normal | > 35% | No warning |
|
||||
| WARNING | <= 35% | Wrap up current task, avoid starting new complex work |
|
||||
| CRITICAL | <= 25% | Stop immediately, save state (`/gsd:pause-work`) |
|
||||
| CRITICAL | <= 25% | Stop immediately, save state (`/gsd-pause-work`) |
|
||||
|
||||
## Debounce
|
||||
|
||||
@@ -56,7 +56,7 @@ The bridge file is a simple JSON object:
|
||||
|
||||
## Integration with GSD
|
||||
|
||||
GSD's `/gsd:pause-work` command saves execution state. The WARNING message suggests using it. The CRITICAL message instructs immediate state save.
|
||||
GSD's `/gsd-pause-work` command saves execution state. The WARNING message suggests using it. The CRITICAL message instructs immediate state save.
|
||||
|
||||
## Setup
|
||||
|
||||
|
||||
@@ -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の好み、ベンダー選択、フラストレーショントリガー、学習スタイル、説明の深度。
|
||||
|
||||
@@ -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/` |
|
||||
|
||||
### 抽象化ポイント
|
||||
|
||||
@@ -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
|
||||
```
|
||||
|
||||
@@ -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` を作成する際、グローバルデフォルトを読み込み、初期設定としてマージします。プロジェクトごとの設定は常にグローバル設定を上書きします。
|
||||
|
||||
@@ -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` の推奨を含める
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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 対象）
|
||||
```
|
||||
|
||||
@@ -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 メッセージは即座の状態保存を指示します。
|
||||
|
||||
## セットアップ
|
||||
|
||||
|
||||
@@ -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` が初めて設定に書き込む際にも、
|
||||
これらのキーは追加されない。設定ファイルは実効設定のごく一部しか反映しない。
|
||||
|
||||
**解決策:**
|
||||
|
||||
@@ -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. **完了** — ワークスペースのパスと次のステップを表示する
|
||||
|
||||
|
||||
@@ -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` (모든 executor 완료 후) |
|
||||
| **생성 주체** | `/gsd-execute-phase` (모든 executor 완료 후) |
|
||||
| **병렬성** | 단일 인스턴스 |
|
||||
| **도구** | 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 선호도, 벤더 선택, 불만 요인, 학습 스타일, 설명 깊이.
|
||||
|
||||
@@ -31,7 +31,7 @@ GSD는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCode, Ki
|
||||
```
|
||||
┌──────────────────────────────────────────────────────┐
|
||||
│ USER │
|
||||
│ /gsd:command [args] │
|
||||
│ /gsd-command [args] │
|
||||
└─────────────────────┬────────────────────────────────┘
|
||||
│
|
||||
┌─────────────────────▼────────────────────────────────┐
|
||||
@@ -107,10 +107,10 @@ GSD는 사용자와 AI 코딩 에이전트(Claude Code, Gemini CLI, OpenCode, Ki
|
||||
### Commands (`commands/gsd/*.md`)
|
||||
|
||||
사용자 대면 진입점입니다. 각 파일은 YAML 전문(name, description, allowed-tools)과 워크플로우를 부트스트랩하는 프롬프트 본문을 포함합니다. 명령어는 다음과 같이 설치됩니다.
|
||||
- **Claude Code:** 커스텀 슬래시 명령어 (`/gsd:command-name`)
|
||||
- **Claude Code:** 커스텀 슬래시 명령어 (`/gsd-command-name`)
|
||||
- **OpenCode / Kilo:** 슬래시 명령어 (`/gsd-command-name`)
|
||||
- **Codex:** Skills (`$gsd-command-name`)
|
||||
- **Copilot:** 슬래시 명령어 (`/gsd:command-name`)
|
||||
- **Copilot:** 슬래시 명령어 (`/gsd-command-name`)
|
||||
- **Antigravity:** Skills
|
||||
|
||||
**전체 명령어 수:** 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/ # 완료된 할 일
|
||||
├── 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의 스크린샷 (gitignored)
|
||||
├── ui-reviews/ # /gsd-ui-review의 스크린샷 (gitignored)
|
||||
└── continue-here.md # 컨텍스트 핸드오프 (pause-work에서)
|
||||
```
|
||||
|
||||
@@ -439,7 +439,7 @@ UI-SPEC.md (per phase) ───────────────────
|
||||
- Antigravity: Google 모델 등가물을 사용한 skills-first 방식
|
||||
5. **경로 정규화** — `~/.claude/` 경로를 런타임별 경로로 교체
|
||||
6. **설정 통합** — 런타임의 `settings.json`에 훅 등록
|
||||
7. **패치 백업** — v1.17부터 로컬 수정 파일을 `gsd-local-patches/`에 백업하여 `/gsd:reapply-patches`에 사용
|
||||
7. **패치 백업** — v1.17부터 로컬 수정 파일을 `gsd-local-patches/`에 백업하여 `/gsd-reapply-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는 통합된 명령어/워크플로우 아키텍처를 통해 여러 AI 코
|
||||
|
||||
| 런타임 | 명령어 형식 | 에이전트 시스템 | 설정 위치 |
|
||||
|---------|---------------|--------------|-----------------|
|
||||
| Claude Code | `/gsd:command` | Task 생성 | `~/.claude/` |
|
||||
| Claude Code | `/gsd-command` | Task 생성 | `~/.claude/` |
|
||||
| OpenCode | `/gsd-command` | Subagent 모드 | `~/.config/opencode/` |
|
||||
| Kilo | `/gsd-command` | Subagent 모드 | `~/.config/kilo/` |
|
||||
| Gemini CLI | `/gsd:command` | Task 생성 | `~/.gemini/` |
|
||||
| Gemini CLI | `/gsd-command` | Task 생성 | `~/.gemini/` |
|
||||
| Codex | `$gsd-command` | Skills | `~/.codex/` |
|
||||
| Copilot | `/gsd:command` | 에이전트 위임 | `~/.github/` |
|
||||
| Copilot | `/gsd-command` | 에이전트 위임 | `~/.github/` |
|
||||
| Antigravity | Skills | Skills | `~/.gemini/antigravity/` |
|
||||
|
||||
### 추상화 포인트
|
||||
|
||||
@@ -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 # Wave 2만 실행
|
||||
/gsd-execute-phase 1 # 페이즈 1 실행
|
||||
/gsd-execute-phase 1 --wave 2 # Wave 2만 실행
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### `/gsd:verify-work`
|
||||
### `/gsd-verify-work`
|
||||
|
||||
자동 진단을 포함한 사용자 인수 테스트(UAT)를 수행합니다.
|
||||
|
||||
@@ -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 @@ Nyquist 검증 갭을 소급하여 감사하고 보완합니다.
|
||||
| `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`
|
||||
|
||||
하나의 터미널에서 여러 페이즈를 관리하는 대화형 명령 센터입니다.
|
||||
|
||||
@@ -482,24 +482,24 @@ Nyquist 검증 갭을 소급하여 감사하고 보완합니다.
|
||||
- 하나의 터미널에서 여러 페이즈를 병렬로 처리하는 파워 유저를 위해 설계되었습니다
|
||||
|
||||
```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`
|
||||
|
||||
마찰 없는 아이디어 캡처 — 노트 추가, 목록 조회, 또는 노트를 할 일로 승격합니다.
|
||||
|
||||
@@ -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` | 아니오 | 할 일 설명 |
|
||||
|
||||
```bash
|
||||
/gsd:add-todo "Consider adding dark mode support"
|
||||
/gsd-add-todo "Consider adding dark mode support"
|
||||
```
|
||||
|
||||
### `/gsd:check-todos`
|
||||
### `/gsd-check-todos`
|
||||
|
||||
보류 중인 할 일 목록을 표시하고 작업할 항목을 선택합니다.
|
||||
|
||||
```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 # 예산 프로필로 전환
|
||||
/gsd:set-profile quality # 품질 프로필로 전환
|
||||
/gsd-set-profile budget # 예산 프로필로 전환
|
||||
/gsd-set-profile quality # 품질 프로필로 전환
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 브라운필드 명령어
|
||||
|
||||
### `/gsd:map-codebase`
|
||||
### `/gsd-map-codebase`
|
||||
|
||||
병렬 매퍼 에이전트를 사용하여 기존 코드베이스를 분석합니다.
|
||||
|
||||
@@ -751,35 +751,35 @@ Claude Code 세션 분석을 통해 8개 차원(커뮤니케이션 스타일,
|
||||
| `area` | 아니오 | 특정 영역으로 매핑 범위를 제한합니다 |
|
||||
|
||||
```bash
|
||||
/gsd:map-codebase # 전체 코드베이스 분석
|
||||
/gsd:map-codebase auth # 인증 영역에 집중
|
||||
/gsd-map-codebase # 전체 코드베이스 분석
|
||||
/gsd-map-codebase 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
|
||||
```
|
||||
|
||||
@@ -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`에 저장합니다. `/gsd:
|
||||
| `workflow.auto_advance` | boolean | `false` | discuss → plan → execute를 중단 없이 자동으로 연결 |
|
||||
| `workflow.nyquist_validation` | boolean | `true` | plan 단계 리서치 중 테스트 커버리지 매핑 |
|
||||
| `workflow.ui_phase` | boolean | `true` | 프론트엔드 단계를 위한 UI 디자인 계약서 생성 |
|
||||
| `workflow.ui_safety_gate` | boolean | `true` | plan 단계에서 프론트엔드 단계에 대해 /gsd:ui-phase 실행 여부 확인 |
|
||||
| `workflow.ui_safety_gate` | boolean | `true` | plan 단계에서 프론트엔드 단계에 대해 /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'` (기본값)는 질문을 하나씩 합니다. `'assumptions'`는 코드베이스를 먼저 읽고 신뢰도 수준이 있는 구조화된 가정을 생성하여 틀린 부분만 수정하도록 요청합니다. v1.28에서 추가 |
|
||||
| `workflow.skip_discuss` | boolean | `false` | `true`로 설정하면 `/gsd:autonomous`가 discuss 단계를 완전히 건너뛰고 ROADMAP 단계 목표로부터 최소한의 CONTEXT.md를 작성합니다. 개발자 선호사항이 PROJECT.md/REQUIREMENTS.md에 모두 캡처된 프로젝트에 유용합니다. v1.28에서 추가 |
|
||||
| `workflow.discuss_mode` | string | `'discuss'` | `/gsd-discuss-phase`의 컨텍스트 수집 방식을 제어합니다. `'discuss'` (기본값)는 질문을 하나씩 합니다. `'assumptions'`는 코드베이스를 먼저 읽고 신뢰도 수준이 있는 구조화된 가정을 생성하여 틀린 부분만 수정하도록 요청합니다. v1.28에서 추가 |
|
||||
| `workflow.skip_discuss` | boolean | `false` | `true`로 설정하면 `/gsd-autonomous`가 discuss 단계를 완전히 건너뛰고 ROADMAP 단계 목표로부터 최소한의 CONTEXT.md를 작성합니다. 개발자 선호사항이 PROJECT.md/REQUIREMENTS.md에 모두 캡처된 프로젝트에 유용합니다. v1.28에서 추가 |
|
||||
| `workflow.text_mode` | boolean | `false` | AskUserQuestion TUI 메뉴를 일반 텍스트 번호 목록으로 대체합니다. TUI 메뉴가 렌더링되지 않는 Claude Code 원격 세션 (`/rc` 모드)에 필요합니다. discuss 단계에서 `--text` 플래그로 세션별 설정도 가능합니다. v1.28에서 추가 |
|
||||
|
||||
### 권장 프리셋
|
||||
@@ -132,7 +132,7 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
|
||||
| 설정 | 타입 | 기본값 | 설명 |
|
||||
|------|------|--------|------|
|
||||
| `hooks.context_warnings` | boolean | `true` | context monitor 훅을 통해 컨텍스트 윈도우 사용 경고 표시 |
|
||||
| `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`에 저장합니다. `/gsd:
|
||||
| `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 또는 null | `null` | `/gsd:quick` 태스크를 위한 선택적 브랜치 이름 템플릿 |
|
||||
| `git.quick_branch_template` | string 또는 null | `null` | `/gsd-quick` 태스크를 위한 선택적 브랜치 이름 템플릿 |
|
||||
|
||||
### 전략 비교
|
||||
|
||||
@@ -339,4 +339,4 @@ quick 태스크 브랜칭 예시:
|
||||
|
||||
**위치:** `~/.gsd/defaults.json`
|
||||
|
||||
`/gsd:new-project`가 새 `config.json`을 생성할 때 전역 기본값을 읽어 초기 설정으로 병합합니다. 프로젝트별 설정은 항상 전역 설정보다 우선합니다.
|
||||
`/gsd-new-project`가 새 `config.json`을 생성할 때 전역 기본값을 읽어 초기 설정으로 병합합니다. 프로젝트별 설정은 항상 전역 설정보다 우선합니다.
|
||||
|
||||
@@ -77,7 +77,7 @@
|
||||
|
||||
### 1. Project Initialization
|
||||
|
||||
**명령어:** `/gsd:new-project [--auto @file.md]`
|
||||
**명령어:** `/gsd-new-project [--auto @file.md]`
|
||||
|
||||
**목적:** 사용자의 아이디어를 연구, 범위가 지정된 요구사항, 단계별 로드맵을 갖춘 완전히 구조화된 프로젝트로 전환합니다.
|
||||
|
||||
@@ -116,13 +116,13 @@
|
||||
- 연구 에이전트는 현재 생태계 정보를 위한 웹 검색 기능을 갖추고 있습니다.
|
||||
- 세분화 설정으로 페이즈 수를 제어합니다. `coarse`(3-5), `standard`(5-8), `fine`(8-12)
|
||||
- `--auto` 모드는 대화형 질문 없이 제공된 문서에서 모든 정보를 추출합니다.
|
||||
- 기존 코드베이스 컨텍스트(`/gsd:map-codebase`에서)가 있으면 로드됩니다.
|
||||
- 기존 코드베이스 컨텍스트(`/gsd-map-codebase`에서)가 있으면 로드됩니다.
|
||||
|
||||
---
|
||||
|
||||
### 2. Phase Discussion
|
||||
|
||||
**명령어:** `/gsd:discuss-phase [N] [--auto] [--batch]`
|
||||
**명령어:** `/gsd-discuss-phase [N] [--auto] [--batch]`
|
||||
|
||||
**목적:** 연구와 계획이 시작되기 전에 사용자의 구현 선호도와 결정을 캡처합니다. AI가 추측하게 만드는 회색 지대를 제거합니다.
|
||||
|
||||
@@ -149,7 +149,7 @@
|
||||
|
||||
### 3. UI Design Contract
|
||||
|
||||
**명령어:** `/gsd:ui-phase [N]`
|
||||
**명령어:** `/gsd-ui-phase [N]`
|
||||
|
||||
**목적:** 계획 전에 설계 결정을 확정하여 페이즈 내 모든 컴포넌트가 일관된 시각적 기준을 공유하도록 합니다.
|
||||
|
||||
@@ -181,7 +181,7 @@
|
||||
|
||||
### 4. Phase Planning
|
||||
|
||||
**명령어:** `/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: 계획이 완료되기 전에 모든 페이즈 요구사항이 최소 하나의 계획에 포함되어 있는지 확인해야 합니다(요구사항 커버리지 게이트).
|
||||
|
||||
@@ -231,7 +231,7 @@
|
||||
|
||||
### 5. Phase Execution
|
||||
|
||||
**명령어:** `/gsd:execute-phase <N>`
|
||||
**명령어:** `/gsd-execute-phase <N>`
|
||||
|
||||
**목적:** 실행자별 새로운 컨텍스트 창을 사용한 웨이브 기반 병렬화로 페이즈의 모든 계획을 실행합니다.
|
||||
|
||||
@@ -275,7 +275,7 @@
|
||||
|
||||
### 6. Work Verification
|
||||
|
||||
**명령어:** `/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 Review
|
||||
|
||||
**명령어:** `/gsd:ui-review [N]`
|
||||
**명령어:** `/gsd-ui-review [N]`
|
||||
|
||||
**목적:** 구현된 프론트엔드 코드의 소급 6기둥 시각적 감사. 모든 프로젝트에서 독립적으로 작동합니다.
|
||||
|
||||
@@ -337,7 +337,7 @@
|
||||
|
||||
### 8. Milestone Management
|
||||
|
||||
**명령어:** `/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. Phase Management
|
||||
|
||||
**명령어:** `/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 Mode
|
||||
|
||||
**명령어:** `/gsd:quick [--full] [--discuss] [--research]`
|
||||
**명령어:** `/gsd-quick [--full] [--discuss] [--research]`
|
||||
|
||||
**목적:** GSD 보증을 제공하지만 더 빠른 경로로 임시 작업을 실행합니다.
|
||||
|
||||
@@ -394,7 +394,7 @@
|
||||
|
||||
### 11. Autonomous Mode
|
||||
|
||||
**명령어:** `/gsd:autonomous [--from N]`
|
||||
**명령어:** `/gsd-autonomous [--from N]`
|
||||
|
||||
**목적:** 나머지 모든 페이즈를 자율적으로 실행합니다 — 페이즈별로 논의 → 계획 → 실행.
|
||||
|
||||
@@ -409,7 +409,7 @@
|
||||
|
||||
### 12. Freeform Routing
|
||||
|
||||
**명령어:** `/gsd:do`
|
||||
**명령어:** `/gsd-do`
|
||||
|
||||
**목적:** 자유형 텍스트를 분석하고 적절한 GSD 명령어로 라우팅합니다.
|
||||
|
||||
@@ -423,7 +423,7 @@
|
||||
|
||||
### 13. Note Capture
|
||||
|
||||
**명령어:** `/gsd:note`
|
||||
**명령어:** `/gsd-note`
|
||||
|
||||
**목적:** 워크플로우를 방해하지 않고 아이디어를 즉시 캡처합니다. 타임스탬프가 있는 노트를 추가하거나, 모든 노트를 나열하거나, 노트를 구조화된 할 일로 승격합니다.
|
||||
|
||||
@@ -438,7 +438,7 @@
|
||||
|
||||
### 14. Auto-Advance (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. Health Validation
|
||||
|
||||
**명령어:** `/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. Session Management
|
||||
|
||||
**명령어:** `/gsd:pause-work`, `/gsd:resume-work`, `/gsd:progress`
|
||||
**명령어:** `/gsd-pause-work`, `/gsd-resume-work`, `/gsd-progress`
|
||||
|
||||
**목적:** 컨텍스트 초기화와 세션 간에 프로젝트 연속성을 유지합니다.
|
||||
|
||||
@@ -608,7 +608,7 @@
|
||||
|
||||
### 24. Session Reporting
|
||||
|
||||
**명령어:** `/gsd:session-report`
|
||||
**명령어:** `/gsd-session-report`
|
||||
|
||||
**목적:** 수행된 작업, 달성된 결과, 예상 리소스 사용량을 캡처하는 구조화된 세션 후 요약 문서를 생성합니다.
|
||||
|
||||
@@ -647,7 +647,7 @@
|
||||
|
||||
### 26. Model Profiles
|
||||
|
||||
**명령어:** `/gsd:set-profile <quality|balanced|budget|inherit>`
|
||||
**명령어:** `/gsd-set-profile <quality|balanced|budget|inherit>`
|
||||
|
||||
**목적:** 각 에이전트가 사용하는 AI 모델을 제어하여 품질과 비용의 균형을 맞춥니다.
|
||||
|
||||
@@ -683,7 +683,7 @@
|
||||
|
||||
### 27. Codebase Mapping
|
||||
|
||||
**명령어:** `/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. Debug System
|
||||
|
||||
**명령어:** `/gsd:debug [description]`
|
||||
**명령어:** `/gsd-debug [description]`
|
||||
|
||||
**목적:** 컨텍스트 초기화 전반에 걸쳐 영구적인 상태로 체계적인 디버깅을 수행합니다.
|
||||
|
||||
@@ -729,7 +729,7 @@
|
||||
|
||||
### 29. Todo Management
|
||||
|
||||
**명령어:** `/gsd:add-todo [desc]`, `/gsd:check-todos`
|
||||
**명령어:** `/gsd-add-todo [desc]`, `/gsd-check-todos`
|
||||
|
||||
**목적:** 세션 중 나중에 처리할 아이디어와 작업을 캡처합니다.
|
||||
|
||||
@@ -743,7 +743,7 @@
|
||||
|
||||
### 30. Statistics Dashboard
|
||||
|
||||
**명령어:** `/gsd:stats`
|
||||
**명령어:** `/gsd-stats`
|
||||
|
||||
**목적:** 프로젝트 지표를 표시합니다 — 페이즈, 계획, 요구사항, git 히스토리, 타임라인.
|
||||
|
||||
@@ -757,7 +757,7 @@
|
||||
|
||||
### 31. Update System
|
||||
|
||||
**명령어:** `/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. Settings Management
|
||||
|
||||
**명령어:** `/gsd:settings`
|
||||
**명령어:** `/gsd-settings`
|
||||
|
||||
**목적:** 워크플로우 토글과 모델 프로파일의 대화형 구성.
|
||||
|
||||
@@ -805,7 +805,7 @@
|
||||
|
||||
### 33. Test Generation
|
||||
|
||||
**명령어:** `/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. Developer Profiling
|
||||
|
||||
**명령어:** `/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. Verification Debt Tracking
|
||||
|
||||
**명령어:** `/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 Mode
|
||||
|
||||
**명령어:** `/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. Cross-AI Peer Review
|
||||
|
||||
**명령어:** `/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. Backlog Parking Lot
|
||||
|
||||
**명령어:** `/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: 시드는 표시 조건에 대한 전체 이유와 시기를 캡처해야 합니다.
|
||||
- REQ-SEED-02: `/gsd:new-milestone`은 시드를 스캔하고 일치하는 항목을 표시해야 합니다.
|
||||
- REQ-SEED-02: `/gsd-new-milestone`은 시드를 스캔하고 일치하는 항목을 표시해야 합니다.
|
||||
|
||||
**생성 산출물.**
|
||||
| 산출물 | 설명 |
|
||||
@@ -1054,9 +1054,9 @@ fix(03-01): correct auth token expiry
|
||||
|
||||
### 44. Persistent Context Threads
|
||||
|
||||
**명령어:** `/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 Branch Filtering
|
||||
|
||||
**명령어:** `/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. Discussion Audit Trail
|
||||
|
||||
**목적:** `/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. Forensics
|
||||
|
||||
**명령어:** `/gsd:forensics [description]`
|
||||
**명령어:** `/gsd-forensics [description]`
|
||||
|
||||
**목적:** 실패하거나 막힌 GSD 워크플로우의 사후 조사.
|
||||
|
||||
@@ -1165,7 +1165,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
|
||||
|
||||
### 50. Milestone Summary
|
||||
|
||||
**명령어:** `/gsd:milestone-summary [version]`
|
||||
**명령어:** `/gsd-milestone-summary [version]`
|
||||
|
||||
**목적:** 팀 온보딩을 위해 마일스톤 산출물에서 포괄적인 프로젝트 요약을 생성합니다.
|
||||
|
||||
@@ -1188,7 +1188,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
|
||||
|
||||
### 51. Workstream Namespacing
|
||||
|
||||
**명령어:** `/gsd:workstreams`
|
||||
**명령어:** `/gsd-workstreams`
|
||||
|
||||
**목적:** 마일스톤의 다른 영역에서 동시 작업을 위한 병렬 워크스트림.
|
||||
|
||||
@@ -1211,7 +1211,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
|
||||
|
||||
### 52. Manager Dashboard
|
||||
|
||||
**명령어:** `/gsd:manager`
|
||||
**명령어:** `/gsd-manager`
|
||||
|
||||
**목적:** 하나의 터미널에서 여러 페이즈를 관리하는 대화형 명령 센터.
|
||||
|
||||
@@ -1231,7 +1231,7 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
|
||||
|
||||
### 53. Assumptions Discussion Mode
|
||||
|
||||
**명령어:** `/gsd:discuss-phase` with `workflow.discuss_mode: 'assumptions'`
|
||||
**명령어:** `/gsd-discuss-phase` with `workflow.discuss_mode: 'assumptions'`
|
||||
|
||||
**목적:** 인터뷰 스타일 질문을 코드베이스 우선 가정 분석으로 대체합니다.
|
||||
|
||||
@@ -1257,20 +1257,20 @@ Claude가 GSD 워크플로우 컨텍스트 밖에서 파일 편집을 시도하
|
||||
|
||||
### 54. UI Phase Auto-Detection
|
||||
|
||||
**일부:** `/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` 권장사항 포함
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ Get Shit Done (GSD) 프레임워크의 종합 문서입니다. GSD는 AI 코딩
|
||||
## 빠른 링크
|
||||
|
||||
- **v1.28의 새로운 기능:** Forensics, milestone 요약, workstream, assumptions 모드, UI 자동 감지, manager 대시보드
|
||||
- **시작하기:** [README](../README.md) → 설치 → `/gsd:new-project`
|
||||
- **시작하기:** [README](../README.md) → 설치 → `/gsd-new-project`
|
||||
- **전체 워크플로우 안내:** [User Guide](USER-GUIDE.md)
|
||||
- **모든 명령어 한눈에 보기:** [Command Reference](COMMANDS.md)
|
||||
- **GSD 설정하기:** [Configuration Reference](CONFIGURATION.md)
|
||||
|
||||
@@ -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 능력이 부족해서가 아닙니다. 실행 전에 설계 계약이 존재하지 않았기 때문입니다. 공유 간격 척도, 색상 계약, 또는 카피라이팅 기준 없이 구축된 다섯 개의 컴포넌트는 다섯 가지 약간씩 다른 시각적 결정을 만들어냅니다.
|
||||
|
||||
`/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 생성 프론트엔드가 시각적으로 일관성이 없는 이유는 Claud
|
||||
|
||||
**출력:** `.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 생성 프론트엔드가 시각적으로 일관성이 없는 이유는 Claud
|
||||
| 설정 | 기본값 | 설명 |
|
||||
|------|--------|------|
|
||||
| `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 프로젝트에서 `components.json`이 없으면 UI 조사
|
||||
|
||||
### 스크린샷 저장
|
||||
|
||||
`/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 프로젝트에서 `components.json`이 없으면 UI 조사
|
||||
활성 계획에 아직 준비되지 않은 아이디어는 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 프로젝트에서 `components.json`이 없으면 UI 조사
|
||||
스레드는 여러 세션에 걸쳐 이어지지만 특정 페이즈에 속하지 않는 작업을 위한 경량 교차 세션 지식 저장소입니다.
|
||||
|
||||
```
|
||||
/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`보다 가볍습니다. 페이즈 상태나 계획 컨텍스트가 없습니다. 각 스레드 파일에는 목표, 컨텍스트, 참조, 다음 단계 섹션이 포함됩니다.
|
||||
스레드는 `/gsd-pause-work`보다 가볍습니다. 페이즈 상태나 계획 컨텍스트가 없습니다. 각 스레드 파일에는 목표, 컨텍스트, 참조, 다음 단계 섹션이 포함됩니다.
|
||||
|
||||
스레드가 성숙해지면 페이즈(`/gsd:add-phase`)나 백로그 항목(`/gsd:add-backlog`)으로 승격할 수 있습니다.
|
||||
스레드가 성숙해지면 페이즈(`/gsd-add-phase`)나 백로그 항목(`/gsd-add-backlog`)으로 승격할 수 있습니다.
|
||||
|
||||
**저장 위치:** `.planning/threads/{slug}.md`
|
||||
|
||||
@@ -304,16 +304,16 @@ React/Next.js/Vite 프로젝트에서 `components.json`이 없으면 UI 조사
|
||||
|
||||
| 명령어 | 목적 |
|
||||
|--------|------|
|
||||
| `/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`(별도 저장소 worktree를 생성)보다 가볍습니다. 워크스트림은 동일한 코드베이스와 git 히스토리를 공유하지만 계획 아티팩트를 격리합니다.
|
||||
이는 `/gsd-new-workspace`(별도 저장소 worktree를 생성)보다 가볍습니다. 워크스트림은 동일한 코드베이스와 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` | 보류 중인 할 일 목록 | 캡처된 아이디어 검토 시 |
|
||||
| `/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` | 보류 중인 할 일 목록 | 캡처된 아이디어 검토 시 |
|
||||
| `/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`에 저장합니다. `/gsd:
|
||||
| `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`에 저장합니다. `/gsd:
|
||||
| `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 @@ GSD는 프로젝트 설정을 `.planning/config.json`에 저장합니다. `/gsd:
|
||||
|
||||
```bash
|
||||
claude --dangerously-skip-permissions
|
||||
/gsd:new-project # Answer questions, configure, approve roadmap
|
||||
/gsd-new-project # Answer questions, configure, approve roadmap
|
||||
/clear
|
||||
/gsd:discuss-phase 1 # Lock in your preferences
|
||||
/gsd:ui-phase 1 # Design contract (frontend phases)
|
||||
/gsd:plan-phase 1 # Research + plan + verify
|
||||
/gsd:execute-phase 1 # Parallel execution
|
||||
/gsd:verify-work 1 # Manual UAT
|
||||
/gsd:ship 1 # Create PR from verified work
|
||||
/gsd:ui-review 1 # Visual audit (frontend phases)
|
||||
/gsd-discuss-phase 1 # Lock in your preferences
|
||||
/gsd-ui-phase 1 # Design contract (frontend phases)
|
||||
/gsd-plan-phase 1 # Research + plan + verify
|
||||
/gsd-execute-phase 1 # Parallel execution
|
||||
/gsd-verify-work 1 # Manual UAT
|
||||
/gsd-ship 1 # Create PR from verified work
|
||||
/gsd-ui-review 1 # Visual audit (frontend phases)
|
||||
/clear
|
||||
/gsd:next # Auto-detect and run next step
|
||||
/gsd-next # Auto-detect and run next step
|
||||
...
|
||||
/gsd:audit-milestone # Check everything shipped
|
||||
/gsd:complete-milestone # Archive, tag, done
|
||||
/gsd:session-report # Generate session summary
|
||||
/gsd-audit-milestone # Check everything shipped
|
||||
/gsd-complete-milestone # Archive, tag, done
|
||||
/gsd-session-report # Generate session summary
|
||||
```
|
||||
|
||||
### 기존 문서로 새 프로젝트 시작
|
||||
|
||||
```bash
|
||||
/gsd:new-project --auto @prd.md # Auto-runs research/requirements/roadmap from your doc
|
||||
/gsd-new-project --auto @prd.md # Auto-runs research/requirements/roadmap from your doc
|
||||
/clear
|
||||
/gsd:discuss-phase 1 # Normal flow from here
|
||||
/gsd-discuss-phase 1 # Normal flow from here
|
||||
```
|
||||
|
||||
### 기존 코드베이스
|
||||
|
||||
```bash
|
||||
/gsd:map-codebase # Analyze what exists (parallel agents)
|
||||
/gsd:new-project # Questions focus on what you're ADDING
|
||||
/gsd-map-codebase # Analyze what exists (parallel agents)
|
||||
/gsd-new-project # Questions focus on what you're ADDING
|
||||
# (normal phase workflow from here)
|
||||
```
|
||||
|
||||
### 빠른 버그 수정
|
||||
|
||||
```bash
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> "Fix the login button not responding on mobile Safari"
|
||||
```
|
||||
|
||||
### 휴식 후 재개
|
||||
|
||||
```bash
|
||||
/gsd:progress # See where you left off and what's next
|
||||
/gsd-progress # See where you left off and what's next
|
||||
# or
|
||||
/gsd:resume-work # Full context restoration from last session
|
||||
/gsd-resume-work # Full context restoration from last session
|
||||
```
|
||||
|
||||
### 릴리스 준비
|
||||
|
||||
```bash
|
||||
/gsd:audit-milestone # Check requirements coverage, detect stubs
|
||||
/gsd:plan-milestone-gaps # If audit found gaps, create phases to close them
|
||||
/gsd:complete-milestone # Archive, tag, done
|
||||
/gsd-audit-milestone # Check requirements coverage, detect stubs
|
||||
/gsd-plan-milestone-gaps # If audit found gaps, create phases to close them
|
||||
/gsd-complete-milestone # Archive, tag, done
|
||||
```
|
||||
|
||||
### 속도 vs 품질 프리셋
|
||||
@@ -654,16 +654,16 @@ claude --dangerously-skip-permissions
|
||||
| 일반 개발 | `interactive` | `standard` | `balanced` | 켜기 | 켜기 | 켜기 |
|
||||
| 프로덕션 | `interactive` | `fine` | `quality` | 켜기 | 켜기 | 켜기 |
|
||||
|
||||
**자율 모드에서 discuss-phase 건너뛰기:** PROJECT.md에 선호도가 이미 충분히 캡처된 `yolo` 모드에서 실행할 때 `/gsd:settings`에서 `workflow.skip_discuss: true`로 설정하세요. 이렇게 하면 discuss-phase를 완전히 우회하고 ROADMAP 페이즈 목표에서 파생된 최소한의 CONTEXT.md를 작성합니다. PROJECT.md와 관례가 충분히 포괄적이어서 토론이 새로운 정보를 제공하지 않을 때 유용합니다.
|
||||
**자율 모드에서 discuss-phase 건너뛰기:** PROJECT.md에 선호도가 이미 충분히 캡처된 `yolo` 모드에서 실행할 때 `/gsd-settings`에서 `workflow.skip_discuss: true`로 설정하세요. 이렇게 하면 discuss-phase를 완전히 우회하고 ROADMAP 페이즈 목표에서 파생된 최소한의 CONTEXT.md를 작성합니다. PROJECT.md와 관례가 충분히 포괄적이어서 토론이 새로운 정보를 제공하지 않을 때 유용합니다.
|
||||
|
||||
### 마일스톤 중간 범위 변경
|
||||
|
||||
```bash
|
||||
/gsd:add-phase # Append a new phase to the roadmap
|
||||
/gsd-add-phase # Append a new phase to the roadmap
|
||||
# or
|
||||
/gsd:insert-phase 3 # Insert urgent work between phases 3 and 4
|
||||
/gsd-insert-phase 3 # Insert urgent work between phases 3 and 4
|
||||
# or
|
||||
/gsd:remove-phase 7 # Descope phase 7 and renumber
|
||||
/gsd-remove-phase 7 # Descope phase 7 and renumber
|
||||
```
|
||||
|
||||
### 멀티 프로젝트 워크스페이스
|
||||
@@ -672,18 +672,18 @@ claude --dangerously-skip-permissions
|
||||
|
||||
```bash
|
||||
# Create a workspace with repos from your monorepo
|
||||
/gsd:new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI
|
||||
|
||||
# Feature branch isolation — worktree of current repo with its own .planning/
|
||||
/gsd:new-workspace --name feature-b --repos .
|
||||
/gsd-new-workspace --name feature-b --repos .
|
||||
|
||||
# Then cd into the workspace and initialize GSD
|
||||
cd ~/gsd-workspaces/feature-b
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
|
||||
# List and manage workspaces
|
||||
/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"
|
||||
|
||||
`.planning/PROJECT.md`가 이미 존재하는데 `/gsd:new-project`를 실행했습니다. 이것은 안전 검사입니다. 처음부터 다시 시작하려면 먼저 `.planning/` 디렉터리를 삭제하세요.
|
||||
`.planning/PROJECT.md`가 이미 존재하는데 `/gsd-new-project`를 실행했습니다. 이것은 안전 검사입니다. 처음부터 다시 시작하려면 먼저 `.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`을 사용하거나 UAT를 통해 체계적으로 문제를 식별하고 수정하려면 `/gsd:verify-work`를 사용하세요.
|
||||
`/gsd-execute-phase`를 다시 실행하지 마세요. 목표를 정확히 수정하려면 `/gsd-quick`을 사용하거나 UAT를 통해 체계적으로 문제를 식별하고 수정하려면 `/gsd-verify-work`를 사용하세요.
|
||||
|
||||
### 모델 비용이 너무 높은 경우
|
||||
|
||||
예산 프로필로 전환하세요: `/gsd:set-profile budget`. 도메인이 익숙하다면 (또는 Claude에게 익숙하다면) `/gsd:settings`에서 조사 및 plan-check 에이전트를 비활성화하세요.
|
||||
예산 프로필로 전환하세요: `/gsd-set-profile budget`. 도메인이 익숙하다면 (또는 Claude에게 익숙하다면) `/gsd-settings`에서 조사 및 plan-check 에이전트를 비활성화하세요.
|
||||
|
||||
### 비Claude 런타임 사용 (Codex, OpenCode, Gemini CLI, Kilo)
|
||||
|
||||
@@ -746,19 +746,19 @@ cd ~/gsd-workspaces/feature-b
|
||||
|
||||
### 비Anthropic 공급자와 함께 Claude Code 사용 (OpenRouter, 로컬)
|
||||
|
||||
GSD 서브에이전트가 Anthropic 모델을 호출하는데 OpenRouter나 로컬 공급자를 통해 비용을 지불하고 있다면 `inherit` 프로필로 전환하세요: `/gsd:set-profile inherit`. 이렇게 하면 모든 에이전트가 특정 Anthropic 모델 대신 현재 세션 모델을 사용합니다. `/gsd:settings` → Model Profile → Inherit도 참고하세요.
|
||||
GSD 서브에이전트가 Anthropic 모델을 호출하는데 OpenRouter나 로컬 공급자를 통해 비용을 지불하고 있다면 `inherit` 프로필로 전환하세요: `/gsd-set-profile inherit`. 이렇게 하면 모든 에이전트가 특정 Anthropic 모델 대신 현재 세션 모델을 사용합니다. `/gsd-settings` → Model Profile → 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 # Decisions, blockers, session memory
|
||||
config.json # Workflow configuration
|
||||
MILESTONES.md # Completed milestone archive
|
||||
HANDOFF.json # Structured session handoff (from /gsd:pause-work)
|
||||
research/ # Domain research from /gsd:new-project
|
||||
reports/ # Session reports (from /gsd:session-report)
|
||||
HANDOFF.json # Structured session handoff (from /gsd-pause-work)
|
||||
research/ # Domain research from /gsd-new-project
|
||||
reports/ # Session reports (from /gsd-session-report)
|
||||
todos/
|
||||
pending/ # Captured ideas awaiting work
|
||||
done/ # Completed todos
|
||||
debug/ # Active debug sessions
|
||||
resolved/ # Archived debug sessions
|
||||
codebase/ # Brownfield codebase mapping (from /gsd:map-codebase)
|
||||
codebase/ # Brownfield codebase mapping (from /gsd-map-codebase)
|
||||
phases/
|
||||
XX-phase-name/
|
||||
XX-YY-PLAN.md # Atomic execution plans
|
||||
@@ -836,7 +836,7 @@ Windows에서 설치 프로그램이 `EPERM: operation not permitted, scandir`
|
||||
CONTEXT.md # Your implementation preferences
|
||||
RESEARCH.md # Ecosystem research findings
|
||||
VERIFICATION.md # Post-execution verification results
|
||||
XX-UI-SPEC.md # UI design contract (from /gsd:ui-phase)
|
||||
XX-UI-REVIEW.md # Visual audit scores (from /gsd:ui-review)
|
||||
ui-reviews/ # Screenshots from /gsd:ui-review (gitignored)
|
||||
XX-UI-SPEC.md # UI design contract (from /gsd-ui-phase)
|
||||
XX-UI-REVIEW.md # Visual audit scores (from /gsd-ui-review)
|
||||
ui-reviews/ # Screenshots from /gsd-ui-review (gitignored)
|
||||
```
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
|------|-----------|---------------|
|
||||
| Normal | > 35% | 경고 없음 |
|
||||
| WARNING | <= 35% | 현재 작업 마무리, 새로운 복잡한 작업 시작 금지 |
|
||||
| CRITICAL | <= 25% | 즉시 중단 후 상태 저장 (`/gsd:pause-work`) |
|
||||
| CRITICAL | <= 25% | 즉시 중단 후 상태 저장 (`/gsd-pause-work`) |
|
||||
|
||||
## Debounce
|
||||
|
||||
@@ -56,7 +56,7 @@ additionalContext -> 에이전트가 경고를 받음
|
||||
|
||||
## GSD와의 통합
|
||||
|
||||
GSD의 `/gsd:pause-work` 명령어는 실행 상태를 저장합니다. WARNING 메시지는 해당 명령어 사용을 권장하며 CRITICAL 메시지는 즉각적인 상태 저장을 지시합니다.
|
||||
GSD의 `/gsd-pause-work` 명령어는 실행 상태를 저장합니다. WARNING 메시지는 해당 명령어 사용을 권장하며 CRITICAL 메시지는 즉각적인 상태 저장을 지시합니다.
|
||||
|
||||
## 설정
|
||||
|
||||
|
||||
@@ -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에 대한 단일 진실 공급원으로서 `config.cjs`에 단일 JS 함수 `buildNewProjectConfig(cwd, userChoices)`를 추가합니다. CLI 명령어 `config-new-project`로 노출합니다. 부분적인 JSON을 인라인으로 작성하는 대신 이 명령어를 호출하도록 `new-project.md` 워크플로우를 업데이트합니다.
|
||||
|
||||
@@ -316,7 +316,7 @@ function buildNewProjectConfig(cwd, userChoices) {
|
||||
/**
|
||||
* 명령어: 새 프로젝트를 위한 완전히 구체화된 .planning/config.json을 생성합니다.
|
||||
*
|
||||
* 사용자가 선택한 설정을 JSON 문자열로 받습니다(/gsd:new-project 중 명시적으로
|
||||
* 사용자가 선택한 설정을 JSON 문자열로 받습니다(/gsd-new-project 중 명시적으로
|
||||
* 구성한 키들). 나머지 키들은 하드코딩된 기본값과 선택적 ~/.gsd/defaults.json에서 채워집니다.
|
||||
*
|
||||
* 멱등성: config.json이 이미 존재하면 { created: false }를 반환합니다.
|
||||
@@ -660,7 +660,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`)는
|
||||
@@ -669,7 +669,7 @@ feat: materialize all config defaults at new-project initialization
|
||||
이로 인해 두 가지 문제가 발생합니다:
|
||||
1. **발견성**: 소스 코드를 읽지 않고는 `git.branching_strategy`를
|
||||
확인하거나 이해할 수 없습니다 — config에 표시되지 않습니다.
|
||||
2. **암묵적 확장**: `/gsd:settings` 또는 `config-set`이 처음으로 config에
|
||||
2. **암묵적 확장**: `/gsd-settings` 또는 `config-set`이 처음으로 config에
|
||||
기록할 때도 해당 키들이 추가되지 않습니다. config는 유효한 구성의
|
||||
일부만 반영합니다.
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# 멀티 프로젝트 워크스페이스 (`/gsd:new-workspace`)
|
||||
# 멀티 프로젝트 워크스페이스 (`/gsd-new-workspace`)
|
||||
|
||||
**Issue:** #1241
|
||||
**Date:** 2026-03-20
|
||||
@@ -18,13 +18,13 @@ GSD는 작업 디렉토리당 하나의 `.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 # 동일 저장소 격리
|
||||
/gsd-new-workspace --name feature-b --repos hr-ui,ZeymoAPI --path ~/workspaces/feature-b
|
||||
/gsd-new-workspace --name feature-b --repos . --strategy worktree # 동일 저장소 격리
|
||||
```
|
||||
|
||||
**인수.**
|
||||
@@ -38,11 +38,11 @@ GSD는 작업 디렉토리당 하나의 `.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는 작업 디렉토리당 하나의 `.planning/` 디렉토리에 종속되
|
||||
~/gsd-workspaces/feature-b/ # 워크스페이스 루트
|
||||
├── WORKSPACE.md # 매니페스트
|
||||
├── .planning/ # 독립적인 GSD 계획 디렉토리
|
||||
│ ├── PROJECT.md # (사용자가 /gsd:new-project를 실행한 경우)
|
||||
│ ├── PROJECT.md # (사용자가 /gsd-new-project를 실행한 경우)
|
||||
│ ├── STATE.md
|
||||
│ └── config.json
|
||||
├── hr-ui/ # 소스 저장소의 git worktree
|
||||
@@ -89,7 +89,7 @@ Strategy: worktree
|
||||
|
||||
## 워크플로우
|
||||
|
||||
### `/gsd:new-workspace` 워크플로우 단계
|
||||
### `/gsd-new-workspace` 워크플로우 단계
|
||||
|
||||
1. **설정** — `init new-workspace` 호출, JSON 컨텍스트 파싱
|
||||
2. **입력 수집** — `--name`/`--repos`/`--path`가 제공되지 않으면 대화형으로 질문합니다. 저장소의 경우 cwd의 하위 `.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. **완료** — 워크스페이스 경로와 다음 단계 출력
|
||||
|
||||
|
||||
@@ -16,7 +16,7 @@ Para detalhes de implementação linha a linha, consulte [ARCHITECTURE.md em ing
|
||||
## Componentes centrais
|
||||
|
||||
1. **Camada de comando**
|
||||
Recebe entrada do usuário (`/gsd:*`) e roteia fluxo.
|
||||
Recebe entrada do usuário (`/gsd-*`) e roteia fluxo.
|
||||
|
||||
2. **Camada de orquestração**
|
||||
Coordena pesquisadores, planejadores, executores e verificadores.
|
||||
@@ -33,7 +33,7 @@ Para detalhes de implementação linha a linha, consulte [ARCHITECTURE.md em ing
|
||||
## Fluxo arquitetural (alto nível)
|
||||
|
||||
```text
|
||||
Entrada (/gsd:comando)
|
||||
Entrada (/gsd-comando)
|
||||
-> Orquestrador
|
||||
-> Subagentes especializados
|
||||
-> Artefatos em .planning/
|
||||
|
||||
@@ -9,74 +9,74 @@ Para detalhes completos de flags avançadas e mudanças recentes, consulte tamb
|
||||
|
||||
| Comando | Finalidade | Quando usar |
|
||||
|---------|------------|-------------|
|
||||
| `/gsd:new-project` | Inicialização completa: perguntas, pesquisa, requisitos e roadmap | Início de projeto |
|
||||
| `/gsd:discuss-phase [N]` | Captura decisões de implementação | Antes do planejamento |
|
||||
| `/gsd:ui-phase [N]` | Gera contrato de UI (`UI-SPEC.md`) | Fases com frontend |
|
||||
| `/gsd:plan-phase [N]` | Pesquisa + planejamento + verificação | Antes de executar uma fase |
|
||||
| `/gsd:execute-phase <N>` | Executa planos em ondas paralelas | Após planejamento aprovado |
|
||||
| `/gsd:verify-work [N]` | UAT manual com diagnóstico automático | Após execução |
|
||||
| `/gsd:ship [N]` | Cria PR da fase validada | Ao concluir a fase |
|
||||
| `/gsd:next` | Detecta e executa o próximo passo lógico | Qualquer momento |
|
||||
| `/gsd:fast <texto>` | Tarefa curta sem planejamento completo | Ajustes triviais |
|
||||
| `/gsd-new-project` | Inicialização completa: perguntas, pesquisa, requisitos e roadmap | Início de projeto |
|
||||
| `/gsd-discuss-phase [N]` | Captura decisões de implementação | Antes do planejamento |
|
||||
| `/gsd-ui-phase [N]` | Gera contrato de UI (`UI-SPEC.md`) | Fases com frontend |
|
||||
| `/gsd-plan-phase [N]` | Pesquisa + planejamento + verificação | Antes de executar uma fase |
|
||||
| `/gsd-execute-phase <N>` | Executa planos em ondas paralelas | Após planejamento aprovado |
|
||||
| `/gsd-verify-work [N]` | UAT manual com diagnóstico automático | Após execução |
|
||||
| `/gsd-ship [N]` | Cria PR da fase validada | Ao concluir a fase |
|
||||
| `/gsd-next` | Detecta e executa o próximo passo lógico | Qualquer momento |
|
||||
| `/gsd-fast <texto>` | Tarefa curta sem planejamento completo | Ajustes triviais |
|
||||
|
||||
## Navegação e Sessão
|
||||
|
||||
| Comando | Finalidade |
|
||||
|---------|------------|
|
||||
| `/gsd:progress` | Mostra status atual e próximos passos |
|
||||
| `/gsd:resume-work` | Retoma contexto da sessão anterior |
|
||||
| `/gsd:pause-work` | Salva handoff estruturado |
|
||||
| `/gsd:session-report` | Gera resumo da sessão |
|
||||
| `/gsd:help` | Lista comandos e uso |
|
||||
| `/gsd:update` | Atualiza o GSD |
|
||||
| `/gsd-progress` | Mostra status atual e próximos passos |
|
||||
| `/gsd-resume-work` | Retoma contexto da sessão anterior |
|
||||
| `/gsd-pause-work` | Salva handoff estruturado |
|
||||
| `/gsd-session-report` | Gera resumo da sessão |
|
||||
| `/gsd-help` | Lista comandos e uso |
|
||||
| `/gsd-update` | Atualiza o GSD |
|
||||
|
||||
## Gestão de Fases
|
||||
|
||||
| Comando | Finalidade |
|
||||
|---------|------------|
|
||||
| `/gsd:add-phase` | Adiciona fase no roadmap |
|
||||
| `/gsd:insert-phase [N]` | Insere trabalho urgente entre fases |
|
||||
| `/gsd:remove-phase [N]` | Remove fase futura e reenumera |
|
||||
| `/gsd:list-phase-assumptions [N]` | Mostra abordagem assumida pelo Claude |
|
||||
| `/gsd:plan-milestone-gaps` | Cria fases para fechar lacunas de auditoria |
|
||||
| `/gsd-add-phase` | Adiciona fase no roadmap |
|
||||
| `/gsd-insert-phase [N]` | Insere trabalho urgente entre fases |
|
||||
| `/gsd-remove-phase [N]` | Remove fase futura e reenumera |
|
||||
| `/gsd-list-phase-assumptions [N]` | Mostra abordagem assumida pelo Claude |
|
||||
| `/gsd-plan-milestone-gaps` | Cria fases para fechar lacunas de auditoria |
|
||||
|
||||
## Brownfield e Utilidades
|
||||
|
||||
| Comando | Finalidade |
|
||||
|---------|------------|
|
||||
| `/gsd:map-codebase` | Mapeia base existente antes de novo projeto |
|
||||
| `/gsd:quick` | Tarefas ad-hoc com garantias do GSD |
|
||||
| `/gsd:debug [desc]` | Debug sistemático com estado persistente |
|
||||
| `/gsd:forensics` | Diagnóstico de falhas no workflow |
|
||||
| `/gsd:settings` | Configuração de agentes, perfil e toggles |
|
||||
| `/gsd:set-profile <perfil>` | Troca rápida de perfil de modelo |
|
||||
| `/gsd-map-codebase` | Mapeia base existente antes de novo projeto |
|
||||
| `/gsd-quick` | Tarefas ad-hoc com garantias do GSD |
|
||||
| `/gsd-debug [desc]` | Debug sistemático com estado persistente |
|
||||
| `/gsd-forensics` | Diagnóstico de falhas no workflow |
|
||||
| `/gsd-settings` | Configuração de agentes, perfil e toggles |
|
||||
| `/gsd-set-profile <perfil>` | Troca rápida de perfil de modelo |
|
||||
|
||||
## Qualidade de Código
|
||||
|
||||
| Comando | Finalidade |
|
||||
|---------|------------|
|
||||
| `/gsd:review` | Peer review com múltiplas IAs |
|
||||
| `/gsd:pr-branch` | Cria branch limpa sem commits de planejamento |
|
||||
| `/gsd:audit-uat` | Audita dívida de validação/UAT |
|
||||
| `/gsd-review` | Peer review com múltiplas IAs |
|
||||
| `/gsd-pr-branch` | Cria branch limpa sem commits de planejamento |
|
||||
| `/gsd-audit-uat` | Audita dívida de validação/UAT |
|
||||
|
||||
## Backlog e Threads
|
||||
|
||||
| Comando | Finalidade |
|
||||
|---------|------------|
|
||||
| `/gsd:add-backlog <desc>` | Adiciona item no backlog (999.x) |
|
||||
| `/gsd:review-backlog` | Promove, mantém ou remove itens |
|
||||
| `/gsd:plant-seed <ideia>` | Registra ideia com gatilho futuro |
|
||||
| `/gsd:thread [nome]` | Gerencia threads persistentes |
|
||||
| `/gsd-add-backlog <desc>` | Adiciona item no backlog (999.x) |
|
||||
| `/gsd-review-backlog` | Promove, mantém ou remove itens |
|
||||
| `/gsd-plant-seed <ideia>` | Registra ideia com gatilho futuro |
|
||||
| `/gsd-thread [nome]` | Gerencia threads persistentes |
|
||||
|
||||
---
|
||||
|
||||
## Exemplo rápido
|
||||
|
||||
```bash
|
||||
/gsd:new-project
|
||||
/gsd:discuss-phase 1
|
||||
/gsd:plan-phase 1
|
||||
/gsd:execute-phase 1
|
||||
/gsd:verify-work 1
|
||||
/gsd:ship 1
|
||||
/gsd-new-project
|
||||
/gsd-discuss-phase 1
|
||||
/gsd-plan-phase 1
|
||||
/gsd-execute-phase 1
|
||||
/gsd-verify-work 1
|
||||
/gsd-ship 1
|
||||
```
|
||||
|
||||
@@ -66,7 +66,7 @@ Esta versão resume os parâmetros principais em Português. Para schema complet
|
||||
| `git.branching_strategy` | `none`, `phase`, `milestone` | `none` | Estratégia de criação de branches |
|
||||
| `git.phase_branch_template` | string | `gsd/phase-{phase}-{slug}` | Nome para branch por fase |
|
||||
| `git.milestone_branch_template` | string | `gsd/{milestone}-{slug}` | Nome para branch de milestone |
|
||||
| `git.quick_branch_template` | string ou `null` | `null` | Branch opcional para `/gsd:quick` |
|
||||
| `git.quick_branch_template` | string ou `null` | `null` | Branch opcional para `/gsd-quick` |
|
||||
|
||||
## Perfis de modelo
|
||||
|
||||
@@ -80,5 +80,5 @@ Esta versão resume os parâmetros principais em Português. Para schema complet
|
||||
Troca rápida:
|
||||
|
||||
```bash
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
@@ -13,8 +13,8 @@ Para catálogo completo e detalhamento exaustivo, consulte [FEATURES.md em ingl
|
||||
- **Execução em ondas paralelas** com controle por dependências
|
||||
- **Commits atômicos por tarefa** para rastreabilidade e rollback
|
||||
- **Verificação pós-execução** com foco em objetivos da fase
|
||||
- **UAT guiado** via `/gsd:verify-work`
|
||||
- **Suporte brownfield** com `/gsd:map-codebase`
|
||||
- **UAT guiado** via `/gsd-verify-work`
|
||||
- **Suporte brownfield** com `/gsd-map-codebase`
|
||||
- **Workstreams** para trilhas paralelas sem colisão de estado
|
||||
- **Backlog, seeds e threads** para memória de médio/longo prazo
|
||||
|
||||
@@ -28,16 +28,16 @@ Para catálogo completo e detalhamento exaustivo, consulte [FEATURES.md em ingl
|
||||
|
||||
## UX de frontend
|
||||
|
||||
- **`/gsd:ui-phase`**: contrato visual antes da execução
|
||||
- **`/gsd:ui-review`**: auditoria visual em 6 pilares
|
||||
- **`/gsd-ui-phase`**: contrato visual antes da execução
|
||||
- **`/gsd-ui-review`**: auditoria visual em 6 pilares
|
||||
- **UI safety gate** para uso de registries de terceiros
|
||||
|
||||
## Operação e manutenção
|
||||
|
||||
- **Perfis de modelo** (`quality`, `balanced`, `budget`, `inherit`)
|
||||
- **Ajuste por toggles** para custo/qualidade/velocidade
|
||||
- **Diagnóstico forense** com `/gsd:forensics`
|
||||
- **Relatório de sessão** com `/gsd:session-report`
|
||||
- **Diagnóstico forense** com `/gsd-forensics`
|
||||
- **Relatório de sessão** com `/gsd-session-report`
|
||||
|
||||
---
|
||||
|
||||
@@ -45,10 +45,10 @@ Para catálogo completo e detalhamento exaustivo, consulte [FEATURES.md em ingl
|
||||
|
||||
| Cenário | Comandos |
|
||||
|--------|----------|
|
||||
| Projeto novo | `/gsd:new-project` -> `/gsd:discuss-phase` -> `/gsd:plan-phase` -> `/gsd:execute-phase` |
|
||||
| Correção rápida | `/gsd:quick` |
|
||||
| Código existente | `/gsd:map-codebase` -> `/gsd:new-project` |
|
||||
| Fechamento de release | `/gsd:audit-milestone` -> `/gsd:complete-milestone` |
|
||||
| Projeto novo | `/gsd-new-project` -> `/gsd-discuss-phase` -> `/gsd-plan-phase` -> `/gsd-execute-phase` |
|
||||
| Correção rápida | `/gsd-quick` |
|
||||
| Código existente | `/gsd-map-codebase` -> `/gsd-new-project` |
|
||||
| Fechamento de release | `/gsd-audit-milestone` -> `/gsd-complete-milestone` |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -20,7 +20,7 @@ Documentação abrangente do framework Get Shit Done (GSD) — um sistema de met
|
||||
|
||||
## Links rápidos
|
||||
|
||||
- **Começar rápido:** [README principal](../../README.pt-BR.md) -> instalação -> `/gsd:new-project`
|
||||
- **Começar rápido:** [README principal](../../README.pt-BR.md) -> instalação -> `/gsd-new-project`
|
||||
- **Fluxo completo:** [Guia do usuário](USER-GUIDE.md)
|
||||
- **Comandos:** [Referência de comandos](COMMANDS.md)
|
||||
- **Configuração:** [Referência de configuração](CONFIGURATION.md)
|
||||
|
||||
@@ -23,23 +23,23 @@ Referência detalhada de workflows, troubleshooting e configuração. Para setup
|
||||
|
||||
Fluxo recomendado por fase:
|
||||
|
||||
1. `/gsd:discuss-phase [N]` — trava preferências de implementação
|
||||
2. `/gsd:ui-phase [N]` — contrato visual para fases frontend
|
||||
3. `/gsd:plan-phase [N]` — pesquisa + plano + validação
|
||||
4. `/gsd:execute-phase [N]` — execução em ondas paralelas
|
||||
5. `/gsd:verify-work [N]` — UAT manual com diagnóstico
|
||||
6. `/gsd:ship [N]` — cria PR (opcional)
|
||||
1. `/gsd-discuss-phase [N]` — trava preferências de implementação
|
||||
2. `/gsd-ui-phase [N]` — contrato visual para fases frontend
|
||||
3. `/gsd-plan-phase [N]` — pesquisa + plano + validação
|
||||
4. `/gsd-execute-phase [N]` — execução em ondas paralelas
|
||||
5. `/gsd-verify-work [N]` — UAT manual com diagnóstico
|
||||
6. `/gsd-ship [N]` — cria PR (opcional)
|
||||
|
||||
Para iniciar projeto novo:
|
||||
|
||||
```bash
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
Para seguir automaticamente o próximo passo:
|
||||
|
||||
```bash
|
||||
/gsd:next
|
||||
/gsd-next
|
||||
```
|
||||
|
||||
### Nyquist Validation
|
||||
@@ -68,13 +68,13 @@ Com `workflow.discuss_mode: "assumptions"`, o GSD analisa o código antes de per
|
||||
|
||||
| Comando | Descrição |
|
||||
|---------|-----------|
|
||||
| `/gsd:ui-phase [N]` | Gera contrato de design `UI-SPEC.md` para a fase |
|
||||
| `/gsd:ui-review [N]` | Auditoria visual retroativa em 6 pilares |
|
||||
| `/gsd-ui-phase [N]` | Gera contrato de design `UI-SPEC.md` para a fase |
|
||||
| `/gsd-ui-review [N]` | Auditoria visual retroativa em 6 pilares |
|
||||
|
||||
### Quando usar
|
||||
|
||||
- Rode `/gsd:ui-phase` depois de `/gsd:discuss-phase` e antes de `/gsd:plan-phase`.
|
||||
- Rode `/gsd:ui-review` após execução/validação para avaliar qualidade visual e consistência.
|
||||
- Rode `/gsd-ui-phase` depois de `/gsd-discuss-phase` e antes de `/gsd-plan-phase`.
|
||||
- Rode `/gsd-ui-review` após execução/validação para avaliar qualidade visual e consistência.
|
||||
|
||||
### Configurações relacionadas
|
||||
|
||||
@@ -92,14 +92,14 @@ Com `workflow.discuss_mode: "assumptions"`, o GSD analisa o código antes de per
|
||||
Ideias fora da sequência ativa vão para backlog:
|
||||
|
||||
```bash
|
||||
/gsd:add-backlog "Camada GraphQL"
|
||||
/gsd:add-backlog "Responsividade mobile"
|
||||
/gsd-add-backlog "Camada GraphQL"
|
||||
/gsd-add-backlog "Responsividade mobile"
|
||||
```
|
||||
|
||||
Promover/revisar:
|
||||
|
||||
```bash
|
||||
/gsd:review-backlog
|
||||
/gsd-review-backlog
|
||||
```
|
||||
|
||||
### Seeds
|
||||
@@ -107,7 +107,7 @@ Promover/revisar:
|
||||
Seeds guardam ideias futuras com condição de gatilho:
|
||||
|
||||
```bash
|
||||
/gsd:plant-seed "Adicionar colaboração real-time quando infra de WebSocket estiver pronta"
|
||||
/gsd-plant-seed "Adicionar colaboração real-time quando infra de WebSocket estiver pronta"
|
||||
```
|
||||
|
||||
### Threads persistentes
|
||||
@@ -115,9 +115,9 @@ Seeds guardam ideias futuras com condição de gatilho:
|
||||
Threads são contexto leve entre sessões:
|
||||
|
||||
```bash
|
||||
/gsd:thread
|
||||
/gsd:thread fix-deploy-key-auth
|
||||
/gsd:thread "Investigar timeout TCP"
|
||||
/gsd-thread
|
||||
/gsd-thread fix-deploy-key-auth
|
||||
/gsd-thread "Investigar timeout TCP"
|
||||
```
|
||||
|
||||
---
|
||||
@@ -128,10 +128,10 @@ Workstreams permitem trabalho paralelo sem colisão de estado de planejamento.
|
||||
|
||||
| Comando | Função |
|
||||
|---------|--------|
|
||||
| `/gsd:workstreams create <name>` | Cria workstream isolado |
|
||||
| `/gsd:workstreams switch <name>` | Troca workstream ativo |
|
||||
| `/gsd:workstreams list` | Lista workstreams |
|
||||
| `/gsd:workstreams complete <name>` | Finaliza e arquiva workstream |
|
||||
| `/gsd-workstreams create <name>` | Cria workstream isolado |
|
||||
| `/gsd-workstreams switch <name>` | Troca workstream ativo |
|
||||
| `/gsd-workstreams list` | Lista workstreams |
|
||||
| `/gsd-workstreams complete <name>` | Finaliza e arquiva workstream |
|
||||
|
||||
`workstreams` compartilham o mesmo código/git, mas isolam artefatos de `.planning/`.
|
||||
|
||||
@@ -156,27 +156,27 @@ Para arquivos sensíveis, use deny list no Claude Code.
|
||||
|
||||
| Comando | Quando usar |
|
||||
|---------|-------------|
|
||||
| `/gsd:new-project` | Início de projeto |
|
||||
| `/gsd:discuss-phase [N]` | Definir preferências antes do plano |
|
||||
| `/gsd:plan-phase [N]` | Criar e validar planos |
|
||||
| `/gsd:execute-phase [N]` | Executar planos em ondas |
|
||||
| `/gsd:verify-work [N]` | UAT manual |
|
||||
| `/gsd:ship [N]` | Gerar PR da fase |
|
||||
| `/gsd:next` | Próximo passo automático |
|
||||
| `/gsd-new-project` | Início de projeto |
|
||||
| `/gsd-discuss-phase [N]` | Definir preferências antes do plano |
|
||||
| `/gsd-plan-phase [N]` | Criar e validar planos |
|
||||
| `/gsd-execute-phase [N]` | Executar planos em ondas |
|
||||
| `/gsd-verify-work [N]` | UAT manual |
|
||||
| `/gsd-ship [N]` | Gerar PR da fase |
|
||||
| `/gsd-next` | Próximo passo automático |
|
||||
|
||||
### Gestão e utilidades
|
||||
|
||||
| Comando | Quando usar |
|
||||
|---------|-------------|
|
||||
| `/gsd:progress` | Ver status atual |
|
||||
| `/gsd:resume-work` | Retomar sessão |
|
||||
| `/gsd:pause-work` | Pausar com handoff |
|
||||
| `/gsd:session-report` | Resumo da sessão |
|
||||
| `/gsd:quick` | Tarefa ad-hoc com garantias GSD |
|
||||
| `/gsd:debug [desc]` | Debug sistemático |
|
||||
| `/gsd:forensics` | Diagnóstico de workflow quebrado |
|
||||
| `/gsd:settings` | Ajustar workflow/modelos |
|
||||
| `/gsd:set-profile <profile>` | Troca rápida de perfil |
|
||||
| `/gsd-progress` | Ver status atual |
|
||||
| `/gsd-resume-work` | Retomar sessão |
|
||||
| `/gsd-pause-work` | Pausar com handoff |
|
||||
| `/gsd-session-report` | Resumo da sessão |
|
||||
| `/gsd-quick` | Tarefa ad-hoc com garantias GSD |
|
||||
| `/gsd-debug [desc]` | Debug sistemático |
|
||||
| `/gsd-forensics` | Diagnóstico de workflow quebrado |
|
||||
| `/gsd-settings` | Ajustar workflow/modelos |
|
||||
| `/gsd-set-profile <profile>` | Troca rápida de perfil |
|
||||
|
||||
Para lista completa e flags avançadas, consulte [Command Reference](../COMMANDS.md).
|
||||
|
||||
@@ -224,35 +224,35 @@ Detalhes completos: [Configuration Reference](../CONFIGURATION.md).
|
||||
|
||||
```bash
|
||||
claude --dangerously-skip-permissions
|
||||
/gsd:new-project
|
||||
/gsd:discuss-phase 1
|
||||
/gsd:ui-phase 1
|
||||
/gsd:plan-phase 1
|
||||
/gsd:execute-phase 1
|
||||
/gsd:verify-work 1
|
||||
/gsd:ship 1
|
||||
/gsd-new-project
|
||||
/gsd-discuss-phase 1
|
||||
/gsd-ui-phase 1
|
||||
/gsd-plan-phase 1
|
||||
/gsd-execute-phase 1
|
||||
/gsd-verify-work 1
|
||||
/gsd-ship 1
|
||||
```
|
||||
|
||||
### Código já existente
|
||||
|
||||
```bash
|
||||
/gsd:map-codebase
|
||||
/gsd:new-project
|
||||
/gsd-map-codebase
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
### Correção rápida
|
||||
|
||||
```bash
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> "Corrigir botão de login no mobile Safari"
|
||||
```
|
||||
|
||||
### Preparação para release
|
||||
|
||||
```bash
|
||||
/gsd:audit-milestone
|
||||
/gsd:plan-milestone-gaps
|
||||
/gsd:complete-milestone
|
||||
/gsd-audit-milestone
|
||||
/gsd-plan-milestone-gaps
|
||||
/gsd-complete-milestone
|
||||
```
|
||||
|
||||
---
|
||||
@@ -265,11 +265,11 @@ claude --dangerously-skip-permissions
|
||||
|
||||
### Sessão longa degradando contexto
|
||||
|
||||
Use `/clear` entre etapas grandes e retome com `/gsd:resume-work` ou `/gsd:progress`.
|
||||
Use `/clear` entre etapas grandes e retome com `/gsd-resume-work` ou `/gsd-progress`.
|
||||
|
||||
### Plano desalinhado
|
||||
|
||||
Rode `/gsd:discuss-phase [N]` antes do plano e valide suposições com `/gsd:list-phase-assumptions [N]`.
|
||||
Rode `/gsd-discuss-phase [N]` antes do plano e valide suposições com `/gsd-list-phase-assumptions [N]`.
|
||||
|
||||
### Execução falhou ou saiu com stubs
|
||||
|
||||
@@ -280,7 +280,7 @@ Replaneje com escopo menor (tarefas menores por plano).
|
||||
Use perfil budget:
|
||||
|
||||
```bash
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
### Runtime não-Claude (Codex/OpenCode/Gemini/Kilo)
|
||||
@@ -293,13 +293,13 @@ Use `resolve_model_ids: "omit"` para deixar o runtime resolver modelos padrão.
|
||||
|
||||
| Problema | Solução |
|
||||
|---------|---------|
|
||||
| Perdeu contexto | `/gsd:resume-work` ou `/gsd:progress` |
|
||||
| Perdeu contexto | `/gsd-resume-work` ou `/gsd-progress` |
|
||||
| Fase deu errado | `git revert` + replanejar |
|
||||
| Precisa alterar escopo | `/gsd:add-phase`, `/gsd:insert-phase`, `/gsd:remove-phase` |
|
||||
| Bug em workflow | `/gsd:forensics` |
|
||||
| Correção pontual | `/gsd:quick` |
|
||||
| Custo alto | `/gsd:set-profile budget` |
|
||||
| Não sabe próximo passo | `/gsd:next` |
|
||||
| Precisa alterar escopo | `/gsd-add-phase`, `/gsd-insert-phase`, `/gsd-remove-phase` |
|
||||
| Bug em workflow | `/gsd-forensics` |
|
||||
| Correção pontual | `/gsd-quick` |
|
||||
| Custo alto | `/gsd-set-profile budget` |
|
||||
| Não sabe próximo passo | `/gsd-next` |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -9,7 +9,7 @@ Para detalhes completos de implementação, veja [context-monitor.md em inglês]
|
||||
## Objetivos
|
||||
|
||||
- identificar quando a sessão principal está saturando
|
||||
- recomendar ações de recuperação (`/clear`, `/gsd:resume-work`, `/gsd:progress`)
|
||||
- recomendar ações de recuperação (`/clear`, `/gsd-resume-work`, `/gsd-progress`)
|
||||
- manter previsibilidade durante ciclos longos de desenvolvimento
|
||||
|
||||
## Como funciona
|
||||
@@ -29,9 +29,9 @@ Para detalhes completos de implementação, veja [context-monitor.md em inglês]
|
||||
|
||||
```bash
|
||||
/clear
|
||||
/gsd:resume-work
|
||||
/gsd-resume-work
|
||||
# ou
|
||||
/gsd:progress
|
||||
/gsd-progress
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
@@ -7,7 +7,7 @@ Fonte canônica: `docs/superpowers/plans/2026-03-18-materialize-new-project-conf
|
||||
|
||||
## Contexto
|
||||
|
||||
Este plano formaliza a materialização explícita da configuração do projeto durante `/gsd:new-project`, garantindo que escolhas feitas na inicialização sejam persistidas de forma determinística em `.planning/config.json`.
|
||||
Este plano formaliza a materialização explícita da configuração do projeto durante `/gsd-new-project`, garantindo que escolhas feitas na inicialização sejam persistidas de forma determinística em `.planning/config.json`.
|
||||
|
||||
## Objetivos
|
||||
|
||||
@@ -37,7 +37,7 @@ Não inclui:
|
||||
|
||||
## Critérios de aceitação
|
||||
|
||||
- após `/gsd:new-project`, `config.json` reflete as escolhas feitas
|
||||
- após `/gsd-new-project`, `config.json` reflete as escolhas feitas
|
||||
- rerun não duplica nem corrompe campos
|
||||
- comandos subsequentes observam os valores persistidos
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Discuss Mode (Modo de Discussão)
|
||||
|
||||
O GSD oferece dois estilos para `/gsd:discuss-phase`:
|
||||
O GSD oferece dois estilos para `/gsd-discuss-phase`:
|
||||
|
||||
- **`standard`**: entrevista aberta para levantar preferências
|
||||
- **`assumptions`**: análise do código primeiro, seguida de confirmação/correção de suposições
|
||||
@@ -33,7 +33,7 @@ Trade-off: depende da qualidade do mapeamento de contexto.
|
||||
|
||||
## Como habilitar
|
||||
|
||||
Via `/gsd:settings`, defina:
|
||||
Via `/gsd-settings`, defina:
|
||||
|
||||
```json
|
||||
{
|
||||
|
||||
@@ -86,7 +86,7 @@ npx get-shit-done-cc@latest
|
||||
2. **位置** —— 全局（所有项目）或本地（仅当前项目）
|
||||
|
||||
验证安装：
|
||||
- Claude Code / Gemini: `/gsd:help`
|
||||
- Claude Code / Gemini: `/gsd-help`
|
||||
- OpenCode: `/gsd-help`
|
||||
- Kilo: `/gsd-help`
|
||||
- Codex: `$gsd-help`
|
||||
@@ -196,12 +196,12 @@ claude --dangerously-skip-permissions
|
||||
|
||||
## 工作原理
|
||||
|
||||
> **已有代码？** 先运行 `/gsd:map-codebase`。它会生成并行代理分析你的技术栈、架构、约定和关注点。然后 `/gsd:new-project` 就了解你的代码库了 —— 问题聚焦在你正在**添加**什么，规划会自动加载你的模式。
|
||||
> **已有代码？** 先运行 `/gsd-map-codebase`。它会生成并行代理分析你的技术栈、架构、约定和关注点。然后 `/gsd-new-project` 就了解你的代码库了 —— 问题聚焦在你正在**添加**什么，规划会自动加载你的模式。
|
||||
|
||||
### 1. 初始化项目
|
||||
|
||||
```
|
||||
/gsd:new-project
|
||||
/gsd-new-project
|
||||
```
|
||||
|
||||
一条命令，一个流程。系统：
|
||||
@@ -220,7 +220,7 @@ claude --dangerously-skip-permissions
|
||||
### 2. 讨论阶段
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 1
|
||||
/gsd-discuss-phase 1
|
||||
```
|
||||
|
||||
**这是你塑造实现方式的地方。**
|
||||
@@ -248,7 +248,7 @@ claude --dangerously-skip-permissions
|
||||
### 3. 规划阶段
|
||||
|
||||
```
|
||||
/gsd:plan-phase 1
|
||||
/gsd-plan-phase 1
|
||||
```
|
||||
|
||||
系统：
|
||||
@@ -266,7 +266,7 @@ claude --dangerously-skip-permissions
|
||||
### 4. 执行阶段
|
||||
|
||||
```
|
||||
/gsd:execute-phase 1
|
||||
/gsd-execute-phase 1
|
||||
```
|
||||
|
||||
系统：
|
||||
@@ -317,7 +317,7 @@ claude --dangerously-skip-permissions
|
||||
### 5. 验证工作
|
||||
|
||||
```
|
||||
/gsd:verify-work 1
|
||||
/gsd-verify-work 1
|
||||
```
|
||||
|
||||
**这是你确认它真的有效的地方。**
|
||||
@@ -331,7 +331,7 @@ claude --dangerously-skip-permissions
|
||||
3. **自动诊断失败** —— 生成调试代理找根本原因
|
||||
4. **创建已验证的修复计划** —— 准备立即重新执行
|
||||
|
||||
如果一切通过，继续。如果有东西坏了，不用手动调试 —— 只需再次运行 `/gsd:execute-phase`，使用它创建的修复计划。
|
||||
如果一切通过，继续。如果有东西坏了，不用手动调试 —— 只需再次运行 `/gsd-execute-phase`，使用它创建的修复计划。
|
||||
|
||||
**创建：** `{阶段号}-UAT.md`，如果发现问题则创建修复计划
|
||||
|
||||
@@ -340,31 +340,31 @@ claude --dangerously-skip-permissions
|
||||
### 6. 循环 → 完成 → 下一个里程碑
|
||||
|
||||
```
|
||||
/gsd:discuss-phase 2
|
||||
/gsd:plan-phase 2
|
||||
/gsd:execute-phase 2
|
||||
/gsd:verify-work 2
|
||||
/gsd-discuss-phase 2
|
||||
/gsd-plan-phase 2
|
||||
/gsd-execute-phase 2
|
||||
/gsd-verify-work 2
|
||||
...
|
||||
/gsd:complete-milestone
|
||||
/gsd:new-milestone
|
||||
/gsd-complete-milestone
|
||||
/gsd-new-milestone
|
||||
```
|
||||
|
||||
循环 **讨论 → 规划 → 执行 → 验证** 直到里程碑完成。
|
||||
|
||||
如果你想在讨论期间更快速地输入，使用 `/gsd:discuss-phase <n> --batch` 一次回答一组小问题，而不是一个一个来。使用 `--chain` 可以自动链式执行从讨论到规划+执行，中间不停顿。
|
||||
如果你想在讨论期间更快速地输入，使用 `/gsd-discuss-phase <n> --batch` 一次回答一组小问题，而不是一个一个来。使用 `--chain` 可以自动链式执行从讨论到规划+执行，中间不停顿。
|
||||
|
||||
每个阶段都会获得你的输入（讨论）、适当的研究（规划）、干净的执行（执行）和人工验证（验证）。上下文保持新鲜。质量保持高水平。
|
||||
|
||||
当所有阶段完成后，`/gsd:complete-milestone` 归档里程碑并标记发布。
|
||||
当所有阶段完成后，`/gsd-complete-milestone` 归档里程碑并标记发布。
|
||||
|
||||
然后 `/gsd:new-milestone` 开始下一个版本 —— 与 `new-project` 相同的流程，但针对你现有的代码库。你描述接下来想构建什么，系统研究领域，你界定需求范围，它创建新的路线图。每个里程碑是一个干净的周期：定义 → 构建 → 发布。
|
||||
然后 `/gsd-new-milestone` 开始下一个版本 —— 与 `new-project` 相同的流程，但针对你现有的代码库。你描述接下来想构建什么，系统研究领域，你界定需求范围，它创建新的路线图。每个里程碑是一个干净的周期：定义 → 构建 → 发布。
|
||||
|
||||
---
|
||||
|
||||
### 快速模式
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
```
|
||||
|
||||
**用于不需要完整规划的临时任务。**
|
||||
@@ -386,7 +386,7 @@ claude --dangerously-skip-permissions
|
||||
标志可组合：`--discuss --research --validate` 提供讨论 + 研究 + 计划检查 + 验证。
|
||||
|
||||
```
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> 你想做什么？"在设置中添加深色模式切换"
|
||||
```
|
||||
|
||||
@@ -483,58 +483,58 @@ lmn012o feat(08-02): 创建注册端点
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:new-project [--auto]` | 完整初始化：提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd:discuss-phase [N] [--auto] [--chain]` | 在规划前捕获实现决策（`--chain` 自动链式执行规划+执行） |
|
||||
| `/gsd:plan-phase [N] [--auto]` | 阶段的研究 + 规划 + 验证 |
|
||||
| `/gsd:execute-phase <N>` | 在并行波次中执行所有计划，完成后验证 |
|
||||
| `/gsd:verify-work [N]` | 手动用户验收测试 ¹ |
|
||||
| `/gsd:audit-milestone` | 验证里程碑达到了其完成定义 |
|
||||
| `/gsd:complete-milestone` | 归档里程碑，标记发布 |
|
||||
| `/gsd:new-milestone [name]` | 开始下一个版本：提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd-new-project [--auto]` | 完整初始化：提问 → 研究 → 需求 → 路线图 |
|
||||
| `/gsd-discuss-phase [N] [--auto] [--chain]` | 在规划前捕获实现决策（`--chain` 自动链式执行规划+执行） |
|
||||
| `/gsd-plan-phase [N] [--auto]` | 阶段的研究 + 规划 + 验证 |
|
||||
| `/gsd-execute-phase <N>` | 在并行波次中执行所有计划，完成后验证 |
|
||||
| `/gsd-verify-work [N]` | 手动用户验收测试 ¹ |
|
||||
| `/gsd-audit-milestone` | 验证里程碑达到了其完成定义 |
|
||||
| `/gsd-complete-milestone` | 归档里程碑，标记发布 |
|
||||
| `/gsd-new-milestone [name]` | 开始下一个版本：提问 → 研究 → 需求 → 路线图 |
|
||||
|
||||
### 导航
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:progress` | 我在哪？接下来做什么？ |
|
||||
| `/gsd:help` | 显示所有命令和使用指南 |
|
||||
| `/gsd:update` | 更新 GSD 并预览变更日志 |
|
||||
| `/gsd:join-discord` | 加入 GSD Discord 社区 |
|
||||
| `/gsd-progress` | 我在哪？接下来做什么？ |
|
||||
| `/gsd-help` | 显示所有命令和使用指南 |
|
||||
| `/gsd-update` | 更新 GSD 并预览变更日志 |
|
||||
| `/gsd-join-discord` | 加入 GSD Discord 社区 |
|
||||
|
||||
### 现有代码库
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:map-codebase` | 在 new-project 之前分析现有代码库 |
|
||||
| `/gsd-map-codebase` | 在 new-project 之前分析现有代码库 |
|
||||
|
||||
### 阶段管理
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:add-phase` | 向路线图追加阶段 |
|
||||
| `/gsd:insert-phase [N]` | 在阶段之间插入紧急工作 |
|
||||
| `/gsd:remove-phase [N]` | 删除未来阶段，重新编号 |
|
||||
| `/gsd:list-phase-assumptions [N]` | 规划前查看 Claude 的预期方法 |
|
||||
| `/gsd:plan-milestone-gaps` | 创建阶段以填补审计发现的差距 |
|
||||
| `/gsd-add-phase` | 向路线图追加阶段 |
|
||||
| `/gsd-insert-phase [N]` | 在阶段之间插入紧急工作 |
|
||||
| `/gsd-remove-phase [N]` | 删除未来阶段，重新编号 |
|
||||
| `/gsd-list-phase-assumptions [N]` | 规划前查看 Claude 的预期方法 |
|
||||
| `/gsd-plan-milestone-gaps` | 创建阶段以填补审计发现的差距 |
|
||||
|
||||
### 会话
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:pause-work` | 阶段中途停止时创建交接 |
|
||||
| `/gsd:resume-work` | 从上次会话恢复 |
|
||||
| `/gsd-pause-work` | 阶段中途停止时创建交接 |
|
||||
| `/gsd-resume-work` | 从上次会话恢复 |
|
||||
|
||||
### 工具
|
||||
|
||||
| 命令 | 作用 |
|
||||
|---------|--------------|
|
||||
| `/gsd:settings` | 配置模型配置文件和工作流代理 |
|
||||
| `/gsd:set-profile <profile>` | 切换模型配置文件（quality/balanced/budget） |
|
||||
| `/gsd:add-todo [desc]` | 捕获想法留待后用 |
|
||||
| `/gsd:check-todos` | 列出待处理事项 |
|
||||
| `/gsd:debug [desc]` | 带持久状态的系统化调试 |
|
||||
| `/gsd:quick [--full] [--discuss] [--research]` | 用 GSD 保证执行临时任务（`--full` 启用全部阶段，`--discuss` 先收集上下文，`--research` 规划前调查方法） |
|
||||
| `/gsd:health [--repair]` | 验证 `.planning/` 目录完整性，用 `--repair` 自动修复 |
|
||||
| `/gsd-settings` | 配置模型配置文件和工作流代理 |
|
||||
| `/gsd-set-profile <profile>` | 切换模型配置文件（quality/balanced/budget） |
|
||||
| `/gsd-add-todo [desc]` | 捕获想法留待后用 |
|
||||
| `/gsd-check-todos` | 列出待处理事项 |
|
||||
| `/gsd-debug [desc]` | 带持久状态的系统化调试 |
|
||||
| `/gsd-quick [--full] [--discuss] [--research]` | 用 GSD 保证执行临时任务（`--full` 启用全部阶段，`--discuss` 先收集上下文，`--research` 规划前调查方法） |
|
||||
| `/gsd-health [--repair]` | 验证 `.planning/` 目录完整性，用 `--repair` 自动修复 |
|
||||
|
||||
<sup>¹ 由 Reddit 用户 OracleGreyBeard 贡献</sup>
|
||||
|
||||
@@ -542,7 +542,7 @@ lmn012o feat(08-02): 创建注册端点
|
||||
|
||||
## 配置
|
||||
|
||||
GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project` 期间配置或稍后用 `/gsd:settings` 更新。完整配置模式、工作流开关、git 分支选项和每个代理的模型分解，请参阅[用户指南](USER-GUIDE.md#配置参考)。
|
||||
GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd-new-project` 期间配置或稍后用 `/gsd-settings` 更新。完整配置模式、工作流开关、git 分支选项和每个代理的模型分解，请参阅[用户指南](USER-GUIDE.md#配置参考)。
|
||||
|
||||
### 核心设置
|
||||
|
||||
@@ -563,10 +563,10 @@ GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project`
|
||||
|
||||
切换配置：
|
||||
```
|
||||
/gsd:set-profile budget
|
||||
/gsd-set-profile budget
|
||||
```
|
||||
|
||||
或通过 `/gsd:settings` 配置。
|
||||
或通过 `/gsd-settings` 配置。
|
||||
|
||||
### 工作流代理
|
||||
|
||||
@@ -579,9 +579,9 @@ GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project`
|
||||
| `workflow.verifier` | `true` | 执行后确认必须项已交付 |
|
||||
| `workflow.auto_advance` | `false` | 自动链式执行 讨论 → 规划 → 执行 |
|
||||
|
||||
使用 `/gsd:settings` 切换这些，或每次调用时覆盖：
|
||||
- `/gsd:plan-phase --skip-research`
|
||||
- `/gsd:plan-phase --skip-verify`
|
||||
使用 `/gsd-settings` 切换这些，或每次调用时覆盖：
|
||||
- `/gsd-plan-phase --skip-research`
|
||||
- `/gsd-plan-phase --skip-verify`
|
||||
|
||||
### 执行
|
||||
|
||||
@@ -648,7 +648,7 @@ GSD 的代码库映射和分析命令读取文件以了解你的项目。**保
|
||||
- 对于 Codex，验证技能是否存在于 `~/.codex/skills/gsd-*/SKILL.md`（全局）或 `./.codex/skills/gsd-*/SKILL.md`（本地）
|
||||
|
||||
**命令没有按预期工作？**
|
||||
- 运行 `/gsd:help` 验证安装
|
||||
- 运行 `/gsd-help` 验证安装
|
||||
- 重新运行 `npx get-shit-done-cc` 重新安装
|
||||
|
||||
**更新到最新版本？**
|
||||
|
||||
@@ -22,7 +22,7 @@
|
||||
```
|
||||
┌──────────────────────────────────────────────────┐
|
||||
│ 新建项目 │
|
||||
│ /gsd:new-project │
|
||||
│ /gsd-new-project │
|
||||
│ 提问 -> 研究 -> 需求 -> 路线图 │
|
||||
└─────────────────────────┬────────────────────────┘
|
||||
│
|
||||
@@ -30,19 +30,19 @@
|
||||
│ 每个阶段: │
|
||||
│ │
|
||||
│ ┌────────────────────┐ │
|
||||
│ │ /gsd:discuss-phase │ │ <- 锁定偏好
|
||||
│ │ /gsd-discuss-phase │ │ <- 锁定偏好
|
||||
│ └──────────┬─────────┘ │
|
||||
│ │ │
|
||||
│ ┌──────────▼─────────┐ │
|
||||
│ │ /gsd:plan-phase │ │ <- 研究 + 规划 + 验证
|
||||
│ │ /gsd-plan-phase │ │ <- 研究 + 规划 + 验证
|
||||
│ └──────────┬─────────┘ │
|
||||
│ │ │
|
||||
│ ┌──────────▼─────────┐ │
|
||||
│ │ /gsd:execute-phase │ │ <- 并行执行
|
||||
│ │ /gsd-execute-phase │ │ <- 并行执行
|
||||
│ └──────────┬─────────┘ │
|
||||
│ │ │
|
||||
│ ┌──────────▼─────────┐ │
|
||||
│ │ /gsd:verify-work │ │ <- 手动 UAT
|
||||
│ │ /gsd-verify-work │ │ <- 手动 UAT
|
||||
│ └──────────┬─────────┘ │
|
||||
│ │ │
|
||||
│ 下一阶段?────────────┘
|
||||
@@ -50,8 +50,8 @@
|
||||
└─────────────┼──────────────┘
|
||||
│
|
||||
┌───────────────▼──────────────┐
|
||||
│ /gsd:audit-milestone │
|
||||
│ /gsd:complete-milestone │
|
||||
│ /gsd-audit-milestone │
|
||||
│ /gsd-complete-milestone │
|
||||
└───────────────┬──────────────┘
|
||||
│
|
||||
另一个里程碑?
|
||||
@@ -59,14 +59,14 @@
|
||||
是 否 -> 完成!
|
||||
│
|
||||
┌───────▼──────────────┐
|
||||
│ /gsd:new-milestone │
|
||||
│ /gsd-new-milestone │
|
||||
└──────────────────────┘
|
||||
```
|
||||
|
||||
### 规划代理协调
|
||||
|
||||
```
|
||||
/gsd:plan-phase N
|
||||
/gsd-plan-phase N
|
||||
│
|
||||
├── 阶段研究员 (x4 并行)
|
||||
│ ├── 技术栈研究员
|
||||
@@ -107,14 +107,14 @@
|
||||
|
||||
**输出：** `{阶段}-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
|
||||
|
|
||||
+-- 检测状态 (VALIDATION.md 存在? SUMMARY.md 存在?)
|
||||
|
|
||||
@@ -134,12 +134,12 @@
|
||||
|
||||
审计器从不修改实现代码 —— 只修改测试文件和 VALIDATION.md。如果测试发现实现 bug，它会标记为升级让你处理。
|
||||
|
||||
**何时使用：** 在启用了 Nyquist 之前规划的阶段执行后，或在 `/gsd:audit-milestone` 发现 Nyquist 合规缺口后。
|
||||
**何时使用：** 在启用了 Nyquist 之前规划的阶段执行后，或在 `/gsd-audit-milestone` 发现 Nyquist 合规缺口后。
|
||||
|
||||
### 执行波次协调
|
||||
|
||||
```
|
||||
/gsd:execute-phase N
|
||||
/gsd-execute-phase N
|
||||
│
|
||||
├── 分析计划依赖
|
||||
│
|
||||
@@ -154,13 +154,13 @@
|
||||
└── 根据阶段目标检查代码库
|
||||
│
|
||||
├── 通过 -> VERIFICATION.md (成功)
|
||||
└── 失败 -> 问题记录到 /gsd:verify-work
|
||||
└── 失败 -> 问题记录到 /gsd-verify-work
|
||||
```
|
||||
|
||||
### 现有代码库工作流
|
||||
|
||||
```
|
||||
/gsd:map-codebase
|
||||
/gsd-map-codebase
|
||||
│
|
||||
├── 技术栈映射器 -> codebase/STACK.md
|
||||
├── 架构映射器 -> codebase/ARCHITECTURE.md
|
||||
@@ -168,7 +168,7 @@
|
||||
└── 关注点映射器 -> codebase/CONCERNS.md
|
||||
│
|
||||
┌───────▼──────────┐
|
||||
│ /gsd:new-project │ <- 问题聚焦于你正在添加的内容
|
||||
│ /gsd-new-project │ <- 问题聚焦于你正在添加的内容
|
||||
└──────────────────┘
|
||||
```
|
||||
|
||||
@@ -180,56 +180,56 @@
|
||||
|
||||
| 命令 | 用途 | 何时使用 |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:new-project` | 完整项目初始化：提问、研究、需求、路线图 | 新项目开始时 |
|
||||
| `/gsd:new-project --auto @idea.md` | 从文档自动初始化 | 有现成的 PRD 或想法文档 |
|
||||
| `/gsd:discuss-phase [N]` | 捕获实现决策 | 规划前，塑造构建方式 |
|
||||
| `/gsd:plan-phase [N]` | 研究 + 规划 + 验证 | 执行阶段前 |
|
||||
| `/gsd:execute-phase <N>` | 在并行波次中执行所有计划 | 规划完成后 |
|
||||
| `/gsd:verify-work [N]` | 带自动诊断的手动 UAT | 执行完成后 |
|
||||
| `/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-plan-phase [N]` | 研究 + 规划 + 验证 | 执行阶段前 |
|
||||
| `/gsd-execute-phase <N>` | 在并行波次中执行所有计划 | 规划完成后 |
|
||||
| `/gsd-verify-work [N]` | 带自动诊断的手动 UAT | 执行完成后 |
|
||||
| `/gsd-audit-milestone` | 验证里程碑达到其完成定义 | 完成里程碑前 |
|
||||
| `/gsd-complete-milestone` | 归档里程碑，标记发布 | 所有阶段已验证 |
|
||||
| `/gsd-new-milestone [name]` | 开始下一个版本周期 | 完成里程碑后 |
|
||||
|
||||
### 导航
|
||||
|
||||
| 命令 | 用途 | 何时使用 |
|
||||
|---------|---------|-------------|
|
||||
| `/gsd:progress` | 显示状态和下一步 | 任何时候 -- "我在哪?" |
|
||||
| `/gsd:resume-work` | 从上次会话恢复完整上下文 | 开始新会话 |
|
||||
| `/gsd:pause-work` | 保存上下文交接 | 阶段中途停止 |
|
||||
| `/gsd:help` | 显示所有命令 | 快速参考 |
|
||||
| `/gsd:update` | 更新 GSD 并预览变更日志 | 检查新版本 |
|
||||
| `/gsd:join-discord` | 打开 Discord 社区邀请 | 问题或社区 |
|
||||
| `/gsd-progress` | 显示状态和下一步 | 任何时候 -- "我在哪?" |
|
||||
| `/gsd-resume-work` | 从上次会话恢复完整上下文 | 开始新会话 |
|
||||
| `/gsd-pause-work` | 保存上下文交接 | 阶段中途停止 |
|
||||
| `/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 保证的临时任务 | Bug 修复、小功能、配置更改 |
|
||||
| `/gsd:debug [desc]` | 带持久状态的系统化调试 | 出问题时 |
|
||||
| `/gsd:add-todo [desc]` | 捕获想法留待后用 | 会话期间想到什么 |
|
||||
| `/gsd:check-todos` | 列出待处理事项 | 查看捕获的想法 |
|
||||
| `/gsd:settings` | 配置工作流开关和模型配置 | 更改模型、切换代理 |
|
||||
| `/gsd:set-profile <profile>` | 快速切换配置 | 更改成本/质量权衡 |
|
||||
| `/gsd:reapply-patches` | 更新后恢复本地修改 | 如果你有本地编辑，在 `/gsd:update` 后 |
|
||||
| `/gsd-map-codebase` | 分析现有代码库 | 在现有代码上运行 `/gsd-new-project` 之前 |
|
||||
| `/gsd-quick` | 带 GSD 保证的临时任务 | Bug 修复、小功能、配置更改 |
|
||||
| `/gsd-debug [desc]` | 带持久状态的系统化调试 | 出问题时 |
|
||||
| `/gsd-add-todo [desc]` | 捕获想法留待后用 | 会话期间想到什么 |
|
||||
| `/gsd-check-todos` | 列出待处理事项 | 查看捕获的想法 |
|
||||
| `/gsd-settings` | 配置工作流开关和模型配置 | 更改模型、切换代理 |
|
||||
| `/gsd-set-profile <profile>` | 快速切换配置 | 更改成本/质量权衡 |
|
||||
| `/gsd-reapply-patches` | 更新后恢复本地修改 | 如果你有本地编辑，在 `/gsd-update` 后 |
|
||||
|
||||
---
|
||||
|
||||
## 配置参考
|
||||
|
||||
GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project` 期间配置或稍后用 `/gsd:settings` 更新。
|
||||
GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd-new-project` 期间配置或稍后用 `/gsd-settings` 更新。
|
||||
|
||||
### 完整 config.json 模式
|
||||
|
||||
@@ -331,56 +331,56 @@ GSD 在 `.planning/config.json` 中存储项目设置。在 `/gsd:new-project`
|
||||
|
||||
```bash
|
||||
claude --dangerously-skip-permissions
|
||||
/gsd:new-project # 回答问题，配置，批准路线图
|
||||
/gsd-new-project # 回答问题，配置，批准路线图
|
||||
/clear
|
||||
/gsd:discuss-phase 1 # 锁定你的偏好
|
||||
/gsd:plan-phase 1 # 研究 + 规划 + 验证
|
||||
/gsd:execute-phase 1 # 并行执行
|
||||
/gsd:verify-work 1 # 手动 UAT
|
||||
/gsd-discuss-phase 1 # 锁定你的偏好
|
||||
/gsd-plan-phase 1 # 研究 + 规划 + 验证
|
||||
/gsd-execute-phase 1 # 并行执行
|
||||
/gsd-verify-work 1 # 手动 UAT
|
||||
/clear
|
||||
/gsd:discuss-phase 2 # 对每个阶段重复
|
||||
/gsd-discuss-phase 2 # 对每个阶段重复
|
||||
...
|
||||
/gsd:audit-milestone # 检查所有内容已发布
|
||||
/gsd:complete-milestone # 归档，标记，完成
|
||||
/gsd-audit-milestone # 检查所有内容已发布
|
||||
/gsd-complete-milestone # 归档，标记，完成
|
||||
```
|
||||
|
||||
### 从现有文档创建新项目
|
||||
|
||||
```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 # 问题聚焦于你正在添加的内容
|
||||
# （从这里开始正常阶段工作流）
|
||||
```
|
||||
|
||||
### 快速 Bug 修复
|
||||
|
||||
```bash
|
||||
/gsd:quick
|
||||
/gsd-quick
|
||||
> "修复移动端 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 # 归档，标记，完成
|
||||
```
|
||||
|
||||
### 速度与质量预设
|
||||
@@ -394,11 +394,11 @@ claude --dangerously-skip-permissions
|
||||
### 里程碑中途范围变更
|
||||
|
||||
```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 并重新编号
|
||||
```
|
||||
|
||||
---
|
||||
@@ -407,15 +407,15 @@ claude --dangerously-skip-permissions
|
||||
|
||||
### "项目已初始化"
|
||||
|
||||
你运行了 `/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]`。大多数计划质量问题来自 Claude 做出了 `CONTEXT.md` 本可以防止的假设。你也可以运行 `/gsd:list-phase-assumptions [N]` 在提交计划前查看 Claude 打算做什么。
|
||||
在规划前运行 `/gsd-discuss-phase [N]`。大多数计划质量问题来自 Claude 做出了 `CONTEXT.md` 本可以防止的假设。你也可以运行 `/gsd-list-phase-assumptions [N]` 在提交计划前查看 Claude 打算做什么。
|
||||
|
||||
### 执行失败或产生存根
|
||||
|
||||
@@ -423,23 +423,23 @@ claude --dangerously-skip-permissions
|
||||
|
||||
### 忘记你在哪里
|
||||
|
||||
运行 `/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` 禁用研究和计划检查代理。
|
||||
切换到 budget 配置：`/gsd-set-profile budget`。如果领域对你（或 Claude）熟悉，通过 `/gsd-settings` 禁用研究和计划检查代理。
|
||||
|
||||
### 处理敏感/私有项目
|
||||
|
||||
在 `/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` 将你的更改合并回来。
|
||||
|
||||
### 子代理似乎失败但工作已完成
|
||||
|
||||
@@ -451,15 +451,15 @@ claude --dangerously-skip-permissions
|
||||
|
||||
| 问题 | 解决方案 |
|
||||
|---------|----------|
|
||||
| 丢失上下文 / 新会话 | `/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 "描述"` |
|
||||
| 快速针对性修复 | `/gsd:quick` |
|
||||
| 计划与你的愿景不符 | `/gsd:discuss-phase [N]` 然后重新规划 |
|
||||
| 成本过高 | `/gsd:set-profile budget` 和 `/gsd:settings` 关闭代理 |
|
||||
| 更新破坏了本地更改 | `/gsd:reapply-patches` |
|
||||
| 需要更改范围 | `/gsd-add-phase`、`/gsd-insert-phase` 或 `/gsd-remove-phase` |
|
||||
| 里程碑审计发现缺口 | `/gsd-plan-milestone-gaps` |
|
||||
| 出问题了 | `/gsd-debug "描述"` |
|
||||
| 快速针对性修复 | `/gsd-quick` |
|
||||
| 计划与你的愿景不符 | `/gsd-discuss-phase [N]` 然后重新规划 |
|
||||
| 成本过高 | `/gsd-set-profile budget` 和 `/gsd-settings` 关闭代理 |
|
||||
| 更新破坏了本地更改 | `/gsd-reapply-patches` |
|
||||
|
||||
---
|
||||
|
||||
@@ -475,13 +475,13 @@ claude --dangerously-skip-permissions
|
||||
STATE.md # 决策、阻塞项、会话记忆
|
||||
config.json # 工作流配置
|
||||
MILESTONES.md # 已完成里程碑归档
|
||||
research/ # 来自 /gsd:new-project 的领域研究
|
||||
research/ # 来自 /gsd-new-project 的领域研究
|
||||
todos/
|
||||
pending/ # 等待处理的捕获想法
|
||||
done/ # 已完成的待办事项
|
||||
debug/ # 活跃调试会话
|
||||
resolved/ # 已归档的调试会话
|
||||
codebase/ # 现有代码库映射（来自 /gsd:map-codebase）
|
||||
codebase/ # 现有代码库映射（来自 /gsd-map-codebase）
|
||||
phases/
|
||||
XX-phase-name/
|
||||
XX-YY-PLAN.md # 原子执行计划
|
||||
|
||||
@@ -44,7 +44,7 @@
|
||||
|
||||
**02-03: 刷新令牌轮换** — 添加带滑动过期的 /api/auth/refresh
|
||||
|
||||
`/gsd:execute-phase 2`
|
||||
`/gsd-execute-phase 2`
|
||||
|
||||
<sub>`/clear` 优先 → 全新上下文窗口</sub>
|
||||
|
||||
@@ -52,7 +52,7 @@
|
||||
|
||||
**也可选：**
|
||||
- 执行前审查计划
|
||||
- `/gsd:list-phase-assumptions 2` — 检查假设
|
||||
- `/gsd-list-phase-assumptions 2` — 检查假设
|
||||
|
||||
---
|
||||
```
|
||||
@@ -69,7 +69,7 @@
|
||||
**02-03: 刷新令牌轮换** — 添加带滑动过期的 /api/auth/refresh
|
||||
<sub>阶段 2 的最后一个计划</sub>
|
||||
|
||||
`/gsd:execute-phase 2`
|
||||
`/gsd-execute-phase 2`
|
||||
|
||||
<sub>`/clear` 优先 → 全新上下文窗口</sub>
|
||||
|
||||
@@ -91,15 +91,15 @@
|
||||
|
||||
**阶段 2: 认证** — 带刷新令牌的 JWT 登录流程
|
||||
|
||||
`/gsd:plan-phase 2`
|
||||
`/gsd-plan-phase 2`
|
||||
|
||||
<sub>`/clear` 优先 → 全新上下文窗口</sub>
|
||||
|
||||
---
|
||||
|
||||
**也可选：**
|
||||
- `/gsd:discuss-phase 2` — 先收集上下文
|
||||
- `/gsd:research-phase 2` — 调查未知项
|
||||
- `/gsd-discuss-phase 2` — 先收集上下文
|
||||
- `/gsd-research-phase 2` — 调查未知项
|
||||
- 审查路线图
|
||||
|
||||
---
|
||||
@@ -120,15 +120,15 @@
|
||||
|
||||
**阶段 3: 核心功能** — 用户仪表板、设置和数据导出
|
||||
|
||||
`/gsd:plan-phase 3`
|
||||
`/gsd-plan-phase 3`
|
||||
|
||||
<sub>`/clear` 优先 → 全新上下文窗口</sub>
|
||||
|
||||
---
|
||||
|
||||
**也可选：**
|
||||
- `/gsd:discuss-phase 3` — 先收集上下文
|
||||
- `/gsd:research-phase 3` — 调查未知项
|
||||
- `/gsd-discuss-phase 3` — 先收集上下文
|
||||
- `/gsd-research-phase 3` — 调查未知项
|
||||
- 回顾阶段 2 构建的内容
|
||||
|
||||
---
|
||||
@@ -145,11 +145,11 @@
|
||||
|
||||
**阶段 3: 核心功能** — 用户仪表板、设置和数据导出
|
||||
|
||||
**直接规划：** `/gsd:plan-phase 3`
|
||||
**直接规划：** `/gsd-plan-phase 3`
|
||||
|
||||
**先讨论上下文：** `/gsd:discuss-phase 3`
|
||||
**先讨论上下文：** `/gsd-discuss-phase 3`
|
||||
|
||||
**研究未知项：** `/gsd:research-phase 3`
|
||||
**研究未知项：** `/gsd-research-phase 3`
|
||||
|
||||
<sub>`/clear` 优先 → 全新上下文窗口</sub>
|
||||
|
||||
@@ -169,7 +169,7 @@
|
||||
|
||||
**开始 v1.1** — 提问 → 研究 → 需求 → 路线图
|
||||
|
||||
`/gsd:new-milestone`
|
||||
`/gsd-new-milestone`
|
||||
|
||||
<sub>`/clear` 优先 → 全新上下文窗口</sub>
|
||||
|
||||
@@ -214,7 +214,7 @@
|
||||
## 继续
|
||||
|
||||
运行 `/clear`，然后粘贴：
|
||||
/gsd:execute-phase 2
|
||||
/gsd-execute-phase 2
|
||||
```
|
||||
|
||||
用户不知道 02-03 是关于什么的。
|
||||
@@ -222,7 +222,7 @@
|
||||
### 不要：缺少 /clear 说明
|
||||
|
||||
```
|
||||
`/gsd:plan-phase 3`
|
||||
`/gsd-plan-phase 3`
|
||||
|
||||
先运行 /clear。
|
||||
```
|
||||
@@ -242,7 +242,7 @@
|
||||
|
||||
```
|
||||
```
|
||||
/gsd:plan-phase 3
|
||||
/gsd-plan-phase 3
|
||||
```
|
||||
```
|
||||
|
||||
|
||||
@@ -66,7 +66,7 @@
|
||||
|
||||
## 切换配置
|
||||
|
||||
运行时：`/gsd:set-profile <profile>`
|
||||
运行时：`/gsd-set-profile <profile>`
|
||||
|
||||
项目默认值：在 `.planning/config.json` 中设置：
|
||||
```json
|
||||
|
||||
@@ -115,8 +115,8 @@
|
||||
───────────────────────────────────────────────────────────────
|
||||
|
||||
**也可选：**
|
||||
- `/gsd:alternative-1` — 描述
|
||||
- `/gsd:alternative-2` — 描述
|
||||
- `/gsd-alternative-1` — 描述
|
||||
- `/gsd-alternative-2` — 描述
|
||||
|
||||
───────────────────────────────────────────────────────────────
|
||||
```
|
||||
|
||||
@@ -765,7 +765,7 @@ function cmdScaffold(cwd, type, options, raw) {
|
||||
switch (type) {
|
||||
case 'context': {
|
||||
filePath = path.join(phaseDir, `${padded}-CONTEXT.md`);
|
||||
content = `---\nphase: "${padded}"\nname: "${name || phaseInfo?.phase_name || 'Unnamed'}"\ncreated: ${today}\n---\n\n# Phase ${phase}: ${name || phaseInfo?.phase_name || 'Unnamed'} — Context\n\n## Decisions\n\n_Decisions will be captured during /gsd:discuss-phase ${phase}_\n\n## Discretion Areas\n\n_Areas where the executor can use judgment_\n\n## Deferred Ideas\n\n_Ideas to consider later_\n`;
|
||||
content = `---\nphase: "${padded}"\nname: "${name || phaseInfo?.phase_name || 'Unnamed'}"\ncreated: ${today}\n---\n\n# Phase ${phase}: ${name || phaseInfo?.phase_name || 'Unnamed'} — Context\n\n## Decisions\n\n_Decisions will be captured during /gsd-discuss-phase ${phase}_\n\n## Discretion Areas\n\n_Areas where the executor can use judgment_\n\n## Deferred Ideas\n\n_Ideas to consider later_\n`;
|
||||
break;
|
||||
}
|
||||
case 'uat': {
|
||||
|
||||
@@ -64,7 +64,7 @@ function validateKnownConfigKeyPath(keyPath) {
|
||||
* Merges (increasing priority):
|
||||
* 1. Hardcoded defaults — every key that loadConfig() resolves, plus mode/granularity
|
||||
* 2. User-level defaults from ~/.gsd/defaults.json (if present)
|
||||
* 3. userChoices — the settings the user explicitly selected during /gsd:new-project
|
||||
* 3. userChoices — the settings the user explicitly selected during /gsd-new-project
|
||||
*
|
||||
* Uses the canonical `git` namespace for branching keys (consistent with VALID_CONFIG_KEYS
|
||||
* and the settings workflow). loadConfig() handles both flat and nested formats, so this
|
||||
@@ -173,7 +173,7 @@ function buildNewProjectConfig(userChoices) {
|
||||
* Command: create a fully-materialized .planning/config.json for a new project.
|
||||
*
|
||||
* Accepts user-chosen settings as a JSON string (the keys the user explicitly
|
||||
* configured during /gsd:new-project). All remaining keys are filled from
|
||||
* configured during /gsd-new-project). All remaining keys are filled from
|
||||
* hardcoded defaults and optional ~/.gsd/defaults.json.
|
||||
*
|
||||
* Idempotent: if config.json already exists, returns { created: false }.
|
||||
|
||||
@@ -806,10 +806,10 @@ function cmdInitManager(cwd, raw) {
|
||||
|
||||
// Validate prerequisites
|
||||
if (!fs.existsSync(paths.roadmap)) {
|
||||
error('No ROADMAP.md found. Run /gsd:new-milestone first.');
|
||||
error('No ROADMAP.md found. Run /gsd-new-milestone first.');
|
||||
}
|
||||
if (!fs.existsSync(paths.state)) {
|
||||
error('No STATE.md found. Run /gsd:new-milestone first.');
|
||||
error('No STATE.md found. Run /gsd-new-milestone first.');
|
||||
}
|
||||
const rawContent = fs.readFileSync(paths.roadmap, 'utf-8');
|
||||
const content = extractCurrentMilestone(rawContent, cwd);
|
||||
@@ -968,7 +968,7 @@ function cmdInitManager(cwd, raw) {
|
||||
phase_name: phase.name,
|
||||
action: 'execute',
|
||||
reason: `${phase.plan_count} plans ready, dependencies met`,
|
||||
command: `/gsd:execute-phase ${phase.number}`,
|
||||
command: `/gsd-execute-phase ${phase.number}`,
|
||||
});
|
||||
} else if (phase.disk_status === 'discussed' || phase.disk_status === 'researched') {
|
||||
recommendedActions.push({
|
||||
@@ -976,7 +976,7 @@ function cmdInitManager(cwd, raw) {
|
||||
phase_name: phase.name,
|
||||
action: 'plan',
|
||||
reason: 'Context gathered, ready for planning',
|
||||
command: `/gsd:plan-phase ${phase.number}`,
|
||||
command: `/gsd-plan-phase ${phase.number}`,
|
||||
});
|
||||
} else if ((phase.disk_status === 'empty' || phase.disk_status === 'no_directory') && phase.is_next_to_discuss) {
|
||||
recommendedActions.push({
|
||||
@@ -984,7 +984,7 @@ function cmdInitManager(cwd, raw) {
|
||||
phase_name: phase.name,
|
||||
action: 'discuss',
|
||||
reason: 'Unblocked, ready to gather context',
|
||||
command: `/gsd:discuss-phase ${phase.number}`,
|
||||
command: `/gsd-discuss-phase ${phase.number}`,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
@@ -363,7 +363,7 @@ function cmdPhaseAdd(cwd, description, raw, customId) {
|
||||
|
||||
// Build phase entry
|
||||
const dependsOn = config.phase_naming === 'custom' ? '' : `\n**Depends on:** Phase ${typeof _newPhaseId === 'number' ? _newPhaseId - 1 : 'TBD'}`;
|
||||
const phaseEntry = `\n### Phase ${_newPhaseId}: ${description}\n\n**Goal:** [To be planned]\n**Requirements**: TBD${dependsOn}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /gsd:plan-phase ${_newPhaseId} to break down)\n`;
|
||||
const phaseEntry = `\n### Phase ${_newPhaseId}: ${description}\n\n**Goal:** [To be planned]\n**Requirements**: TBD${dependsOn}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /gsd-plan-phase ${_newPhaseId} to break down)\n`;
|
||||
|
||||
// Find insertion point: before last "---" or at end
|
||||
let updatedContent;
|
||||
@@ -445,7 +445,7 @@ function cmdPhaseInsert(cwd, afterPhase, description, raw) {
|
||||
fs.writeFileSync(path.join(dirPath, '.gitkeep'), '');
|
||||
|
||||
// Build phase entry
|
||||
const phaseEntry = `\n### Phase ${_decimalPhase}: ${description} (INSERTED)\n\n**Goal:** [Urgent work - to be planned]\n**Requirements**: TBD\n**Depends on:** Phase ${afterPhase}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /gsd:plan-phase ${_decimalPhase} to break down)\n`;
|
||||
const phaseEntry = `\n### Phase ${_decimalPhase}: ${description} (INSERTED)\n\n**Goal:** [Urgent work - to be planned]\n**Requirements**: TBD\n**Depends on:** Phase ${afterPhase}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /gsd-plan-phase ${_decimalPhase} to break down)\n`;
|
||||
|
||||
// Insert after the target phase section
|
||||
const headerPattern = new RegExp(`(#{2,4}\\s*Phase\\s+0*${afterPhaseEscaped}:[^\\n]*\\n)`, 'i');
|
||||
|
||||
@@ -173,7 +173,7 @@ const CLAUDE_INSTRUCTIONS = {
|
||||
};
|
||||
|
||||
const CLAUDE_MD_FALLBACKS = {
|
||||
project: 'Project not yet initialized. Run /gsd:new-project to set up.',
|
||||
project: 'Project not yet initialized. Run /gsd-new-project to set up.',
|
||||
stack: 'Technology stack not yet documented. Will populate after codebase mapping or first phase.',
|
||||
conventions: 'Conventions not yet established. Will populate as patterns emerge during development.',
|
||||
architecture: 'Architecture not yet mapped. Follow existing patterns found in the codebase.',
|
||||
@@ -187,9 +187,9 @@ const CLAUDE_MD_WORKFLOW_ENFORCEMENT = [
|
||||
'Before using Edit, Write, or other file-changing tools, start work through a GSD command so planning artifacts and execution context stay in sync.',
|
||||
'',
|
||||
'Use these entry points:',
|
||||
'- `/gsd:quick` for small fixes, doc updates, and ad-hoc tasks',
|
||||
'- `/gsd:debug` for investigation and bug fixing',
|
||||
'- `/gsd:execute-phase` for planned phase work',
|
||||
'- `/gsd-quick` for small fixes, doc updates, and ad-hoc tasks',
|
||||
'- `/gsd-debug` for investigation and bug fixing',
|
||||
'- `/gsd-execute-phase` for planned phase work',
|
||||
'',
|
||||
'Do not make direct repo edits outside a GSD workflow unless the user explicitly asks to bypass it.',
|
||||
].join('\n');
|
||||
@@ -198,7 +198,7 @@ const CLAUDE_MD_PROFILE_PLACEHOLDER = [
|
||||
'<!-- GSD:profile-start -->',
|
||||
'## Developer Profile',
|
||||
'',
|
||||
'> Profile not yet configured. Run `/gsd:profile-user` to generate your developer profile.',
|
||||
'> Profile not yet configured. Run `/gsd-profile-user` to generate your developer profile.',
|
||||
'> This section is managed by `generate-claude-profile` -- do not edit manually.',
|
||||
'<!-- GSD:profile-end -->',
|
||||
].join('\n');
|
||||
@@ -765,7 +765,7 @@ function cmdGenerateDevPreferences(cwd, options, raw) {
|
||||
|
||||
let stackBlock;
|
||||
if (analysis.data_source === 'questionnaire') {
|
||||
stackBlock = 'Stack preferences not available (questionnaire-only profile). Run `/gsd:profile-user --refresh` with session data to populate.';
|
||||
stackBlock = 'Stack preferences not available (questionnaire-only profile). Run `/gsd-profile-user --refresh` with session data to populate.';
|
||||
} else if (options.stack) {
|
||||
stackBlock = options.stack;
|
||||
} else {
|
||||
@@ -785,7 +785,7 @@ function cmdGenerateDevPreferences(cwd, options, raw) {
|
||||
|
||||
const result = {
|
||||
command_path: outputPath,
|
||||
command_name: '/gsd:dev-preferences',
|
||||
command_name: '/gsd-dev-preferences',
|
||||
dimensions_included: dimensionsIncluded,
|
||||
source: analysis.data_source || 'session_analysis',
|
||||
};
|
||||
@@ -851,7 +851,7 @@ function cmdGenerateClaudeProfile(cwd, options, raw) {
|
||||
'<!-- GSD:profile-start -->',
|
||||
'## Developer Profile',
|
||||
'',
|
||||
`> Generated by GSD from ${dataSource}. Run \`/gsd:profile-user --refresh\` to update.`,
|
||||
`> Generated by GSD from ${dataSource}. Run \`/gsd-profile-user --refresh\` to update.`,
|
||||
'',
|
||||
'| Dimension | Rating | Confidence |',
|
||||
'|-----------|--------|------------|',
|
||||
@@ -1021,7 +1021,7 @@ function cmdGenerateClaudeMd(cwd, options, raw) {
|
||||
let message = `Generated ${genCount}/${totalManaged} sections.`;
|
||||
if (sectionsFallback.length > 0) message += ` Fallback: ${sectionsFallback.join(', ')}.`;
|
||||
if (sectionsSkipped.length > 0) message += ` Skipped (manually edited): ${sectionsSkipped.join(', ')}.`;
|
||||
if (profileStatus === 'placeholder_added') message += ' Run /gsd:profile-user to unlock Developer Profile.';
|
||||
if (profileStatus === 'placeholder_added') message += ' Run /gsd-profile-user to unlock Developer Profile.';
|
||||
|
||||
const result = {
|
||||
claude_md_path: outputPath,
|
||||
|
||||
@@ -556,7 +556,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
|
||||
// ─── Check 1: .planning/ exists ───────────────────────────────────────────
|
||||
if (!fs.existsSync(planBase)) {
|
||||
addIssue('error', 'E001', '.planning/ directory not found', 'Run /gsd:new-project to initialize');
|
||||
addIssue('error', 'E001', '.planning/ directory not found', 'Run /gsd-new-project to initialize');
|
||||
output({
|
||||
status: 'broken',
|
||||
errors,
|
||||
@@ -569,7 +569,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
|
||||
// ─── Check 2: PROJECT.md exists and has required sections ─────────────────
|
||||
if (!fs.existsSync(projectPath)) {
|
||||
addIssue('error', 'E002', 'PROJECT.md not found', 'Run /gsd:new-project to create');
|
||||
addIssue('error', 'E002', 'PROJECT.md not found', 'Run /gsd-new-project to create');
|
||||
} else {
|
||||
const content = fs.readFileSync(projectPath, 'utf-8');
|
||||
const requiredSections = ['## What This Is', '## Core Value', '## Requirements'];
|
||||
@@ -582,12 +582,12 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
|
||||
// ─── Check 3: ROADMAP.md exists ───────────────────────────────────────────
|
||||
if (!fs.existsSync(roadmapPath)) {
|
||||
addIssue('error', 'E003', 'ROADMAP.md not found', 'Run /gsd:new-milestone to create roadmap');
|
||||
addIssue('error', 'E003', 'ROADMAP.md not found', 'Run /gsd-new-milestone to create roadmap');
|
||||
}
|
||||
|
||||
// ─── Check 4: STATE.md exists and references valid phases ─────────────────
|
||||
if (!fs.existsSync(statePath)) {
|
||||
addIssue('error', 'E004', 'STATE.md not found', 'Run /gsd:health --repair to regenerate', true);
|
||||
addIssue('error', 'E004', 'STATE.md not found', 'Run /gsd-health --repair to regenerate', true);
|
||||
repairs.push('regenerateState');
|
||||
} else {
|
||||
const stateContent = fs.readFileSync(statePath, 'utf-8');
|
||||
@@ -614,7 +614,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
'warning',
|
||||
'W002',
|
||||
`STATE.md references phase ${ref}, but only phases ${[...diskPhases].sort().join(', ')} exist`,
|
||||
'Review STATE.md manually before changing it; /gsd:health --repair will not overwrite an existing STATE.md for phase mismatches'
|
||||
'Review STATE.md manually before changing it; /gsd-health --repair will not overwrite an existing STATE.md for phase mismatches'
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -623,7 +623,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
|
||||
// ─── Check 5: config.json valid JSON + valid schema ───────────────────────
|
||||
if (!fs.existsSync(configPath)) {
|
||||
addIssue('warning', 'W003', 'config.json not found', 'Run /gsd:health --repair to create with defaults', true);
|
||||
addIssue('warning', 'W003', 'config.json not found', 'Run /gsd-health --repair to create with defaults', true);
|
||||
repairs.push('createConfig');
|
||||
} else {
|
||||
try {
|
||||
@@ -635,7 +635,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
addIssue('warning', 'W004', `config.json: invalid model_profile "${parsed.model_profile}"`, `Valid values: ${validProfiles.join(', ')}`);
|
||||
}
|
||||
} catch (err) {
|
||||
addIssue('error', 'E005', `config.json: JSON parse error - ${err.message}`, 'Run /gsd:health --repair to reset to defaults', true);
|
||||
addIssue('error', 'E005', `config.json: JSON parse error - ${err.message}`, 'Run /gsd-health --repair to reset to defaults', true);
|
||||
repairs.push('resetConfig');
|
||||
}
|
||||
}
|
||||
@@ -646,7 +646,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
const configRaw = fs.readFileSync(configPath, 'utf-8');
|
||||
const configParsed = JSON.parse(configRaw);
|
||||
if (configParsed.workflow && configParsed.workflow.nyquist_validation === undefined) {
|
||||
addIssue('warning', 'W008', 'config.json: workflow.nyquist_validation absent (defaults to enabled but agents may skip)', 'Run /gsd:health --repair to add key', true);
|
||||
addIssue('warning', 'W008', 'config.json: workflow.nyquist_validation absent (defaults to enabled but agents may skip)', 'Run /gsd-health --repair to add key', true);
|
||||
if (!repairs.includes('addNyquistKey')) repairs.push('addNyquistKey');
|
||||
}
|
||||
} catch { /* intentionally empty */ }
|
||||
@@ -693,7 +693,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
const researchFile = phaseFiles.find(f => f.endsWith('-RESEARCH.md'));
|
||||
const researchContent = fs.readFileSync(path.join(phasesDir, e.name, researchFile), 'utf-8');
|
||||
if (researchContent.includes('## Validation Architecture')) {
|
||||
addIssue('warning', 'W009', `Phase ${e.name}: has Validation Architecture in RESEARCH.md but no VALIDATION.md`, 'Re-run /gsd:plan-phase with --research to regenerate');
|
||||
addIssue('warning', 'W009', `Phase ${e.name}: has Validation Architecture in RESEARCH.md but no VALIDATION.md`, 'Re-run /gsd-plan-phase with --research to regenerate');
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -869,7 +869,7 @@ function cmdValidateHealth(cwd, options, raw) {
|
||||
stateContent += `**Current phase:** (determining...)\n`;
|
||||
stateContent += `**Status:** Resuming\n\n`;
|
||||
stateContent += `## Session Log\n\n`;
|
||||
stateContent += `- ${new Date().toISOString().split('T')[0]}: STATE.md regenerated by /gsd:health --repair\n`;
|
||||
stateContent += `- ${new Date().toISOString().split('T')[0]}: STATE.md regenerated by /gsd-health --repair\n`;
|
||||
writeStateMd(statePath, stateContent, cwd);
|
||||
repairActions.push({ action: repair, success: true, path: 'STATE.md' });
|
||||
break;
|
||||
|
||||
@@ -78,7 +78,7 @@ function cmdWorkstreamCreate(cwd, name, options, raw) {
|
||||
|
||||
const baseDir = planningRoot(cwd);
|
||||
if (!fs.existsSync(baseDir)) {
|
||||
error('.planning/ directory not found — run /gsd:new-project first');
|
||||
error('.planning/ directory not found — run /gsd-new-project first');
|
||||
}
|
||||
|
||||
const wsRoot = path.join(baseDir, 'workstreams');
|
||||
|
||||
@@ -46,13 +46,13 @@ Standard format for presenting next steps after completing a command or workflow
|
||||
|
||||
`/clear` then:
|
||||
|
||||
`/gsd:execute-phase 2`
|
||||
`/gsd-execute-phase 2`
|
||||
|
||||
---
|
||||
|
||||
**Also available:**
|
||||
- Review plan before executing
|
||||
- `/gsd:list-phase-assumptions 2` — check assumptions
|
||||
- `/gsd-list-phase-assumptions 2` — check assumptions
|
||||
|
||||
---
|
||||
```
|
||||
@@ -71,7 +71,7 @@ Add note that this is the last plan and what comes after:
|
||||
|
||||
`/clear` then:
|
||||
|
||||
`/gsd:execute-phase 2`
|
||||
`/gsd-execute-phase 2`
|
||||
|
||||
---
|
||||
|
||||
@@ -93,13 +93,13 @@ Add note that this is the last plan and what comes after:
|
||||
|
||||
`/clear` then:
|
||||
|
||||
`/gsd:plan-phase 2`
|
||||
`/gsd-plan-phase 2`
|
||||
|
||||
---
|
||||
|
||||
**Also available:**
|
||||
- `/gsd:discuss-phase 2` — gather context first
|
||||
- `/gsd:research-phase 2` — investigate unknowns
|
||||
- `/gsd-discuss-phase 2` — gather context first
|
||||
- `/gsd-research-phase 2` — investigate unknowns
|
||||
- Review roadmap
|
||||
|
||||
---
|
||||
@@ -122,13 +122,13 @@ Show completion status before next action:
|
||||
|
||||
`/clear` then:
|
||||
|
||||
`/gsd:plan-phase 3`
|
||||
`/gsd-plan-phase 3`
|
||||
|
||||
---
|
||||
|
||||
**Also available:**
|
||||
- `/gsd:discuss-phase 3` — gather context first
|
||||
- `/gsd:research-phase 3` — investigate unknowns
|
||||
- `/gsd-discuss-phase 3` — gather context first
|
||||
- `/gsd-research-phase 3` — investigate unknowns
|
||||
- Review what Phase 2 built
|
||||
|
||||
---
|
||||
@@ -147,11 +147,11 @@ When there's no clear primary action:
|
||||
|
||||
`/clear` then one of:
|
||||
|
||||
**To plan directly:** `/gsd:plan-phase 3`
|
||||
**To plan directly:** `/gsd-plan-phase 3`
|
||||
|
||||
**To discuss context first:** `/gsd:discuss-phase 3`
|
||||
**To discuss context first:** `/gsd-discuss-phase 3`
|
||||
|
||||
**To research unknowns:** `/gsd:research-phase 3`
|
||||
**To research unknowns:** `/gsd-research-phase 3`
|
||||
|
||||
---
|
||||
```
|
||||
@@ -171,7 +171,7 @@ All 4 phases shipped
|
||||
|
||||
`/clear` then:
|
||||
|
||||
`/gsd:new-milestone`
|
||||
`/gsd-new-milestone`
|
||||
|
||||
---
|
||||
```
|
||||
@@ -214,7 +214,7 @@ Extract: `**02-03: Refresh Token Rotation** — Add /api/auth/refresh with slidi
|
||||
## To Continue
|
||||
|
||||
Run `/clear`, then paste:
|
||||
/gsd:execute-phase 2
|
||||
/gsd-execute-phase 2
|
||||
```
|
||||
|
||||
User has no idea what 02-03 is about.
|
||||
@@ -222,7 +222,7 @@ User has no idea what 02-03 is about.
|
||||
### Don't: Missing /clear explanation
|
||||
|
||||
```
|
||||
`/gsd:plan-phase 3`
|
||||
`/gsd-plan-phase 3`
|
||||
|
||||
Run /clear first.
|
||||
```
|
||||
@@ -242,7 +242,7 @@ Sounds like an afterthought. Use "Also available:" instead.
|
||||
|
||||
```
|
||||
```
|
||||
/gsd:plan-phase 3
|
||||
/gsd-plan-phase 3
|
||||
```
|
||||
```
|
||||
|
||||
|
||||
@@ -274,7 +274,7 @@ Set `commit_docs: false` so planning docs stay local and are not committed to an
|
||||
|
||||
### How It Works
|
||||
|
||||
1. **Auto-detection:** During `/gsd:new-project`, directories with their own `.git` folder are detected and offered for selection as sub-repos. On subsequent runs, `loadConfig` auto-syncs the `sub_repos` list with the filesystem — adding newly created repos and removing deleted ones. This means `config.json` may be rewritten automatically when repos change on disk.
|
||||
1. **Auto-detection:** During `/gsd-new-project`, directories with their own `.git` folder are detected and offered for selection as sub-repos. On subsequent runs, `loadConfig` auto-syncs the `sub_repos` list with the filesystem — adding newly created repos and removing deleted ones. This means `config.json` may be rewritten automatically when repos change on disk.
|
||||
2. **File grouping:** Code files are grouped by their sub-repo prefix (e.g., `backend/src/api/users.ts` belongs to the `backend/` repo).
|
||||
3. **Independent commits:** Each sub-repo receives its own atomic commit via `gsd-tools.cjs commit-to-subrepo`. File paths are made relative to the sub-repo root before staging.
|
||||
4. **Planning stays local:** The `.planning/` directory is not committed; it acts as cross-repo coordination.
|
||||
|
||||
@@ -69,7 +69,7 @@ If you're using Claude Code with OpenRouter, a local model, or any non-Anthropic
|
||||
|
||||
```bash
|
||||
# Via settings command
|
||||
/gsd:settings
|
||||
/gsd-settings
|
||||
# → Select "Inherit" for model profile
|
||||
|
||||
# Or manually in .planning/config.json
|
||||
@@ -109,7 +109,7 @@ Overrides take precedence over the profile. Valid values: `opus`, `sonnet`, `hai
|
||||
|
||||
## Switching Profiles
|
||||
|
||||
Runtime: `/gsd:set-profile <profile>`
|
||||
Runtime: `/gsd-set-profile <profile>`
|
||||
|
||||
Per-project default: Set in `.planning/config.json`:
|
||||
```json
|
||||
|
||||
@@ -115,8 +115,8 @@ Always at end of major completions.
|
||||
───────────────────────────────────────────────────────────────
|
||||
|
||||
**Also available:**
|
||||
- `/gsd:alternative-1` — description
|
||||
- `/gsd:alternative-2` — description
|
||||
- `/gsd-alternative-1` — description
|
||||
- `/gsd-alternative-2` — description
|
||||
|
||||
───────────────────────────────────────────────────────────────
|
||||
```
|
||||
|
||||
@@ -99,7 +99,7 @@ files_changed: []
|
||||
|
||||
<lifecycle>
|
||||
|
||||
**Creation:** Immediately when /gsd:debug is called
|
||||
**Creation:** Immediately when /gsd-debug is called
|
||||
- Create file with trigger from user input
|
||||
- Set status to "gathering"
|
||||
- Current Focus: next_action = "gather symptoms"
|
||||
|
||||
@@ -106,7 +106,7 @@ blocked: [N]
|
||||
**Gaps:**
|
||||
- APPEND only when issue found (YAML format)
|
||||
- After diagnosis: fill `root_cause`, `artifacts`, `missing`, `debug_session`
|
||||
- This section feeds directly into /gsd:plan-phase --gaps
|
||||
- This section feeds directly into /gsd-plan-phase --gaps
|
||||
|
||||
</section_rules>
|
||||
|
||||
@@ -120,7 +120,7 @@ blocked: [N]
|
||||
4. UAT.md Gaps section updated with diagnosis:
|
||||
- Each gap gets `root_cause`, `artifacts`, `missing`, `debug_session` filled
|
||||
5. status → "diagnosed"
|
||||
6. Ready for /gsd:plan-phase --gaps with root causes
|
||||
6. Ready for /gsd-plan-phase --gaps with root causes
|
||||
|
||||
**After diagnosis:**
|
||||
```yaml
|
||||
@@ -144,7 +144,7 @@ blocked: [N]
|
||||
|
||||
<lifecycle>
|
||||
|
||||
**Creation:** When /gsd:verify-work starts new session
|
||||
**Creation:** When /gsd-verify-work starts new session
|
||||
- Extract tests from SUMMARY.md files
|
||||
- Set status to "testing"
|
||||
- Current Test points to test 1
|
||||
@@ -171,7 +171,7 @@ blocked: [N]
|
||||
- Present summary with outstanding items highlighted
|
||||
|
||||
**Resuming partial session:**
|
||||
- `/gsd:verify-work {phase}` picks up from first pending/blocked test
|
||||
- `/gsd-verify-work {phase}` picks up from first pending/blocked test
|
||||
- When all items resolved, status advances to "complete"
|
||||
|
||||
**Resume after /clear:**
|
||||
|
||||
@@ -29,7 +29,7 @@ created: {date}
|
||||
|
||||
- **After every task commit:** Run `{quick run command}`
|
||||
- **After every plan wave:** Run `{full suite command}`
|
||||
- **Before `/gsd:verify-work`:** Full suite must be green
|
||||
- **Before `/gsd-verify-work`:** Full suite must be green
|
||||
- **Max feedback latency:** {N} seconds
|
||||
|
||||
---
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user