mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
40840dae0b
- Transform 28K+ token superclaude-user-guide.md into 4.5K token overview (84% reduction) - Extract specialized guides: examples-cookbook.md, troubleshooting-guide.md, best-practices.md, session-management.md, technical-architecture.md - Add comprehensive cross-references between all guides for improved navigation - Maintain professional documentation quality with technical-writer agent approach - Remove template files and consolidate agent naming (backend-engineer → backend-architect, etc.) - Update all existing guides with cross-references and related guides sections - Create logical learning paths from beginner to advanced users - Eliminate content duplication while preserving all valuable information 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
3.6 KiB
3.6 KiB
name, description, category, complexity, mcp-servers, personas
| name | description | category | complexity | mcp-servers | personas | |
|---|---|---|---|---|---|---|
| save | Session lifecycle management with Serena MCP integration for session context persistence | session | standard |
|
/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
- Analyze: Examine session progress and identify discoveries worth preserving
- Persist: Save session context and learnings using Serena MCP memory management
- Checkpoint: Create recovery points for complex sessions and progress tracking
- Validate: Ensure session data integrity and cross-session compatibility
- 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