---
name: codex-plan
description: コードベースを分析し、詳細な実装計画を plan.md に作成する。新機能実装前、改修前、codex-research 後、"codex-plan", "codexで計画作成", "plan.mdを作って", "実装計画を作って" で使う。
---

# Codex Plan Creation

実際のコードベースに基づいて `plan.md` を作成する。調査済みの場合は `research.md` を読み、計画に反映する。

## 手順

1. 対象プロジェクトと依頼内容を特定する。
2. 関連ファイルを読む。変更を提案する前に、既存の構造・命名・テスト方針を確認する。
3. `.local/issues/<番号>/research.md` やタスク配下の `research.md` があれば必ず読む。
4. 具体的な変更ファイル、実装順序、テスト方針を決める。
5. `plan.md` を作成する。issue 番号やタスク名が分かる場合は `.local/issues/<番号>/plan.md` を優先する。

## plan.md の要件

必ず含める:

- アプローチの説明
- 変更されるファイルパス
- 主要なコードスニペットまたは擬似コード
- 実装順序
- テスト・動作確認
- 考慮事項とトレードオフ

## 出力例

````markdown
# 実装計画: [機能名]

## 概要
[機能の説明と目的]

## アプローチ
[既存実装を踏まえた方針]

## 変更ファイル
- `path/to/file.ts` - 変更内容

## 実装詳細
### 1. [変更内容]
[説明]

```typescript
// 必要な場合だけコード例
```

## テスト
- 実行するテスト
- 手動確認

## 考慮事項
- リスク
- 代替案
````

## 原則

- 実装はまだ行わず、計画に集中する。
- 既存パターンを優先し、不要な抽象化を足さない。
- 不明点は「要確認」として残す。
- 計画は実行可能な粒度にする。