tomevault-io 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 を書く。
Converted and distributed by TomeVault — claim your Tome and manage your conversions.