『LLM ウィキ』をチームの知識へ：エージェントが読む文脈を広げる

要点 — いま多くの人が、Claude Code のようなコーディングエージェントのために、マークダウンのフォルダで『LLM ウィキ』を手作りしています。強力ですが、たいてい一人で止まります。手で集めた文脈をチーム全体へ広げる方法を見ていきます。

『LLM ウィキ』とは何か

最近、開発者の間で一つのパターンが広がっています。プロダクト・決定・ルールをいくつかのマークダウンファイルにまとめて一つのフォルダに置き、Claude Code やローカルエージェントにそのフォルダを読ませる、という方法です。人はこれを『LLM ウィキ』、あるいはエージェントのための『セカンドブレイン』と呼びます。

やり方は単純です。エージェントに毎回背景を説明する代わりに、背景をファイルに書いておき「ここを参照して」と伝えるだけ。以降、エージェントは推測ではなく、書いておいた文脈の上で答えます。

なぜこれほどうまくいくのか

肝心なのは、エージェントに 正しい文脈 を渡すことです。モデルが賢くなったからではなく、自分で選んだ文脈があるから、答えが自分の状況に合います。手で整理する作業そのものが「何が重要かを選ぶ」作業であり、それが品質に表れます。

手作りのウィキが強力な理由はここにあります。かき集めた雑多なものではなく、人が判断して選んだ文脈だからです。これは置き換える対象ではなく、守るべき強みです。

問題は『一人』で止まること

しかし手作りのウィキは、たいてい一人のノートパソコンの中にあります。そこからいくつかの問題が生じます。

• 他のメンバーはその文脈を読めません。結局、各自が自分のウィキを別々に作ります。
• 内容は一人が手をかけた分だけ新しく、忙しいとそのまま古くなります。
• 他の人のエージェント、別の端末のエージェントは、そのフォルダにアクセスできません。

個人にはうまくいった方法が、チームに移った瞬間に壁に当たります。文脈は一か所に集まってこそ力を発揮しますが、各自のフォルダに散らばると、最初の問題に逆戻りです。

チーム版はどう違うのか

Specify はこの『LLM ウィキ』の発想をそのまま受け継ぎ、チーム規模に育てます。発想は同じです。エージェントが読む文脈を一か所に集める。違うのは、その文脈が一人のフォルダではなく、チームの共有ワークスペースにあることです。

• 自動で集まります。 ドキュメントや決定に加え、Notion・Slack・GitHub をつなげば、そちらの文脈まで一緒に読み込みます。手で書き写す必要はありません。
• みんなで使います。 一人が整理した文脈を、すべてのメンバーとそのエージェントが同時に読みます。
• エージェントに直接つながります。 Specify は MCP サーバーとして動作し、Claude Code・Codex がチームの文脈を直接探索します。フォルダをコピーして回す必要はありません。

手でやっていたことを、そのままチーム規模に移した形です。

手作りのものを捨てる必要はありません

すでにウィキがあるなら、それは良い出発点です。捨てる理由はありません。使っているドキュメントやツールをつないでそのまま取り込み、足りないところだけ補えばいい。一度にすべてを移す必要もありません。

小さく始めて大丈夫です。チームが何度も聞き直すことを一つ、文脈として集め、エージェントをつないでみてください。個人のウィキで得ていた感覚 — 毎回説明しなくていい心地よさ — を、今度はチーム全体で得られる地点がすぐに来ます。

よくある質問

既存のドキュメントや使っているツールを持ち込めますか？

ドキュメントをワークスペースに取り込むか、使っているツールをソースとして接続すれば、その文脈も一緒に読み込みます。ゼロから書き直す必要はありません。

Claude Code からそのまま使えますか？

はい。Specify を MCP サーバーとして一行でつなげば、Claude Code がチームのドキュメント・決定・コードの文脈を直接読みます。ワークフローはそのまま、文脈だけがチームのものになります。