plan-builder

プランビルダー

複雑さに応じて適切なテンプレートを使い、実装計画を作成します。

テンプレートの選択

複雑さ	使用するタイミング	テンプレート
最小限	単純なバグ、小規模な改善、変更対象が明確な単一ファイル	references/minimal.md
標準	ほとんどの機能、複雑なバグ、チームでの共同作業	references/standard.md
包括的	大規模な機能、アーキテクチャの変更、複数フェーズにわたる作業	references/comprehensive.md

選択基準

最小限を使用する場合

• 修正方法が明らかで、対象が限定されている
• 単一ファイル、または関連する2〜3個のファイルが対象
• アーキテクチャ上の判断が不要
• 説明から受け入れ基準が明確

標準を使用する場合（デフォルト）

• 複数のコンポーネントに影響する
• 調査または外部ドキュメントの参照が必要
• チームでのレビューにあたり、背景情報が必要
• 依存関係またはリスクがある

包括的を使用する場合

• 新しいシステムまたは大規模な機能
• 複数フェーズにわたる作業
• アーキテクチャ上の判断が必要
• 複数の領域にまたがる懸案事項（セキュリティ、パフォーマンス）
• 複数のチームまたは関係者が関与する

計画の出力

計画の保存先：docs/plans/[YYYYMMDDHHMMSS]_<title>.md

すべての計画に含める項目：

• ファイルパスを含む調査結果（例：src/models/user.rb:42）
• 外部ドキュメントのURL
• 関連するイシュー／PR（判明している場合）
• ユーザー入力に基づく 受け入れ基準（ブループリントのステップ2から記入）

条件付きセクション

UI 機能

次の機能を含む場合は、「デザインシステムの参照」セクションを追加します。

• ページ、コンポーネント、フォーム、ボタン、モーダル
• 視覚的なデザイン要素

DevOps 機能

次の機能を含む場合は、「インフラストラクチャのコンテキスト」セクションを追加します。

• Terraform/OpenTofu、Ansible、クラウドリソース
• Docker、CI/CD、インフラストラクチャ

避けるべきパターン

避けること	実施すること
単純なバグに包括的テンプレートを使う	実際の複雑さに合ったテンプレートを選ぶ
受け入れ基準を省略する	テスト可能な基準を必ず含める
プレースホルダーテキストを残す	すべてのセクションを埋めるか、削除する
明白な変更を過剰に計画する	最小限のテンプレートがあるのには理由があります