MarkdownファイルをAIコーディングエージェントのメモリシステムとして使用する

コア手法：チャットウィンドウではなくファイル内で会話する

開発者はClaude Codeを使用しますが、標準のチャットインターフェースは避けています。代わりに、エージェントに{topic}_LOG.mdファイルを作成させ、そこで重要な議論をすべて行い永続化します。チャットウィンドウでは、/responseとだけ書き、Claudeに現在の議論ファイルを確認してそこで返答するよう指示します。永続化が必要ない些細な質問はチャットに限定します。

ファイル構造と注釈

返答は通常、通常のチャットのようにLOGファイルの末尾に追加されますが、特定のポイントに応答するためにインラインでコメントを挿入することもできます。これは特にプロジェクト計画中の並行した明確化に役立ちます。再読時の明確性を維持するため、すべての人間のコメントはC:でマークされ、Claudeの貢献と区別されます。

デュアルメモリシステムのアーキテクチャ

LOGファイルに加えて、Claudeは{topic}_SUMMARY.mdファイルを作成・維持するよう指示されます。この要約には、LOGがメモリに収まりきらなくなることが多いため、行番号付きの元のLOGへの参照が含まれます。要約は高レベルの宣言的メモリとして機能し、LOGは詳細な手続き的メモリとして機能します。

エージェント起動とメモリ管理

新しいエージェントが起動したとき、または圧縮後のプロセスは以下の通りです：

• ユーザーがコンテキストを提供：「あなたのタスクは会話{topic}を継続することです。Xに焦点を当てます。」
• エージェントは{topic}_SUMMARY.mdを読み、重要な内容を理解する
• 要約はXがどこで議論されたかを示す（例：LOGの100-200行目と500-800行目）
• エージェントはそれらの特定のLOG行と、最近のコンテキストのために最後の100行を読み込む
• エージェントは要約で言及された詳細をいつ参照するかを自律的に決定できる

メンテナンスと品質管理

シンプルなサブエージェントが定期的に要約をスキャンし、対応するログとの適切な同期を確保します。異なるトピックの要約には、適切な場合に相互参照が含まれ、ワーカーエージェントが追加の詳細を参照するための基盤を提供します。エージェントはまた、未対応のC:コメントにフラグを立て、見逃された質問を防ぎます。

フォールバックとドキュメントの利点

トークンコストに関係なく最大の信頼性を得るために、新しいエージェントにLOGファイル全体を再読するよう指示できます。これは、Pythonファイルの読み取りやウェブ閲覧などの他の操作を除外するため、元の議論よりも少ないメモリで済みます。追加の利点として、LOGファイルは同じプロジェクトで作業する他の人々のための徹底的なドキュメントとして機能します。