implementation-notes

実装メモ

どれだけ計画しても、すべての未知要素をなくすことはできません。コードを開いて初めて見つかるものもあります。実際の状況が計画と異なっても、作業を止めたり、黙って独自に判断したりせず、保守的な選択をして記録し、そのまま進めてください。メモファイルを残すことで、次回の試行に今回の経験を活かせます。

手順

1. ビルド開始時に、次の3つの見出しを含む implementation-notes.md を作成します：計画との差異、発見したエッジケース、レビュー用の質問。
2. 計画で想定されていなかった選択を実際の状況に迫られた場合は、次のようにします。
   • 保守的な選択肢（最も簡単に元に戻せるもの）を選びます。
   • 計画に書かれていたこと、代わりに実施したこと、その理由、再検討に必要なことを「計画との差異」に記録します。
   • 作業を続けます。元に戻せる判断についてユーザーの返答を待って作業を止めないでください。
3. エッジケースは、問題なく対処できたものも含め、見つけた時点で記録します。次の計画で考慮すべき未知要素が、まさにこれらです。
4. 元に戻せない変更やスコープを変更する内容は「レビュー用の質問」に記録し、安全なチェックポイントで作業を停止します。保守的に計画から逸脱するのは問題ありませんが、コストのかかる逸脱には人間の判断が必要です。
5. 最後に、5行の概要を追記します。計画との差異の件数、最も再検討される可能性が高いもの、見つかったエッジケース、次のセッションで最初に読むべきものを記載します。引き継ぎ資料または PR でこのファイルを参照してください。

ガードレール

• メモファイルは一時的な作業メモであり、ドキュメントではありません。各項目は2～3行に収めます。
• メモを実際の状況と食い違わせないでください。記録漏れのある差異は、ファイルが完全な記録であるかのように示されるため、メモがない状態よりも悪いものです。
• 「保守的」とは元に戻せるという意味であり、必ずしも単純という意味ではありません。