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.6 KiB
ワークスペースで作業を分離する方法
目標: 独立した git ワークツリー、独自の .planning/ ルート、そして必要に応じて複数リポジトリを持つ、完全に分離された GSD 環境をフィーチャーブランチやマルチリポジトリ作業のために作成する。
前提条件: git がインストールされており、リポジトリがワークツリーをサポートしていること。マルチリポジトリのワークスペースの場合、対象リポジトリがローカルマシン上に存在するか、パスでアクセス可能であること。
ワークスペースとは
ワークスペースは、1 つ以上の git ワークツリー（またはクローン）と独自の .planning/ ルートディレクトリを組み合わせた、自己完結型の環境です。各ワークスペースには以下が含まれます。
- ソースリポジトリの
.planning/とは完全に独立した独自の.planning/ディレクトリ（サブディレクトリではない） - メンバーリポジトリを追跡する独自の
WORKSPACE.mdマニフェスト - 指定されたリポジトリの git ワークツリー（デフォルト）またはフルクローン（専用ブランチ
workspace/<name>でチェックアウト）
ワークスペースはデフォルトで ~/gsd-workspaces/<name>/ 以下に配置されます。
~/gsd-workspaces/
└── feature-b/
├── WORKSPACE.md ← マニフェスト
├── .planning/ ← 完全に独立した GSD 状態
│ ├── PROJECT.md
│ ├── ROADMAP.md
│ └── ...
├── hr-ui/ ← hr-ui リポジトリのワークツリーまたはクローン
└── ZeymoAPI/ ← ZeymoAPI リポジトリのワークツリーまたはクローン
ワークスペースの .planning/ はソースリポジトリとは独立しているため、ソースリポジトリ内に存在する計画状態との重複や競合は発生しません。
複数リポジトリのワークスペースを作成する
/gsd-workspace --new --name feature-b --repos hr-ui,ZeymoAPI
GSD は ~/gsd-workspaces/feature-b/ 内に hr-ui と ZeymoAPI のワークツリーを作成し、それぞれに workspace/feature-b ブランチをチェックアウトし、WORKSPACE.md を書き込み、/gsd-new-project に備えた空の .planning/ ディレクトリを作成します。
場所をカスタマイズするには：
/gsd-workspace --new --name feature-b --repos hr-ui,ZeymoAPI --path /projects/feature-b
現在のリポジトリのワークスペースを作成する
単一リポジトリでフィーチャーブランチの分離が必要な場合（独立したブランチ、独立した .planning/、main からの状態汚染なし）：
/gsd-workspace --new --name payments-rework --repos .
. は現在のリポジトリのワークツリーを作成するよう GSD に指示します。ワークツリーは workspace/payments-rework でチェックアウトされます。
ワークツリーの代わりにフルクローンを強制するには：
/gsd-workspace --new --name payments-rework --repos . --strategy clone
ブランチを明示的に指定する
/gsd-workspace --new --name payments-rework --repos . --branch feature/payments-v2
--branch フラグはワークスペース内のすべてのリポジトリのブランチ名を設定します。デフォルトは workspace/<name> です。
対話的な質問をスキップする
/gsd-workspace --new --name payments-rework --repos . --auto
GSD はプロンプトなしですべてのデフォルト値を適用します。
ワークスペース内で GSD を初期化する
ワークスペースを作成したら、その中に移動して GSD プロジェクトを初期化します。
cd ~/gsd-workspaces/feature-b
/gsd-new-project
ワークスペース内の .planning/ ディレクトリは、そのディレクトリから実行されるすべての GSD コマンドのルートとなります。ソースリポジトリ内に存在する .planning/ とは完全に独立しています。
ワークスペースを一覧表示する
/gsd-workspace --list
アクティブなすべての GSD ワークスペースとそのステータスを表示します。
ワークスペースを削除する
/gsd-workspace --remove feature-b
GSD は git ワークツリーを削除し、ワークスペースディレクトリをクリーンアップします。リモートのブランチは削除されません。ローカルのワークツリーとワークスペースディレクトリのみが対象です。
ワークストリームではなくワークスペースを選ぶ場面
ワークスペースを選ぶべき場合：
- 1 つの GSD プロジェクトとして連携させる必要がある複数のリポジトリ（例：一緒にリリースする API リポジトリと UI リポジトリ）にまたがって作業している
- フィーチャーごとに独自のブランチ、ロックファイル、ビルド成果物を持つ独立した git ワークツリーが必要（あるビルド環境での依存関係インストールが他に影響しない）
- メインリポジトリの
.planning/のサブディレクトリではなく、完全に独立した.planning/ルートが必要 - 各トラッカーイシューをワークスペースにマッピングするイシュー駆動ワークフローを採用している（トラッカーイシューから GSD を操作するを参照）
代わりにワークストリームを選ぶべき場合：
- すべての作業が1 つのリポジトリ内にあり、同じ git 履歴を共有している
- API、UI、インフラなどの異なる関心領域で
/gsd-plan-phaseや/gsd-discuss-phaseを並行して実行したいが、各領域のSTATE.mdファイル間でのコンテキスト汚染を避けたい - 関心領域ごとに別のワークツリーは不要で、計画コンテキストの切り替えで十分