Fix Checklist
症状駆動の修正は設計を壊すので、コード変更前に根本原因を特定する。
手順
- •止まる — コードを書かない、ファイルを編集しない
- •Why — エラーは症状。「なぜ発生?システムは何を期待?」を問う
- •設計を読む —
docs/の関連設計書を読み、意図された動作を理解する - •フローを追う — 何がトリガー→期待状態→どこで乖離?
- •根本原因を特定 — エラー箇所≠原因箇所(型定義
src/types/、バリデーションsrc/validation/、リプレーサsrc/replacers/、コアsrc/core/) - •理解を検証 — 根本原因・設計意図・最小限の正しい修正を言語化する
- •修正 — 根本原因に対する最小変更のみ実行
アンチパターン: 「Xが見つからない→Xを追加」ではなく「なぜXが期待されるのか→設計はXについて何を言っているか」
複雑な問題は tmp/investigation/<issue>/ に overview.md, trace.md, root-cause.md を書く。