planner

プランナー

複数タスクのプロジェクト向けに、オーケストレーターが扱いやすい構造化された計画を作成します。

ソース：am-will の codex-skills ワークフローパターンをベースにしています
連携先：後続の実装には task-orchestrator スキルを使用します

---

クイックスタート

次の手順に従ってください。

1. フェーズ 0：要件を明確にする（的を絞った質問を最大 5 つ行います）
2. フェーズ 1：コードベースを調査し、理解する
3. フェーズ 2：スプリント、タスク、受け入れ基準を含む詳細な計画を作成する
4. フェーズ 3：サブエージェントが計画をレビューする
5. フェーズ 4：計画を Markdown 形式で提示し、ユーザーが永続化された成果物を求めた場合にのみファイルを保存する

---

主な原則

タスクの粒度

各タスクは次の条件を満たす必要があります。

• 独立してコミット可能 — 小さく、独立した作業であること
• 具体的で実行可能 — 曖昧でないこと
• テスト可能 — テストまたは検証方法を含めること
• 場所が明確 — ファイルパスとコードの位置を含めること

良くないタスク分割と良いタスク分割

❌ 良くない例：「サードパーティーのサインインを実装する」

✓ 良い例：

• 「環境変数にサインイン設定を追加する」
• 「必要な認証パッケージをインストールして設定する」
• 「src/routes/auth.ts にサインインのコールバックルートハンドラーを作成する」
• 「ログイン UI にサインインボタンを追加する」

スプリントの構成

各スプリントは次の条件を満たす必要があります。

• デモ可能、実行可能、テスト可能な成果を生み出す
• 前のスプリントの作業を土台にする
• 明確なデモ／検証チェックリストを含める

---

計画テンプレート

# Plan: [Task Name]

**Generated**: [Date]
**Estimated Complexity**: [Low/Medium/High]

## Overview
[Brief summary of what needs to be done and the general approach]

## Prerequisites
- [Dependencies or requirements that must be met first]
- [Tools, libraries, or access needed]
- [Tooling limitations, e.g., browser relay/CDP restrictions]

## Sprint 1: [Sprint Name]
**Goal**: [What this sprint accomplishes]
**Demo/Validation**:
- [How to run/demo this sprint's output]
- [What to verify]

### Task 1.1: [Task Name]
- **Location**: [File paths or components involved]
- **Description**: [What needs to be done]
- **Perceived Complexity**: [1-10]
- **Dependencies**: [Any previous tasks this depends on]
- **Acceptance Criteria**:
  - [Specific, testable criteria]
- **Validation**:
  - [Test(s) or alternate validation steps]

### Task 1.2: [Task Name]
[...]

## Sprint 2: [Sprint Name]
[...]

## Testing Strategy
- [How to test the implementation]
- [What to verify at each sprint]

## Potential Risks
- [Things that could go wrong]
- [Mitigation strategies]

## Rollback Plan
- [How to undo changes if needed]

---

引き継ぎ

計画の準備ができたら、parallel-task ワーカーに引き継ぎます。

Please run parallel-task.md against my-plan.md

または、次のように直接呼び出します。

「plan.md のブロックされていないすべてのタスクを、並列サブエージェントを使って実行してください。すべてのタスクが完了するまで繰り返してください。」

安全上の境界

• ユーザーが計画ファイルを求めた場合、または周囲のワークフローで永続化された成果物が明示的に必要な場合を除き、計画ファイルを保存しないでください。
• 競合について明記せずに、並列タスクに重複する書き込み範囲を割り当てないでください。
• リポジトリのコンテキストで裏付けられない依存関係、検証手順、完了状況を作り上げないでください。
• ユーザーが計画から実装に進むことを明示的に求めない限り、計画の依頼を実装作業に変えないでください。

---

関連項目

• parallel-task — このスキルが作成した計画を実行する並列タスクワーカー

am-will の codex-skills planner／parallel-task プロンプトをベースにしています。