Claude Code の初回タスク：調査、変更、検証

初回タスクは少数のファイルに限定し、再現手順のある不具合修正、既存関数へのテスト追加、単一のドキュメント区画の変更など、観測可能な完了条件を設定します。「プロジェクト全体を最適化する」などの範囲が定まらない要求は使用しません。

プロジェクトのルートでセッションを起動し、Git ワークツリーの状態を記録します。ファイル変更やコマンド実行を許可する前に、既存の未コミット変更を保全します。

エントリポイント、依存関係、テストコマンド、タスクに関連する既存パターンを特定します。Claude Code は必要に応じてファイルを読み取るため、リポジトリ全体をプロンプトへ貼り付ける必要はありません。

結果には具体的なファイルと関数の参照、および不確定事項を含めます。変更前に認識の相違を解消し、無関係な探索を制限します。

タスクが複数ファイルにまたがる場合、API の選択が必要な場合、または未確認のモジュールへ影響する場合は、Plan モードで調査と変更を分離します。計画には対象ファイル、データフロー、リスク、検証コマンド、対象外を記載します。

局所的な誤記修正やログ一行の追加では、直接実装を選択できます。計画の詳細度はタスクの範囲とリスクに合わせます。

実装要求には再現手順、境界条件、検証コマンドを含め、チェック失敗後の修正まで指定します。

検証条件には、テスト成功、ビルド終了コード 0、API の期待ステータス、指定したスクリーンショット差分の解消など、観測可能な結果を使用します。

コミットを要求する前に Git diff を確認し、既存の未コミット変更の上書き、無関係なフォーマット変更、認証情報、不要なビルド成果物がないことを検証します。

差分の要約後、独立したコンテキストまたはサブエージェントで正確性、回帰、見落としを確認します。要件と無関係なリファクタリング提案は対象外とします。

実装方向が誤っている場合は Esc で中断し、不足している制約を追加します。複数回の修正で解消しない場合は /clear を実行し、範囲と検証条件を明示して再開します。

各プロンプトはチェックポイントを作成します。/rewind は会話と Claude の編集ツールが生成したファイル状態を復元できますが、Bash コマンドや外部プロセスによる変更は対象外です。永続的な復旧には Git を使用します。