A Claude Code subagent for pastry recipe lookup and Baker's Percentage calculation, built around a professional pastry recipe library.

The knowledge base and technique references in this agent reflect the author's personal industry experience (18+ years in professional kitchens and fine dining consulting) and publicly available culinary science. This project is not affiliated with, endorsed by, or associated with any culinary school or educational institution. The recipe library does not contain any confidential, proprietary, or internal recipes belonging to any educational brand or institution.

• Recipe lookup — find recipes by name (French or Chinese) or by ingredient
• Baker's % calculation — express every ingredient as a percentage of the base (flour, chocolate, etc.)
• Recipe scaling — scale any formula to a target batch size
• Technique Q&A — answer pastry science questions (ganache ratios, mousse stability, hydrocolloid selection, etc.) using a curated knowledge base

• Claude Code CLI
• Python 3.9+
• No external Python dependencies

cp agents/baker.md /path/to/your-project/.claude/agents/baker.md

Or place it in ~/.claude/agents/baker.md to make it available globally.

cp -r scripts/ data/ /path/to/your-project/

Drop .md recipe files into:

data/recipe-library/baker/_md/
data/recipe-library/baker/_md/glm/
data/recipe-library/baker/_md/glm/intermediate/

See Recipe Format below for the expected structure. An example file is included at data/recipe-library/baker/_md/example-brioche.md.

The agent always searches intermediate/ first (highest quality), then glm/, then _md/.

Once the agent is installed, Claude Code will automatically route pastry/recipe queries to the Baker Agent. You can also trigger it directly:

查一下 canele 的配方
帮我把这个 brioche 配方缩放到 2000g 面粉
配方库里哪些配方用到了 praliné？
慕斯为什么不稳定？
甘那许奶油和巧克力用什么比例？

# Find a recipe by name (French or Chinese both work)
python scripts/bakers_percent.py --find charlotte
python scripts/bakers_percent.py --find 可丽露

# Find all recipes using an ingredient
python scripts/bakers_percent.py --ingredient gélatine
python scripts/bakers_percent.py --ingredient 吉利丁

# Calculate Baker's % for a recipe
python scripts/bakers_percent.py data/recipe-library/baker/_md/brioche.md

# Override the base ingredient
python scripts/bakers_percent.py recipe.md --base chocolate

# Scale to a target batch (base ingredient = 2000g)
python scripts/bakers_percent.py recipe.md --scale 2000

Recipes are Markdown files with a YAML frontmatter block. The parser handles three source formats:

---
titre: BRIOCHE CLASSIQUE
niveau: basique
source: your-source
source_file: recipe.1.md
---

# BRIOCHE CLASSIQUE 经典布里欧修

## Pâte à Brioche 面团

| Ingrédients | 食材 |
|-------------|------|
| 250 g de farine T45 | 250 克 T45 面粉 |
| 150 g d'œufs | 150 克鸡蛋 |
| 150 g de beurre | 150 克黄油 |

## Pâte

- 250 g de farine
- 150 g d'œufs
- 150 g de beurre

Frontmatter fields:

Baker's % expresses every ingredient as a ratio of the base ingredient (100%):

Baker's % = (ingredient weight / base weight) × 100

Typical ranges:

data/recipe-library/baker/knowledge/ contains technique reference files covering:

MIT — see LICENSE.

The recipe files in _md/ are not included in this repository. Always ensure you have the right to digitize and use any recipe you add to this system.