Mind Palace

Mind Palace Navigation

Query keeper entities for codebase knowledge. Each entity guards a subsystem and knows HOW it works, WHY it's designed that way, and WATCH_OUT warnings.

Quick Reference

List entities: Read .mind-palace/palace.yaml for entity names

Query an entity: Read .mind-palace/entities/<entityname>.yaml (lowercase)

Available Keepers (22 total):

• MemoryKeeper - ChromaDB, summaries, retrieval
• SchedulingKeeper - Day phases, decision engine
• AgentKeeper - Claude SDK, Temple-Codex, tool execution
• SelfModelKeeper - Identity, observations, growth edges
• GoalsKeeper - Unified goals, hierarchies, approval workflow
• ConversationKeeper - Message persistence, threading
• And 16 more...

Entity Format

Each entity YAML contains:

name: MemoryKeeper
slug: memorykeeper          # Deterministic ID for cross-agent refs
location: memory
role: "Guardian of hierarchical vector memory..."
topics:
  - name: semantic search
    how: "Vector-based memory using ChromaDB..."
    why: "Finding relevant context requires semantic understanding..."
    watch_out: "Attractor basins use specific marker format..."

Slug System

All palace elements have deterministic slugs for cross-agent communication:

• Entities: memorykeeper, schedulingkeeper
• Rooms: memory-add-message (file-function pattern)
• Buildings: memory (file stem)
• Regions: backend (directory)

Path format: {region}/{building}/{room} → backend/memory/memory-add-message

Slugs survive regeneration - same codebase produces same slugs.

Sub-Palaces

Each major directory has its own sub-palace:

• backend/.mind-palace/ - Python backend
• admin-frontend/.mind-palace/ - React admin UI
• tui-frontend/.mind-palace/ - Textual TUI
• mobile-frontend/.mind-palace/ - React Native mobile

Root .mind-palace/ contains shared entities (Keepers). Sub-palaces contain regions/buildings/rooms for their scope.

Usage Examples

Before modifying the scheduler:

1. Read .mind-palace/entities/schedulingkeeper.yaml
2. Check topics for "day phases", "phase queues", "decision engine"
3. Note the WATCH_OUT warnings

Understanding memory system:

1. Read .mind-palace/entities/memorykeeper.yaml
2. Topics cover semantic search, hierarchical retrieval, journals, context sources

Finding the right entity:

1. Grep .mind-palace/entities/*.yaml for keyword
2. Read matched entity for full context

Files

• .mind-palace/palace.yaml - Palace index with entity list
• .mind-palace/entities/*.yaml - Individual entity definitions
• backend/mind_palace/ - Palace implementation code