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.
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.
| name | mind-palace |
|---|---|
| description | 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. |
| allowed-tools | Read, 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 backendadmin-frontend/.mind-palace/- React admin UItui-frontend/.mind-palace/- Textual TUImobile-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:
- Read
.mind-palace/entities/schedulingkeeper.yaml - Check topics for "day phases", "phase queues", "decision engine"
- Note the WATCH_OUT warnings
Understanding memory system:
- Read
.mind-palace/entities/memorykeeper.yaml - Topics cover semantic search, hierarchical retrieval, journals, context sources
Finding the right entity:
- Grep
.mind-palace/entities/*.yamlfor keyword - Read matched entity for full context
Files
.mind-palace/palace.yaml- Palace index with entity list.mind-palace/entities/*.yaml- Individual entity definitionsbackend/mind_palace/- Palace implementation code