Initial commit

commands/save.md

@@ -0,0 +1,92 @@
+---
+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