---
allowed-tools:
  [
    Read,
    Glob,
    Grep,
    TodoWrite,
    Task,
    mcp__sequential-thinking__sequentialthinking,
  ]
description: "Execute complex tasks with intelligent workflow management and cross-session persistence"
wave-enabled: true
complexity-threshold: 0.7
performance-profile: complex
personas: [architect, analyzer, project-manager]
mcp-servers: [sequential, context7]
---

# /hc:task - Enhanced Task Management

## Purpose

Execute complex tasks with intelligent workflow management, cross-session persistence, hierarchical task organization, and advanced orchestration capabilities.

## Usage

```
/hc:task [action] [target] [--strategy systematic|agile|enterprise] [--persist] [--hierarchy] [--delegate]
```

## Actions

- `create` - Create new project-level task hierarchy
- `execute` - Execute task with intelligent orchestration
- `status` - View task status across sessions
- `analytics` - Task performance and analytics dashboard
- `optimize` - Optimize task execution strategies
- `delegate` - Delegate tasks across multiple agents
- `validate` - Validate task completion with evidence

## Arguments

- `target` - Task description, project scope, or existing task ID
- `--strategy` - Execution strategy (systematic, agile, enterprise)
- `--persist` - Enable cross-session task persistence
- `--hierarchy` - Create hierarchical task breakdown
- `--delegate` - Enable multi-agent task delegation
- `--wave-mode` - Enable wave-based execution
- `--validate` - Enforce quality gates and validation
- `--mcp-routing` - Enable intelligent MCP server routing

## Execution Modes

### Systematic Strategy

1. **Discovery Phase**: Use @agent-architect for comprehensive project analysis and scope definition
2. **Planning Phase**: @agent-architect creates hierarchical task breakdown with dependency mapping
3. **Execution Phase**: Orchestrate @agent-coder/@agent-designer for implementation with validation gates
4. **Validation Phase**: @agent-test-engineer performs evidence collection and quality assurance
5. **Optimization Phase**: @agent-architect provides performance analysis and improvement recommendations

### Agile Strategy

1. **Sprint Planning**: Priority-based task organization
2. **Iterative Execution**: Short cycles with continuous feedback
3. **Adaptive Planning**: Dynamic task adjustment based on outcomes
4. **Continuous Integration**: Real-time validation and testing
5. **Retrospective Analysis**: Learning and process improvement

### Enterprise Strategy

1. **Stakeholder Analysis**: Multi-domain impact assessment
2. **Resource Allocation**: Optimal resource distribution across tasks
3. **Risk Management**: Comprehensive risk assessment and mitigation
4. **Compliance Validation**: Regulatory and policy compliance checks
5. **Governance Reporting**: Detailed progress and compliance reporting

## Advanced Features

### Task Hierarchy Management

- **Epic Level**: Large-scale project objectives (weeks to months)
- **Story Level**: Feature-specific implementations (days to weeks)
- **Task Level**: Specific actionable items (hours to days)
- **Subtask Level**: Granular implementation steps (minutes to hours)

### Intelligent Task Orchestration

- **Agent Coordination**: @agent-architect analyzes → @agent-coder/@agent-designer implement → @agent-test-engineer validates
- **Dependency Resolution**: Automatic dependency detection and sequencing
- **Parallel Execution**: Independent task parallelization with multiple agents
- **Resource Optimization**: Intelligent resource allocation and scheduling
- **Context Sharing**: Cross-task context via MCP memory server protocols

### Cross-Session Persistence

- **Task State Management**: Persistent task states across sessions
- **Context Continuity**: Preserved context and progress tracking
- **Historical Analytics**: Task execution history and learning
- **Recovery Mechanisms**: Automatic recovery from interruptions

### Quality Gates and Validation

- **Evidence Collection**: Systematic evidence gathering during execution
- **Validation Criteria**: Customizable completion criteria
- **Quality Metrics**: Comprehensive quality assessment
- **Compliance Checks**: Automated compliance validation

## Integration Points

### Wave System Integration

- **Wave Coordination**: Multi-wave task execution strategies
- **Context Accumulation**: Progressive context building across waves
- **Performance Monitoring**: Real-time performance tracking and optimization
- **Error Recovery**: Graceful error handling and recovery mechanisms

### MCP Server Coordination

- **Context7**: Framework patterns, library documentation, and UI component patterns
- **Sequential**: Complex analysis and multi-step reasoning
- **Puppeteer**: End-to-end testing and performance validation

### Agent & Persona Integration

- **@agent-architect**: System design, architectural decisions, and task planning
- **@agent-coder**: Implementation of business logic and backend features
- **@agent-designer**: UI/UX implementation and frontend components
- **@agent-security-analyst**: Security assessment and vulnerability detection
- **@agent-test-engineer**: Validation, testing, and quality assurance
- **Personas**: Overlay behavioral patterns on agents for domain expertise

## Performance Optimization

### Execution Efficiency

- **Batch Operations**: Grouped execution for related tasks
- **Parallel Processing**: Independent task parallelization
- **Context Caching**: Reusable context and analysis results
- **Resource Pooling**: Shared resource utilization

### Intelligence Features

- **Predictive Planning**: AI-driven task estimation and planning
- **Adaptive Execution**: Dynamic strategy adjustment based on progress
- **Learning Systems**: Continuous improvement from execution patterns
- **Optimization Recommendations**: Data-driven improvement suggestions

## Usage Examples

### Create Project-Level Task Hierarchy

```
/hc:task create "Implement user authentication system" --hierarchy --persist --strategy systematic
```

### Execute with Multi-Agent Delegation

```
/hc:task execute AUTH-001 --delegate --wave-mode --validate
```

### Analytics and Optimization

```
/hc:task analytics --project AUTH --optimization-recommendations
```

### Cross-Session Task Management

```
/hc:task status --all-sessions --detailed-breakdown
```

## Claude Code Integration

- **Agent Orchestration**: Uses Task tool to coordinate specialized agents
- **TodoWrite Integration**: Seamless session-level task coordination
- **Wave System**: Advanced multi-stage execution orchestration
- **Hook System**: Real-time task monitoring and optimization
- **MCP Coordination**: Intelligent server routing and resource utilization
- **Inter-Agent Protocol**: Follows AGENT_PROTOCOLS.md for data exchange
- **Performance Monitoring**: Sub-100ms execution targets with comprehensive metrics

## Success Criteria

- **Task Completion Rate**: >95% successful task completion
- **Performance Targets**: <100ms hook execution, <5s task creation
- **Quality Metrics**: >90% validation success rate
- **Cross-Session Continuity**: 100% task state preservation
- **Intelligence Effectiveness**: >80% accurate predictive planning