rpi-implement

実装計画

承認済みの技術計画を実装してください。これらの計画には、具体的な変更内容と成功基準を含むフェーズが記載されています。

はじめに

ユーザーが計画のパスを指定した場合は、そのまま作業を進めてください。計画のパスが指定されていない場合は、docs/agents/plans/ で最新の計画を確認してください。計画が見つからない場合は、ユーザーにパスを尋ねてください。

計画を確認したら、次の手順に従ってください。

• 計画全体を読み、既存のチェックマーク（- [x]）がないか確認します
• 計画で言及されているファイルをすべて読みます
• ファイルは最後まで読みます。limit/offset パラメーターは使わず、全体を把握してください
• 各要素がどのように関連しているかを深く考えます
• 必要な作業を理解したら、実装を開始します
• 作業中のタスクには [-]、完了したタスクには [x] を付けます（タスクリストツールよりこちらを優先してください）

タスクの追跡

計画ファイルは進捗管理にも使います。各タスクの完了後、必ずすぐにチェックボックスを更新してください。また、作業中のタスクにも印を付けます。

• [ ] - 未着手
• [-] - 進行中（着手する前に更新）
• [x] - 完了（テストに成功した直後に更新）。手動確認のステップでは、ユーザーの確認後にのみ [x] を付けます。

実装の方針

計画は慎重に策定されていますが、実際の状況は複雑になることがあります。次の点に従ってください。

• 計画の意図に従いながら、状況に応じて対応します
• 各フェーズを完全に実装してから、次のフェーズに進みます
• コードベース全体との整合性を考慮し、実装が適切であることを確認します

計画と実際の状況が一致しない場合は、その理由を考え、明確に伝えてください。計画は指針ですが、判断も重要です。

不一致が見つかった場合は、作業を止め、計画に従えない理由をよく考えてから、問題を明確に提示してください。

Issue in Phase [N]:
Expected: [what the plan says]
Found: [actual situation]
Why this matters: [explanation]

How should I proceed?

検証方法

フェーズを実装した後は、次の手順に従ってください。

• 計画に記載された成功基準のチェック（テストコマンド、リンター、型チェッカーなど）を実行します
• 問題があれば、次に進む前に修正します
• フェーズに手動確認のステップが含まれている場合は、作業を一時停止し、人に知らせてください。

  Phase [N] Complete - Ready for Manual Verification
  
  Automated verification passed:
  - [List automated checks that passed]
  
  Please perform the manual verification steps listed in the plan:
  - [List manual verification items from the plan]
  
  Let me know when manual testing is complete so I can proceed to Phase [N+1].
  

• 明示的に別の指示がない限り、次のフェーズに進みます

ユーザーが確認するまで、手動テストの項目にチェックを付けないでください。

すべてのフェーズが完了したら、ユーザーが確認できるよう、概要を提示してください。

行き詰まった場合

想定どおりに動作しない場合は、次の手順に従ってください。

• まず、関連するコードをすべて読み、理解していることを確認します
• 計画の作成後にコードベースが変更されていないか検討します
• 不一致を明確に伝え、対応方法を尋ねます

サブエージェントは必要な場合に限って使用し、主に対象を絞ったデバッグや、把握していない領域の調査に活用してください。

作業の再開

計画にチェックマークが付いている場合は、次のように対応してください。

• 完了済みの作業は完了したものとして扱います
• 最初の未完了項目から再開します
• 何かおかしい点がある場合に限り、以前の作業を検証します

チェックボックスを埋めることだけが目的ではありません。ソリューションを実装することを忘れず、最終目標を意識して作業を進めてください。