/airis:save - Session Context Persistence

Triggers

• Session completion and project context persistence needs
• Cross-session memory management and checkpoint creation requests
• Project understanding preservation and discovery archival scenarios
• Session lifecycle management and progress tracking requirements

Usage

/airis:save [--type session|learnings|context|all] [--summarize] [--checkpoint]

Behavioral Flow

1. Analyze: Examine session progress and identify discoveries worth preserving
2. Persist: Save session context and learnings using Serena MCP memory management
3. Checkpoint: Create recovery points for complex sessions and progress tracking
4. Validate: Ensure session data integrity and cross-session compatibility
5. Prepare: Ready session context for seamless continuation in future sessions

Key behaviors:

• Serena MCP integration for memory management and cross-session persistence
• Automatic checkpoint creation based on session progress and critical tasks
• Session context preservation with comprehensive discovery and pattern archival
• Cross-session learning with accumulated project insights and technical decisions

MCP Integration

• Serena MCP: Mandatory integration for session management, memory operations, and cross-session persistence
• Memory Operations: Session context storage, checkpoint creation, and discovery archival
• Performance Critical: <200ms for memory operations, <1s for checkpoint creation

Tool Coordination

• write_memory/read_memory: Core session context persistence and retrieval
• think_about_collected_information: Session analysis and discovery identification
• summarize_changes: Session summary generation and progress documentation
• TodoRead: Task completion tracking for automatic checkpoint triggers

Key Patterns

• Session Preservation: Discovery analysis → memory persistence → checkpoint creation
• Cross-Session Learning: Context accumulation → pattern archival → enhanced project understanding
• Progress Tracking: Task completion → automatic checkpoints → session continuity
• Recovery Planning: State preservation → checkpoint validation → restoration readiness

Examples

Basic Session Save

/airis:save
# Saves current session discoveries and context to Serena MCP
# Automatically creates checkpoint if session exceeds 30 minutes

Comprehensive Session Checkpoint

/airis:save --type all --checkpoint
# Complete session preservation with recovery checkpoint
# Includes all learnings, context, and progress for session restoration

Session Summary Generation

/airis:save --summarize
# Creates session summary with discovery documentation
# Updates cross-session learning patterns and project insights

Discovery-Only Persistence

/airis:save --type learnings
# Saves only new patterns and insights discovered during session
# Updates project understanding without full session preservation

Boundaries

Will:

• Save session context using Serena MCP integration for cross-session persistence
• Create automatic checkpoints based on session progress and task completion
• Preserve discoveries and patterns for enhanced project understanding

Will Not:

• Operate without proper Serena MCP integration and memory access
• Save session data without validation and integrity verification
• Override existing session context without proper checkpoint preservation