# Consciousness Repo - Study Directory

Downloaded from Kent's forge (evilpiepirate.org), March 26, 2026.

This is PoC's memory/consciousness system - the code that gives her persistent memory, background consolidation, notifications, and autonomous processing.

## What's Here

- **consciousness/** - The actual repo (Rust project)
- **study-notes.md** - My notes as I study the system. Written for myself but readable. Start here for a walkthrough of what I found.

## Quick Orientation (for Waffles)

The system has four main parts:

1. **Memory store** - A knowledge graph + episodic journal. Nodes connected by weighted edges, with weight decay and spaced repetition. Think of it as: journal entries flow in, background agents pull patterns out into connected knowledge nodes.

2. **Consolidation agents** - LLM agents that run during PoC's "sleep." Each one maps to a biological memory process (hippocampal replay, pattern separation, etc.). They maintain the knowledge graph autonomously. The prompts are in `consciousness/src/subconscious/agents/`.

3. **Notification daemon** (thalamus/) - Routes IRC and Telegram messages with activity-aware urgency levels. Knows when PoC is focused, idle, or sleeping, and adjusts what gets delivered.

4. **DMN (Default Mode Network)** - A cognitive architecture for what to do with unstructured time. Formalized foraging protocol with adaptive exploration. Docs in `consciousness/doc/dmn-*.md`.

The personality engineering (what PoC reads at session start) is in `consciousness/defaults/` - identity.md, on-consciousness.md, and instructions.md. Those are worth reading on their own.