docs: update localized documentation for v1.32.0 release

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Tom Boucher
2026-04-04 08:45:55 -04:00
parent acf82440e5
commit f6eda30b19
20 changed files with 1283 additions and 20 deletions

View File

@@ -1,6 +1,6 @@
# GSD エージェントリファレンス
> 全18種の専門エージェント — 役割、ツール、スポーンパターン、相互関係。アーキテクチャの詳細は[アーキテクチャ](ARCHITECTURE.md)を参照してください。
> 全18種の専門エージェント(v1.32 現在) — 役割、ツール、スポーンパターン、相互関係。アーキテクチャの詳細は[アーキテクチャ](ARCHITECTURE.md)を参照してください。
---

View File

@@ -21,7 +21,7 @@
## システム概要
GSDは、ユーザーとAIコーディングエージェント(Claude Code、Gemini CLI、OpenCode、Kilo、Codex、Copilot、Antigravity)の間に位置する**メタプロンプティングフレームワーク**です。以下の機能を提供します:
GSDは、ユーザーとAIコーディングエージェント(Claude Code、Gemini CLI、OpenCode、Kilo、Codex、Copilot、Antigravity、Trae、Cline、Augment Code)の間に位置する**メタプロンプティングフレームワーク**です。以下の機能を提供します:
1. **コンテキストエンジニアリング** — タスクごとにAIが必要とするすべてを提供する構造化アーティファクト
2. **マルチエージェントオーケストレーション** — 専門エージェントをフレッシュなコンテキストウィンドウで起動する軽量オーケストレーター

View File

@@ -101,6 +101,8 @@
| `--auto` | すべての質問で推奨デフォルトを自動選択 |
| `--batch` | 質問を一つずつではなくバッチ取り込みでグループ化 |
| `--analyze` | ディスカッション中にトレードオフ分析を追加 |
| `--chain` | discuss → plan → execute を1つのフローで自動チェーン (v1.31) |
| `--power` | 準備済み回答ファイルから一括入力で質問に回答 (v1.32) |
**前提条件:** `.planning/ROADMAP.md` が存在すること
**生成物:** `{phase}-CONTEXT.md`、`{phase}-DISCUSSION-LOG.md`(監査証跡)
@@ -482,7 +484,21 @@
- 1つのターミナルから複数フェーズの作業を並列化するパワーユーザー向け
```bash
/gsd-manager # コマンドセンターダッシュボードを開く
/gsd-manager # コ<EFBFBD><EFBFBD>ンドセンターダッシュボードを開く
```
---
### `/gsd-analyze-dependencies`
フェーズ依存関係を検出し、ROADMAP.md に `Depends on` エントリを提案します。(v1.32)
**前提<E5898D><E68F90><EFBFBD>件:** `.planning/ROADMAP.md` が存在すること
**検出方法:** ファイルオーバーラップ、セマンティック依存関係(API/スキーマのプロデューサーとコンシューマー)、データフロー依存関係
**動作:** 依存関係提案テーブルを表示し、ユーザー確認後に ROADMAP.md の `Depends on` フィールドを更新します。
```bash
/gsd-analyze-dependencies # 依存関係の分析と提案
```
---
@@ -525,10 +541,16 @@ GSDの保証付きでアドホックタスクを実行します。
| フラグ | 説明 |
|------|-------------|
| `--from N` | 特定のフェーズ番号から開始 |
| `--to N` | フェーズ N 完了後に自律実行を停止 (v1.32) |
| `--only N` | 指定された単一フェーズのみを自律的に実行 (v1.31) |
| `--interactive` | 各フェーズのディスカスステップでユーザー確認を要求 |
```bash
/gsd-autonomous # 残りの全フェーズを実行
/gsd-autonomous --from 3 # フェーズ3から開始
/gsd-autonomous --to 5 # フェーズ5まで実行
/gsd-autonomous --from 3 --to 5 # フェーズ3〜5の範囲を実行
/gsd-autonomous --only 4 # フェーズ4のみを自律実行
```
### `/gsd-do`
@@ -567,8 +589,13 @@ GSDの保証付きでアドホックタスクを実行します。
|----------|----------|-------------|
| `description` | いいえ | バグの説明 |
| フラグ | 説明 |
|------|-------------|
| `--diagnose` | 修正を試みず調査のみを行う診断専用モード (v1.32) |
```bash
/gsd-debug "Login button not responding on mobile Safari"
/gsd-debug --diagnose "API returning 500 on /users endpoint"
```
### `/gsd-add-todo`

View File

@@ -33,7 +33,8 @@ GSD はプロジェクト設定を `.planning/config.json` に保存します。
"research_before_questions": false,
"discuss_mode": "discuss",
"skip_discuss": false,
"text_mode": false
"text_mode": false,
"use_worktrees": true
},
"hooks": {
"context_warnings": true,
@@ -100,6 +101,7 @@ GSD はプロジェクト設定を `.planning/config.json` に保存します。
| `workflow.node_repair` | boolean | `true` | 検証失敗時にタスクを自律的に修復 |
| `workflow.node_repair_budget` | number | `2` | 失敗タスクあたりの最大修復試行回数 |
| `workflow.research_before_questions` | boolean | `false` | ディスカッション質問の後ではなく前にリサーチを実行 |
| `workflow.use_worktrees` | boolean | `true` | `false` の場合、git worktree 分離を無効化 (v1.31) |
| `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 で追加 |
@@ -228,7 +230,27 @@ quick タスクのブランチ設定例:
| 設定 | 型 | デフォルト | 説明 |
|------|-----|-----------|------|
| `safety.always_confirm_destructive` | boolean | `true` | 破壊的操作(削除、上書き)の確認 |
| `safety.always_confirm_external_services` | boolean | `true` | 外部サービスとのやり取りの確認 |
| `safety.always_confirm_external_services` | boolean | `true` | 外部サービ<EFBFBD><EFBFBD>とのやり取りの確認 |
---
## セキュリティ設定 (v1.31)
| 設定 | 型 | <20><>フォルト | 説明 |
|------|-----|-----------|------|
| `security_enforcement` | boolean | `true` | 脅威モデルセキュリティ検証を有効化 |
| `security_asvs_level` | number (1-3) | `1` | OWASP ASVS 検証レベル |
| `security_block_on` | string | `"high"` | フェーズ進行をブロックする最小重大度 |
---
## レスポンス言語設定 (v1.32)
| 設定 | 型 | デフォルト | 説明 |
|------|-----|-----------|------|
| `response_language` | string | (なし) | エージェントレスポンスの言語コード(例: `"pt"`、`"ko"`、`"ja"`) |
`response_language` が設定されると、すべてのフェーズおよびスポーンされたエージェントで一貫した言語出力が保証されます。
---
@@ -330,6 +352,7 @@ GSD が非 Claude ランタイム向けにインストールされると、イ
| `CLAUDE_CONFIG_DIR` | デフォルトの設定ディレクトリ(`~/.claude/`)をオーバーライド |
| `GEMINI_API_KEY` | コンテキストモニターがフックイベント名を切り替えるために検出 |
| `WSL_DISTRO_NAME` | インストーラーが WSL のパス処理のために検出 |
| `GSD_SKIP_SCHEMA_CHECK` | スキーマドリフト検出をバイパス (v1.31) |
---

View File

@@ -70,6 +70,40 @@
- [Assumptions ディスカッションモード](#53-assumptions-ディスカッションモード)
- [UI フェーズ自動検出](#54-ui-フェーズ自動検出)
- [マルチランタイムインストーラー選択](#55-マルチランタイムインストーラー選択)
- [v1.29 の機能](#v129-の機能)
- [Windsurf ランタイムサポート](#56-windsurf-ランタイムサポート)
- [国際化ドキュメント](#57-国際化ドキュメント)
- [v1.30 の機能](#v130-の機能)
- [GSD SDK](#58-gsd-sdk)
- [v1.31 の機能](#v131-の機能)
- [スキーマドリフト検出](#59-スキーマドリフト検出)
- [セキュリティエンフォースメント](#60-セキュリティエンフォースメント)
- [ドキュメント生成](#61-ドキュメント生成)
- [ディスカスチェーンモード](#62-ディスカスチェーンモード)
- [単一フェーズ自律モード](#63-単一フェーズ自律モード)
- [スコープ削減検出](#64-スコープ削減検出)
- [クレーム出所タグ付け](#65-クレーム出所タグ付け)
- [Worktree トグル](#66-worktree-トグル)
- [プロジェクトコードプレフィックス](#67-プロジェクトコードプレフィックス)
- [Claude Code スキルマイグレーション](#68-claude-code-スキルマイグレーション)
- [v1.32 の機能](#v132-の機能)
- [STATE.md 整合性ゲート](#69-statemd-整合性ゲート)
- [自律モード `--to N` フラグ](#70-自律モード---to-n-フラグ)
- [リサーチゲート](#71-リサーチゲート)
- [ベリファイヤーマイルストーンスコープフィルタリング](#72-ベリファイヤーマイルストーンスコープフィルタリング)
- [Read-Before-Edit ガードフック](#73-read-before-edit-ガードフック)
- [コンテキスト削減](#74-コンテキスト削減)
- [ディスカスフェーズ `--power` フラグ](#75-ディスカスフェーズ---power-フラグ)
- [デバッグ `--diagnose` フラグ](#76-デバッグ---diagnose-フラグ)
- [フェーズ依存関係分析](#77-フェーズ依存関係分析)
- [アンチパターン重大度レベル](#78-アンチパターン重大度レベル)
- [メソドロジーアーティファクトタイプ](#79-メソドロジーアーティファクトタイプ)
- [プランナー到達可能性チェック](#80-プランナー到達可能性チェック)
- [Playwright-MCP UI 検証](#81-playwright-mcp-ui-検証)
- [Pause-Work 拡張](#82-pause-work-拡張)
- [レスポンス言語設定](#83-レスポンス言語設定)
- [手動アップデート手順](#84-手動アップデート手順)
- [新規ランタイムサポート (Trae, Cline, Augment Code)](#85-新規ランタイムサポート-trae-cline-augment-code)
---
@@ -1288,3 +1322,522 @@ Claude が GSD ワークフローコンテキスト外でファイル編集を
1. **検出** — システム上で利用可能な AI CLI ランタイムを特定
2. **プロンプト** — ランタイム選択のためのマルチセレクトインターフェースを提示
3. **インストール** — 1回のセッションで選択されたすべてのランタイムに対して GSD を設定
---
## v1.29 の機能
### 56. Windsurf ランタイムサポート
**対象:** `npx get-shit-done-cc`
**目的:** Windsurf AI IDE のサポートを追加します。
**要件:**
- REQ-WINDSURF-01: インストーラーは `--windsurf` フラグによる Windsurf インストールをサポートしなければならない
- REQ-WINDSURF-02: Windsurf ルール形式に対応したプロンプトファイルを生成しなければならない
**プロセス:**
1. **検出** — Windsurf のインストール状態を確認
2. **変換** — GSD プロンプトを Windsurf ルール形式に変換
3. **インストール** — Windsurf 設定ディレクトリに GSD を設定
---
### 57. 国際化ドキュメント
**対象:** `docs/` ディレクトリ
**目的:** GSD ドキュメントをポルトガル語、韓国語、日本語で提供します。
**要件:**
- REQ-I18N-01: ドキュメントはポルトガル語(pt)、韓国語(ko)、日本語(ja)で提供されなければならない
- REQ-I18N-02: 翻訳は英語のソースドキュメントと同期を維持しなければならない
**プロセス:**
1. **翻訳** — コアドキュメントを対象言語に変換
2. **公開** — 翻訳されたドキュメントを英語版と並んでアクセス可能にする
---
## v1.30 の機能
### 58. GSD SDK
**コマンド:** プログラマティック API(ヘッドレス)
**目的:** CLI セッションなしでプログラムから GSD ワークフローを実行するためのヘッドレス TypeScript SDK。
**要件:**
- REQ-SDK-01: SDK は GSD ワークフロー操作を TypeScript 関数として公開しなければならない
- REQ-SDK-02: SDK はインタラクティブプロンプトなしのヘッドレス実行をサポートしなければならない
- REQ-SDK-03: SDK は CLI 駆動ワークフローと同一のアーティファクトを生成しなければならない
**プロセス:**
1. **インポート** — GSD SDK を TypeScript/JavaScript プロジェクトにインポート
2. **設定** — プロジェクトパスとワークフローオプションをプログラムから設定
3. **実行** — API コールで GSD フェーズ(discuss、plan、execute)を実行
---
## v1.31 の機能
### 59. スキーマドリフト検出
**コマンド:** `/gsd-execute-phase` 実行時に自動
**目的:** ORM スキーマファイルが対応するマイグレーションまたは push コマンドなしに変更された場合を検出し、誤検知の検証を防止します。
**要件:**
- REQ-SCHEMA-01: システムは ORM スキーマファイル(Prisma、Drizzle、Payload、Sanity、Mongoose)の変更を検出しなければならない
- REQ-SCHEMA-02: スキーマ変更が検出された場合、対応するマイグレーション/push コマンドの存在を確認しなければならない
- REQ-SCHEMA-03: 二層防御を実装しなければならない: 計画時注入と実行時ゲート
- REQ-SCHEMA-04: 検出をオーバーライドする `GSD_SKIP_SCHEMA_CHECK` 環境変数をサポートしなければならない
- REQ-SCHEMA-05: マイグレーションなしのスキーマ変更時に誤検知の検証を防止しなければならない
**プロセス:**
1. **検出** — 計画実行中の ORM スキーマファイルの変更を監視
2. **確認** — 計画に対応するマイグレーション/push コマンドが含まれていることを確認
3. **ゲート** — マイグレーションなしのスキーマドリフトが検出された場合、実行をブロック(実行時ゲート)
4. **注入** — 計画生成中にマイグレーションリマインダーを追加(計画時注入)
**設定:** `GSD_SKIP_SCHEMA_CHECK` 環境変数で検出をバイパス。
---
### 60. セキュリティエンフォースメント
**コマンド:** `/gsd-secure-phase <N>`
**目的:** フェーズ実装に対する脅威モデルアンカードのセキュリティ検証。
**要件:**
- REQ-SEC-01: システムは脅威モデルアンカードの検証(ブラインドスキャンではない)を実行しなければならない
- REQ-SEC-02: 設定可能な OWASP ASVS 検証レベル(1-3)をサポートしなければならない
- REQ-SEC-03: 設定可能な重大度しきい値に基づいてフェーズ進行をブロックしなければならない
- REQ-SEC-04: 分析のために `gsd-security-auditor` エージェントを起動しなければならない
**生成物:**
| 成果物 | 説明 |
|--------|------|
| セキュリティ監査レポート | 重大度分類付きの脅威モデルアンカードの発見事項 |
**プロセス:**
1. **モデル** — フェーズ実装コンテキストから脅威モデルを構築
2. **監査** — `gsd-security-auditor` を起動して脅威モデルに対して検証
3. **ゲート** — 発見事項が `security_block_on` 重大度以上の場合、フェーズ進行をブロック
**設定:**
| 設定 | 型 | デフォルト | 説明 |
|------|-----|-----------|------|
| `security_enforcement` | boolean | `true` | 脅威モデルセキュリティ検証を有効化 |
| `security_asvs_level` | number (1-3) | `1` | OWASP ASVS 検証レベル |
| `security_block_on` | string | `"high"` | フェーズ進行をブロックする最小重大度 |
---
### 61. ドキュメント生成
**コマンド:** `/gsd-docs-update`
**目的:** 正確性チェック付きのプロジェクトドキュメントを生成・検証します。
**要件:**
- REQ-DOCS-01: システムはドキュメント生成のために `gsd-doc-writer` エージェントを起動しなければならない
- REQ-DOCS-02: システムは正確性チェックのために `gsd-doc-verifier` エージェントを起動しなければならない
- REQ-DOCS-03: システムは生成されたドキュメントを実際の実装に対して検証しなければならない
**生成物:**
| 成果物 | 説明 |
|--------|------|
| 更新されたプロジェクトドキュメント | 生成および検証されたドキュメントファイル |
**プロセス:**
1. **生成** — `gsd-doc-writer` を起動して実装からドキュメントを作成・更新
2. **検証** — `gsd-doc-verifier` を起動してコードベースに対するドキュメント正確性をチェック
3. **出力** — 正確性アノテーション付きの検証済みドキュメントを生成
---
### 62. ディスカスチェーンモード
**フラグ:** `/gsd-discuss-phase <N> --chain`
**目的:** 手動のコマンド連続実行を削減するため、discuss、plan、execute フェーズを1つのフローで自動チェーンします。
**要件:**
- REQ-CHAIN-01: `--chain` フラグが提供された場合、システムは discuss → plan → execute を自動チェーンしなければならない
- REQ-CHAIN-02: チェーンされたフェーズ間のすべてのゲート設定を尊重しなければならない
- REQ-CHAIN-03: いずれかのフェーズが失敗した場合、チェーンを停止しなければならない
**プロセス:**
1. **ディスカス** — コンテキスト収集のためにディスカスフェーズを実行
2. **プラン** — 収集されたコンテキストでプランフェーズを自動的に呼び出し
3. **エクセキュート** — 生成されたプランでエクセキュートフェーズを自動的に呼び出し
---
### 63. 単一フェーズ自律モード
**フラグ:** `/gsd-autonomous --only N`
**目的:** 全残りフェーズではなく、1つのフェーズだけを自律的に実行します。
**要件:**
- REQ-ONLY-01: `--only N` が提供された場合、システムは指定されたフェーズ番号のみを実行しなければならない
- REQ-ONLY-02: フル自律モードと同じ discuss → plan → execute フローに従わなければならない
- REQ-ONLY-03: 指定されたフェーズが完了した後に停止しなければならない
**プロセス:**
1. **選択** — `--only N` 引数からターゲットフェーズを特定
2. **実行** — そのフェーズに対してフル自律フロー(discuss → plan → execute)を実行
3. **停止** — 次のフェーズに進まず、フェーズ完了後に停止
---
### 64. スコープ削減検出
**対象:** `/gsd-plan-phase`
**目的:** 三層防御により、計画生成中のサイレントな要件削除を防止します。
**要件:**
- REQ-SCOPE-01: プランナーは明示的な正当化なしにスコープを削減することを禁止されなければならない
- REQ-SCOPE-02: プランチェッカーは要件ディメンションカバレッジを検証しなければならない
- REQ-SCOPE-03: オーケストレーターは削除された要件を回復して再注入しなければならない
- REQ-SCOPE-04: 三層防御を実装しなければならない: プランナー禁止、チェッカーディメンション、オーケストレーター回復
**プロセス:**
1. **禁止** — プランナー指示でスコープ削減を明示的に禁止
2. **チェック** — プランチェッカーがすべてのフェーズ要件が計画でカバーされていることを確認
3. **回復** — オーケストレーターが削除された要件を検出してプランニングループに再注入
---
### 65. クレーム出所タグ付け
**対象:** `/gsd-research-phase`
**目的:** リサーチのクレームにソースエビデンスのタグを付け、仮定を別途記録します。
**要件:**
- REQ-PROVENANCE-01: リサーチャーはクレームにソースエビデンス参照をマークしなければならない
- REQ-PROVENANCE-02: 仮定はソース付きクレームとは別に記録されなければならない
- REQ-PROVENANCE-03: システムはエビデンス付き事実と推論された仮定を区別しなければならない
**プロセス:**
1. **リサーチ** — リサーチャーがコードベースとドメインソースから情報を収集
2. **タグ** — 各クレームにソース(ファイルパス、ドキュメント、API レスポンス)をアノテーション
3. **分離** — 直接的なエビデンスのない仮定を別セクションに記録
---
### 66. Worktree トグル
**設定:** `workflow.use_worktrees: false`
**目的:** 順次実行を好むユーザーのために git worktree 分離を無効化します。
**要件:**
- REQ-WORKTREE-01: システムは分離戦略を決定する際に `workflow.use_worktrees` 設定を尊重しなければならない
- REQ-WORKTREE-02: 後方互換性のためにデフォルトは `true`(worktree 有効)でなければならない
- REQ-WORKTREE-03: worktree が無効な場合、順次実行にフォールバックしなければならない
**設定:**
| 設定 | 型 | デフォルト | 説明 |
|------|-----|-----------|------|
| `workflow.use_worktrees` | boolean | `true` | `false` の場合、git worktree 分離を無効化 |
---
### 67. プロジェクトコードプレフィックス
**設定:** `project_code: "ABC"`
**目的:** マルチプロジェクトの曖昧さ解消のためにフェーズディレクトリ名にプロジェクトコードをプレフィックスします。
**要件:**
- REQ-PREFIX-01: 設定された場合、システムはフェーズディレクトリにプロジェクトコードをプレフィックスしなければならない(例: `ABC-01-setup/`)
- REQ-PREFIX-02: `project_code` が設定されていない場合、標準命名を使用しなければならない
- REQ-PREFIX-03: すべてのフェーズ操作で一貫してプレフィックスを適用しなければならない
**設定:**
| 設定 | 型 | デフォルト | 説明 |
|------|-----|-----------|------|
| `project_code` | string | (なし) | フェーズディレクトリ名のプレフィックス |
---
### 68. Claude Code スキルマイグレーション
**対象:** `npx get-shit-done-cc`
**目的:** GSD コマンドを Claude Code 2.1.88+ のスキル形式に後方互換性を維持してマイグレーションします。
**要件:**
- REQ-SKILLS-01: インストーラーは Claude Code 2.1.88+ 向けに `skills/gsd-*/SKILL.md` を書き込まなければならない
- REQ-SKILLS-02: インストーラーはレガシー `commands/gsd/` ディレクトリを自動クリーンしなければならない
- REQ-SKILLS-03: Gemini パスを通じて古い Claude Code バージョンとの後方互換性を維持しなければならない
**プロセス:**
1. **検出** — Claude Code のバージョンをチェックしてスキルサポートを判定
2. **マイグレーション** — 各 GSD コマンドに対して `skills/gsd-*/SKILL.md` ファイルを書き込み
3. **クリーン** — スキルがインストールされた場合、レガシー `commands/gsd/` ディレクトリを削除
4. **フォールバック** — 古い Claude Code バージョンのために Gemini パス互換性を維持
---
## v1.32 の機能
### 69. STATE.md 整合性ゲート
**コマンド:** `state validate`、`state sync [--verify]`、`state planned-phase --phase N --plans N`
**目的:** STATE.md と実際のファイルシステム間のドリフトを検出・修復し、古い状態からのカスケードエラーを防止します。
**要件:**
- REQ-STATE-01: `state validate` は STATE.md フィールドとファイルシステムの実態間のドリフトを検出しなければならない
- REQ-STATE-02: `state sync` はディスク上の実際のプロジェクト状態から STATE.md を再構築しなければならない
- REQ-STATE-03: `state sync --verify` は書き込みなしで提案される変更を表示するドライランを実行しなければならない
- REQ-STATE-04: `state planned-phase` はプランフェーズ完了後の状態遷移を記録しなければならない(Planned/Ready to execute)
**生成物:**
| 成果物 | 説明 |
|--------|------|
| 更新された `STATE.md` | ファイルシステムの実態を反映した修正済み状態 |
**プロセス:**
1. **検証** — STATE.md フィールドをファイルシステム(フェーズディレクトリ、計画ファイル、サマリー)と比較
2. **同期** — ドリフトが検出された場合、ディスクから STATE.md を再構築
3. **遷移** — エクセキュートフェーズの準備状態として計画数付きのポストプランニング状態を記録
---
### 70. 自律モード `--to N` フラグ
**フラグ:** `/gsd-autonomous --to N`
**目的:** 特定のフェーズ完了後に自律実行を停止し、部分的な自律実行を可能にします。
**要件:**
- REQ-TO-01: システムは指定されたフェーズ番号の完了後に実行を停止しなければならない
- REQ-TO-02: N までの各フェーズに対して同じ discuss → plan → execute フローに従わなければならない
- REQ-TO-03: `--to N` は境界付き自律範囲のために `--from N` と組み合わせ可能でなければならない
**プロセス:**
1. **境界設定** — `--to N` 引数から上限フェーズを設定
2. **実行** — フェーズ N まで(含む)の各フェーズに対して自律フローを実行
3. **停止** — フェーズ N の完了後に停止
---
### 71. リサーチゲート
**対象:** `/gsd-plan-phase`
**目的:** RESEARCH.md に未解決のオープンクエスチョンがある場合にプランニングをブロックし、不完全な情報に基づく計画を防止します。
**要件:**
- REQ-RESGATE-01: プランニング開始前に RESEARCH.md の未解決オープンクエスチョンをスキャンしなければならない
- REQ-RESGATE-02: オープンクエスチョンが存在する場合、プランフェーズのエントリをブロックしなければならない
- REQ-RESGATE-03: 具体的な未解決クエスチョンをユーザーに表示しなければならない
**プロセス:**
1. **スキャン** — RESEARCH.md のオープンクエスチョンセクションで未解決項目をチェック
2. **ゲート** — 未解決クエスチョンが見つかった場合、プランニングをブロック
3. **表示** — 解決が必要な具体的なオープンクエスチョンを表示
---
### 72. ベリファイヤーマイルストーンスコープフィルタリング
**対象:** `/gsd-execute-phase`(ベリファイヤーステップ)
**目的:** 真のギャップと後続フェーズに延期された項目を区別し、検証の偽陰性を削減します。
**要件:**
- REQ-VSCOPE-01: ベリファイヤーはギャップが後続マイルストーンフェーズで対処されるかチェックしなければならない
- REQ-VSCOPE-02: 後続フェーズで対処されるギャップは「ギャップ」ではなく「延期」とマークされなければならない
- REQ-VSCOPE-03: 真のギャップ(将来のフェーズでもカバーされない)のみが失敗として報告されなければならない
**プロセス:**
1. **検証** — 標準的なゴール逆行検証を実行
2. **フィルター** — 検出されたギャップを後続マイルストーンフェーズとクロスリファレンス
3. **分類** — 延期された項目を真のギャップとは別にマーク
---
### 73. Read-Before-Edit ガードフック
**対象:** フック(`PreToolUse`)
**目的:** ファイルが編集前に読み込まれることを確認し、非 Claude ランタイムでの無限リトライループを防止します。
**要件:**
- REQ-RBE-01: フックはセッションで以前に読み込まれていないファイルを対象とする Edit/Write ツールコールを検出しなければならない
- REQ-RBE-02: フックはまずファイルを読み込むよう勧告しなければならない(勧告的、非ブロッキング)
- REQ-RBE-03: フックは組み込みの read-before-edit 強制のないランタイムで一般的な無限リトライループを防止しなければならない
---
### 74. コンテキスト削減
**対象:** GSD SDK プロンプトアセンブリ
**目的:** Markdown 切り詰めとキャッシュフレンドリーなプロンプト順序により、コンテキストプロンプトサイズを削減します。
**要件:**
- REQ-CTXRED-01: システムはコンテキスト予算内に収まるよう、大きすぎる Markdown アーティファクトを切り詰めなければならない
- REQ-CTXRED-02: キャッシュフレンドリーなアセンブリのためにプロンプトを順序付けなければならない(安定したプレフィックスを先頭に)
- REQ-CTXRED-03: 削減は必須情報(見出し、要件、タスク構造)を保持しなければならない
**プロセス:**
1. **計測** — ワークフローの総プロンプトサイズを計算
2. **切り詰め** — 大きすぎるアーティファクトに Markdown 対応の切り詰めを適用
3. **順序付け** — KV キャッシュ再利用の最適化のためにプロンプトセクションを配置
---
### 75. ディスカスフェーズ `--power` フラグ
**フラグ:** `/gsd-discuss-phase --power`
**目的:** ディスカスフェーズのファイルベースの一括質問回答で、準備済み回答ファイルからのバッチ入力を可能にします。
**要件:**
- REQ-POWER-01: システムはディスカッション質問への事前記述済み回答を含むファイルを受け付けなければならない
- REQ-POWER-02: システムは回答を対応するグレーエリア質問にマッピングしなければならない
- REQ-POWER-03: システムはインタラクティブなディスカスフェーズと同一の CONTEXT.md を生成しなければならない
---
### 76. デバッグ `--diagnose` フラグ
**フラグ:** `/gsd-debug --diagnose`
**目的:** 修正を試みず調査のみを行う診断専用モード。
**要件:**
- REQ-DIAG-01: システムは完全なデバッグ調査(仮説、エビデンス、根本原因)を実行しなければならない
- REQ-DIAG-02: システムはコード変更を一切行ってはならない
- REQ-DIAG-03: システムは発見事項と推奨修正を含む診断レポートを生成しなければならない
---
### 77. フェーズ依存関係分析
**コマンド:** `/gsd-analyze-dependencies`
**目的:** フェーズ依存関係を検出し、`/gsd-manager` 実行前に ROADMAP.md への `Depends on` エントリを提案します。
**要件:**
- REQ-DEP-01: システムはフェーズ間のファイルオーバーラップを検出しなければならない
- REQ-DEP-02: システムはセマンティック依存関係(API/スキーマのプロデューサーとコンシューマー)を検出しなければならない
- REQ-DEP-03: システムはデータフロー依存関係(出力プロデューサーとリーダー)を検出しなければならない
- REQ-DEP-04: システムは依存関係エントリを提案し、書き込み前にユーザー確認を要求しなければならない
**生成物:** 依存関係提案テーブル;オプションで ROADMAP.md の `Depends on` フィールドを更新
---
### 78. アンチパターン重大度レベル
**対象:** `/gsd-resume-work`
**目的:** 重大度ベースのアンチパターン強制によるリジューム時の必須理解チェック。
**要件:**
- REQ-ANTI-01: システムはアンチパターンを重大度レベルで分類しなければならない
- REQ-ANTI-02: システムはセッションリジューム時に必須の理解チェックを強制しなければならない
- REQ-ANTI-03: より高い重大度のアンチパターンは承認されるまでワークフロー進行をブロックしなければならない
---
### 79. メソドロジーアーティファクトタイプ
**対象:** プランニングアーティファクト
**目的:** メソドロジードキュメントの消費メカニズムを定義し、エージェントによって正しく消費されることを確保します。
**要件:**
- REQ-METHOD-01: システムはメソドロジーを独自のアーティファクトタイプとしてサポートしなければならない
- REQ-METHOD-02: メソドロジーアーティファクトはエージェント向けの定義された消費メカニズムを持たなければならない
---
### 80. プランナー到達可能性チェック
**対象:** `/gsd-plan-phase`
**目的:** 実行にコミットする前にプランステップが達成可能であることを検証します。
**要件:**
- REQ-REACH-01: プランナーは各プランステップが到達可能なファイルと API を参照していることを検証しなければならない
- REQ-REACH-02: 到達不可能なステップは実行中ではなくプランニング中にフラグ付けされなければならない
---
### 81. Playwright-MCP UI 検証
**対象:** `/gsd-verify-work`(オプション)
**目的:** ベリファイフェーズ中の Playwright-MCP を使用した自動ビジュアル検証。
**要件:**
- REQ-PLAY-01: システムはベリファイフェーズ中のオプションの Playwright-MCP ビジュアル検証をサポートしなければならない
- REQ-PLAY-02: ビジュアル検証はオプトインであり、必須であってはならない
- REQ-PLAY-03: システムは UI-SPEC.md の期待値に対してビジュアル状態をキャプチャ・比較しなければならない
---
### 82. Pause-Work 拡張
**対象:** `/gsd-pause-work`
**目的:** よりリッチなハンドオフデータで非フェーズコンテキストをサポートし、pause-work の適用範囲を拡大します。
**要件:**
- REQ-PAUSE-01: システムは非フェーズコンテキスト(クイックタスク、デバッグセッション、スレッド)でのポーズをサポートしなければならない
- REQ-PAUSE-02: ハンドオフデータは現在の作業タイプに適切なよりリッチなコンテキストを含まなければならない
---
### 83. レスポンス言語設定
**設定:** `response_language`
**目的:** 非英語ユーザーのためのクロスフェーズ言語一貫性。
**要件:**
- REQ-LANG-01: システムはすべてのフェーズとエージェントで `response_language` 設定を尊重しなければならない
- REQ-LANG-02: 設定はすべてのスポーンされたエージェントに伝播し、一貫した言語出力を確保しなければならない
**設定:**
| 設定 | 型 | デフォルト | 説明 |
|------|-----|-----------|------|
| `response_language` | string | (なし) | エージェントレスポンスの言語コード(例: `"pt"`、`"ko"`、`"ja"`) |
---
### 84. 手動アップデート手順
**対象:** `docs/manual-update.md`
**目的:** `npx` が利用不可または npm パブリッシュに障害が発生している環境のための手動アップデートパスを文書化します。
**要件:**
- REQ-MANUAL-01: ドキュメントはステップバイステップの手動アップデート手順を記述しなければならない
- REQ-MANUAL-02: 手順は npm アクセスなしで機能しなければならない
---
### 85. 新規ランタイムサポート (Trae, Cline, Augment Code)
**対象:** `npx get-shit-done-cc`
**目的:** Trae IDE、Cline、Augment Code ランタイムへの GSD インストールを拡張します。
**要件:**
- REQ-TRAE-01: インストーラーは Trae IDE インストールのための `--trae` フラグをサポートしなければならない
- REQ-CLINE-01: インストーラーは `.clinerules` 設定を通じて Cline をサポートしなければならない
- REQ-AUGMENT-01: インストーラーはスキル変換と設定管理で Augment Code をサポートしなければならない

View File

@@ -11,14 +11,14 @@ Get Shit Done(GSD)フレームワークの包括的なドキュメントで
| [コマンドリファレンス](COMMANDS.md) | 全ユーザー | 全コマンドの構文、フラグ、オプション、使用例 |
| [設定リファレンス](CONFIGURATION.md) | 全ユーザー | 設定スキーマ、ワークフロートグル、モデルプロファイル、Git ブランチ |
| [CLI ツールリファレンス](CLI-TOOLS.md) | コントリビューター、エージェント作成者 | `gsd-tools.cjs` のプログラマティック API(ワークフローおよびエージェント向け) |
| [エージェントリファレンス](AGENTS.md) | コントリビューター、上級ユーザー | 全15種の専門エージェント — 役割、ツール、スポーンパターン |
| [エージェントリファレンス](AGENTS.md) | コントリビューター、上級ユーザー | 全18種の専門エージェント — 役割、ツール、スポーンパターン |
| [ユーザーガイド](USER-GUIDE.md) | 全ユーザー | ワークフローのウォークスルー、トラブルシューティング、リカバリー |
| [コンテキストモニター](context-monitor.md) | 全ユーザー | コンテキストウィンドウ監視フックのアーキテクチャ |
| [ディスカスモード](workflow-discuss-mode.md) | 全ユーザー | discuss フェーズにおける assumptions モードと interview モード |
## クイックリンク
- **v1.28 の新機能:** フォレンジクス、マイルストーンサマリー、ワークストリーム、assumptions モード、UI 自動検出、マネージャーダッシュボード
- **v1.32 の新機能:** STATE.md 整合性ゲート、`--to N` 自律モード、リサーチゲート、ベリファイヤーマイルストーンスコープフィルタリング、read-before-edit ガード、コンテキスト削減、新規ランタイム(Trae, Cline, Augment Code)、レスポンス言語設定、`--power`/`--diagnose` フラグ、`/gsd-analyze-dependencies`
- **はじめに:** [README](../README.md) → インストール → `/gsd-new-project`
- **ワークフロー完全ガイド:** [ユーザーガイド](USER-GUIDE.md)
- **コマンド一覧:** [コマンドリファレンス](COMMANDS.md)