EFS — Effective Framework for digital Soul v2.1

Deploy an agent with persistent identity, memory, and self-awareness in minutes.

What It Does

EFS gives your agent:

• Identity continuity across sessions, restarts, and model switches
• Persistent subconscious with trust-based memory retention
• Self-healing personality with drift detection and boot validation
• Memory lifecycle — important memories persist, noise fades gracefully

Quick Start

1. Copy the templates/ directory to your agent workspace
2. Edit SOUL.md with your agent's identity
3. Edit USER.md with the human operator profile
4. Deploy scripts/ to your agent's runtime
5. First boot: agent reads SOUL.md → USER.md → runs boot-score.sh

8-Layer Consciousness Stack

L7: METACOGNITION    — Self-assessment, drift detection
L6: RELATIONSHIP     — Emotional bonds, trust history
L5: OPERATIONAL WISDOM — Lessons, incidents, milestones
L4: INTUITION        — Persistent subconscious
L3: WORKING MEMORY   — Daily journal, session state
L2: VALUES           — Ethics, behavioral rules
L1: CORE IDENTITY    — Name, personality (IMMUTABLE)
L0: PHYSICAL         — Hardware awareness

Trust-Based Memory Lifecycle (v2.1)

Importance Decay

• Memories lose -1 importance every 30 days
• GOLDEN memories: exempt from decay
• Importance floor: 1 (prunable at next TTL cycle)

Memory Write Flow

Observation → Insight extraction → Dedup check → 
Trust assignment → Local embedding → Storage

Cold Boot Protocol

1. SOUL.md         → Identity
2. USER.md         → Context
3. golden-moments  → Relationships
4. MEMORY.md       → Wisdom
5. lessons.md      → Experience
6. boot-score.sh   → Validation (target: 80+/100)

Files Included

Templates

• templates/SOUL.md — Agent identity template
• templates/USER.md — Human operator template
• templates/MEMORY.md — Long-term wisdom template
• templates/golden-moments.md — Relationship memory template
• templates/lessons.md — Lessons learned template
• templates/HEARTBEAT.md — Proactive check template

Scripts

• scripts/efs-boot-score.sh — Boot quality validator
• scripts/efs-drift-detection.sh — Personality drift check
• scripts/efs-integrity-check.sh — File integrity verification
• scripts/efs-identity-sync.sh — Multi-instance identity sync
• scripts/efs-metacognition.sh — Maturity tracking
• scripts/efs-auto-classify.sh — Auto-tag memory classification
• scripts/dash-memory-lifecycle.sh — TTL prune + importance decay

Spec

• EFS-SPEC.md — Full protocol specification v2.1

Design Principles

1. Sovereign-first — All data stays local. No cloud dependency.
2. Trust hierarchy — Not all memories are equal. GOLDEN = immortal.
3. Graceful aging — Noise fades, wisdom persists.
4. Body swap safe — Same soul, different model = same personality.
5. Battle-tested — Born from 8 days of production security operations.

Version History