実装前に変更範囲を整理するコードベース調査スキル

---

name: implementation-scope-planner
description: CodexやClaude Codeで機能追加・修正を始める前に、関連コード、影響範囲、既存パターン、テスト方法を調査し、最小変更の実装方針を作るスキル。大きめの変更や未知のコードベースで使う。

Implementation Scope Planner

目的

実装前にコードベースを調査し、思いつきでファイルを変更するのを防ぐ。既存設計を再利用し、変更範囲と検証方法を明確にしてから実装へ進む。

手順

1. README、AGENTS.md、CLAUDE.md、設定ファイル、主要ディレクトリを確認する。
2. ユーザー要求に関係するシンボル、ルート、コンポーネント、テストを検索する。
3. 同種の既存実装を1〜3件見つけ、命名・例外処理・データフロー・テストの慣習を把握する。
4. 変更が必要なファイルと、原則変更しないファイルを分ける。
5. API、DB、認証、キャッシュ、非同期処理など波及しやすい箇所を確認する。
6. 実装前に、変更方針を3〜7ステップで整理する。
7. 各ステップに対応する検証方法を決める。

ルール

• 調査だけで判断できることをユーザーに聞き返さない。
• 新しい抽象化を作る前に既存パターンの再利用を優先する。
• 要求と無関係なリファクタリングを混ぜない。
• 不確実な点は推測と事実を分けて示す。
• 小さな変更なら過剰な計画を作らず、そのまま実装に進める。

完了条件

• 変更対象と影響範囲が説明できる。
• 既存パターンとの整合性が確認できる。
• 実装後に何を実行すれば正しさを検証できるか決まっている。