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>
120 lines
5.2 KiB
Markdown
120 lines
5.2 KiB
Markdown
# フェーズの実行方法
|
||
|
||
**目的:** プランニング済みのフェーズをウェーブベースの並列実行で処理し、各プランをアトミックな git コミットとしてランディングさせます。
|
||
|
||
**前提条件:** フェーズに少なくとも 1 つの `PLAN.md` ファイルがあること。プランニングがまだ完了していない場合は、先に `/gsd-plan-phase N` を実行してください — [フェーズのプランニング](plan-a-phase.md) を参照。
|
||
|
||
---
|
||
|
||
## フェーズ全体を実行する
|
||
|
||
```bash
|
||
/gsd-execute-phase 1
|
||
```
|
||
|
||
GSD はフェーズのプランファイルを読み込み、依存関係ウェーブにグループ化し、プランごとに新鮮なエグゼキュータエージェントを起動します。各エグゼキュータは次のウェーブが始まる前にアトミックにコミットします。
|
||
|
||
エージェントがディスパッチされる前に、GSD はウェーブテーブルを表示します:
|
||
|
||
```
|
||
## Execution Plan
|
||
|
||
Phase 1: Core middleware — 3 plans across 2 wave(s)
|
||
|
||
| Wave | Plans | What it builds |
|
||
|------|----------------|---------------------------|
|
||
| 1 | 01-01, 01-02 | Core validation function |
|
||
| 2 | 01-03 | Express middleware wrapper |
|
||
```
|
||
|
||
ウェーブ 1 のプランは並列実行されます（それぞれ独立した git ワークツリーで）。ウェーブ 2 はウェーブ 1 のすべてのコミットがマージされるまで待機します。
|
||
|
||
基礎となるエージェント調整モデルについては [マルチエージェントオーケストレーション](../explanation/multi-agent-orchestration.md) を参照してください。
|
||
|
||
---
|
||
|
||
## 単一ウェーブのみ実行する
|
||
|
||
ウェーブ 1 の出力を確認してからウェーブ 2 に進むなど、1 つのウェーブのみを実行したい場合は `--wave N` を使用します:
|
||
|
||
```bash
|
||
/gsd-execute-phase 1 --wave 2
|
||
```
|
||
|
||
GSD はウェーブ 2 のプランのみを実行します。実行前に前のウェーブがすべて完了しているか確認します。ウェーブ 1 のプランがまだ未完了の場合は、先に前のウェーブを完了するよう指示して停止します。
|
||
|
||
---
|
||
|
||
## 実行前に状態を検証する
|
||
|
||
クラッシュや前の実行の中断後など、`.planning/` ディレクトリがファイルシステムと同期がとれていない可能性がある場合は `--validate` を指定します:
|
||
|
||
```bash
|
||
/gsd-execute-phase 1 --validate
|
||
```
|
||
|
||
GSD はエグゼキュータを起動する前に状態の一貫性チェックを実行します。検出されたずれを報告し、続行前に受け入れるか修正するかを選択できます。
|
||
|
||
---
|
||
|
||
## 停止した実行を再開する
|
||
|
||
クォータエラー、ネットワーク切断、セッションのクラッシュなどで実行が途中停止した場合、ウェーブレベルの進捗は保持されています。GSD は各プランの `SUMMARY.md` ファイルを確認し、すでに存在するプランは再実行時に自動的にスキップされます:
|
||
|
||
```bash
|
||
/gsd-execute-phase 1
|
||
```
|
||
|
||
GSD は `SUMMARY.md` がすでに存在するプランをスキップし、最初の未完了プランから再開します。
|
||
|
||
**コミットは存在するが `SUMMARY.md` がない場合**（エグゼキュータはコミットしたが、セッションが終了する前にサマリーを書き込まなかった）、GSD はセーフ再開ゲートを表示し、3 つの選択肢を提示します:
|
||
|
||
- `close out manually` — コミットを確認し、`SUMMARY.md` を書き込んで再実行する
|
||
- `re-execute from scratch` — 部分的なコミットを差し戻すか上書きしてから新しいエグゼキュータをディスパッチする
|
||
- `mark-and-skip` — 異常を記録して次に進む（明示的な確認が必要）
|
||
|
||
体系的な障害診断については [実行失敗のデバッグ](debug-a-failed-execution.md) を参照してください。
|
||
|
||
---
|
||
|
||
## 出力の場所
|
||
|
||
すべてのウェーブが完了すると、フェーズディレクトリには以下が含まれます:
|
||
|
||
```
|
||
.planning/phases/01-<name>/
|
||
01-01-SUMMARY.md # プラン 01 が構築したもの、主要ファイル、逸脱
|
||
01-02-SUMMARY.md
|
||
01-03-SUMMARY.md
|
||
VERIFICATION.md # 要件ごとの合格/不合格状態
|
||
```
|
||
|
||
`STATE.md` と `ROADMAP.md` はすべてのウェーブが完了すると自動的に更新されます。`VERIFICATION.md` はフェーズが完全に完了した時のみ書き込まれます。
|
||
|
||
Git の履歴には、各エグゼキュータからのタスクごとのコミットと、オーケストレータからのトラッキングコミットが表示されます。
|
||
|
||
---
|
||
|
||
## クロス AI 実行
|
||
|
||
`workflow.cross_ai_command` で設定された外部 AI CLI（Codex、Gemini など）に実行を委任するには:
|
||
|
||
```bash
|
||
/gsd-execute-phase 2 --cross-ai
|
||
```
|
||
|
||
設定でクロス AI が有効であってもローカル実行を強制するには:
|
||
|
||
```bash
|
||
/gsd-execute-phase 2 --no-cross-ai
|
||
```
|
||
|
||
---
|
||
|
||
## Related
|
||
|
||
- [フェーズのプランニング](plan-a-phase.md)
|
||
- [検証とシッピング](verify-and-ship.md)
|
||
- [実行失敗のデバッグ](debug-a-failed-execution.md)
|
||
- [コマンド](../COMMANDS.md)
|