feature-planning

機能の計画

機能リクエストを体系的に分析し、詳細で実行可能な実装計画を作成します。

使用するタイミング

• 新機能をリクエストされた場合（「ユーザー認証を追加」「ダッシュボードを作成」）
• 拡張を依頼された場合（「パフォーマンスを改善」「エクスポートを追加」）
• 複雑な複数ステップの変更について説明された場合
• 明示的に計画を依頼された場合（「X の実装方法を計画して」）
• 明確化が必要な曖昧な要件が提示された場合

計画のワークフロー

1. 要件を把握する

確認の質問をする：

• どのような問題を解決しますか？
• ユーザーは誰ですか？
• 具体的な技術上の制約はありますか？
• 成功とはどのような状態ですか？

コードベースを調査する： Task ツールで subagent_type='Explore' および thoroughness='medium' を指定し、以下を把握します。

• 既存のアーキテクチャとパターン
• 参考にできる類似機能
• 新しいコードを配置する場所
• 影響を受ける箇所

2. 分析して設計する

コンポーネントを特定する：

• データベースの変更（モデル、マイグレーション、スキーマ）
• バックエンドのロジック（API エンドポイント、ビジネスロジック、サービス）
• フロントエンドの変更（UI、状態、ルーティング）
• テスト要件
• ドキュメントの更新

アーキテクチャを検討する：

• 既存のパターンに従う（CLAUDE.md を確認）
• 再利用可能なコンポーネントを特定する
• エラー処理とエッジケースを計画する
• パフォーマンスへの影響を検討する
• セキュリティとバリデーションを考慮する

依存関係を確認する：

• 必要となる新しいパッケージやライブラリ
• 既存のスタックとの互換性
• 必要な設定変更

3. 実装計画を作成する

機能を個別の連続したタスクに分割します。

## Feature: [Feature Name]

### Overview
[Brief description of what will be built and why]

### Architecture Decisions
- [Key decision 1 and rationale]
- [Key decision 2 and rationale]

### Implementation Tasks

#### Task 1: [Component Name]
- **File**: `path/to/file.py:123`
- **Description**: [What needs to be done]
- **Details**:
  - [Specific requirement 1]
  - [Specific requirement 2]
- **Dependencies**: None (or list task numbers)

#### Task 2: [Component Name]
...

### Testing Strategy
- [What types of tests needed]
- [Critical test cases to cover]

### Integration Points
- [How this connects with existing code]
- [Potential impacts on other features]

具体的な参照情報を含めます：

• 行番号付きのファイルパス（src/utils/auth.py:45）
• 従うべき既存のパターン
• 関連ドキュメント

4. ユーザーと計画を確認する

以下を確認します。

• この計画は期待に合っていますか？
• 要件に漏れはありませんか？
• 優先順位やアプローチを調整しますか？
• 進めてもよいですか？

5. plan-implementer で実行する

各タスクについて plan-implementer エージェントを起動します。

Task tool with:
- subagent_type: 'plan-implementer'
- description: 'Implement [task name]'
- prompt: Detailed task description from plan

実行方針：

• 依存関係を考慮し、順番に実装する
• 次のタスクに進む前に、各タスクを検証する
• 問題が見つかったら計画を調整する
• テストの失敗には test-fixing スキルを使用する
• コミットには git-pushing スキルを使用する

ベストプラクティス

計画：

• 大まかな内容から始め、次第に具体化する
• 既存のコードパターンを参照する
• ファイルパスと行番号を含める
• エッジケースを事前に検討する
• タスクを絞り込み、個別に完結させる

コミュニケーション：

• アーキテクチャ上の判断を説明する
• トレードオフと代替案を明示する
• 前提条件を明確にする
• 将来のメンテナーに向けて背景を示す

実行：

• 一度に1つのタスクを実装する
• 次に進む前に検証する
• ユーザーに進捗を伝える
• 調査結果に応じて対応を調整する

連携

• plan-implementer エージェント：タスク仕様を受け取り、実装します
• test-fixing スキル：テスト失敗時に自動で起動します
• git-pushing スキル：コミット時に起動します