writing-plans

計画の作成（Symfony）

使用する場面

• エンティティ、サービス、API、非同期処理など、複数のレイヤーにまたがる機能の場合。
• コーディングを始める前に、作業をレビューするか、複数のセッションに分割する必要がある場合。
• アプローチを決定する前に、スコープとリスクを把握する必要がある場合。

デフォルトのワークフロー

1. 概要を記述します。要約、対象範囲と対象外の範囲、依存関係を含めます。
2. 変更内容を設計します。新規および変更するエンティティ、サービスとハンドラー、API エンドポイントを明記します。
3. 作業を、各ステップの最初にテストを行う小さなフェーズに分割します。
4. ステップ間の依存関係を示し、それぞれの規模（S、M、L）を記載します。
5. 受け入れ基準と、リスクおよびその軽減策を記載します。

ガードレール

• 各ステップは単独で完了し、テストできるようにします。
• 意図だけでなく、具体的なファイル、クラス、エンドポイントを記載します。
• 対象外の内容は、黙って省略せずに列挙します。
• 該当する場合は、reference.md のテンプレート（CRUD、バックグラウンドジョブ、インテグレーション）から始めます。

段階的な情報開示

• 実行方針とリスク管理には、このファイルを使用します。
• 実装の詳細を掘り下げる必要がある場合は、リファレンスを開きます。

出力要件

• 概要、設計、ステップ、受け入れ基準、リスクを含む計画。
• ステップ間の依存関係と規模。
• レビュアーへの未解決の質問。

リファレンス

• reference.md