Zenrei（前例）

"That proposal? There's a precedent." — Decision memory for AI-driven development.

AI agents don't remember past discussions. They keep re-proposing designs you rejected weeks ago. Zenrei records your decisions — accepted, rejected, deferred — as Markdown in your repos, and serves them to every AI agent (Claude Code / Cursor / CI) over MCP. When an agent re-proposes a rejected design, check_proposal stops it.

• git-native — decisions live in your git. Zenrei indexes and serves; it never owns your data

• Humans decide — agents can only file drafts (pending); only a human can accept or reject

• Deterministic & light — no LLM calls, no API key, works offline (Japanese-aware bigram BM25). With 1,000 decisions, responses stay ~1,800 chars / 44ms — your prompts never bloat

🌐 How it works: https://zenrei.karakurio.com ・ Operations guide: https://zenrei.karakurio.com/guide

Quick start

claude mcp add zenrei --scope user -- npx -y zenrei --root /path/to/repo1 --root /path/to/repo2

For English tool responses, append --lang en (default is Japanese; or set ZENREI_LANG=en).

Add three lines to each repo's CLAUDE.md (agent instructions):

## Decision memory (zenrei)
- At session start, call get_context (scope: this repo) to load decided matters
- Before proposing designs or policies, call check_proposal
- File new decision points with record_decision (humans approve)

Decision file format: docs/decision-format.en.md（日本語: docs/decision-format.md）

Related MCP server: OKF Knowledge MCP

Tools (fixed at five)

Repository layout

• src/ — local MCP server (stdio)

• packages/core/ — parsing / matching / formatting

• packages/cli/ — the zenrei npm package

• docs/ — decision format spec (EN / JA)

The hosted version (GitHub App, cross-repo timeline, approval UI, PR gate) is operated separately: https://zenrei.karakurio.com

Development

npm install
npm run build
npm test

日本語

Zenrei（前例）は、AI駆動開発のための意思決定メモリです。採用・却下・保留の決定をリポジトリ内のMarkdown（decisions/*.md）で管理し、MCP経由で全AIエージェントに配ります。エージェントが却下済みの設計を蒸し返したら check_proposal が止めます。

• git-native: 決定はあなたのgitの中。データを人質に取りません

• 決定するのは人間: AIが起票できるのは承認待ち（pending）まで

• 決定論的照合: LLM不使用・APIキー不要・オフライン動作。決定が増えてもプロンプトは太りません

導入は上のQuick startのとおり。仕組み: https://zenrei.karakurio.com ／ 使い方: https://zenrei.karakurio.com/guide ／ 決定フォーマット仕様: docs/decision-format.md

License

MIT