Initial commit

commands/reflect.md

@@ -0,0 +1,87 @@
+---
+description: "Task reflection and validation using Serena MCP analysis capabilities"
+category: special
+complexity: standard
+mcp-servers: [serena]
+personas: []
+---
+
+# /sc:reflect - Task Reflection and Validation
+
+## Triggers
+- Task completion requiring validation and quality assessment
+- Session progress analysis and reflection on work accomplished
+- Cross-session learning and insight capture for project improvement
+- Quality gates requiring comprehensive task adherence verification
+
+## Usage
+```
+/sc:reflect [--type task|session|completion] [--analyze] [--validate]
+```
+
+## Behavioral Flow
+1. **Analyze**: Examine current task state and session progress using Serena reflection tools
+2. **Validate**: Assess task adherence, completion quality, and requirement fulfillment
+3. **Reflect**: Apply deep analysis of collected information and session insights
+4. **Document**: Update session metadata and capture learning insights
+5. **Optimize**: Provide recommendations for process improvement and quality enhancement
+
+Key behaviors:
+- Serena MCP integration for comprehensive reflection analysis and task validation
+- Bridge between TodoWrite patterns and advanced Serena analysis capabilities
+- Session lifecycle integration with cross-session persistence and learning capture
+- Performance-critical operations with <200ms core reflection and validation
+## MCP Integration
+- **Serena MCP**: Mandatory integration for reflection analysis, task validation, and session metadata
+- **Reflection Tools**: think_about_task_adherence, think_about_collected_information, think_about_whether_you_are_done
+- **Memory Operations**: Cross-session persistence with read_memory, write_memory, list_memories
+- **Performance Critical**: <200ms for core reflection operations, <1s for checkpoint creation
+
+## Tool Coordination
+- **TodoRead/TodoWrite**: Bridge between traditional task management and advanced reflection analysis
+- **think_about_task_adherence**: Validates current approach against project goals and session objectives
+- **think_about_collected_information**: Analyzes session work and information gathering completeness
+- **think_about_whether_you_are_done**: Evaluates task completion criteria and remaining work identification
+- **Memory Tools**: Session metadata updates and cross-session learning capture
+
+## Key Patterns
+- **Task Validation**: Current approach → goal alignment → deviation identification → course correction
+- **Session Analysis**: Information gathering → completeness assessment → quality evaluation → insight capture
+- **Completion Assessment**: Progress evaluation → completion criteria → remaining work → decision validation
+- **Cross-Session Learning**: Reflection insights → memory persistence → enhanced project understanding
+
+## Examples
+
+### Task Adherence Reflection
+```
+/sc:reflect --type task --analyze
+# Validates current approach against project goals
+# Identifies deviations and provides course correction recommendations
+```
+
+### Session Progress Analysis
+```
+/sc:reflect --type session --validate
+# Comprehensive analysis of session work and information gathering
+# Quality assessment and gap identification for project improvement
+```
+
+### Completion Validation
+```
+/sc:reflect --type completion
+# Evaluates task completion criteria against actual progress
+# Determines readiness for task completion and identifies remaining blockers
+```
+
+## Boundaries
+
+**Will:**
+- Perform comprehensive task reflection and validation using Serena MCP analysis tools
+- Bridge TodoWrite patterns with advanced reflection capabilities for enhanced task management
+- Provide cross-session learning capture and session lifecycle integration
+
+**Will Not:**
+- Operate without proper Serena MCP integration and reflection tool access
+- Override task completion decisions without proper adherence and quality validation
+- Bypass session integrity checks and cross-session persistence requirements
+