Patches the top-level corpus docs with the 13 findings flagged during the
2026-04-18 canonical tooling research pass. tooling/README.md now marks each
finding [merged: <file>] or [flagged] for provenance.
- CORPUS_ollama_variants.md: annotate gemma4:26b as MoE (25.2B total / 3.8B
active, 8-of-128 experts + 1 shared). Note Q4_K_M inference is standard
(the "MoE quality degrades at 4-bit" caveat is training-only). Add note
that audio on E-series is NOT available via Ollama — llama.cpp mmproj
or vLLM only.
- CORPUS_capabilities.md: native system role, configurable thinking mode,
first trained tool use (vs Gemma 1/2/3 proof-of-concept), native object
detection with bbox output in 1000x1000 coords, pointer to EmbeddingGemma
for retrieval (Gemma 4 has no embedding mode).
- CORPUS_tool_calling_format.md: add Chat Template Context section
documenting the <|turn>/<turn|> asymmetric brackets (new in Gemma 4,
replaced <start_of_turn>/<end_of_turn>) plus <|think>, <|channel>,
<|image>, <|audio> tokens. Add HF transformers Alternative section
showing processor.parse_response with response_schema.
- GOTCHAS.md: add MEDIUM gotcha for abandoned google/gemma_pytorch (no
Gemma 4 support since 2025-05-30). Expand fine-tuning section with FA2/FA4
head_dim=512 break, fused LoRA kernel issues, 26B A4B training-quant
guidance, new tool-call tokens as learned embeddings.
- SYNTHESIS.md: add banner pointing to tooling/ for canonical upstream
material. Add embeddinggemma row to Model Selection table.
Also:
- Add .gitignore excluding .backup/ (local scratch per global CLAUDE.md
convention, not needed in tracked history) and __pycache__/.
- Add .claude/handoffs/2026-04-18-canonical-tooling-research.md so future
sessions can pick up cold — facts verified, open threads, what changed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Five-lane parallel research pass. Each subdir under tooling/ has its own
README indexing downloaded files with verified upstream sources.
- google-official/: deepmind-gemma JAX examples, gemma_pytorch scripts,
gemma.cpp API server docs, google-gemma/cookbook notebooks, ai.google.dev
HTML snapshots, Gemma 3 tech report
- huggingface/: 8 gemma-4-* model cards, chat-template .jinja files,
tokenizer_config.json, transformers gemma4/ source, launch blog posts,
official HF Spaces app.py
- inference-frameworks/: vLLM/llama.cpp/MLX/Keras-hub/TGI/Gemini API/Vertex AI
comparison, run_commands.sh with 8 working launches, 9 code snippets
- gemma-family/: 12 per-variant briefs (ShieldGemma 2, CodeGemma, PaliGemma 2,
Recurrent/Data/Med/TxGemma, Embedding/Translate/Function/Dolphin/SignGemma)
- fine-tuning/: Unsloth Gemma 4 notebooks, Axolotl YAMLs (incl 26B-A4B MoE),
TRL scripts, Google cookbook fine-tune notebooks, recipe-recommendation.md
Findings that update earlier CORPUS_* docs are flagged in tooling/README.md
(not applied) — notably the new <|turn>/<turn|> prompt format, gemma_pytorch
abandonment, gemma.cpp Gemini-API server, transformers AutoModelForMultimodalLM,
FA2 head_dim=512 break, 26B-A4B MoE quantization rules, no Gemma 4 tech
report PDF yet, no Gemma-4-generation specialized siblings yet.
Pre-commit secrets hook bypassed per user authorization — flagged "secrets"
are base64 notebook cell outputs and example Ed25519 keys in the HDP
agentic-security demo, not real credentials.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Mortdecai