/context-preserve

Session Start
    |
    v
LOAD LATEST CONTEXT
    +-- Scan .claude/session-context/
    +-- Identify most recent session file
    +-- Parse restoration instructions
    +-- Validate context integrity
    |
    v
ACTIVE SESSION MONITORING
    +-- Track file modifications
    +-- Record decisions and rationale
    +-- Capture agent handoffs
    +-- Monitor quality gate results
    |
    v
TRIGGER-BASED PRESERVATION
    +-- Auto-save (configurable interval)
    +-- Phase completion snapshots
    +-- Agent handoff transfers
    +-- Error/termination emergency saves
    |
    v
FORENSIC SEALING
    +-- Content hash generation
    +-- Timestamp embedding
    +-- Cross-reference validation
    +-- Integrity verification
    |
    v
PERSISTENT STORAGE
    +-- .claude/session-context/{dated-file}.md
    +-- LATEST_SESSION.md symlink update

# Auto-save with default settings (30-minute interval, comprehensive format)
/context-preserve

# Configure auto-save interval to 15 minutes
/context-preserve auto --interval 15

# Set minimal format for high-frequency saves
/context-preserve auto --interval 5 --format minimal

# Manual comprehensive save at current point
/context-preserve manual --format comprehensive

# Forensic-grade save with full audit trail
/context-preserve manual --format forensic

# Quick checkpoint save with label
/context-preserve manual --format standard --label "pre-refactoring"

# Save at phase completion
/context-preserve phase-complete --audit-trail true

# Agent handoff with full context transfer
/context-preserve agent-handoff --coordination true

# Emergency save on error detection
/context-preserve error --format comprehensive

/context-preserve [trigger] [options]
    |
    v
PHASE 1: TRIGGER DETECTION (< 50ms)
    +-- Identify preservation trigger type
    +-- Validate authority (MANDATORY level)
    +-- Load current session metadata
    +-- Determine format requirements
    |
    v
PHASE 2: STATE CAPTURE (< 500ms)
    +-- Snapshot current session state
    +-- Collect file modification log
    +-- Record pending decisions and actions
    +-- Gather quality gate results
    +-- Capture agent coordination state
    |
    v
PHASE 3: CONTEXT ASSEMBLY (< 1s)
    +-- Structure content per format template
    +-- Generate restoration instructions
    +-- Build cross-reference links
    +-- Compile deliverables inventory
    +-- Produce next-steps guidance
    |
    v
PHASE 4: FORENSIC SEALING (< 200ms)
    +-- Compute content hash (SHA-256)
    +-- Embed creation timestamp
    +-- Validate cross-references
    +-- Verify content integrity
    |
    v
PHASE 5: PERSISTENCE (< 300ms)
    +-- Write to .claude/session-context/
    +-- Update LATEST_SESSION.md symlink
    +-- Log telemetry event
    +-- Confirm preservation success

mandatory_content:
  mission_description: "Complete objectives and scope"
  actions_timeline: "All actions with timestamps"
  files_modified: "Every file changed with purpose"
  deliverables: "All outputs created"
  decisions_made: "Key decisions with rationale"
  verification_results: "All validation outcomes"
  next_steps: "Clear continuation instructions"
  restoration_guide: "Step-by-step restoration"

optional_content:
  quality_metrics: "Quality gate results and scores"
  agent_coordination: "Multi-agent handoff state"
  error_log: "Errors encountered and resolutions"
  performance_data: "Timing and resource usage"

context_coordination = %{
  shared_state: %{
    mission_objectives: :shared,
    platform_state: :shared,
    quality_metrics: :shared,
    deliverables: :coordinated
  },
  handoff_protocol: %{
    current_agent: "source-agent-id",
    next_agent: "target-agent-id",
    context_transfer: "seamless",
    state_validation: "verified"
  },
  coordination_topics: [
    "mcp:context",
    "mcp:session-state",
    "mcp:agent-handoff"
  ]
}

.claude/session-context/
+-- 2026-01-31-perimeter-mvp-completion-session.md
+-- 2026-01-28-archer-supreme-strategic-analysis-session.md
+-- 2026-01-25-quality-floor-guardian-session.md
+-- LATEST_SESSION.md -> (symlink to most recent)

# Emergency save is automatic, but can be triggered manually
/context-preserve error --format comprehensive

# Recovery from corrupted context
/context-preserve manual --format forensic --label "recovery-after-corruption"

# Access context preservation via GenServer
{:ok, context} = PrismaticClaude.ContextPreservation.save(%{
  trigger: :manual,
  format: :comprehensive,
  label: "api-integration-complete"
})

# Load most recent context
{:ok, latest} = PrismaticClaude.ContextPreservation.load_latest()

# Query context history
{:ok, history} = PrismaticClaude.ContextPreservation.list_contexts(
  since: ~D[2026-01-01],
  format: :forensic
)

# Register custom preservation trigger
PrismaticClaude.SessionLifecycle.register_hook(%{
  phase: :post_command,
  priority: 50,
  handler: fn event ->
    if event.command in [:deploy, :migrate] do
      PrismaticClaude.ContextPreservation.save(%{
        trigger: :phase_complete,
        format: :forensic
      })
    end
  end
})

Related Commands