メソッドマップ
この表は、長時間実行されるコーディングエージェントの最も一般的な失敗モードを、 それを最初に修正する成果物や運用ルールにマッピングします。
| 失敗モード | 実践でどう見えるか | 主要な修正 | 補助成果物 |
|---|---|---|---|
| コールドスタートの混乱 | 新しいセッションがセットアップとステータスの再発見に大部分の時間を費やす | リポジトリをシステムオブレコードにする | claude-progress.md |
| スコープの拡散 | エージェントが複数の機能を開始し、どれもきれいに完了しない | アクティブスコープを制限する | feature_list.json |
| 早すぎる完了 | エージェントがコード編集後に完了を主張するが、実行可能な証拠の前 | 完了を証拠に紐付ける | clean-state-checklist.md |
| 脆弱な起動 | 毎セッションがプロジェクトの起動方法を再学習する | セットアップと検証を標準化する | init.sh |
| 弱い引き継ぎ | 次のセッションが何が検証済み、壊れている、次なのか判断できない | 明示的な引き継ぎで終了する | session-handoff.md |
| 主観的なレビュー | レビュー品質が好みや記憶に依存する | 固定カテゴリで出力を評価する | evaluator-rubric.md |
運用原則
観察された失敗モードを直接解決する最小の成果物を追加する。 すべての信頼性問題を1つのグローバル指示ファイルにより多くのテキストを投入して 解決することを避ける。