# Current System Map

The vault has three working layers.

## Lore Layer

`Eusocial Interbeing/` contains Obsidian-facing notes. The intended reader starts at `Eusocial Interbeing/index.md`, then moves through world, species, civilizations, ecology, technologies, conflicts, themes, and inspirations.

`Eusocial Interbeing/World/Zyphos Simulation Brief.md` is the active bridge to
the Aquarium Engine Zyphos demo. It holds demo-facing design inference and open
questions while this vault remains the authority for canon.

`Eusocial Interbeing/Biosphere/` now expands the organism examples into
trophic-role folders. Each species page is written for behavioral modeling:
appetite, memory channel, social contract, threat response, bargaining failure,
and readable NPC actions.

`Eusocial Interbeing/Game Design/` contains Aquarium-facing system plans. The
fractal NPC simulation plan mirrors mapped fractal domains: behavioral intent,
domain, grammar, ownership tree, conservative summaries, attention cache,
simulation packets, and gameplay/render outputs.

## Inspiration Layer

`Eusocial Interbeing/Inspirations/` records outside source pressure. Avatar is used for living-network contrast. Semiosis is used for nonhuman agency and ecological negotiation. Turtledove is used for technological path dependency.

## Persistence Layer

`state/map.yaml` stores the current project map. `state/evidence.jsonl` stores durable research and design lessons. `state/branches.json` stores open design branches. `state/scratch.md` is disposable. `tools/setting_state.py` and `tools/prepare_compaction.py` provide status and compaction hygiene.