athola Palace Diagram
Generate Mermaid and ASCII diagrams from the knowledge graph, showing palace structure, entity relationships, synapse connectivity, and tier assignments.
Status: wired. Invoke via
/palace diagram <palace-id> [--type map|ascii|entity|heatmap], which callsSkill(memory-palace:palace-diagram). The renderer lives inmemory_palace.palace_renderer.PalaceRenderer; see the Usage section below for direct programmatic access.
When To Use
- Inspecting palace structure after creation or migration
- Understanding knowledge topology and connections
- Identifying strong and weak synapses (heatmap)
- Reviewing entity relationships and triples
- Getting an ASCII overview for inline display
When NOT To Use
- Creating palaces: use memory-palace-architect
- Searching knowledge: use knowledge-locator
- Code architecture diagrams: use cartograph
Diagram Types
| Type | Format | Description |
|---|---|---|
| Palace map | Mermaid flowchart | Rooms as subgraphs, entities as nodes, synapses as edges |
| Entity graph | Mermaid flowchart | Single entity's connections and triples |
| Synapse heatmap | Mermaid flowchart | Edge styling by strength (thick=strong, dotted=weak) |
| ASCII overview | Text | Box-drawing palace layout with entity counts |
Workflow
- Identify palace by ID or name
- Choose diagram type based on what you want to see
- Generate diagram using
PalaceRenderer - Render via Mermaid Chart MCP (for Mermaid) or display inline (for ASCII)
Usage
Palace Map
from memory_palace.knowledge_graph import KnowledgeGraph
from memory_palace.palace_renderer import PalaceRenderer
graph = KnowledgeGraph("path/to/knowledge_graph.db")
renderer = PalaceRenderer(graph)
mermaid = renderer.palace_map("palace_id")
Then call mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagram
with the generated Mermaid string.
ASCII Overview
ascii_art = renderer.ascii_overview("palace_id")
print(ascii_art)
Entity Graph
mermaid = renderer.entity_graph("entity_id")
Synapse Heatmap
mermaid = renderer.synapse_heatmap("palace_id")
Edge Styling
| Strength | Style | Meaning |
|---|---|---|
| >= 0.7 | ==> (thick) |
Strong connection |
| >= 0.4 | --> (normal) |
Medium connection |
| < 0.4 | -.-> (dotted) |
Weak connection |
Integration
Works with:
memory-palace-architect: visualize after palace creationknowledge-locator: display search results as graphgraph-analyzer: tier-informed node sizing
Exit Criteria
- At least one of the four diagram types (palace map, entity graph,
synapse heatmap, ASCII overview) is generated without a Python
exception from
PalaceRenderer - Mermaid diagrams are passed to
mcp__claude_ai_Mermaid_Chart__validate_and_render_mermaid_diagramand render successfully - ASCII overview displays rooms with box-drawing characters and entity counts per room
- Synapse edge styling matches strength thresholds:
==>for strength ≥ 0.7,-->for ≥ 0.4,-.->for < 0.4 - If the requested palace ID does not exist in the knowledge graph, an error is reported with the palace ID that was searched