Vouch: agent memory に review gate を挟む
AI agent の memory は、今かなり極端な方向に寄りやすい。
一方ではまったく覚えない。新しい session を開くたびに、project background、test command、deployment の癖、前回の調査がどこまで進んだかを説明し直す。もう一方では、何でも覚える。Agent が chat、file fragment、推測した conclusion を memory store に入れ、次に出てきた時には、それが事実なのか一時的な判断なのか見分けにくい。
今日メモしておきたい vouchdev/vouch は、後者のリスクを扱う project だ。もう 1 つの automatic memory layer ではなく、Git-native, review-gated knowledge base for LLM agents として作られている。Agent は knowledge change を提案できる。ただし、その knowledge は自動的に approved fact にはならない。まず review queue に入り、人が承認してから .vouch/ の普通の file として保存され、Git history に残る。
GitHub repository page、README、release page、commits page、page embedded metadata から 2026-07-07 に確認できる公開情報では、vouchdev/vouch は現在 155 stars、46 forks。主言語は Python で、GitHub の language stats では Python が約 74.6%、TypeScript が約 16.7%。License は MIT。Repository 作成日は 2026-05-17 12:32 UTC、latest push / page update は 2026-07-07 10:01 UTC。Latest release は vouch 1.2.1 で、release time は 2026-07-06 04:00 UTC。
Project Overview
| 属性 | 内容 |
|---|---|
| Repository | vouchdev/vouch |
| 位置づけ | Git-native, review-gated knowledge base for LLM agents |
| Stars | 155 |
| Forks | 46 |
| 主言語 | Python |
| License | MIT |
| Repository 作成時間 | 2026-05-17 12:32 UTC |
| Latest push | 2026-07-07 10:01 UTC |
| Latest version | vouch 1.2.1 |
| Release time | 2026-07-06 04:00 UTC |
| Core interfaces | CLI、MCP server、JSONL tool server、review UI、Git-tracked .vouch/ files |
制限しているのは write permission
多くの agent memory tool は、まず「どう recall するか」を議論する。Vouch が先に見ているのは「何が recall される資格を持つか」だ。
README の workflow はかなり明確だ。Agent は session 中に capture した内容や proposed write を pending state に入れる。人間が vouch review を実行し、1 件ずつ approve、reject、skip する。Approved claim と page だけが durable knowledge になり、その後の session は vouch recall、MCP tools、slash command からそれらを取り出せる。
この設計は agent memory の重要な境界を押さえている。Read は自動化できるが、write は無条件に自動化すべきではない。間違った conclusion が long-term memory になると、次に現れた時には「過去の知識」という顔をして current task に入ってくる。Human review gate は、その危険を明示的な workflow にする。
Knowledge を opaque database に閉じ込めない点もよい。Approved content は .vouch/ 配下の YAML claim、Markdown page、audit record として保存される。Diff を review でき、commit でき、code と一緒に clone できる。Long-running project では、「どこかの agent が覚えている」よりずっと追跡しやすい。
Session capture から compiled wiki へ
Vouch の面白いところは、手書き notes だけを保存する tool ではないことだ。
README が示す loop は、おおむねこうだ。Install 後に Claude Code などへ hooks を接続し、session 中の tool call を temporary buffer に capture する。Session end で pending session summary を作る。人が承認した claim は、さらに vouch compile で citation 付き topic page にまとめられる。Page も同じ review gate を通り、承認されてから recall 対象になる。
これは「chat log を全部保存する」より engineering knowledge base に近い。Chat log には process noise が多い。一方で claim/page は、再利用できる fact に近い単位になる。Design decision、deployment constraint、module convention、bugfix の理由。Vouch は claim に source citation を求め、README でも citation を machine-verified にする流れが説明されている。出所のない断言をそのまま knowledge base に入れないためだ。
Coding agent にとって、この粒度は重要だ。次に同じ area を直す時、agent は先週の会話全体を再生する必要はない。Current task に関係する approved facts だけを参照できればよい。
MCP は入口で、Git が trust layer
Vouch は MCP server、JSONL tool server、CLI を提供するので、Claude Code、Codex、Zed、Cursor、Windsurf、OpenClaw などの workflow に接続できる。Recent commits でも MCP registry publication 周りの作業が見え、agent integration を first-class entry point として扱っていることが分かる。
ただ、価値の中心は「MCP tools が増える」ことではない。Trust layer を Git に戻していることだ。
Agent は kb.* tools で content を propose できる。しかし approved artifacts は file だ。誰が提案し、誰が承認し、どの source を引用し、いつ変更されたかを project history に入れられる。Team は pull request で .vouch/ の diff を review でき、通常の Git flow で rollback、audit、comparison ができる。
この点で Vouch は普通の vector memory とかなり違う。Vector store は似た内容の recall が得意だが、「この knowledge は誰が承認したのか」「なぜ信頼できるのか」「いつ置き換えられたのか」を自然には答えない。Vouch はそれらを後付け metadata ではなく、中心 workflow にしている。
どんな人に向くか
Vouch は、coding agent をかなり真面目に使い始めた small team に向いている。特に、agent に team knowledge base を自動で書き換えさせたくない場合だ。
Project に次のような情報がよく出てくるなら、役に立ちやすい。
- module の historical design trade-off;
- test、release、migration flow の隠れた constraint;
- incident や bugfix の後に残った investigation conclusion;
- agent が何度も踏む同じ罠;
- session をまたいで使いたいが README に書くほどではない local project knowledge。
これらを chat だけに置くと、次回探しにくい。Automatic memory に直接入れると、汚染しやすい。Vouch はその中間にいる。Agent が整理を手伝い、人間が何を long-term context にするか決める。
注意点
第一に、project は新しい。Repository 作成日は 2026-05-17、latest release は 2026-07-06 の vouch 1.2.1。README はかなり整っているが、team adoption 前には速く変化している tool として扱うべきだ。
第二に、workflow discipline が必要になる。Review gate は長所であり、同時にコストでもある。Team が pending queue を定期的に処理しなければ、knowledge は蓄積されない。
第三に、Vouch は documentation system の置き換えではない。Agent が参加して維持する project knowledge layer と見るほうがよい。Claim、decision、topic page、session summary には向いているが、正式な architecture doc、外部 user doc、compliance material には既存の publish/review flow が必要だ。
第四に、approved memory も古くなりうる。Git history は traceability をくれるが、fact が永遠に正しいことは保証しない。Project constraint が変われば、knowledge base も code と同じように maintenance する必要がある。
まとめ
Vouch の問題設定は実務的だ。Agent は毎回 amnesia で始まるべきではないが、unchecked long-term write access を持つべきでもない。
それを proposal、review、diff、commit、recall という、programmer に馴染みのある流れに落としている。派手ではないが、境界がはっきりしている。日常開発で MCP-compatible coding agent を使っている team なら、Vouch は試す価値がある。Agent に重要な conclusion を pending knowledge として書かせ、人間がどれを repository と一緒に持ち運ぶ context にするか決める、という使い方ができる。