SuperClaude/Framework-Lite/Commands/load.md

name	description	allowed-tools	category	complexity	scope	mcp-integration	performance-profile	performance-targets
load	Session lifecycle management with Serena MCP integration and performance requirements for project context loading	Read Grep Glob Write activate_project list_memories read_memory write_memory check_onboarding_performed onboarding	session	standard	cross-session	servers personas wave-enabled complexity-threshold auto-flags serena false 0.3	session-critical	initialization core-operations checkpoint-creation memory-operations <500ms <200ms <1s <200ms

/sc:load - Project Context Loading with Serena

Purpose

Load and analyze project context using Serena MCP for project activation, memory retrieval, and context management with session lifecycle integration and cross-session persistence capabilities.

Usage

/sc:load [target] [--type project|config|deps|env|checkpoint] [--refresh] [--analyze] [--checkpoint ID] [--resume] [--validate] [--performance] [--metadata] [--cleanup] [--uc]

Arguments

• target - Project directory or name (defaults to current directory)
• --type - Specific loading type (project, config, deps, env, checkpoint)
• --refresh - Force reload of project memories and context
• --analyze - Run deep analysis after loading
• --onboard - Run onboarding if not performed
• --checkpoint - Restore from specific checkpoint ID
• --resume - Resume from latest checkpoint automatically
• --validate - Validate session integrity and data consistency
• --performance - Enable performance monitoring and optimization
• --metadata - Include comprehensive session metadata
• --cleanup - Perform session cleanup and optimization
• --uc - Enable Token Efficiency mode for all memory operations (optional)

Token Efficiency Integration

Optional Token Efficiency Mode

The /sc:load command supports optional Token Efficiency mode via the --uc flag:

• User Choice: --uc flag can be explicitly specified for compression
• Compression Strategy: When enabled: 30-50% reduction with ≥95% information preservation
• Content Classification:
  • SuperClaude Framework (0% compression): Complete exclusion
  • User Project Content (0% compression): Full fidelity preservation
  • Session Data (30-50% compression): Optimized storage when --uc used
• Quality Preservation: Framework compliance with MODE_Token_Efficiency.md patterns

Performance Benefits (when --uc used)

• Token Efficiency applies to all session memory operations
• Compression inherited by memory operations within session context
• Performance benefits: Faster session operations and reduced context usage

Session Lifecycle Integration

1. Session State Management

• Analyze current session state and context requirements
• Use activate_project tool to activate the project
• Pass {"project": target} as parameters
• Automatically handles project registration if needed
• Validates project path and language detection
• Identify critical information for persistence or restoration
• Assess session integrity and continuity needs

2. Serena MCP Coordination with Token Efficiency

• Execute appropriate Serena MCP operations for session management
• Call list_memories tool to discover existing memories
• Load relevant memories based on --type parameter:
  • project: Load project_purpose, tech_stack memories (framework excluded from compression)
  • config: Load code_style_conventions, completion_tasks (framework excluded from compression)
  • deps: Analyze package.json/pyproject.toml (preserve user content)
  • env: Load environment-specific memories (framework excluded from compression)
• Content Classification Strategy:
  • SuperClaude Framework (Complete exclusion): All framework directories and components
  • Session Data (Apply compression): Session metadata, checkpoints, cache content only
  • User Project Content (Preserve fidelity): Project files, user documentation, configurations
• Handle memory organization, checkpoint creation, or state restoration with selective compression
• Manage cross-session context preservation and enhancement with optimized storage

3. Performance Validation

• Monitor operation performance against strict session targets
• Read memories using read_memory tool with {"memory_file_name": name}
• Build comprehensive project context from memories
• Supplement with file analysis if memories incomplete
• Validate memory efficiency and response time requirements
• Ensure session operations meet <200ms core operation targets

4. Context Continuity

• Maintain session context across operations and interruptions
• Call check_onboarding_performed tool
• If not onboarded and --onboard flag, call onboarding tool
• Create initial memories if project is new
• Preserve decision history, task progress, and accumulated insights
• Enable seamless continuation of complex multi-session workflows

5. Quality Assurance

• Validate session data integrity and completeness
• If --checkpoint flag: Load specific checkpoint via read_memory
• If --resume flag: Load latest checkpoint from checkpoints/latest
• If --type checkpoint: Restore session state from checkpoint metadata
• Display resumption summary showing:
  • Work completed in previous session
  • Open tasks and questions
  • Context changes since checkpoint
  • Estimated time to full restoration
• Verify cross-session compatibility and version consistency
• Generate session analytics and performance reports

Mandatory Serena MCP Integration

Core Serena Operations

• Memory Management: read_memory, write_memory, list_memories
• Project Management: activate_project, check_onboarding_performed, onboarding
• Context Enhancement: Build and enhance project understanding across sessions
• State Management: Session state persistence and restoration capabilities

Session Data Organization

• Memory Hierarchy: Structured memory organization for efficient retrieval
• Context Accumulation: Building understanding across session boundaries
• Performance Metrics: Session operation timing and efficiency tracking
• Project Activation: Seamless project initialization and context loading

Advanced Session Features

• Checkpoint Restoration: Resume from specific checkpoints with full context
• Cross-Session Learning: Accumulating knowledge and patterns across sessions
• Performance Optimization: Session-level caching and efficiency improvements
• Onboarding Integration: Automatic onboarding for new projects

Session Management Patterns

Memory Operations

• Memory Categories: Project, session, checkpoint, and insight memory organization
• Intelligent Retrieval: Context-aware memory loading and optimization
• Memory Lifecycle: Creation, update, archival, and cleanup operations
• Cross-Reference Management: Maintaining relationships between memory entries

Context Enhancement Operations with Selective Compression

• Analyze project structure if --analyze flag
• Create/update memories with new discoveries using selective compression
• Save enhanced context using write_memory tool with compression awareness
• Initialize session metadata with start time and optimized context loading
• Build comprehensive project understanding from compressed and preserved memories
• Enhance context through accumulated experience and insights with efficient storage
• Compression Application:
  • SuperClaude framework components: 0% compression (complete exclusion)
  • User project files and custom configurations: 0% compression (full preservation)
  • Session operational data only: 40-70% compression for storage optimization

Memory Categories Used

• project_purpose - Overall project goals and architecture
• tech_stack - Technologies, frameworks, dependencies
• code_style_conventions - Coding standards and patterns
• completion_tasks - Build/test/deploy commands
• suggested_commands - Common development workflows
• session/* - Session records and continuity data
• checkpoints/* - Checkpoint data for restoration

Context Operations

• Context Preservation: Maintaining critical context across session boundaries
• Context Enhancement: Building richer context through accumulated experience
• Context Optimization: Efficient context management and storage
• Context Validation: Ensuring context consistency and accuracy

Performance Requirements

Critical Performance Targets (Enhanced with Compression)

• Session Initialization: <500ms for complete session setup (improved with compression: <400ms)
• Core Operations: <200ms for memory reads, writes, and basic operations (improved: <150ms)
• Memory Operations: <200ms per individual memory operation (optimized: <150ms)
• Context Loading: <300ms for full context restoration (enhanced: <250ms)
• Project Activation: <100ms for project activation (maintained: <100ms)
• Deep Analysis: <3s for large projects (optimized: <2.5s)
• Compression Overhead: <50ms additional processing time for selective compression
• Storage Efficiency: 30-50% reduction in internal content storage requirements

Performance Monitoring

• Real-Time Metrics: Continuous monitoring of operation performance
• Performance Analytics: Detailed analysis of session operation efficiency
• Optimization Recommendations: Automated suggestions for performance improvement
• Resource Management: Efficient memory and processing resource utilization

Performance Validation

• Automated Testing: Continuous validation of performance targets
• Performance Regression Detection: Monitoring for performance degradation
• Benchmark Comparison: Comparing against established performance baselines
• Performance Reporting: Detailed performance analytics and recommendations

Error Handling & Recovery

Session-Critical Error Handling

• Data Integrity Errors: Comprehensive validation and recovery procedures
• Memory Access Failures: Robust fallback and retry mechanisms
• Context Corruption: Recovery strategies for corrupted session context
• Performance Degradation: Automatic optimization and resource management
• Serena Unavailable: Use traditional file analysis with local caching
• Onboarding Failures: Graceful degradation with manual onboarding options

Recovery Strategies

• Graceful Degradation: Maintaining core functionality under adverse conditions
• Automatic Recovery: Intelligent recovery from common failure scenarios
• Manual Recovery: Clear escalation paths for complex recovery situations
• State Reconstruction: Rebuilding session state from available information
• Fallback Mechanisms: Backward compatibility with existing workflow patterns

Error Categories

• Serena MCP Errors: Specific handling for Serena server communication issues
• Memory System Errors: Memory corruption, access, and consistency issues
• Performance Errors: Operation timeout and resource constraint handling
• Integration Errors: Cross-system integration and coordination failures

Session Analytics & Reporting

Performance Analytics

• Operation Timing: Detailed timing analysis for all session operations
• Resource Utilization: Memory, processing, and network resource tracking
• Efficiency Metrics: Session operation efficiency and optimization opportunities
• Trend Analysis: Performance trends and improvement recommendations

Session Intelligence

• Usage Patterns: Analysis of session usage and optimization opportunities
• Context Evolution: Tracking context development and enhancement over time
• Success Metrics: Session effectiveness and user satisfaction tracking
• Predictive Analytics: Intelligent prediction of session needs and optimization

Quality Metrics

• Data Integrity: Comprehensive validation of session data quality
• Context Accuracy: Ensuring session context remains accurate and relevant
• Performance Compliance: Validation against performance targets and requirements
• User Experience: Session impact on overall user experience and productivity

Integration Ecosystem

SuperClaude Framework Integration

• Command Coordination: Integration with other SuperClaude commands for session support
• Quality Gates: Integration with validation cycles and quality assurance
• Mode Coordination: Support for different operational modes and contexts
• Workflow Integration: Seamless integration with complex workflow operations

Cross-Session Coordination

• Multi-Session Projects: Managing complex projects spanning multiple sessions
• Context Handoff: Smooth transition of context between sessions and users
• Session Hierarchies: Managing parent-child session relationships
• Continuous Learning: Each session builds on previous knowledge and insights

Integration with /sc:save

• Context loaded by /sc:load is enhanced during session
• Use /sc:save to persist session changes back to Serena
• Maintains session lifecycle: load → work → save
• Session continuity through checkpoint and restoration mechanisms

Examples

Basic Project Load

/sc:load
# Activates current directory project and loads all memories

Specific Project with Analysis

/sc:load ~/projects/webapp --analyze
# Activates webapp project and runs deep analysis

Refresh Configuration

/sc:load --type config --refresh
# Reloads configuration memories and updates context

New Project Onboarding

/sc:load ./new-project --onboard
# Activates and onboards new project, creating initial memories

Session Checkpoint

/sc:load --type checkpoint --metadata
# Create comprehensive checkpoint with metadata

Session Recovery

/sc:load --resume --validate
# Resume from previous session with validation

Performance Monitoring with Compression

/sc:load --performance --validate
# Session operation with performance monitoring

/sc:load --optimize-internal --performance
# Enable selective compression with performance tracking

Checkpoint Restoration

/sc:load --resume
# Automatically resume from latest checkpoint

/sc:load --checkpoint checkpoint-2025-01-31-16:00:00  
# Restore from specific checkpoint ID

/sc:load --type checkpoint MyProject
# Load project and restore from latest checkpoint

Session Continuity Examples

# Previous session workflow:
/sc:load MyProject              # Initialize session
# ... work on project ...
/sc:save --checkpoint          # Create checkpoint

# Next session workflow:
/sc:load MyProject --resume    # Resume from checkpoint
# ... continue work ...
/sc:save --summarize          # Save with summary

Boundaries

This session command will:

• Provide robust session lifecycle management with strict performance requirements
• Integrate seamlessly with Serena MCP for comprehensive session capabilities
• Maintain context continuity and cross-session persistence effectively
• Support complex multi-session workflows with intelligent state management
• Deliver session operations within strict performance targets consistently
• Enable seamless project activation and context loading across sessions

This session command will not:

• Operate without proper Serena MCP integration and connectivity
• Compromise performance targets for additional functionality
• Proceed without proper session state validation and integrity checks
• Function without adequate error handling and recovery mechanisms
• Ignore onboarding requirements for new projects
• Skip context validation and enhancement procedures