SPARC development workflow: Specification, Pseudocode, Architecture, Refinement, Completion. A structured approach for complex implementations that ensures thorough planning before coding. Use when: new feature implementation, complex implementations, architectural changes, system redesign, integrat

SPARC Methodology Comprehensive Development Framework Overview SPARC (Specification, Pseudocode, Architecture, Refinement, Completion) is a systematic development methodology integrated with Claude Flow's multi agent orchestration capabilities. It provides 17 specialized modes for comprehensive software development, from initial research through deployment and monitoring. Table of Contents 1. [Core Philosophy]( core philosophy) 2. [Development Phases]( development phases) 3. [Available Modes]( available modes) 4. [Activation Methods]( activation methods) 5. [Orchestration Patterns]( orchestration patterns) 6. [TDD Workflows]( tdd workflows) 7. [Best Practices]( best practices) 8. [Integration Examples]( integration examples) 9. [Common Workflows]( common workflows) Core Philosophy SPARC methodology emphasizes: Systematic Approach : Structured phases from specification to completion Test Driven Development : Tests written before implementation Parallel Execution : Concurrent agent coordination for 2.8 4.4x speed improvements Memory Integration : Persistent knowledge sharing across agents and sessions Quality First : Comprehensive reviews, testing, and validation Modular Design : Clean separation of concerns with clear interfaces Key Principles 1. Specification Before Code : Define requirements and constraints clearly 2. Design Before Implementation : Plan architecture and components 3. Tests Before Features : Write failing tests, then make them pass 4. Review Everything : Code quality, security, and performance checks 5. Document Continuously : Maintain current documentation throughout Development Phases Phase 1: Specification Goal : Define requirements, constraints, and success criteria Requirements analysis User story mapping Constraint identification Success metrics definition Pseudocode planning Key Modes : researcher , analyzer , memory manager Phase 2: Architecture Goal : Design system structure and component interfaces System architecture design Component interface definition Database schema planning API contract specification Infrastructure planning Key Modes : architect , designer , orchestrator Phase 3: Refinement (TDD Implementation) Goal : Implement features with test first approach Write failing tests Implement minimum viable code Make tests pass Refactor for quality Iterate until complete Key Modes : tdd , coder , tester Phase 4: Review Goal : Ensure code quality, security, and performance Code quality assessment Security vulnerability scanning Performance profiling Best practices validation Documentation review Key Modes : reviewer , optimizer , debugger Phase 5: Completion Goal : Integration, deployment, and monitoring System integration Deployment automation Monitoring setup Documentation finalization Knowledge capture Key Modes : workflow manager , documenter , memory manager Available Modes Core Orchestration Modes orchestrator Multi agent task orchestration with TodoWrite/Task/Memory coordination. Capabilities : Task decomposition into manageable units Agent coordination and resource allocation Progress tracking and result synthesis Adaptive strategy selection Cross agent communication Usage : swarm coordinator Specialized swarm management for complex multi agent workflows. Capabilities : Topology optimization (mesh, hierarchical, ring, star) Agent lifecycle management Dynamic scaling based on workload Fault tolerance and recovery Performance monitoring workflow manager Process automation and workflow orchestration. Capabilities : Workflow definition and execution Event driven triggers Sequential and parallel pipelines State management Error handling and retry logic batch executor Parallel task execution for high throughput operations. Capabilities : Concurrent file operations Batch processing optimization Resource pooling Load balancing Progress aggregation Development Modes coder Autonomous code generation with batch file operations. Capabilities : Feature implementation Code refactoring Bug fixes and patches API development Algorithm implementation Quality Standards : ES2022+ standards TypeScript type safety Comprehensive error handling Performance optimization Security best practices Usage : architect System design with Memory based coordination. Capabilities : Microservices architecture Event driven design Domain driven design (DDD) Hexagonal architecture CQRS and Event Sourcing Memory Integration : Store architectural decisions Share component specifications Maintain design consistency Track architectural evolution Design Patterns : Layered architecture Microservices patterns Event driven patterns Domain modeling Infrastructure as Code Usage : tdd Test driven development with comprehensive testing. Capabilities : Test first development Red green refactor cycle Test suite design Coverage optimization (target: 90%+) Continuous testing TDD Workflow : 1. Write failing test (RED) 2. Implement minimum code 3. Make test pass (GREEN) 4. Refactor for quality (REFACTOR) 5. Repeat cycle Testing Strategies : Unit testing (Jest, Mocha, Vitest) Integration testing End to end testing (Playwright, Cypress) Performance testing Security testing Usage : reviewer Code review using batch file analysis. Capabilities : Code quality assessment Security vulnerability detection Performance analysis Best practices validation Documentation review Review Criteria : Code correctness and logic Design pattern adherence Comprehensive error handling Test coverage adequacy Maintainability and readability Security vulnerabilities Performance bottlenecks Batch Analysis : Parallel file review Pattern detection Dependency checking Consistency validation Automated reporting Usage : Analysis and Research Modes researcher Deep research with parallel WebSearch/WebFetch and Memory coordination. Capabilities : Comprehensive information gathering Source credibility evaluation Trend analysis and forecasting Competitive research Technology assessment Research Methods : Parallel web searches Academic paper analysis Industry report synthesis Expert opinion gathering Statistical data compilation Memory Integration : Store research findings with citations Build knowledge graphs Track information sources Cross reference insights Maintain research history Usage : analyzer Code and data analysis with pattern recognition. Capabilities : Static code analysis Dependency analysis Performance profiling Security scanning Data pattern recognition optimizer Performance optimization and bottleneck resolution. Capabilities : Algorithm optimization Database query tuning Caching strategy design Bundle size reduction Memory leak detection Creative and Support Modes designer UI/UX design with accessibility focus. Capabilities : Interface design User experience optimization Accessibility compliance (WCAG 2.1) Design system creation Responsive layout design innovator Creative problem solving and novel solutions. Capabilities : Brainstorming and ideation Alternative approach generation Technology evaluation Proof of concept development Innovation feasibility analysis documenter Comprehensive documentation generation. Capabilities : API documentation (OpenAPI/Swagger) Architecture diagrams User guides and tutorials Code comments and JSDoc README and changelog maintenance debugger Systematic debugging and issue resolution. Capabilities : Bug reproduction Root cause analysis Fix implementation Regression prevention Debug logging optimization tester Comprehensive testing beyond TDD. Capabilities : Test suite expansion Edge case identification Performance testing Load testing Chaos engineering memory manager Knowledge management and context preservation. Capabilities : Cross session memory persistence Knowledge graph construction Context restoration Learning pattern extraction Decision tracking Activation Methods Method 1: MCP Tools (Preferred in Claude Code) Best for : Integrated Claude Code workflows with full orchestration capabilities Method 2: NPX CLI (Fallback) Best for : Terminal usage or when MCP tools unavailable Method 3: Local Installation Best for : Projects with local claude flow installation Orchestration Patterns Pattern 1: Hierarchical Coordination Best for : Complex projects with clear delegation hierarchy Pattern 2: Mesh Coordination Best for : Collaborative tasks requiring peer to peer communication Pattern 3: Sequential Pipeline Best for : Ordered workflow execution (spec → design → code → test → review) Pattern 4: Parallel Execution Best for : Independent tasks that can run concurrently Pattern 5: Adaptive Strategy Best for : Dynamic workloads with changing requirements TDD Workflows Complete TDD Workflow Red Green Refactor Cycle Best Practices 1. Memory Integration Always use Memory for cross agent coordination : 2. Parallel Operations Batch all related operations in single message : 3. Hook Integration Every SPARC mode should use hooks : 4. Test Coverage Maintain minimum 90% coverage : Unit tests for all functions Integration tests for APIs E2E tests for critical flows Edge case coverage Error path testing 5. Documentation Document as you build : API documentation (OpenAPI) Architecture decision records (ADR) Code comments for complex logic README with setup instructions Changelog for version tracking 6. File Organization Never save to root folder : Integration Examples Example 1: Full Stack Development Example 2: Research Driven Innovation Example 3: Legacy Code Refactoring Common Workflows Workflow 1: Feature Development Workflow 2: Bug Investigation Workflow 3: Performance Optimization Workflow 4: Complete Pipeline Advanced Features Neural Pattern Training Cross Session Memory GitHub Integration Performance Monitoring Performance Benefits Proven Results : 84.8% SWE Bench solve rate 32.3% token reduction through optimizations 2.8 4.4x speed improvement with parallel execution 27+ neural models for pattern learning 90%+ test coverage standard Support and Resources Documentation : https://github.com/ruvnet/claude flow Issues : https://github.com/ruvnet/claude flow/issues NPM Package : https://www.npmjs.com/package/claude flow Community : Discord server (link in repository) Quick Reference Most Common Commands Most Common MCP Calls Remember: SPARC = Systematic, Parallel, Agile, Refined, Complete

sparc-methodology