Claude Code の known-failures.md を育てる — 書き方・読ませ方・陳腐化対処の運用設計
この記事で分かること
Claude Codeのknown-failures.mdを効果的に育てるための書き方、読み込ませ方、陳腐化を防ぐ運用設計を解説している。具体的な記述ルールや更新タイミングの設計基準が示されているため、長期運用でドキュメントが死蔵される問題を回避できる。
詳細要約
Claude Codeのknown-failures.mdは、過去に失敗したプロンプトや設定パターンを記録し、再発防止とチーム内の知見共有を効率化する運用ドキュメントである。実際の運用では、失敗事例ごとに「発生条件」「エラー内容」「回避策」を箇条書きで簡潔に記載し、新規プロンプト作成時に参照するルールを設ける。陳腐化を防ぐには、月1回のレビューで不要なエントリを削除し、新しい失敗が発生したら即座に追記する更新サイクルを組み込む。