リポジトリが文脈だ：なぜエージェントに履歴は不要なのか

Dev.to / 2026/6/19

💬 オピニオンIdeas & Deep AnalysisModels & Research

共有:

要点

著者は、ADRsや仕様書、移行ログ、計画資料などの「履歴」は人間が「なぜ」システムがそうなったのかを理解するうえで有益だが、現在のシステムを編集するコーディング・エージェントのデフォルト文脈にすべきではないと主張している。
Claude CodeやCodexのようなコーディング・エージェントは、過去の文章を再生して推論するのではなく、現在のソース・オブ・トゥルース（現在のスキーマ、モジュール境界、公開API、テスト、設定、状態機械、依存関係ルールなど）を主に読むべきだと述べている。
具体的な失敗例として、数か月前に廃止された古いドキュメントを、エージェントが確信を持って信じて誤った作業を行ってしまうケースを挙げており、これは“幻覚”ではなく「履歴への従順さ」によるものだとしている。
文脈（トークン）の選び方を「何を手渡すか」という問題として捉え、各トークンが検証済みで現在の事実を与えるべきだと論じている。
要点は、「履歴はなぜを説明し、現在のソース・オブ・トゥルースは何を説明する」ことであり、役割と読み手が異なるという整理になっている。

この記事の続きは原文サイトでお読みいただけます。