3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
6.7 KiB
ワークストリームを使って複数の領域を並行して進める方法
目標: バックエンド API、フロントエンドダッシュボード、インフラなど、異なるマイルストーン領域を並行して作業する際に、各領域の計画状態が互いに干渉しないようにする。
前提条件: GSD Core プロジェクトが有効な状態（.planning/ROADMAP.md が存在する）であること。存在しない場合は、まず /gsd-new-project を実行してください。
ワークストリームとは
ワークストリームは、単一のコードベース内で独立した計画コンテキストを持つ仕組みです。各ワークストリームには専用の .planning/workstreams/<name>/ サブツリーが作成され、独立した STATE.md、ROADMAP.md、REQUIREMENTS.md、phases/ ディレクトリが含まれます。コードベース本体（ソースコード、git 履歴、ブランチ）はすべてのワークストリームで共有されます。
.planning/
├── PROJECT.md ← 共有
├── config.json ← 共有
├── codebase/ ← 共有
└── workstreams/
├── backend-api/
│ ├── STATE.md
│ ├── ROADMAP.md
│ ├── REQUIREMENTS.md
│ └── phases/
└── frontend-dash/
├── STATE.md
├── ROADMAP.md
├── REQUIREMENTS.md
└── phases/
ワークストリームがアクティブな間、すべての GSD コマンド（/gsd-progress、/gsd-discuss-phase、/gsd-plan-phase、/gsd-execute-phase）はそのワークストリームのディレクトリを読み書き対象とします。ワークストリームを切り替えると、ソースツリーに触れることなく、これらすべてのコマンドが別のサブツリーを対象とするようになります。
ワークストリームを作成する
/gsd-workstreams create backend-api
GSD は .planning/workstreams/backend-api/ 以下にワークストリームディレクトリを作成し、STATE.md と ROADMAP.md の雛形を生成します。ワークストリームは自動的にアクティブ化されません。明示的に切り替えを行う必要があります。
ワークストリームを一覧表示する
/gsd-workstreams list
すべてのワークストリームと、現在のセッションでアクティブなワークストリームを表示します。
ワークストリームに切り替える
/gsd-workstreams switch backend-api
これ以降、すべての GSD ワークフローコマンドは backend-api コンテキストで動作します。切り替えはセッションスコープで行われます。同じリポジトリで複数の Claude Code ターミナルが開いている場合、各セッションで異なるアクティブワークストリームを保持でき、互いに干渉しません。
切り替え後は、通常のフェーズワークフローを進めてください。
/gsd-discuss-phase 1
/gsd-plan-phase 1
/gsd-execute-phase 1
/gsd-verify-work 1
別の領域を作業する場合は、2 つ目のターミナルでワークストリームを切り替えます。
/gsd-workstreams switch frontend-dash
/gsd-discuss-phase 1
/gsd-plan-phase 1
すべてのワークストリームの進捗を確認する
/gsd-workstreams progress
すべてのワークストリームのフェーズ状態、現在位置、残作業をクロスワークストリームでまとめて表示します。切り替えなしで確認できます。
特定のワークストリームの詳細なステータスを確認する場合は：
/gsd-workstreams status backend-api
ワークストリームの作業を再開する
コンテキストリセットや新しいセッションの後に、作業位置を復元します。
/gsd-workstreams resume backend-api
このコマンドはワークストリームをアクティブ化し、最後の既知の位置を復元します。手動で切り替えてから /gsd-resume-work を実行するのと同等です。
完了したワークストリームをアーカイブする
ワークストリームのマイルストーン作業が完了したら：
/gsd-workstreams complete backend-api
GSD はワークストリームをアーカイブ済みとしてマークし、アクティブ一覧から除外します。計画成果物は監査目的のため .planning/workstreams/backend-api/ 以下に保持されます。
セッションのアクティブコンテキストを変更せずに特定のワークストリームにコマンドを実行する
セッションのアクティブコンテキストを変更せず、特定のワークストリームに対して 1 つのコマンドだけを実行したい場合は、--ws フラグを使用します。
/gsd-progress --ws frontend-dash
/gsd-plan-phase 2 --ws backend-api
--ws は解決順序で最高優先度を持ち、セッションスコープのポインタは変更しません。
ワークスペースではなくワークストリームを選ぶ場面
ワークストリームを選ぶべき場合：
- すべての作業が同一リポジトリ内にあり、同じ git 履歴を共有している
- API、UI、インフラなど異なる関心領域を並行して計画・議論したいが、各ワークストリームの
STATE.mdが互いに上書きされないようにしたい - 作成時にワークストリームごとの別ブランチが不要（各ワークストリームの実行中に通常どおりブランチを切ることは可能）
- 完全な git ワークツリーを作成するオーバーヘッドが、必要な分離に対して割に合わない
代わりにワークスペースを選ぶべき場合：
- 複数のリポジトリ（例：
hr-uiとZeymoAPI）にまたがって作業している - フィーチャーごとに独立した git ワークツリーやクローンが必要（独立したブランチ、ロックファイル、ビルド成果物）
- 各ワークスペースで
/gsd-new-projectを独立して実行し、メインリポジトリの.planning/のサブディレクトリではなく、完全に独立した.planning/ルートを持ちたい