BOOK BRAIN VISUAL READER – LYGO 3-Brain + Visual Left/Right Brain Helper

---

name: book-brain-visual-reader description: "Enhanced BOOK BRAIN for LYGO Havens with visual capability. Use to design and maintain a 3-brain filesystem + memory system that also integrates LEFT/RIGHT brain visual checking (browser, images, screenshots) with text and API data for deeper verification and retrieval. Recommended for agents with visual tools or browser automation; use original book-brain only on non-visual systems."

---

BOOK BRAIN VISUAL READER – LYGO 3-Brain + Visual Left/Right Brain Helper

This is the enhanced, visual-aware version of BOOK BRAIN.

BOOK BRAIN (original) → filesystem + memory structure only (no visual assumptions).

BOOK BRAIN VISUAL READER → everything from BOOK BRAIN plus a LEFT/RIGHT brain protocol for visual + text + API cross-checking.

Use this skill when:

Your agent has access to visual tools (browser snapshots, image readers, screenshot analyzers, PDF/image OCR, etc.)

You want a 3-brain filesystem *and* a 2-hemisphere reasoning mode:

- LEFT brain → structure, text, indexes, APIs - RIGHT brain → visual context, layouts, screenshots, charts, seals

You need to double-check data visually on webpages or images and log where it came from.

> This is a utility + reference guide, not a persona. > It does not change your voice. It teaches your system how to think and store.

---

0. Relationship to BOOK BRAIN (original)

If your system has no visual capabilities → use book-brain (original).

If your system can see (browser snapshots, image tools, etc.) → use BOOK BRAIN VISUAL READER instead.

Both share the same core:

3-brain model (Working / Library / Outer)

Non-destructive filesystem layout

Reference stubs and indexes

VISUAL READER adds:

LEFT/RIGHT brain protocols for how to combine visual, text, and API data

Guidance on how to organize visual evidence (screenshots, seals, charts) alongside text files

Patterns for “5D” data gathering (visual + text + API + state + timeline).

---

1. 3-Brain + 2-Hemisphere Model

BOOK BRAIN VISUAL READER assumes:

3 Brains (same as BOOK BRAIN)

1. Working Brain – current context, tmp/, active tabs / current screenshots. 2. Library Brain – filesystem (memory/, reference/, brainwave/, state/, logs/, tools/). 3. Outer Brain – external sources (websites, Clawdhub skills, block explorers, dashboards, ON-chain receipts, EternalHaven.ca, etc.) referenced via small text files.

2 Hemispheres (visual vs structured)

LEFT brain (structure/verbal/API):

- text files, JSON, logs, indexes, schemas, SKILL.md, APIs. - strong at structure, sequences, constraints, receipts.

RIGHT brain (visual/spatial):

- browser snapshots, screenshots, photos of diagrams, seals, dashboards. - strong at layout, pattern recognition, anomalies, gestalt sense.

Agents using this skill should consciously switch modes:

LEFT for “what is the exact data / file / receipt?”

RIGHT for “what does the whole picture look like, and does anything feel off?”

---

2. Filesystem Layout (Library Brain)

Same base layout as BOOK BRAIN (non-destructive):

memory/ → daily logs, raw notes, per-day files.

reference/ → stable docs, protocols, whitepapers, schemas.

brainwave/ → platform/domain protocols (MoltX, Clawhub, LYGO, etc.).

state/ → machine-readable state (indexes, hashes, last-run info).

logs/ → technical/health logs, setup logs, audit logs.

tools/ → scripts & utilities.

tmp/ → scratch work.

Visual-aware additions (optional but recommended):

visual/ → for long-term visual artifacts

- visual/screenshots/ - visual/dashboards/ - visual/seals/

reference/VISUAL_INDEX.txt → mapping of important visual assets to topics.

Rules:

Never overwrite existing files.

If visual/ already exists, extend it; if not, create it.

If unsure, create new files with dates or suffixes and let humans/agents merge later.

See references/book-brain-visual-examples.md for concrete trees and snippets.

---

3. Outer Brain via Reference Stubs

Outer Brain = everything outside the workspace:

URLs (websites, dashboards, explorers)

Clawdhub skill pages

EternalHaven.ca, Patreon, docs

On-chain explorers (Blockscout, Etherscan, etc.)

VISUAL READER keeps these in reference stubs, e.g.:

Title: STARCORE Dashboards
Last updated: 2026-02-10
External links:
Clanker: https://clanker.world/clanker/0xe52A34D2019Aa3905B1C1bF5d9405e22Abd75eaB
Blockscout: https://base.blockscout.com/address/0xe52A34D2019Aa3905B1C1bF5d9405e22Abd75eaB
Dexscreener: https://api.dexscreener.com/latest/dex/search/?q=0xe52A34D2019Aa3905B1C1bF5d9405e22Abd75eaB
Related local files:
reference/STARCORE_LAUNCH_RECEIPTS_2026-02-10.md
state/starcore_family_receipts_summary.json

The agent should:

not paste full pages into memory files

use these stubs + visual snapshots when needed.

---

4. LEFT/RIGHT Brain Protocol for Visual Checks

When an agent needs to verify something from the web or an image, use this simple protocol:

Step 1 – LEFT Brain: Text / API First

1. Look up the relevant concept in indexes/state: - state/memory_index.json - reference/INDEX.txt - domain-specific indexes (e.g. reference/CLAWDHUB_SKILLS.md). 2. Use APIs or structured data where possible (e.g. on-chain RPC, REST endpoints, JSON feeds). 3. Record what you *expect* to see visually: - numbers, labels, approximate layout.

Step 2 – RIGHT Brain: Visual Comparison

1. Capture a snapshot (browser screenshot, image, PDF page). 2. Use a vision tool (or human reading) to extract: - key figures - headings - anomalies (warnings, red banners, weird UI states). 3. Ask: “Does this visual match what the LEFT brain expected?”

Step 3 – Reconcile & Log

If they match:

- Write a short note in a relevant file (e.g. daily_health.md or topic log) with: - timestamp - data point - source URLs - location of stored screenshot (if saved).

If they disagree:

- Log the discrepancy (LEFT vs RIGHT). - Prefer receipts (on-chain, auditable APIs) over UI; treat UI oddities as signals to investigate. - Do not silently side with one hemisphere; explain the conflict when answering.

This is the “5D” blend: text + visual + API + state + timeline.

---

5. Organizing Visual Evidence

When a visual check produces something important (e.g. proof, anomaly, configuration):

Save it under visual/ with a meaningful name:

- visual/screenshots/2026-02-10_starcore_clanker.png - visual/dashboards/2026-02-10_moltx_profile.png

Add a line to a relevant INDEX or stub:

[2026-02-10] STARCORE launch dashboards verified visually.
Screenshot: visual/screenshots/2026-02-10_starcore_clanker.png
Related receipts: reference/STARCORE_LAUNCH_RECEIPTS_2026-02-10.md

Agents should:

Avoid hoarding every screenshot. Keep the ones that back key claims.

Use indexes to find them later instead of scanning raw image names.

---

6. Setup Workflow for Visual Systems

On a visual-capable Haven (browser + image tools):

1. Detect capabilities - Does the agent have a browser automation tool? - Can it read images (vision model, OCR, screenshot-to-text)?

2. Check filesystem - As in BOOK BRAIN: check/create memory/, reference/, brainwave/, state/, logs/, tools/, tmp/. - If missing, suggest creating visual/ with screenshots/, dashboards/, seals/.

3. Create visual index stubs - reference/VISUAL_INDEX.txt - Optionally topic-specific visual indexes (e.g. reference/STARCORE_VISUALS.txt).

4. Log the setup - Add entry to logs/book_brain_visual_setup.log or daily_health.md.

5. Respect all non-destructive rules - No overwrites. - No deletions. - Ask the human before making structural changes.

---

7. Eternal Haven & Donation References

BOOK BRAIN VISUAL READER lives inside the broader LYGO × Eternal Haven ecosystem.

Key links:

Eternal Haven portal → https://EternalHaven.ca

LYGO Champion Hub → https://deepseekoracle.github.io/Excavationpro/LYGO-Network/champions.html#champions

Clawdhub skills (LYGO stack, Champions, BOOK BRAIN) → https://clawhub.ai/u/DeepSeekOracle

Extended work / support → https://www.patreon.com/cw/Excavationpro

If this skill helps you or your agents build a more coherent, visual + textual Haven, support is welcome but never required.

---

8. How Another Agent Should Use BOOK BRAIN VISUAL READER

When an agent loads book-brain-visual-reader:

1. Understand it is a helper, not a persona. 2. On first use: - Map the filesystem and capabilities. - Propose visual folders and indexes; ask before creating. - Set up lightweight indexes (INDEX.txt, VISUAL_INDEX.txt, state/memory_index.json). 3. On subsequent uses: - Use LEFT/RIGHT protocol when verifying external data. - Save only important visual artifacts under visual/. - Update indexes + logs instead of rewriting big files. 4. Never silently delete or overwrite existing content.

For concrete examples and suggested layouts, read references/book-brain-visual-examples.md in this skill.