planning

計画スキル

新しいコーディングタスクを開始する際に、詳細な実装計画を作成するためにこのスキルを使用します。

手順

1. タスクを理解する

• 課題／タスクの説明を最後まで読みます
• 期待される成果と受け入れ基準を特定します
• 記載されている制約や要件を書き留めます

2. コードベースを調査する

• リポジトリのルートを見つけ、プロジェクト構成を確認します
• 技術スタック（言語、フレームワーク、テストランナー）を特定します
• README、CONTRIBUTING、または同様のドキュメントがあれば読みます
• 既存のテストを見つけ、テストのパターンを把握します

3. 関連ファイルを特定する

• grep を使って、タスクに関連するコードを探します
• 最も関連性の高いファイル（エントリーポイント、関連モジュール）を読みます
• 変更が必要なファイルと新規作成が必要なファイルを特定します
• 従うべき既存のパターンがないか確認します

4. 計画を作成する

write_todos を使って、構造化された計画を作成します。

write_todos([
    "1. <specific change in specific file>",
    "2. <next specific change>",
    "3. Write tests for <feature>",
    "4. Run test suite and fix failures",
    "5. Review all changes"
])

5. リスクを評価する

• 破壊的変更はありますか？
• 対処が必要なエッジケースはありますか？
• コードベースの他の部分に影響しますか？
• 不確かな点はレビュー対象として明示します

ガイドライン

• 計画には具体的な手順を3～10個含めます
• 各手順は、追加の計画を立てなくても実行できるほど具体的にします
• テストの作成と実行を、明示的な手順として含めます
• 最後にレビュー／検証の手順を設けます