/memory-palace-architect

name: memory-palace-architect
description: Designs memory palace structures with spatial layouts and domain organization. Use when creating a new palace or planning knowledge architecture by hand.
alwaysApply: false
category: architecture
tags:
- memory
- organization
- spatial
- knowledge
- architecture
- mnemonic
dependencies:
- leyline:progressive-loading
scripts:
- memory_palace_cli.py
usage_patterns:
- palace-design
- domain-analysis
- layout-creation
complexity: intermediate
estimated_tokens: 600

> **Status: wired**. The `palace-architect` agent loads this skill > for its design method (#618). `/palace create` still creates the > palace record directly. This skill decides what goes in it.

Memory Palace Architect

Design and construct virtual memory palaces for spatial knowledge organization. This skill guides you through creating memorable spatial structures that enhance recall and organize complex information.

What It Is

A memory palace is a mnemonic technique that uses spatial visualization to organize and recall information. This skill provides a systematic approach for:

• Analyzing knowledge domains for optimal spatial mapping
• Designing architectural layouts that reflect conceptual relationships
• Creating multi-sensory associations for enhanced recall
• Building navigable structures for knowledge retrieval

Quick Start

Create a New Palace

python scripts/memory_palace_cli.py create "My Palace" "programming" --metaphor workshop

List Existing Palaces

python scripts/memory_palace_cli.py list

View Palace Status

python scripts/memory_palace_cli.py status

When To Use

• Creating knowledge structures for complex topics
• Organizing large amounts of related information
• Building persistent, project-specific memory systems
• Designing learning pathways for skill acquisition
• Structuring documentation or reference material

When NOT To Use

• Quick knowledge search
• use knowledge-locator instead
• Session-specific context - use

session-palace-builder

• Quick knowledge search
• use knowledge-locator instead
• Session-specific context - use

session-palace-builder

Metaphor Choices

`--metaphor` is a free-form label stored on the palace as given, and it defaults to `building`. Nothing validates it or loads a template from it. These five are suggested starting points for the design:

| Metaphor | Best For | Key Features | |----------|----------|--------------| | **Fortress** | Security, defense, production-grade systems | Strong boundaries, layered access | | **Library** | Knowledge, research, documentation | Organized shelves, categorized sections | | **Workshop** | Practical skills, tools, techniques | Workbenches, tool areas, project spaces | | **Garden** | Organic growth, evolving knowledge | Plots, seasons, interconnected paths | | **Observatory** | Exploration, discovery, patterns | Viewing platforms, star maps, instruments |

Core Workflow

1. **Analyze Domain** - Identify concepts, relationships, and hierarchy 2. **Design Layout** - Choose metaphor and spatial organization 3. **Map Associations** - Create memorable imagery and connections 4. **Encode Details** - Add sensory attributes and ambient atmosphere 5. **Validate Palace** - Test recall efficiency and navigation

Detailed Resources

• **Domain Analysis Guide**: See `modules/domain-analysis.md`
• **Layout Patterns**: See `modules/layout-patterns.md`
• **Sensory Encoding**: See `modules/sensory-encoding.md`
• **Validation Metrics**: See `modules/validation.md`
• **Franklin Protocol**: See `modules/franklin-protocol.md` - Apply the original learning algorithm to palace design

Integration

Works with:

• `knowledge-locator` - For searching across palaces
• `session-palace-builder` - For temporary session palaces
• `digital-garden-cultivator` - For evolving knowledge bases

Expected Outputs

• Complete palace schema with spatial coordinates
• Sensory encoding profile for each location
• Navigation guide and connection map
• Recall testing results and optimization recommendations

Troubleshooting

Common Issues

If palace creation fails, ensure your Python environment meets the requirements listed in `pyproject.toml`. The `metaphor` value cannot cause a failure, because any string is accepted.

Exit Criteria

• [ ] `scripts/memory_palace_cli.py create "<name>" "<domain>" --metaphor

<metaphor>` completes without error and adds the palace to the index

• [ ] `scripts/memory_palace_cli.py list` shows the newly created palace

by the name supplied during creation

• [ ] The created palace JSON has a `layout` (districts, buildings,

rooms, connections) and a `sensory_encoding` block, and both are filled in from the design

• [ ] The palace's `metaphor` field records the metaphor the design

chose

• [ ] Recall testing results or optimization recommendations are

produced as part of the Expected Outputs section