この記事は以下のLTで発表した内容を修正したものです。
https://uniquevision.connpass.com/event/364270/

AIコーディングツールのドキュメント管理の困りごと

粒度が難しい
- 大雑把すぎると意味がない
- 詳細過ぎるとメンテナンスコストが上がる・コンテキストウィンドウを圧迫する
統一性がない
- ツールごとにファイルが異なる
- CLAUDE.md / copilot-instructions.md / .clinerules / AGENTS.md …
更新が面倒
- 放置されがちで情報が古くなりやすい

Memory Bank パターン

Memory Bank は Cline が提唱する AI コーディングツールのドキュメント管理パターンです。
どのツールでも機能します。

構成

プロジェクトルートに memory-bank ディレクトリを配置し、その下に役割の異なる 6 つの Markdown を配置します。

projectbrief.md
productContext.md
systemPatterns.md
techContext.md
activeContext.md
progress.md

導入の仕組み

Memory Bank のドキュメント内にある以下のようなコードを .clinerules に貼ると動作するようになります。


# Cline's Memory Bank

I am Cline, an expert software engineer with a unique characteristic: my memory resets completely between sessions.
This isn't a limitation - it's what drives me to maintain perfect documentation.
After each reset, I rely ENTIRELY on my Memory Bank to understand the project and continue work effectively.
I MUST read ALL memory bank files at the start of EVERY task - this is not optional.
...

Claude Code に Memory Bank を導入する

3通りの方法が考えられます。

CLAUDE.md を作成する
- 先ほどの .clinerules の「Cline」となっている部分を「Claude Code」に置き換えた CLAUDE.md を作成する
Claude Code を Cline でラップして使う
- https://docs.cline.bot/provider-config/claude-code
Memory Bank 用の MCP サーバーを使う（未検証）
- https://github.com/alioshr/memory-bank-mcp

実際に使ってみて

よかった点

利用している AI ツールによらずに利用できる
ドキュメントだけでなく現在アクティブなコンテキストもまとめておける
全部 AI が書いてくれるので粒度に悩まなくて良い

イマイチな点

同一 Memory Bank をチーム開発で git 管理してしまうと変更がコンフリクトする
自動ではほぼ更新されず、明示的に「update memory bank」と言わないといけない
- Claude Code との相性の問題かもしれません
コードベースのサイズによらず 6 ファイル固定なので、大規模プロジェクトではこれだけでは足りなくなりそう

感想

1人で数週間かけて行うプロジェクトならば有用になりそう
複数人で開発する大規模プロジェクトではコンフリクトとサイズの問題がある
git 管理しないようにすればチーム開発でも使えるかもしれない
- Memory Bank のみ git 管理外にする
- ローカルで個々人が持つ

ドキュメント管理のベストプラクティスを求めています。