自律型 Claude Code エージェントにセッションをまたいだ意思決定を覚えさせる ADR 実装 — Markdown ログで再質問地獄を防いだ4つの工夫【2026】

エージェント型のコーディングツールを長期プロジェクトで使うと、毎回同じ質問を繰り返す羽目になります。「これはこのファイルに書くべき？」「この命名規則でいい？」といった会話を、数週間前にしたはずなのに、セッションが変わると忘れられてしまうわけです。特に複数の開発者が同じリポジトリに関わる場合、こうした「判断の揺らぎ」は品質のばらつきにつながります。この記事が紹介する ADR（アーキテクチャ決定記録）という手法は、CLAUDE.md というファイルにそのプロジェクト固有の判断ログを Markdown で残し、エージェントが毎回そのログから判断基準を読み込む仕組みです。つまり、職人技を「ドキュメント化」することで、エージェントに「チーム記憶」を植え付ける工夫だということです。

単純に見えますが、これは大きな転換点です。生成 AI は従来「単発の質問に答えるツール」でしたが、長期開発ではむしろ「プロジェクトに張り付く相棒」になる時代に入ったということ。エージェントも人間の同僚と同じく、プロジェクト固有の文脈や過去の判断を知らないと、信頼できない判断をしてしまいます。CLAUDE.md にそれを蓄積することで、セッションが変わっても「去年の自分たちと同じ判断基準」を保つ。これは従来の「ドキュメント整備」とは違う。実行可能な記憶、つまり AI が実際に参照して動く記憶です。

中小企業が自社製品を数ヶ月かけて改善する場合、毎回 AI に「以前はこう決めた」と説明するのは手間の無駄です。重要な判断や命名規則、設計の方針を CLAUDE.md に一度書いておけば、その後のセッションではエージェント自らが「ここはこの方針に従うべき」と判断します。職人の職人たる所以は経験にあります。エージェントにもその「経験」を形にして渡す。それがこの手法の本質です。