SuperClaude/Framework-Lite/Modes/MODE_Task_Management.md

name	description	type	category	complexity	scope	activation	framework-integration	performance-profile	performance-targets
task-management	Multi-layer task orchestration with wave systems, delegation patterns, and comprehensive analytics	system-architecture	orchestration	advanced	framework	automatic manual-flags confidence-threshold detection-patterns true --delegate --wave-mode --loop --concurrency --wave-strategy --wave-delegation --iterations --interactive 0.8 multi-step operations build/implement/create keywords system/feature/comprehensive scope	mcp-servers commands modes quality-gates task-coordination wave-orchestration /task /spawn /loop TodoWrite all modes for orchestration task_management_validation session_completion_verification real_time_metrics	intensive	delegation-efficiency wave-coordination resource-utilization 40-70% time savings 30-50% better results >0.7 optimization

Task Management Mode

Core Principles

• Evidence-Based Progress: Measurable outcomes with quantified task completion metrics
• Single Focus Protocol: One active task at a time with strict state management
• Real-Time Updates: Immediate status changes with comprehensive tracking
• Quality Gates: Validation before completion with multi-step verification cycles

Architecture Layers

Layer 1: TodoRead/TodoWrite (Session Tasks)

• Scope: Current Claude Code session with real-time state management
• States: pending, in_progress, completed, blocked with strict transitions
• Capacity: 3-20 tasks per session with dynamic load balancing
• Integration: Foundation layer connecting to project and orchestration systems

Layer 2: /task Command (Project Management)

• Scope: Multi-session features spanning days to weeks with persistence
• Structure: Hierarchical organization (Epic → Story → Task) with dependency mapping
• Persistence: Cross-session state management with comprehensive tracking
• Coordination: Inter-layer communication with session lifecycle integration

Layer 3: /spawn Command (Meta-Orchestration)

• Scope: Complex multi-domain operations with system-wide coordination
• Features: Parallel/sequential coordination with intelligent tool management
• Management: Resource allocation and dependency resolution across domains
• Intelligence: Advanced decision-making with compound intelligence coordination

Layer 4: /loop Command (Iterative Enhancement)

• Scope: Progressive refinement workflows with validation cycles
• Features: Iteration cycles with comprehensive validation and quality gates
• Optimization: Performance improvements through iterative analysis
• Analytics: Measurement and feedback loops with continuous learning

Task Detection and Creation

Automatic Triggers

• Multi-step Operations: 3+ step sequences with dependency analysis
• Keywords: build, implement, create, fix, optimize, refactor with context awareness
• Scope Indicators: system, feature, comprehensive, complete with complexity assessment
• Complexity Thresholds: Operations exceeding 0.4 complexity score with multi-domain impact
• File Count Triggers: 3+ files for delegation, 2+ directories for coordination
• Performance Opportunities: Auto-detect parallelizable operations with time estimates

Task State Management

• pending 📋: Ready for execution with dependency validation
• in_progress 🔄: Currently active (ONE per session) with progress tracking
• blocked 🚧: Waiting on dependency with automated resolution monitoring
• completed ✅: Successfully finished with quality validation and evidence

Related Flags

Sub-Agent Delegation Flags

--delegate [files|folders|auto]

• Enable Task tool sub-agent delegation for parallel processing optimization
• files: Delegate individual file analysis to sub-agents with granular control
• folders: Delegate directory-level analysis to sub-agents with hierarchical organization
• auto: Auto-detect delegation strategy based on scope and complexity analysis
• Auto-activates: >2 directories or >3 files with complexity assessment
• 40-70% time savings for suitable operations with proven efficiency metrics

--concurrency [n]

• Control max concurrent sub-agents and tasks (default: 7, range: 1-15)
• Dynamic allocation based on resources and complexity with intelligent load balancing
• Prevents resource exhaustion in complex scenarios with proactive monitoring

Wave Orchestration Flags

--wave-mode [auto|force|off]

• Control wave orchestration activation with intelligent threshold detection
• auto: Auto-activates based on complexity >0.4 AND file_count >3 AND operation_types >2
• force: Override auto-detection and force wave mode for borderline cases
• off: Disable wave mode, use Sub-Agent delegation instead with fallback coordination
• 30-50% better results through compound intelligence and progressive enhancement

--wave-strategy [progressive|systematic|adaptive|enterprise]

• Select wave orchestration strategy with context-aware optimization
• progressive: Iterative enhancement for incremental improvements with validation cycles
• systematic: Comprehensive methodical analysis for complex problems with full coverage
• adaptive: Dynamic configuration based on varying complexity with real-time adjustment
• enterprise: Large-scale orchestration for >100 files with >0.7 complexity threshold

--wave-delegation [files|folders|tasks]

• Control how Wave system delegates work to Sub-Agent with strategic coordination
• files: Sub-Agent delegates individual file analysis across waves with precision targeting
• folders: Sub-Agent delegates directory-level analysis across waves with structural organization
• tasks: Sub-Agent delegates by task type (security, performance, quality, architecture) with domain specialization

Iterative Enhancement Flags

--loop

• Enable iterative improvement mode for commands with automatic validation
• Auto-activates: Quality improvement requests, refinement operations, polish tasks with pattern detection
• Compatible operations: /improve, /refine, /enhance, /fix, /cleanup, /analyze with full integration
• Default: 3 iterations with automatic validation and quality gate enforcement

--iterations [n]

• Control number of improvement cycles (default: 3, range: 1-10)
• Overrides intelligent default based on operation complexity with adaptive optimization

--interactive

• Enable user confirmation between iterations with comprehensive review cycles
• Pauses for review and approval before each cycle with detailed progress reporting
• Allows manual guidance and course correction with decision point integration

Auto-Activation Thresholds

• Sub-Agent Delegation: >2 directories OR >3 files OR complexity >0.4 with multi-condition evaluation
• Wave Mode: complexity ≥0.4 AND files >3 AND operation_types >2 with sophisticated logic
• Loop Mode: polish, refine, enhance, improve keywords detected with contextual analysis

Document Persistence

Comprehensive task management documentation system with automated session completion summaries and orchestration analytics.

Directory Structure

ClaudeDocs/Task/Management/
├── Orchestration/           # Wave orchestration reports
├── Delegation/             # Sub-agent delegation analytics
├── Performance/            # Task execution metrics
├── Coordination/           # Multi-layer coordination results
└── Archives/              # Historical task management data

Summary Documents

ClaudeDocs/Summary/
├── session-completion-{session-id}-{YYYY-MM-DD-HHMMSS}.md
├── task-orchestration-{project}-{YYYY-MM-DD-HHMMSS}.md
├── delegation-summary-{project}-{YYYY-MM-DD-HHMMSS}.md
└── performance-summary-{session-id}-{YYYY-MM-DD-HHMMSS}.md

File Naming Convention

{task-operation}-management-{YYYY-MM-DD-HHMMSS}.md

Examples:
- orchestration-management-2024-12-15-143022.md
- delegation-management-2024-12-15-143045.md
- wave-coordination-management-2024-12-15-143108.md
- performance-analytics-management-2024-12-15-143131.md

Session Completion Summaries

session-completion-{session-id}-{YYYY-MM-DD-HHMMSS}.md
task-orchestration-{project}-{YYYY-MM-DD-HHMMSS}.md
delegation-summary-{project}-{YYYY-MM-DD-HHMMSS}.md
performance-summary-{session-id}-{YYYY-MM-DD-HHMMSS}.md

Metadata Format

---
operation_type: [orchestration|delegation|coordination|performance]
timestamp: 2024-12-15T14:30:22Z
session_id: session_abc123
task_complexity: 0.85
orchestration_metrics:
  wave_strategy: progressive
  wave_count: 3
  delegation_efficiency: 0.78
  coordination_success: 0.92
delegation_analytics:
  sub_agents_deployed: 5
  parallel_efficiency: 0.65
  resource_utilization: 0.72
  completion_rate: 0.88
performance_analytics:
  execution_time_reduction: 0.45
  quality_preservation: 0.96
  resource_optimization: 0.71
  throughput_improvement: 0.38
---

Persistence Workflow

Session Completion Summary Generation

1. Session End Detection: Automatically detect session completion or termination
2. Performance Analysis: Calculate task completion rates, efficiency metrics, orchestration success
3. Summary Generation: Create comprehensive session summary with key achievements and metrics
4. Cross-Reference: Link to related project documents and task hierarchies
5. Knowledge Extraction: Document patterns and lessons learned for future sessions

Task Orchestration Summary

1. Orchestration Tracking: Monitor wave execution, delegation patterns, coordination effectiveness
2. Performance Metrics: Track efficiency gains, resource utilization, quality preservation scores
3. Pattern Analysis: Identify successful orchestration strategies and optimization opportunities
4. Summary Documentation: Generate orchestration summary in ClaudeDocs/Summary/
5. Best Practices: Document effective orchestration patterns for reuse

Integration Points

Quality Gates Integration

• Step 2.5: Task management validation during orchestration operations
• Step 7.5: Session completion verification and summary documentation
• Continuous: Real-time metrics collection and performance monitoring
• Post-Session: Comprehensive session analytics and completion reporting

Integration Points

SuperClaude Framework Integration

• Session Lifecycle: Deep integration with session management and checkpoint systems
• Quality Gates: Embedded validation throughout the 8-step quality cycle
• MCP Coordination: Seamless integration with all MCP servers for orchestration
• Mode Coordination: Cross-mode orchestration with specialized capabilities

Cross-System Coordination

• TodoWrite Integration: Task completion triggers checkpoint evaluation and state transitions
• Command Orchestration: Multi-command coordination with /task, /spawn, /loop integration
• Agent Delegation: Sophisticated sub-agent coordination with performance optimization
• Wave Systems: Advanced wave orchestration with compound intelligence coordination

Quality Gates Integration

• Step 2.5: Task management validation during orchestration operations with real-time verification
• Step 7.5: Session completion verification and summary documentation with comprehensive analytics
• Continuous: Real-time metrics collection and performance monitoring with adaptive optimization
• Specialized: Task-specific validation with domain expertise and quality preservation

Configuration

task_management:
  activation:
    automatic: true
    complexity_threshold: 0.4
    detection_patterns:
      multi_step_operations: ["3+ steps", "build", "implement"]
      keywords: [build, implement, create, fix, optimize, refactor]
      scope_indicators: [system, feature, comprehensive, complete]
  
  delegation_coordination:
    default_strategy: auto
    concurrency_options: [files, folders, auto]
    intelligent_detection: scope_and_complexity_analysis
    performance_optimization: parallel_processing_with_load_balancing
  
  wave_orchestration:
    auto_activation: true
    threshold_complexity: 0.4
    file_count_minimum: 3
    operation_types_minimum: 2
  
  iteration_enhancement:
    default_cycles: 3
    validation_approach: automatic_quality_gates
    interactive_mode: user_confirmation_cycles
    compatible_commands: [improve, refine, enhance, fix, cleanup, analyze]
  
  performance_analytics:
    delegation_efficiency_target: 0.65
    wave_coordination_target: 0.40
    resource_utilization_target: 0.70
    quality_preservation_minimum: 0.95
  
  persistence_config:
    enabled: true
    directory: "ClaudeDocs/Task/Management/"
    auto_save: true
    report_types:
      - orchestration_analytics
      - delegation_summaries
      - performance_metrics
      - session_completions
    metadata_format: yaml
    retention_days: 90

Related Documentation

• Primary Implementation: TodoWrite integration with session-based task management
• Secondary Integration: /task, /spawn, /loop commands for multi-layer orchestration
• Framework Reference: SESSION_LIFECYCLE.md for checkpoint and persistence coordination
• Quality Standards: ORCHESTRATOR.md for validation checkpoints and quality gate integration

---

This mode provides comprehensive task orchestration capabilities with multi-layer architecture, advanced delegation systems, wave orchestration, and comprehensive analytics for maximum efficiency and quality preservation.