Skip to main content
AI/MLathola

session-palace-builder

Builds session-scoped temporary memory palaces for extended conversations. Use when tracking state across interruptions in a multi-step project.

Stars
294
Source
athola/claude-night-market
Updated
2026-05-30
Slug
athola--claude-night-market--session-palace-builder
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/athola/claude-night-market/HEAD/plugins/memory-palace/skills/session-palace-builder/SKILL.md -o .claude/skills/session-palace-builder.md

Drops the SKILL.md into .claude/skills/session-palace-builder.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Table of Contents

Session Palace Builder

Construct temporary, session-specific memory palaces for extended conversations and complex projects. Preserves context across interruptions and enables structured information accumulation.

What It Is

Session palaces are lightweight, temporary memory structures that:

  • Preserve context for extended conversations
  • Track decisions and their rationale
  • Organize project artifacts spatially
  • Enable context recovery after interruptions
  • Support collaborative information gathering

Quick Start

Build Commands

```bash

Run build

make build

Clean and rebuild

make clean && make build ```

Testing

```bash

Run tests

make test

Run with verbose output

make test VERBOSE=1 ```

Verification: Run make build && make test to confirm build works.

When To Use

  • Extended conversations requiring context preservation
  • Complex, multi-step projects with interrelated components
  • Workflows requiring state management across interactions
  • Collaborative sessions accumulating information over time
  • Code review or debugging sessions with many findings

When NOT To Use

  • Permanent knowledge structures needed - use memory-palace-architect
  • Searching existing knowledge
    • use knowledge-locator
  • Permanent knowledge structures needed - use memory-palace-architect
  • Searching existing knowledge
    • use knowledge-locator

Session Palace Templates

Template Purpose Key Areas
Workshop Active development Workbench, tools, materials
Library Research and analysis Stacks, reading room, archives
Council Chamber Decision-making Round table, evidence wall, vote board
Observatory Exploration and discovery Telescope, star charts, log book
Forge Implementation tasks Anvil, cooling rack, finished goods

Information Categories

Organize session content into these standard areas:

  • Conversations - Dialogue threads and key exchanges
  • Decisions - Choices made with rationale
  • Code - Snippets and technical artifacts
  • Research - Findings and references
  • Requirements - Specifications and constraints
  • Progress - Completed milestones
  • Issues - Blockers and challenges
  • Next Steps - Pending action items

Core Workflow

  1. Analyze Context - Assess session scope and complexity
  2. Design Palace - Select template and layout
  3. Structure State - Organize information spatially
  4. Build Navigation - Create access shortcuts
  5. Test Integration - Verify context preservation

Session Lifecycle

Create → Populate → Navigate → Export/Archive
   ↑         ↓          ↓
   └─── Checkpoint ←────┘

Verification: Run the command with --help flag to verify availability.

Clarity Checkpoints

A session palace decays silently: each Populate step can add ambiguity that only surfaces at Export, when it is too late to recover the lost state. MMPO (arXiv:2605.30159, Section 3) frames this as a case for sub-trajectory dense rewards: check intermediate quality at each transition, not just the final outcome.

At every Checkpoint arrow in the lifecycle above (and before any Export/Archive), run the dual-probe gate against the current palace state:

Skill(memory-palace:memory-clarity-probe)

The probe returns a Clarity Assessment with progress/gap verdicts and a Recommendation:

Recommendation Action at the checkpoint
Proceed Palace state is clear; continue the session
Expand memory Add the gap probe's open items to the palace before continuing
Regenerate Flag the session as ambiguous: the progress probe hedges, so reconstruct the current-state room before more work lands on it

Flagging at the checkpoint, not at export, is the point: an ambiguous palace caught early costs one room rebuild; caught at export it costs the session.

When memory-clarity-probe is not installed, ask the two anchor questions inline (progress: what is done and what state is the task in; gap: what concrete items remain) and apply the same table.

Detailed Resources

  • Template Details: See modules/templates.md
  • State Management: See modules/templates.md
  • Export Patterns: See modules/templates.md

Integration

  • memory-palace-architect - Export important concepts to permanent palaces
  • knowledge-locator - Search session content
  • digital-garden-cultivator - Seed garden with session insights
  • memory-clarity-probe - Dual-probe clarity gate at session checkpoints

Exit Criteria

  • A session palace is created with a template and spatial layout before any state is populated
  • The dual-probe clarity gate runs at each Checkpoint transition and before Export/Archive, not only at the end
  • A checkpoint returning Expand memory or Regenerate is acted on (gap items added or current-state room rebuilt) before more work lands, and the ambiguous session is flagged
  • Exported concepts round-trip into a permanent palace via memory-palace-architect