SuperClaude/Framework-Lite/Commands/workflow.md

name	description	allowed-tools	category	complexity	scope	mcp-integration	performance-profile	personas
workflow	Generate structured implementation workflows from PRDs and feature requirements with expert guidance, multi-persona coordination, and advanced orchestration	Read Write Edit MultiEdit Bash Grep Glob TodoWrite Task WebSearch sequentialthinking	orchestration	advanced	cross-session	servers personas wave-enabled complexity-threshold sequential context7 magic playwright morphllm serena architect analyzer frontend backend security devops project-manager true 0.6	complex	architect analyzer project-manager

/sc:workflow - Implementation Workflow Generator

Purpose

Analyze Product Requirements Documents (PRDs) and feature specifications to generate comprehensive, step-by-step implementation workflows with sophisticated orchestration featuring expert guidance, multi-persona coordination, dependency mapping, automated task orchestration, and cross-session workflow management for enterprise-scale development operations.

Usage

/sc:workflow [prd-file|feature-description] [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel] [--validate] [--mcp-routing]

Arguments

• prd-file|feature-description - Path to PRD file or direct feature description for comprehensive workflow analysis
• --strategy - Workflow strategy selection with specialized orchestration approaches
• --depth - Analysis depth and thoroughness level for workflow generation
• --parallel - Enable parallel workflow processing with multi-agent coordination
• --validate - Comprehensive validation and workflow completeness quality gates
• --mcp-routing - Intelligent MCP server routing for specialized workflow analysis
• --wave-mode - Enable wave-based execution with progressive workflow enhancement
• --cross-session - Enable cross-session persistence and workflow continuity
• --persona - Force specific expert persona (architect, frontend, backend, security, devops, etc.)
• --output - Output format (roadmap, tasks, detailed)
• --estimate - Include time and complexity estimates
• --dependencies - Map external dependencies and integrations
• --risks - Include risk assessment and mitigation strategies
• --milestones - Create milestone-based project phases

MCP Integration Flags

• --c7 / --context7 - Enable Context7 for framework patterns and best practices
• --sequential - Enable Sequential thinking for complex multi-step analysis
• --magic - Enable Magic for UI component workflow planning
• --all-mcp - Enable all MCP servers for comprehensive workflow generation

Execution Strategies

Systematic Strategy (Default)

1. Comprehensive Analysis: Deep PRD analysis with architectural assessment
2. Strategic Planning: Multi-phase planning with dependency mapping
3. Coordinated Execution: Sequential workflow execution with validation gates
4. Quality Assurance: Comprehensive testing and validation cycles
5. Optimization: Performance and maintainability optimization
6. Documentation: Comprehensive workflow documentation and knowledge transfer

Agile Strategy

1. Rapid Assessment: Quick scope definition and priority identification
2. Iterative Planning: Sprint-based organization with adaptive planning
3. Continuous Delivery: Incremental execution with frequent feedback
4. Adaptive Validation: Dynamic testing and validation approaches
5. Retrospective Optimization: Continuous improvement and learning
6. Living Documentation: Evolving documentation with implementation

Enterprise Strategy

1. Stakeholder Analysis: Multi-domain impact assessment and coordination
2. Governance Planning: Compliance and policy integration planning
3. Resource Orchestration: Enterprise-scale resource allocation and management
4. Risk Management: Comprehensive risk assessment and mitigation strategies
5. Compliance Validation: Regulatory and policy compliance verification
6. Enterprise Integration: Large-scale system integration and coordination

Advanced Orchestration Features

Wave System Integration

• Multi-Wave Coordination: Progressive workflow execution across multiple coordinated waves
• Context Accumulation: Building understanding and capability across workflow waves
• Performance Monitoring: Real-time optimization and resource management for workflows
• Error Recovery: Sophisticated error handling and recovery across workflow waves

Cross-Session Persistence

• State Management: Maintain workflow operation state across sessions and interruptions
• Context Continuity: Preserve understanding and progress over time for workflows
• Historical Analysis: Learn from previous workflow executions and outcomes
• Recovery Mechanisms: Robust recovery from interruptions and workflow failures

Intelligent MCP Coordination

• Dynamic Server Selection: Choose optimal MCP servers based on workflow context and needs
• Load Balancing: Distribute workflow processing across available servers for efficiency
• Capability Matching: Match workflow operations to server capabilities and strengths
• Fallback Strategies: Graceful degradation when servers are unavailable for workflows

Multi-Persona Orchestration

Expert Coordination System

The command orchestrates multiple domain experts working together on complex workflows:

Primary Coordination Personas

• Architect: System design for workflows, technology decisions, scalability planning
• Analyzer: Workflow analysis, quality assessment, technical evaluation
• Project Manager: Resource coordination, timeline management, stakeholder communication

Domain-Specific Personas (Auto-Activated)

• Frontend Specialist: UI/UX workflow expertise, client-side optimization, accessibility
• Backend Engineer: Server-side workflow architecture, data management, API design
• Security Auditor: Security workflow assessment, threat modeling, compliance validation
• DevOps Engineer: Infrastructure workflow automation, deployment strategies, monitoring

Persona Coordination Patterns

• Sequential Consultation: Ordered expert consultation for complex workflow decisions
• Parallel Analysis: Simultaneous workflow analysis from multiple perspectives
• Consensus Building: Integrating diverse expert opinions into unified workflow approach
• Conflict Resolution: Handling contradictory recommendations and workflow trade-offs

Comprehensive MCP Server Integration

Sequential Thinking Integration

• Complex Problem Decomposition: Break down sophisticated workflow challenges systematically
• Multi-Step Reasoning: Apply structured reasoning for complex workflow decisions
• Pattern Recognition: Identify complex workflow patterns across large systems
• Validation Logic: Comprehensive workflow validation and verification processes

Context7 Integration

• Framework Expertise: Leverage deep framework knowledge and workflow patterns
• Best Practices: Apply industry standards and proven workflow approaches
• Pattern Libraries: Access comprehensive workflow pattern and example repositories
• Version Compatibility: Ensure workflow compatibility across technology stacks

Magic Integration

• Advanced UI Generation: Sophisticated user interface workflow generation
• Design System Integration: Comprehensive design system workflow coordination
• Accessibility Excellence: Advanced accessibility workflow and inclusive design
• Performance Optimization: UI performance workflow and user experience optimization

Playwright Integration

• Comprehensive Testing: End-to-end workflow testing across multiple browsers and devices
• Performance Validation: Real-world workflow performance testing and validation
• Visual Testing: Comprehensive visual workflow regression and compatibility testing
• User Experience Validation: Real user interaction workflow simulation and testing

Morphllm Integration

• Intelligent Code Generation: Advanced workflow code generation with pattern recognition
• Large-Scale Refactoring: Sophisticated workflow refactoring across extensive codebases
• Pattern Application: Apply complex workflow patterns and transformations at scale
• Quality Enhancement: Automated workflow quality improvements and optimization

Serena Integration

• Semantic Analysis: Deep semantic understanding of workflow code and systems
• Knowledge Management: Comprehensive workflow knowledge capture and retrieval
• Cross-Session Learning: Accumulate and apply workflow knowledge across sessions
• Memory Coordination: Sophisticated workflow memory management and organization

Advanced Workflow Management

Task Hierarchies

• Epic Level: Large-scale workflow objectives spanning multiple sessions and domains
• Story Level: Feature-level workflow implementations with clear deliverables
• Task Level: Specific workflow implementation items with defined outcomes
• Subtask Level: Granular workflow implementation steps with measurable progress

Dependency Management

• Cross-Domain Dependencies: Coordinate workflow dependencies across different expertise domains
• Temporal Dependencies: Manage time-based workflow dependencies and sequencing
• Resource Dependencies: Coordinate shared workflow resources and capacity constraints
• Knowledge Dependencies: Ensure prerequisite knowledge and context availability for workflows

Quality Gate Integration

• Pre-Execution Gates: Comprehensive readiness validation before workflow execution
• Progressive Gates: Intermediate quality checks throughout workflow execution
• Completion Gates: Thorough validation before marking workflow operations complete
• Handoff Gates: Quality assurance for transitions between workflow phases or systems

Performance & Scalability

Performance Optimization

• Intelligent Batching: Group related workflow operations for maximum efficiency
• Parallel Processing: Coordinate independent workflow operations simultaneously
• Resource Management: Optimal allocation of tools, servers, and personas for workflows
• Context Caching: Efficient reuse of workflow analysis and computation results

Performance Targets

• Complex Analysis: <60s for comprehensive workflow project analysis
• Strategy Planning: <120s for detailed workflow execution planning
• Cross-Session Operations: <10s for session state management
• MCP Coordination: <5s for server routing and coordination
• Overall Execution: Variable based on scope, with progress tracking

Scalability Features

• Horizontal Scaling: Distribute workflow work across multiple processing units
• Incremental Processing: Process large workflow operations in manageable chunks
• Progressive Enhancement: Build workflow capabilities and understanding over time
• Resource Adaptation: Adapt to available resources and constraints for workflows

Advanced Error Handling

Sophisticated Recovery Mechanisms

• Multi-Level Rollback: Rollback at workflow phase, session, or entire operation levels
• Partial Success Management: Handle and build upon partially completed workflow operations
• Context Preservation: Maintain context and progress through workflow failures
• Intelligent Retry: Smart retry with improved workflow strategies and conditions

Error Classification

• Coordination Errors: Issues with persona or MCP server coordination during workflows
• Resource Constraint Errors: Handling of resource limitations and capacity issues
• Integration Errors: Cross-system integration and communication failures
• Complex Logic Errors: Sophisticated workflow logic and reasoning failures

Recovery Strategies

• Graceful Degradation: Maintain functionality with reduced workflow capabilities
• Alternative Approaches: Switch to alternative workflow strategies when primary approaches fail
• Human Intervention: Clear escalation paths for complex issues requiring human judgment
• Learning Integration: Incorporate failure learnings into future workflow executions

MVP Strategy

1. Core Feature Identification - Strip down to essential functionality
2. Rapid Prototyping - Focus on quick validation and feedback
3. Technical Debt Planning - Identify shortcuts and future improvements
4. Validation Metrics - Define success criteria and measurement
5. Scaling Roadmap - Plan for post-MVP feature expansion
6. User Feedback Integration - Structured approach to user input

Expert Persona Auto-Activation

Frontend Workflow (--persona frontend or auto-detected)

• UI/UX Analysis - Design system integration and component planning
• State Management - Data flow and state architecture
• Performance Optimization - Bundle optimization and lazy loading
• Accessibility Compliance - WCAG guidelines and inclusive design
• Browser Compatibility - Cross-browser testing strategy
• Mobile Responsiveness - Responsive design implementation plan

Backend Workflow (--persona backend or auto-detected)

• API Design - RESTful/GraphQL endpoint planning
• Database Schema - Data modeling and migration strategy
• Security Implementation - Authentication, authorization, and data protection
• Performance Scaling - Caching, optimization, and load handling
• Service Integration - Third-party APIs and microservices
• Monitoring & Logging - Observability and debugging infrastructure

Architecture Workflow (--persona architect or auto-detected)

• System Design - High-level architecture and service boundaries
• Technology Stack - Framework and tool selection rationale
• Scalability Planning - Growth considerations and bottleneck prevention
• Security Architecture - Comprehensive security strategy
• Integration Patterns - Service communication and data flow
• DevOps Strategy - CI/CD pipeline and infrastructure as code

Security Workflow (--persona security or auto-detected)

• Threat Modeling - Security risk assessment and attack vectors
• Data Protection - Encryption, privacy, and compliance requirements
• Authentication Strategy - User identity and access management
• Security Testing - Penetration testing and vulnerability assessment
• Compliance Validation - Regulatory requirements (GDPR, HIPAA, etc.)
• Incident Response - Security monitoring and breach protocols

DevOps Workflow (--persona devops or auto-detected)

• Infrastructure Planning - Cloud architecture and resource allocation
• CI/CD Pipeline - Automated testing, building, and deployment
• Environment Management - Development, staging, and production environments
• Monitoring Strategy - Application and infrastructure monitoring
• Backup & Recovery - Data protection and disaster recovery planning
• Performance Monitoring - APM tools and performance optimization

Output Formats

Roadmap Format (--output roadmap)

# Feature Implementation Roadmap
## Phase 1: Foundation (Week 1-2)
- [ ] Architecture design and technology selection
- [ ] Database schema design and setup
- [ ] Basic project structure and CI/CD pipeline

## Phase 2: Core Implementation (Week 3-6)
- [ ] API development and authentication
- [ ] Frontend components and user interface
- [ ] Integration testing and security validation

## Phase 3: Enhancement & Launch (Week 7-8)
- [ ] Performance optimization and load testing
- [ ] User acceptance testing and bug fixes
- [ ] Production deployment and monitoring setup

Tasks Format (--output tasks)

# Implementation Tasks
## Epic: User Authentication System
### Story: User Registration
- [ ] Design registration form UI components
- [ ] Implement backend registration API
- [ ] Add email verification workflow
- [ ] Create user onboarding flow

### Story: User Login
- [ ] Design login interface
- [ ] Implement JWT authentication
- [ ] Add password reset functionality
- [ ] Set up session management

Detailed Format (--output detailed)

# Detailed Implementation Workflow
## Task: Implement User Registration API
**Persona**: Backend Developer
**Estimated Time**: 8 hours
**Dependencies**: Database schema, authentication service
**MCP Context**: Express.js patterns, security best practices

### Implementation Steps:
1. **Setup API endpoint** (1 hour)
   - Create POST /api/register route
   - Add input validation middleware
   
2. **Database integration** (2 hours)
   - Implement user model
   - Add password hashing
   
3. **Security measures** (3 hours)
   - Rate limiting implementation
   - Input sanitization
   - SQL injection prevention
   
4. **Testing** (2 hours)
   - Unit tests for registration logic
   - Integration tests for API endpoint

### Acceptance Criteria:
- [ ] User can register with email and password
- [ ] Passwords are properly hashed
- [ ] Email validation is enforced
- [ ] Rate limiting prevents abuse

Advanced Features

Dependency Analysis

• Internal Dependencies - Identify coupling between components and features
• External Dependencies - Map third-party services and APIs
• Technical Dependencies - Framework versions, database requirements
• Team Dependencies - Cross-team coordination requirements
• Infrastructure Dependencies - Cloud services, deployment requirements

Risk Assessment & Mitigation

• Technical Risks - Complexity, performance, and scalability concerns
• Timeline Risks - Dependency bottlenecks and resource constraints
• Security Risks - Data protection and compliance vulnerabilities
• Business Risks - Market changes and requirement evolution
• Mitigation Strategies - Fallback plans and alternative approaches

Parallel Work Stream Identification

• Independent Components - Features that can be developed simultaneously
• Shared Dependencies - Common components requiring coordination
• Critical Path Analysis - Bottlenecks that block other work
• Resource Allocation - Team capacity and skill distribution
• Communication Protocols - Coordination between parallel streams

Integration Ecosystem

SuperClaude Framework Integration

• Command Coordination: Orchestrate other SuperClaude commands for comprehensive workflow workflows
• Session Management: Deep integration with session lifecycle and persistence for workflow continuity
• Quality Framework: Integration with comprehensive quality assurance systems for workflow validation
• Knowledge Management: Coordinate with knowledge capture and retrieval systems for workflow insights

External System Integration

• Version Control: Deep integration with Git and version management systems for workflow tracking
• CI/CD Systems: Coordinate with continuous integration and deployment pipelines for workflow validation
• Project Management: Integration with project tracking and management tools for workflow coordination
• Documentation Systems: Coordinate with documentation generation and maintenance for workflow persistence

Brainstorm Command Integration

• Natural Input: Workflow receives PRDs and briefs generated by /sc:brainstorm
• Pipeline Position: Brainstorm discovers requirements → Workflow plans implementation
• Context Flow: Inherits discovered constraints, stakeholders, and decisions from brainstorm
• Typical Usage:

  # After brainstorming session:
  /sc:brainstorm "project idea" --prd
  # Workflow takes the generated PRD:
  /sc:workflow ClaudeDocs/PRD/project-prd.md --strategy systematic
  

TodoWrite Integration

• Automatically creates session tasks for immediate next steps
• Provides progress tracking throughout workflow execution
• Links workflow phases to actionable development tasks

Task Command Integration

• Converts workflow into hierarchical project tasks (/sc:task)
• Enables cross-session persistence and progress tracking
• Supports complex orchestration with /sc:spawn

Implementation Command Integration

• Seamlessly connects to /sc:implement for feature development
• Provides context-aware implementation guidance
• Auto-activates appropriate personas for each workflow phase

Analysis Command Integration

• Leverages /sc:analyze for codebase assessment
• Integrates existing code patterns into workflow planning
• Identifies refactoring opportunities and technical debt

Customization & Extension

Advanced Configuration

• Strategy Customization: Customize workflow execution strategies for specific contexts
• Persona Configuration: Configure persona activation and coordination patterns for workflows
• MCP Server Preferences: Customize server selection and usage patterns for workflow analysis
• Quality Gate Configuration: Customize validation criteria and thresholds for workflows

Extension Mechanisms

• Custom Strategy Plugins: Extend with custom workflow execution strategies
• Persona Extensions: Add custom domain expertise and coordination patterns for workflows
• Integration Extensions: Extend integration capabilities with external workflow systems
• Workflow Extensions: Add custom workflow workflow patterns and orchestration logic

Success Metrics & Analytics

Comprehensive Metrics

• Execution Success Rate: >90% successful completion for complex workflow operations
• Quality Achievement: >95% compliance with quality gates and workflow standards
• Performance Targets: Meeting specified performance benchmarks consistently for workflows
• User Satisfaction: >85% satisfaction with outcomes and process quality for workflow management
• Integration Success: >95% successful coordination across all integrated systems for workflows

Analytics & Reporting

• Performance Analytics: Detailed performance tracking and optimization recommendations for workflows
• Quality Analytics: Comprehensive quality metrics and improvement suggestions for workflow management
• Resource Analytics: Resource utilization analysis and optimization opportunities for workflows
• Outcome Analytics: Success pattern analysis and predictive insights for workflow execution

Examples

Comprehensive Project Analysis

/sc:workflow "enterprise-system-prd.md" --strategy systematic --depth deep --validate --mcp-routing
# Comprehensive analysis with full orchestration capabilities

Agile Multi-Sprint Coordination

/sc:workflow "feature-backlog-requirements" --strategy agile --parallel --cross-session
# Agile coordination with cross-session persistence

Enterprise-Scale Operation

/sc:workflow "digital-transformation-prd.md" --strategy enterprise --wave-mode --all-personas
# Enterprise-scale coordination with full persona orchestration

Complex Integration Project

/sc:workflow "microservices-integration-spec" --depth deep --parallel --validate --sequential
# Complex integration with sequential thinking and validation

Generate Workflow from PRD File

/sc:workflow docs/feature-100-prd.md --strategy systematic --c7 --sequential --estimate

Create Frontend-Focused Workflow

/sc:workflow "User dashboard with real-time analytics" --persona frontend --magic --output detailed

MVP Planning with Risk Assessment

/sc:workflow user-authentication-system --strategy mvp --risks --parallel --milestones

Backend API Workflow with Dependencies

/sc:workflow payment-processing-api --persona backend --dependencies --c7 --output tasks

Full-Stack Feature Workflow

/sc:workflow social-media-integration --all-mcp --sequential --parallel --estimate --output roadmap

Boundaries

This advanced command will:

• Orchestrate complex multi-domain workflow operations with expert coordination
• Provide sophisticated analysis and strategic workflow planning capabilities
• Coordinate multiple MCP servers and personas for optimal workflow outcomes
• Maintain cross-session persistence and progressive enhancement for workflow continuity
• Apply comprehensive quality gates and validation throughout workflow execution
• Analyze Product Requirements Documents with comprehensive workflow generation
• Generate structured implementation workflows with expert guidance and orchestration
• Map dependencies and risks with automated task orchestration capabilities

This advanced command will not:

• Execute without proper analysis and planning phases for workflow management
• Operate without appropriate error handling and recovery mechanisms for workflows
• Proceed without stakeholder alignment and clear success criteria for workflow completion
• Compromise quality standards for speed or convenience in workflow execution

---

Quality Gates and Validation

Workflow Completeness Check

• Requirements Coverage - Ensure all PRD requirements are addressed
• Acceptance Criteria - Validate testable success criteria
• Technical Feasibility - Assess implementation complexity and risks
• Resource Alignment - Match workflow to team capabilities and timeline

Best Practices Validation

• Architecture Patterns - Ensure adherence to established patterns
• Security Standards - Validate security considerations at each phase
• Performance Requirements - Include performance targets and monitoring
• Maintainability - Plan for long-term code maintenance and updates

Stakeholder Alignment

• Business Requirements - Ensure business value is clearly defined
• Technical Requirements - Validate technical specifications and constraints
• Timeline Expectations - Realistic estimation and milestone planning
• Success Metrics - Define measurable outcomes and KPIs

Performance Optimization

Workflow Generation Speed

• PRD Parsing - Efficient document analysis and requirement extraction
• Pattern Recognition - Rapid identification of common implementation patterns
• Template Application - Reusable workflow templates for common scenarios
• Incremental Generation - Progressive workflow refinement and optimization

Context Management

• Memory Efficiency - Optimal context usage for large PRDs
• Caching Strategy - Reuse analysis results across similar workflows
• Progressive Loading - Load workflow details on-demand
• Compression - Efficient storage and retrieval of workflow data

Success Metrics

Workflow Quality

• Implementation Success Rate - >90% successful feature completion following workflows
• Timeline Accuracy - <20% variance from estimated timelines
• Requirement Coverage - 100% PRD requirement mapping to workflow tasks
• Stakeholder Satisfaction - >85% satisfaction with workflow clarity and completeness

Performance Targets

• Workflow Generation - <30 seconds for standard PRDs
• Dependency Analysis - <60 seconds for complex systems
• Risk Assessment - <45 seconds for comprehensive evaluation
• Context Integration - <10 seconds for MCP server coordination

Claude Code Integration

• Multi-Tool Orchestration - Coordinates Read, Write, Edit, Glob, Grep for comprehensive analysis
• Progressive Task Creation - Uses TodoWrite for immediate next steps and Task for long-term planning
• MCP Server Coordination - Intelligent routing to Context7, Sequential, and Magic based on workflow needs
• Cross-Command Integration - Seamless handoff to implement, analyze, design, and other SuperClaude commands
• Evidence-Based Planning - Maintains audit trail of decisions and rationale throughout workflow generation