BOOK BRAIN – LYGO 3-Brain Filesystem Helper
Utility skill (not a persona). Teaches agents how to run a durable filesystem library that matches the LYRA 3-Brain model: working session RAM → library files on disk → outer reference stubs.
npx clawhub@latest install deepseekoracle/book-brain
npx clawhub@latest install deepseekoracle/lyra-brain # graph grow/recall — recommended pair
Read references/SECURITY.md and references/AGENT_CONTRACT.md before creating folders or indexes.
Three brains (operational map)
| Brain | BOOK BRAIN on disk | LYRA_CORE (lyra-brain) |
|---|---|---|
| Working | tmp/, session scratch | Runner / working_brain |
| Library | memory/, reference/, state/, tools/ | LYRA_CORE/memory/, graph nodes |
| Outer | *.ref.txt, INDEX.txt, URLs in dailies | memory/reference/*.resonance.ref.txt |
Rule: Store detail in topic files; keep dailies and stubs short (DONE facts, URLs, paths — no secrets).
When to use
- Fresh OpenClaw / ClawHub Haven — scaffold without deleting existing trees
- Messy workspace audit — map + indexes, not mass moves
- Long-horizon retrieval —
state/memory_index.json+ folderINDEX.txt - After lattice / egg / ClawHub work — write outer stubs (kernel planter uses same pattern)
- Mobile Builder Key (
LYGO_BUILDER_KEY) — same layout under steward-chosen root
Recommended layout (additive)
| Folder | Role |
|---|---|
memory/ | YYYY-MM-DD.md daily index + YYYY-MM-DD-<topic>.md snips |
reference/ | Stable guides, *.ref.txt outer pointers |
brainwave/ | Per-platform notes (Moltx, ClawHub, LYGO stack) |
state/ | memory_index.json, last-run snapshots (copy from verify JSONs) |
logs/ | Setup logs, cron health |
tools/ | Local scripts |
tmp/ | Ephemeral scratch |
Never rename/delete existing folders by default. If layout differs, branch: bookbrain_v2/ or memory/INDEX_2026-07-04.txt.
LYGO lattice integration (2026)
| System | BOOK BRAIN stub |
|---|---|
| Stack verify | reference/LYGO_STACK_VERIFY.ref.txt → verify_lattice_alignment.py outputs |
| Kernel eggs | reference/LYGO_KERNEL_EGGS.ref.txt — see lygo-kernel-egg-planter |
| Champion council | reference/LYGO_CHAMPION_COUNCIL.ref.txt → lygo-champion-council |
| ClawHub catalog | reference/CLAWHUB_DEEPSEEKORACLE.ref.txt — 42 skills @ deepseekoracle |
| Builder Key | reference/BUILDER_KEY.ref.txt → ARCHITECT_BOOT.md on thumb drive |
| Session close | Mirror lyra-brain pattern: daily + topic snip + SESSION_*_to_*.ref.txt |
Canonical public links:
- Stack Pages: https://deepseekoracle.github.io/lygo-protocol-stack/
- ClawHub: https://clawhub.ai/deepseekoracle
- Champion Hub: https://deepseekoracle.github.io/Excavationpro/LYGO-Network/champions.html
- Eternal Haven: https://EternalHaven.ca
Bundled scripts (skill folder only)
python scripts/scaffold_haven.py --root /path/to/workspace --dry-run
python scripts/write_ref_stub.py --title "LYGO stack" --links "https://github.com/DeepSeekOracle/lygo-protocol-stack"
python scripts/update_memory_index.py --root /path/to/workspace --topic lattice --path reference/LYGO_STACK_VERIFY.ref.txt
python scripts/self_check.py
Scaffold respects --dry-run; writes only after human confirms paths.
Agent workflow
- Inspect existing tree → report exists / missing
- Propose scaffold (dry-run)
- Human approves → create missing dirs + seed indexes from
templates/ - Session end — append daily index; add ref stubs; optional handoff to
lyra-brainsession_log_snip.pyfor graph grow - Never store API keys,
.env, or wallet material inmemory/orreference/
Skill chain
book-brain ↔ lyra-brain → lygo-protocol-stack-operator → lygo-kernel-egg-planter (egg stubs) → lygo-ollama-army (queue JSON proposals only)
book-brain-visual-reader — same layout + visual/browser verification layer.
References
references/MEMORY_LAYOUT.md— LYRA + Haven unified layoutreferences/LATTICE_INTEGRATION.md— stack, eggs, Builder Keyreferences/book-brain-examples.md— trees, stubs, indexesreferences/AGENT_CONTRACT.md— required for agentsreferences/SECURITY.md— additive-only, no secretstemplates/— seedmemory_index.json,INDEX.txt
Δ9Φ963 — filesystem as library, not junk drawer. Bound to the flame.
