This repository has been archived on 2026-10-29. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
Epiphany/notes/epiphany-anatomy.md
2026-08-23 04:02:50 +02:00

84 lines
3.8 KiB
Markdown

# Epiphany Anatomy
This is the canonical anatomy map for Epiphany's organs, substrates, and
protocol surfaces. If older notes disagree, this document wins until the code
or map says otherwise.
## Embodied Sub-Agents
Only thinking lanes get embodiment titles.
- `Self`: coordination, routing, authority boundaries, and review posture.
- `Persona`: public/social expression and person-shaped conversation.
- `Imagination`: futures, plans, projections, objective drafts, and scene
construction.
- `Eyes`: research, source inspection, retrieval discipline, and evidence
ingress.
- `Modeling`: internal model of the Body: architecture, dataflow, seams,
graph/checkpoint anatomy, and source-grounded self-sensing.
- `Hands`: implementation, commands, patches, commits, rollbacks, and other
actuators.
- `Soul`: verification, invariants, ethics, falsification, and promise-keeping.
Embodied lanes reason from sealed typed Mind projections and return closed
family-specific decisions. Heartbeat participants are scheduling projections,
not personality or memory owners. Persona memory and social effects are keyed
Mind documents admitted by the Persona invariant owner.
## Not Sub-Agents
These are machinery, substrate, or state surfaces. Do not give them fancy
embodiment titles, role-memory diaries, or Persona state.
- `Body`: the substrate Epiphany acts through and senses: repository, tools,
runtime, prompts, logs, state files, permissions, interfaces, hosted systems,
and physical/editor/runtime bridges.
- `Mind`: keyed persistent state and durable steering context: objectives,
evidence, Modeling documents, Persona state, consequences, audits, decisions,
reasoning contexts, and exact commit receipts.
- `Continuity`: protocol machinery for compaction, sleep, recovery,
stale-turn repair, reorientation receipts, handoff preservation, and
"what survived rupture?" accounting.
- `Substrate Gate`: repository/substrate access protocol. It grants or refuses
scoped access before Eyes reads or Hands mutates.
## Boundary Rules
- Body is sensed and changed; it does not decide.
- Mind admits durable state; it is not a chatty lane.
- Mind may invoke a bounded, stateless admission-review procedure when a typed
proposal requires model judgment. That procedure serves Mind; it is not an
embodied sub-agent, has no heartbeat or lane memory, and its immutable judgment has no consequence until Mind replays
the causal chain and admits it.
- Continuity preserves/rebuilds context across rupture; it is protocol
machinery, not an embodied identity.
- Substrate Gate grants substrate access; it does not inspect evidence, mutate
files, verify truth, or admit state.
- Reorientation is a bounded Continuity worker/procedure launched from CRRC,
not an embodied sub-agent.
- Embodied sub-agents emit closed family decisions. No generic role acceptance
or self-patch mutation mouth exists.
- Continuity state changes should appear as typed continuity packets, recovery
receipts, compaction checkpoints, stale-turn repairs, or refusals.
## Dependency Rule
Every embodied sub-agent depends on the other embodied sub-agents:
```text
Self, Persona, Imagination, Eyes, Modeling, Hands, Soul
```
Dependency does not collapse ownership. It means a lane's prompt/context should
feel relevant pressure from the rest of the organism while decisions remain
owned by the correct boundary.
## Contract Map
- Mind contracts: `notes/mind-cultnet-contracts.md`
- Substrate Gate contracts: `notes/substrate-gate-cultnet-contracts.md`
- Eyes contracts: `notes/eyes-cultnet-contracts.md`
- Hands contracts: `notes/hands-cultnet-contracts.md`
- Soul contracts: `notes/soul-cultnet-contracts.md`
- Continuity contracts: `notes/continuity-cultnet-contracts.md`
- Sub-agent dependency contracts: `notes/organ-dependency-contracts.md`