---
name: implementation-plan
description: 仕様・実装計画書を作成して段階的にステップごとに実装するためのスキル。新機能の開発、大規模リファクタリング、機能の大幅な見直し時に仕様書と実装計画を事前に作成し、フェーズごとの段階的実装を支援する。「仕様書を作って」「実装計画」「段階的に実装したい」「フェーズ分けして」「設計書を作成」「リファクタリング計画」「実装ステップ」「計画を立てて」「ロードマップ」「タスク分解」「設計したい」「大きな変更をしたい」「implementation plan」「spec」「roadmap」などで発火。
---

# Implementation Plan Skill

## スキル読み込み通知

このスキルが読み込まれたら、必ず以下の通知をユーザーに表示してください：

> 💡 **Implementation Plan スキルを読み込みました**  
> 仕様・実装計画書を作成し、段階的な実装を支援します。

## When to Use

- 新機能を実装する前に仕様と実装計画を立てたいとき
- 大規模なリファクタリングを段階的に進めたいとき
- 既存機能の大幅な見直しを行うとき
- 複数フェーズに分けて安全に実装を進めたいとき
- AIに一度に大量のコンテキストを与えず、計画的に実装したいとき
- 「大きな変更をしたいけどどこから手をつければいいか分からない」とき
- 変更の影響範囲を事前に整理しておきたいとき

## 概要

このスキルは、本プロジェクト（Turtle Video）の `spec.md` を参考にした実装計画書テンプレートを提供します。段階的な実装により、以下の効果を得られます：

- **コンテキストの最適化**: AIに一度に大量の情報を与えず、フェーズごとに必要な情報だけを伝達
- **安全な実装**: 各フェーズ終了時に動作確認を行い、既存機能を壊さずに進行
- **進捗の可視化**: チェックリストで完了状況を把握
- **手戻りの防止**: 事前に設計を固めることで不要なやり取りを削減

## 計画書作成手順

### Step 1: 現状分析

以下の情報を収集・整理する：

1. **関連ファイルの調査**: 変更対象のファイルを特定し、現在の実装を確認
2. **影響範囲の確認**: 変更が他のコンポーネント・ストア・フックに与える影響を確認
3. **既存テストの確認**: `src/test/` 配下の関連テストを確認
4. **型定義の確認**: `src/types/index.ts` で関連する型を確認

### Step 2: 仕様書セクションの作成

以下のテンプレートに沿って仕様を明文化する：

📄 **[assets/spec-template.md](assets/spec-template.md)**

### Step 3: 実装計画の作成

フェーズ別に分割し、以下のテンプレートに従う：

📄 **[assets/phase-template.md](assets/phase-template.md)**

### Step 4: 計画書のレビュー

作成した計画書について以下を確認する：

- [ ] 各フェーズが独立して動作確認可能か
- [ ] フェーズ間の依存関係が明確か
- [ ] 1フェーズの変更量が適切か（大きすぎないか）
- [ ] 既存機能を壊さない手順になっているか
- [ ] テスト計画が含まれているか

## フェーズ設計のガイドライン

フェーズ分割の原則、典型的なフェーズ構成、本プロジェクト固有の注意点、レビューチェックリストは以下を参照してください：

📄 **[references/phase-design-guide.md](references/phase-design-guide.md)**

## 参考資料

- [spec.md](../../../spec.md): 本プロジェクトの実装計画の実例（Phase 0〜7）
- [src/types/index.ts](../../../src/types/index.ts): 現在の型定義
- [src/stores/](../../../src/stores/): 現在のストア構成