tomevault-io Before You Fix
症状ドリブンの修正は設計を壊すので、コード変更前に根本原因を特定する。
Checklist
- Stop — まだコードを書かない
- Ask Why — エラーは症状。システムは何をしようとし、何が期待と違ったか？
- Read Design — 関連する設計ドキュメント (
docs/) を読み、意図された振る舞いを理解する - Trace Flow —
PromptManager.generatePrompt()→TemplateFile→ParameterManager→VariableProcessor→VariableMatcher→Replacers→PromptResult - Root Cause — エラー発生箇所と原因箇所は異なることが多い
| エラー箇所 | 根本原因の典型箇所 |
|---|---|
| Runtime validation | src/types/ の型定義 |
| 変数未置換 | src/replacers/ |
| パス検証エラー | src/validation/ |
| テスト失敗 | src/core/ の実装ロジック |
- State — 根本原因・設計の意図・最小限の正しい修正を述べる
- Then Fix — 根本原因に対する最小変更を行う
複雑な問題は tmp/investigation/<issue>/ に overview.md, trace.md, root-cause.md を書き出す（mermaid図必須）。
Converted and distributed by TomeVault — claim your Tome and manage your conversions.