Deepseek Harnessの Agent Notes 運用術を知る

DeepSeek社がエージェント基盤のリポジトリを公開し、その中に「Agent Notes」という設計管理システムが組み込まれていた。これはコードの「なぜ」を記録する仕組みで、提案段階（proposed）から実装（implemented）、却下（rejected）、凍結（archived）の4つの状態でノートを管理している。最大の特徴は、実装PRを出すとき、提案ノートを現在形に書き直してimplemented/に移動させるルールだ。つまり、コードの変更と「設計意図のアップデート」を同じコミットで閉じてしまう。

AIの鬼として面白いのはここだ。AIとの協働が増えると、設計判断のチャットログはすぐ流れ去る。DeepSeekはそれを「チャットに流さず、リポジトリに残す」という物理的な工夫で解決している。さらにrejected/に「なぜこの案は見送ったのか」と記録しておけば、次のセッションでAIが同じ悪手を何度も再提案してくることはない。形骸化するドキュメントの問題も、「実装PRでは必ず現在形に直す」という強制ルールで防いでいる。要するに、AIの短記憶を補うための「チームメンバー向けメモ帳」ではなく、「AI向けの記憶装置」として設計されている点がユニークだ。

中小企業がAIツールを使い始めると、最初は「AIが書いたコード」の質を気にするが、実は「なぜそのコードが選ばれたのか」という判断軸をAIと共有できていない場合がほとんどだ。毎回同じ説明を繰り返さず、判断軸や却下理由をどこかに残す習慣を今から作っておくと、半年後のAI運用は圧倒的に楽になる。