92 lines
3.6 KiB
Markdown
92 lines
3.6 KiB
Markdown
---
|
|
description: "Session lifecycle management with Serena MCP integration for session context persistence"
|
|
category: session
|
|
complexity: standard
|
|
mcp-servers: [serena]
|
|
personas: []
|
|
---
|
|
|
|
# /sc: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
|
|
```
|
|
/sc: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
|
|
```
|
|
/sc:save
|
|
# Saves current session discoveries and context to Serena MCP
|
|
# Automatically creates checkpoint if session exceeds 30 minutes
|
|
```
|
|
|
|
### Comprehensive Session Checkpoint
|
|
```
|
|
/sc:save --type all --checkpoint
|
|
# Complete session preservation with recovery checkpoint
|
|
# Includes all learnings, context, and progress for session restoration
|
|
```
|
|
|
|
### Session Summary Generation
|
|
```
|
|
/sc:save --summarize
|
|
# Creates session summary with discovery documentation
|
|
# Updates cross-session learning patterns and project insights
|
|
```
|
|
|
|
### Discovery-Only Persistence
|
|
```
|
|
/sc: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 |