Dev Cycle Orchestrator は何をしますか?
開発ライフサイクル全体を自動化:ブレインストーム → 計画 → レビュー → Issue → 実装 → コードレビュー → PR。
注意: ユーザーが PRD のみを希望する場合は /write-a-prd に、計画のみを希望する場合は /prd-to-plan にルーティングしてください。このスキルは完全なエンドツーエンドのライフサイクルを対象としています。
7 フェーズパイプライン
すべてのフェーズは必須です。スキップできるフェーズはありません。
| # | フェーズ | 委任先 | ゲート条件 |
|---|---|---|---|
| 1 | ブレインストーム | write-a-prd | Issue URL が記録されている |
| 2 | 計画 | prd-to-plan | docs/plans/ に計画ファイルが存在する |
| 3 | CEO レビュー | plan-ceo-review(スコープ抑制推奨) | レビュー完了、ユーザー承認 |
| 4 | Issue | オーケストレーター(計画をスライス → GitHub Issue) | 全 Issue URL が記録されている |
| 5 | 実装 | オーケストレーター(各 Issue に tdd、subagent-development) | 全 Issue 解決、テスト通過 |
| 6 | コードレビュー | daa-code-review | クリーンレビュー |
| 7 | PR | commit + github-cli | PR URL が記録されている |
再開ロジック
呼び出しごとに:
引数なし(/dev-cycle)
docs/dev-cycle/内の*.state.mdファイルでstatus: in_progressのものをスキャン- 1 つ見つかった場合 → 「{feature}(
{branch})を再開しますか?現在 {phase} です。」 - 複数見つかった場合 → ブランチ名とともに一覧表示、再開するものを選択
- 見つからなかった場合 → 「どの機能を開発していますか?」→ フェーズ 1 を開始
引数あり(/dev-cycle {slug})
docs/dev-cycle/{slug}.state.mdを検索- 見つかった場合 →
current_phaseから再開 - 見つからなかった場合 → 状態ファイルを作成、フェーズ 1 を開始
スラッグの衝突
新しい状態ファイルを作成する際、docs/dev-cycle/ 内で既存のスラッグを確認します。既に存在する場合(放棄または完了済み)、末尾に -2、-3 などを付与します。
再開時のコンテキスト読み込み
続行する前に、関連するすべてのアーティファクトを読み込みます:
- ブレインストーム:
gh issue viewで PRD Issue を表示 - 計画: ディスクから計画ファイルを読み込み
- CEO レビュー: 計画ファイルを読み込み(レビュー修正を含む)
- Issue: 各実装 Issue を
gh issue viewで表示 - 実装: フィーチャーブランチの git ステータスを確認、クローズ済み Issue を確認
サマリーを表示:"{feature} を {phase} から再開します。中断した箇所は..."
フェーズ実行
フェーズ 1: ブレインストーム
write-a-prd を呼び出します。スキルの内部フロー(インタビュー → PRD → GitHub Issue)を信頼します。Issue URL を状態ファイルに記録します。
フェーズ 2: 計画
PRD Issue URL を prd-to-plan に渡します。計画ファイルのパス(docs/plans/{feature}.md)を記録します。
フェーズ 3: CEO レビュー
計画ファイルのパスを plan-ceo-review に渡します。スコープ抑制モードを推奨しますが、スキル自身のモード選択(Step 0F)を優先します。レビュー完了、ユーザー承認を記録します。
フェーズ 4: Issue
オーケストレーターが所有します。 計画の垂直スライスを読み込みます。各スライスについて、gh issue create を使用して GitHub Issue を作成します:
- PRD Issue を参照
- 計画からの受け入れ基準を含む
- 依存関係順に作成
作成後、各 Issue URL を Issues テーブルに即座に記録します。部分完了からの回復については references/phase-transitions.md を参照してください。
フェーズ 5: 実装
オーケストレーターが所有します。 フィーチャーブランチ feat/{feature-slug} を作成します(ブランチ処理の詳細は references/phase-transitions.md を参照)。
各 GitHub Issue に対して 1 つのサブエージェントを subagent-development 手法に従って起動します:
- 各サブエージェントは
tddスキルを呼び出す - サブエージェントの各ディスパッチ間にコードレビューを実行
- 各サブエージェント完了後に状態ファイルを更新(バッチ処理しない)
サブエージェントごとのイベントをログに記録:
"サブエージェントが Issue #N: {title} に対して開始されました""サブエージェントが Issue #N に対して完了しました: {pass/fail}""Issue #N 後のコードレビュー: {clean/blocking issues found}"
フェーズ 6: コードレビュー
フィーチャーブランチ上のすべての変更ファイルに対して daa-code-review を呼び出します。ブロッキングな問題が見つかった場合 → 修正、再実行。クリーンになるまでループします。
計画の見直しが必要なアーキテクチャ上の問題がある場合 → フェーズ 2 への後方遷移をトリガーします。
フェーズ 7: PR
まずデフォルトブランチとの競合を確認します。commit を呼び出して conventional commit を行い、次に github-cli で PR を開きます。PR URL を記録し、status: completed を設定します。その後、アーカイブ手順を実行します(下記のアーカイブを参照)。
状態ファイル
各機能は docs/dev-cycle/{feature-slug}.state.md で追跡されます。完全な形式、フィールド定義、遷移ルールについては references/state-file-schema.md を参照してください。
失敗と回復
references/phase-transitions.md を参照:
- フェーズ再試行ロジック(ブロック → 次回呼び出しで再試行)
- 後方遷移(実装/コードレビュー → 計画)
- 機能の放棄。アーカイブされたファイルは
docs/archive/に移動されます。
ブランチ管理
- フェーズ 1–4: 現在のブランチで実行(ドキュメントのみ)
- フェーズ 5:
feat/{feature-slug}ブランチを作成 - フェーズ 7: デフォルトブランチへの PR(
gh repo view --json defaultBranchRefで検出) - フェーズ 5+ で再開: 既にフィーチャーブランチ上にいない場合、チェックアウト
アーカイブ
機能が終端状態(completed または abandoned)に達した場合、そのアーティファクトをアーカイブします:
- アーカイブディレクトリを作成:
mkdir -p docs/archive/dev-cycle docs/archive/plans - 状態ファイルを移動:
git mv docs/dev-cycle/{slug}.state.md docs/archive/dev-cycle/ - 計画ファイルを移動:アーティファクトテーブルから計画パスを読み取り、
git mv {plan_path} docs/archive/plans/ - 移動をコミット:メッセージ
chore(dev-cycle): archive {slug}
アーカイブは自動的に実行されます:
- フェーズ 7 の終了時(PR URL が記録され、ステータスが
completedに設定された後) - 機能放棄時(ステータスが
abandonedに設定された後)