writing-plans

計画の作成

概要

コードベースについての知識がまったくなく、好みもあまり当てにならないエンジニアを想定して、包括的な実装計画を作成します。知っておく必要のあることをすべて記載してください。各タスクで変更するファイル、コード、テスト、確認が必要なドキュメント、テスト方法を明記します。計画全体を、取り組みやすい小さなタスクに分けてください。DRY。YAGNI。TDD。こまめにコミットします。

熟練した開発者ではあるものの、ツールセットや問題領域についてはほとんど知らない人を想定してください。適切なテスト設計についても、よく知らないものとします。

最初に告知: 「Writing Plans スキルを使って実装計画を作成します。」

コンテキスト: これは専用のワークツリー（brainstorming スキルで作成）で実行してください。

計画の保存先: docs/plans/YYYY-MM-DD-<feature-name>.md

クイックリファレンス

計画ヘッダーのテンプレート: 計画の構成とテンプレートを参照してください。

タスクのテンプレート: 計画の構成とテンプレートを参照してください。

粒度のガイド: 各ステップは2～5分で完了できる粒度にします。ベストプラクティスを参照してください。

基本原則

• ファイルパスは必ず正確に記載する — 「user モジュール」ではなく、"src/models/user.py"
• 計画にはコードをすべて記載する — 「検証を追加する」ではなく、検証コードを示す
• 期待される出力を含む、正確なコマンドを記載する — "pytest tests/file.py -v"と、実行時に表示される内容を記載する
• 関連するスキルを参照する — @構文を使用します。@skills/category/skill-name
• DRY、YAGNI、TDD、こまめなコミット — すべてのタスクでこのパターンに従います

詳しいガイダンスは、ベストプラクティスとガイドラインを参照してください。

実行への引き継ぎ

計画を保存した後、実行方法を選択できるようにします。

「計画が完了し、docs/plans/<filename>.mdに保存されました。実行方法は2つあります。

1. サブエージェント主導（このセッション） — タスクごとに新しいサブエージェントを割り当て、各タスクの間にレビューを行い、素早く反復します

2. 並行セッション（別セッション） — 実行計画を使う新しいセッションを開き、チェックポイントを設けながらまとめて実行します

どちらの方法にしますか？」

サブエージェント主導を選んだ場合:

• @skills/collaboration/subagent-driven-development を使用します
• このセッションを継続します
• タスクごとに新しいサブエージェントを使い、コードレビューを行います

並行セッションを選んだ場合:

• ワークツリーで新しいセッションを開くよう案内します
• 新しいセッションでは @skills/collaboration/executing-plans を使用します

忘れずに

• 前提知識がないエンジニア向けに書きます（すべて具体的に指定してください）
• 指示だけでなく、コードブロックをすべて記載します
• 期待される出力を含む、正確なコマンドを記載します
• まずテストを書き、次に実装し、最後にコミットします
• コードベースにある既存のパターンを参照します
• タスクは取り組みやすい小さな単位（2～5分）に分けます

例が必要ですか？ タスクの詳しい例については、計画の構成とテンプレートを参照してください。

パターンが必要ですか？ エラー処理、ロギング、テスト設計などについては、ベストプラクティスを参照してください。