mind-palace

Navigate Mind Palace to query entity knowledge about codebase subsystems. Use when understanding architecture, exploring how systems work, or checking for hazards/gotchas before modifying code.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

The Mind Palace skill is a sophisticated architectural knowledge retrieval system designed to help developers and AI agents navigate complex codebase subsystems. By querying structured 'Keeper' entities, it provides deep insights into implementation logic, design rationale, and critical 'watch-out' warnings, ensuring that modifications are made with a full understanding of the system's architecture and potential hazards.

Use Cases

  • Architectural Onboarding: Quickly grasp the high-level structure and responsibilities of various codebase subsystems without manual code tracing.
  • Pre-Modification Risk Assessment: Check for 'watch_out' warnings and known hazards before modifying critical components like schedulers or memory systems.
  • Design Rationale Discovery: Understand the 'why' behind specific architectural decisions to ensure new changes align with the original design philosophy.
  • Cross-Subsystem Navigation: Use deterministic slugs to explore dependencies and relationships between different modules (e.g., backend vs. frontend sub-palaces).
  • Technical Debt Identification: Query entities to find documented 'growth edges' and areas where the system architecture requires refinement.
namemind-palace
descriptionNavigate Mind Palace to query entity knowledge about codebase subsystems. Use when understanding architecture, exploring how systems work, or checking for hazards/gotchas before modifying code.
allowed-toolsRead, Glob, Grep

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