mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
SuperClaude V4 Beta: Major framework restructuring
- Restructured core framework components - Added new Agents, MCP servers, and Modes documentation - Introduced SuperClaude-Lite minimal implementation - Enhanced Commands with session management capabilities - Added comprehensive Hooks system with Python integration - Removed legacy setup and profile components - Updated .gitignore to exclude Tests/, ClaudeDocs/, and .serena/ - Consolidated configuration into SuperClaude/Config/ - Added Templates for consistent component creation This is the initial commit for the V4 Beta branch containing all recent framework improvements and architectural changes. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
NomenAK
284
Templates/Template_Command_Session.md
Normal file
284
Templates/Template_Command_Session.md
Normal file
@@ -0,0 +1,284 @@
|
||||
---
|
||||
name: [command-name]
|
||||
description: "[Session lifecycle management with Serena MCP integration and performance requirements]"
|
||||
allowed-tools: [Read, Grep, Glob, Write, activate_project, read_memory, write_memory, list_memories, check_onboarding_performed, onboarding, think_about_*]
|
||||
|
||||
# Command Classification
|
||||
category: session
|
||||
complexity: standard
|
||||
scope: cross-session
|
||||
|
||||
# Integration Configuration
|
||||
mcp-integration:
|
||||
servers: [serena] # Mandatory Serena MCP integration
|
||||
personas: [] # No persona activation required
|
||||
wave-enabled: false
|
||||
complexity-threshold: 0.3
|
||||
|
||||
# Performance Profile
|
||||
performance-profile: session-critical
|
||||
performance-targets:
|
||||
initialization: <500ms
|
||||
core-operations: <200ms
|
||||
checkpoint-creation: <1s
|
||||
memory-operations: <200ms
|
||||
---
|
||||
|
||||
# /sc:[command-name] - [Session Command Title]
|
||||
|
||||
## Purpose
|
||||
[Clear statement of the command's role in session lifecycle management. Explain how it maintains context continuity, enables cross-session persistence, and supports the SuperClaude framework's session management capabilities.]
|
||||
|
||||
## Usage
|
||||
```
|
||||
/sc:[command-name] [--type memory|checkpoint|state] [--resume] [--validate] [--performance]
|
||||
```
|
||||
|
||||
## Arguments
|
||||
- `target` - [Optional target for focused session operations]
|
||||
- `--type` - [Type of session operation: memory, checkpoint, or state management]
|
||||
- `--resume` - [Resume from previous session or checkpoint]
|
||||
- `--validate` - [Validate session integrity and data consistency]
|
||||
- `--performance` - [Enable performance monitoring and optimization]
|
||||
- `--metadata` - [Include comprehensive session metadata]
|
||||
- `--cleanup` - [Perform session cleanup and optimization]
|
||||
|
||||
## Session Lifecycle Integration
|
||||
|
||||
### 1. Session State Management
|
||||
- Analyze current session state and context requirements
|
||||
- Identify critical information for persistence or restoration
|
||||
- Assess session integrity and continuity needs
|
||||
|
||||
### 2. Serena MCP Coordination
|
||||
- Execute appropriate Serena MCP operations for session management
|
||||
- Handle memory organization, checkpoint creation, or state restoration
|
||||
- Manage cross-session context preservation and enhancement
|
||||
|
||||
### 3. Performance Validation
|
||||
- Monitor operation performance against strict session targets
|
||||
- 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
|
||||
- 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
|
||||
- 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`, `get_current_config`
|
||||
- **Reflection System**: `think_about_*` tools for session analysis
|
||||
- **State Management**: Session state persistence and restoration capabilities
|
||||
|
||||
### Session Data Organization
|
||||
- **Memory Hierarchy**: Structured memory organization for efficient retrieval
|
||||
- **Checkpoint System**: Progressive checkpoint creation with metadata
|
||||
- **Context Accumulation**: Building understanding across session boundaries
|
||||
- **Performance Metrics**: Session operation timing and efficiency tracking
|
||||
|
||||
### Advanced Session Features
|
||||
- **Automatic Triggers**: Time-based, task-based, and risk-based session operations
|
||||
- **Error Recovery**: Robust session recovery and state restoration mechanisms
|
||||
- **Cross-Session Learning**: Accumulating knowledge and patterns across sessions
|
||||
- **Performance Optimization**: Session-level caching and efficiency improvements
|
||||
|
||||
## 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
|
||||
|
||||
### Checkpoint Operations
|
||||
- **Progressive Checkpoints**: Building understanding and state across checkpoints
|
||||
- **Metadata Enrichment**: Comprehensive checkpoint metadata with recovery information
|
||||
- **State Validation**: Ensuring checkpoint integrity and completeness
|
||||
- **Recovery Mechanisms**: Robust restoration from checkpoint failures
|
||||
|
||||
### 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
|
||||
- **Session Initialization**: <500ms for complete session setup
|
||||
- **Core Operations**: <200ms for memory reads, writes, and basic operations
|
||||
- **Checkpoint Creation**: <1s for comprehensive checkpoint with metadata
|
||||
- **Memory Operations**: <200ms per individual memory operation
|
||||
- **Context Loading**: <300ms for full context restoration
|
||||
|
||||
### 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
|
||||
|
||||
### 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
|
||||
|
||||
### 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
|
||||
- **Collaborative Sessions**: Support for multi-user session coordination
|
||||
- **Session Hierarchies**: Managing parent-child session relationships
|
||||
|
||||
## Examples
|
||||
|
||||
### Basic Session Operation
|
||||
```
|
||||
/sc:[command-name] --type memory
|
||||
# Standard memory management operation
|
||||
```
|
||||
|
||||
### Session Checkpoint
|
||||
```
|
||||
/sc:[command-name] --type checkpoint --metadata
|
||||
# Create comprehensive checkpoint with metadata
|
||||
```
|
||||
|
||||
### Session Recovery
|
||||
```
|
||||
/sc:[command-name] --resume --validate
|
||||
# Resume from previous session with validation
|
||||
```
|
||||
|
||||
### Performance Monitoring
|
||||
```
|
||||
/sc:[command-name] --performance --validate
|
||||
# Session operation with performance monitoring
|
||||
```
|
||||
|
||||
## 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]
|
||||
|
||||
**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]
|
||||
|
||||
---
|
||||
|
||||
# Template Usage Guidelines
|
||||
|
||||
## Implementation Requirements
|
||||
This template is designed for session management commands that require:
|
||||
- Mandatory Serena MCP integration for all core functionality
|
||||
- Strict performance targets for session-critical operations
|
||||
- Cross-session context persistence and continuity
|
||||
- Comprehensive session lifecycle management
|
||||
- Advanced error handling and recovery capabilities
|
||||
|
||||
## Serena MCP Integration Requirements
|
||||
|
||||
### Mandatory Tools
|
||||
All session commands must integrate with these Serena MCP tools:
|
||||
- **Memory Management**: read_memory, write_memory, list_memories, delete_memory
|
||||
- **Project Management**: activate_project, get_current_config
|
||||
- **Reflection System**: think_about_* tools for session analysis and validation
|
||||
- **State Management**: Session state persistence and restoration capabilities
|
||||
|
||||
### Integration Patterns
|
||||
- **Memory-First Approach**: All operations should leverage Serena memory system
|
||||
- **Performance Validation**: Continuous monitoring against strict performance targets
|
||||
- **Context Preservation**: Maintaining rich context across session boundaries
|
||||
- **Error Recovery**: Robust recovery mechanisms for session-critical failures
|
||||
|
||||
## Performance Validation Requirements
|
||||
|
||||
### Critical Performance Targets
|
||||
Session commands must meet these non-negotiable performance requirements:
|
||||
- Session initialization: <500ms for complete setup
|
||||
- Core operations: <200ms for memory and basic operations
|
||||
- Checkpoint creation: <1s for comprehensive checkpoints
|
||||
- Memory operations: <200ms per individual operation
|
||||
|
||||
### Performance Monitoring
|
||||
- Real-time performance tracking and validation
|
||||
- Automated performance regression detection
|
||||
- Detailed performance analytics and reporting
|
||||
- Resource optimization and efficiency recommendations
|
||||
|
||||
## Quality Standards
|
||||
|
||||
### Session Command Requirements
|
||||
- [ ] Mandatory Serena MCP integration is properly implemented
|
||||
- [ ] All performance targets are realistic and consistently achievable
|
||||
- [ ] Cross-session context persistence works reliably
|
||||
- [ ] Error handling covers all session-critical failure scenarios
|
||||
- [ ] Memory organization follows established patterns
|
||||
- [ ] Session lifecycle integration is comprehensive
|
||||
- [ ] Performance monitoring and analytics are functional
|
||||
|
||||
---
|
||||
|
||||
*This template is specifically designed for session management commands that provide critical session lifecycle capabilities with mandatory Serena MCP integration and strict performance requirements.*
|
||||
Reference in New Issue
Block a user