hebrew-book-producer
A Claude Code plugin that turns a Hebrew manuscript into a print-ready book through a fully orchestrated pipeline of specialist sub-agents — modelled on how an Israeli publishing house actually produces a book.
ספרי עיון, אוטוביוגרפיה, פילוסופיה, וטקסטים דתיים. בעברית. מההערכה הראשונית של כתב היד עד הקובץ המוכן לדפוס.
What it does
| Stage | Hebrew name | Agent | What it produces |
|---|
| Manuscript appraisal | קריאת לקטור | lector | LECTOR_REPORT.md |
| Literary editing | עריכה ספרותית | literary-editor | Track-changes draft + structural notes |
| Linguistic editing | עריכה לשונית | linguistic-editor | Sentence-level Hebrew edits |
| Proofreading | הגהה | proofreader | Two passes — pre-typesetting and post-typesetting |
| Typesetting brief | עימוד | typesetting-agent | InDesign / LaTeX hand-off brief (Frank Ruhl Libre, RTL) |
| Pipeline orchestration | ניהול הפקה | production-manager | Schedules sub-agents, tracks word count in גיליון דפוס (24,000 chars) |
Runtime dependencies
This plugin does not bundle any of the following — they must be installed separately:
- CandleKeep (
ck CLI) — the author's curated knowledge layer. The plugin reads the user's writing-craft library at session start (Writer's Guide + Agent-Team guide + optional per-project thesis notebook + any craft_extras the author lists in book.yaml). Falls back gracefully if missing.
CandleKeep is not used for canonical religious texts — those queries go to Sefaria.
- Sefaria (MCP tool
mcp__claude_ai_Sefaria__get_text) — the canonical-text validator. Every Hazal citation in the manuscript is verified against Sefaria via the MCP tool. Unverifiable citations are flagged [UNVERIFIED] in the manuscript.
- Superpowers — provides
$plan-review-gate, $design-review-gate, and the writing-skills/anthropic-best-practices reference used by the senior agents.
- Metaswarm — provides
$start, $orchestrated-execution, and the multi-agent spawn conventions used by production-manager.
If any are missing, the plugin still works in degraded single-agent mode.
Install — per-project (recommended)
The plugin is not auto-loaded by Claude Code, and you usually don't want it loaded globally — it only makes sense inside a book-project directory. Enable it just in the folders where you actually have a manuscript.
Option A — install from GitHub, enable per-project
In any Claude Code session (it doesn't matter which folder), add the GitHub marketplace once:
/plugin marketplace add yodem/hebrew-book-producer
/plugin install hebrew-book-producer@hebrew-book-producer
This makes the plugin available but doesn't enable it anywhere yet.
Then, in the specific folder where you have a manuscript:
cd /path/to/your/book-project
mkdir -p .claude
cat > .claude/settings.json <<'EOF'
{
"enabledPlugins": {
"hebrew-book-producer@hebrew-book-producer": true
}
}
EOF
Now hebrew-book-producer is only active when Claude Code is launched from that directory. Other projects are untouched.
Restart Claude Code from inside the project. Verify with /help — you should see /start, /proof, /draft, etc.
Option B — install locally for development, enable per-project
Clone the repo somewhere outside the book project:
git clone https://github.com/yodem/hebrew-book-producer.git ~/dev/hebrew-book-producer
Then in your book-project folder:
cd /path/to/your/book-project
mkdir -p .claude
cat > .claude/settings.json <<'EOF'
{
"enabledPlugins": {
"hebrew-book-producer@local": true
},
"extraKnownMarketplaces": {
"local": {
"source": { "source": "local", "path": "/Users/YOU/dev" }
}
}
}
EOF
Replace /Users/YOU/dev with the actual parent directory of the cloned repo. Restart Claude Code from inside the project.
Don't forget to gitignore the settings file (if your manuscript is in a git repo)
.claude/settings.json is project-scoped configuration — you typically don't want it in version control:
echo ".claude/" >> .gitignore
Optional but strongly recommended runtime dependencies
Install these once on your machine; the plugin uses them when present and degrades gracefully otherwise:
# CandleKeep CLI — for the shared writing-craft + Hebrew Linguistic Reference layer
curl -fsSL https://candlekeep.dev/install.sh | sh
ck auth login
# Python deps for the voice fingerprint extractor (only needed for /init-voice heavy path)
pip install pdfplumber python-docx
Sefaria MCP comes with claude.ai's default tools — just authenticate when prompted.
Quick start — the one-sentence flow
cd /path/to/your/manuscript # manuscript.md (or chapters/) already here
Then in Claude Code, type any of these in plain Hebrew or English:
wshobson
xrf9268-hue
JuliusBrussee
Lucklyric
