create-plan

計画の作成

計画のみを作成してください。実装はしないでください。

ファイル

決定とその計画は、プロジェクトの adrs/ フォルダーにまとめて保存します。プロジェクトで別の ADR 構成をすでに使っている場合は、それに従ってください。

• adrs/NNNN-<slug>.md：決定。次に空いている番号を使い、番号を振り直さないでください。
• adrs/NNNN-<slug>.plan.md：その決定を実装する計画。

実質的な決定を伴わない小さな変更には、どちらも必要ありません。そのまま変更するか、チャットで方針に合意してください。

ADR

短くまとめてください。通常は1ページ未満です。

• Status： Proposed、Accepted、または Superseded by NNNN
• Context： 問題とその制約
• Decision： 実施する内容
• Alternatives： 実現可能な最もシンプルな選択肢を必ず含め、採用したかどうかとその理由を記載します
• Consequences： 受け入れるトレードオフ

新しい ADR は Proposed として作成してください。ユーザーが承認した場合にのみ Accepted にしてください。決定が変わった場合は、承認済みの履歴を書き換えるのではなく、古い ADR に取って代わる新しい ADR を作成してください。

計画

• Status： Draft、Ready、In progress、または Done
• Goal： 完了時の状態と、対象範囲外の内容
• Tasks： 順番に記載します。各タスクでは、何をどこから変更するか、検証方法、完了しているかどうかを示してください。検証では、追加または実行する重要なテストと、必要に応じた手動確認（例：UI には agent-browser）を記載します。
• Open questions： ユーザーが決定する必要のある事項

シンプルに保つ

• 計画に必要な範囲でコードとドキュメントを調査し、それ以上は行わないでください。
• 目標を満たす最もシンプルな設計を選んでください。推測に基づく選択肢、フォールバック、抽象化、「後で」対応するタスクは追加しないでください。
• 保存する前に、目標に役立たないタスクをすべて削除してください。
• スコープ、動作、アーキテクチャに関する選択が本当に曖昧な場合は、推測せずにユーザーに尋ねてください。
• 計画へのフィードバックはすべて吟味してください。実際に起こりうる問題を解決するものか、単に複雑さを増すだけなのかを確認します。判断に迷う場合は、ユーザーに尋ねてください。