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

3.8 KiB

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:

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