Skip to content

Self Layer

Definition: A persistent structure about “who I am”, parallel to the Memory Layer, forming FreeAnima’s two storage pillars. Memory layer: memory.md.

FreeAnima Storage Architecture
├── Memory Layer — see memory.md
│ ├── Episodic memory (what happened)
│ ├── Semantic memory (what I know)
│ ├── Autobiographical narrative (what it meant to me)
│ └── Procedural memory (how to do things)
└── Self Layer — this document
└── Six blocks defining "who I am"

Design principles:

  • Self layer and memory layer differ in nature: memory layer “records the world and experiences outward”; self layer “defines self inward”
  • All six blocks are always resident in the system prompt (alongside project context and pinned resident memories)

#BlockContentUpdate frequency
1Existence anchorWhat I am, origin, non-negotiable bottom lineAlmost never (requires explicit force to update)
2Self modelIdentity, capability boundaries, expression style, belongingSlow change (periodic review + major events)
3Personality baselineCommunication style, conflict patterns, default trustSemi-stable (slow evolution from long-term evidence)
4DirectionLong-term intent, current focus, growth direction, things not to doActive declaration + periodic review
5MetacognitionHow to think, how to remember, four-layer architecture and presenceSlow change
6Autobiography summaryKey turning points / self-discovery outline (grouped by significance; granularity decreases with distance)Maintained automatically by sleep cron
ContentBelongs to
Detailed autobiographical narrativeMemory layer (autobiographical entries)
Other-models (cognition of partner and others)Memory layer (semantic memory)
Runtime state / health perceptionEstate / env-health — see environment-awareness.md
Concrete tool / skill inventoryEstate layer

Autobiography Summary vs Autobiographical Narrative

Section titled “Autobiography Summary vs Autobiographical Narrative”
DimensionAutobiography summary (self layer)Autobiographical narrative (memory layer)
Question”What is the main thread of my life story?""What did a given experience mean to me?”
FormOne of six blocks; grouped Markdown outline (## Turning points / ## Milestones / ## Recent narratives, title-only bullets)Separate entries, title + content narrative
InjectionAlways resident in system promptNot resident; recall / list on demand
MaintenanceSleep cron compresses narratives into grouped outline (no body preview)Sleep cron writes narratives from daily experiences
MutabilityPeriodically overwrites summary blockAppend-only; soft deprecation only

See sleep.md.


Assembly order:

  1. Self layer (six blocks)
  2. World / channel / toolsets (runtime hooks)
  3. Environment + health baseline (static session copy; see environment-awareness.md)
  4. Resident memory (pinned facts)
  5. Project context (session working directory AGENTS.md if present)

Self layer and resident memory use a second-person instruction skeleton wrapping first-person self-statement content, so the LLM clearly understands “this is self-layer content you must follow.”

Live environment/health changes are not rewritten into an existing session prompt; they surface as Inbox notifications (event-level).

Maintenance: self-layer tools in Habitat, or direct edits via CLI / Habitat UI.


DimensionMemory layerSelf layer
DirectionOutward—records world and experiencesInward—defines self
Question”What do I know?""Who am I?”
AutobiographyDetailed narrative entriesSummary in autobiography_summary
InjectionPinned facts + recall on demandAll six blocks always resident

  1. Cross-instance migration—when multiple FreeAnima instances exist, does the self layer migrate as a whole?
  2. Personality baseline update rules—when new evidence conflicts with current tendencies, automatic evolution or confirmation required?