SpecSwarm v5.2.0
Complete Software Development Toolkit
Build, fix, maintain, and analyze your entire software project with one unified plugin.
Overview
SpecSwarm is a comprehensive Claude Code plugin for the complete software development lifecycle across any language or framework Claude supports:
- ✅ Spec-Driven Development - Specification to implementation
- 🐛 Bug Management - Systematic fixing with regression testing
- 🔧 Code Maintenance - Refactoring and feature modification
- 📊 Quality Assurance - Automated validation (0-100 scoring)
- 🗣️ Natural Language - Talk to SpecSwarm like a teammate
- 🔌 MCP Auto-Detection - Configures MCP servers for your tech stack
10 Commands | MCP Integration | Production Ready
Installation
# 1. Add the marketplace
/plugin marketplace add MartyBonacci/specswarm
# 2. Install the plugin
/plugin install specswarm@specswarm-marketplace
# 3. (Optional) Install /ss: shortcuts
/plugin install ss@specswarm-marketplace
Restart Claude Code to activate the plugin.
Quick Start
One-Command Workflow
# Initialize your project
/specswarm:init
That's it! Now you can use natural language:
"Build user authentication with JWT"
"Fix the login button on mobile"
"Change authentication from session to JWT"
"Ship this feature"
SpecSwarm automatically runs the right workflow based on your intent.
Core Commands
These 5 commands handle the vast majority of daily development work.
1. /specswarm:init
Initialize SpecSwarm in your project
/specswarm:init
Creates .specswarm/ directory with:
tech-stack.md - Prevent technology driftquality-standards.md - Quality gates and budgetsconstitution.md - Project governance
Use when: First-time project setup, or to refresh tech-stack and constitution after external changes
2. /specswarm:build
Build new features from specification to implementation
/specswarm:build "feature description"
Natural language:
"Build user authentication with JWT"
"Create a payment processing system"
"Add dashboard analytics"
Complete workflow:
- Creates specification
- Asks clarifying questions
- Generates implementation plan
- Breaks down into tasks
- Implements all tasks
- Validates quality (0-100 score)
Quick mode for small tasks:
/specswarm:build "add loading spinner" --quick
Skips clarification, auto-generates micro-spec, and executes immediately.
Use when: Building any new feature
3. /specswarm:fix
Fix bugs with regression testing and auto-retry
/specswarm:fix "bug description"
Natural language:
"Fix the login button on mobile"
"Images don't load"
"Tailwind styles not showing up"
Complete workflow:
- Creates regression test
- Analyzes root cause
- Implements fix
- Validates with tests
- Auto-retries on failure (max 2 attempts)
Use when: Fixing any bug or broken functionality
4. /specswarm:modify
Change existing feature behavior with impact analysis
/specswarm:modify "modification description"
Natural language:
"Change authentication from session to JWT"
"Add pagination to user list API"
"Update search to use full-text search"
Complete workflow:
- Analyzes impact on existing code
- Identifies breaking changes
- Creates migration plan
- Updates specification and plan
- Implements modifications
- Validates against regression tests
Use when:
- Features that work but need to work differently
- NOT for bugs (use
/specswarm:fix)
- NOT for code quality (use
/specswarm:modify "..." --refactor)
5. /specswarm:ship
Validate quality, merge to parent branch, and complete feature
/specswarm:ship
Natural language:
"Ship this feature" ⚠️ (requires confirmation)
"Deploy to production" ⚠️ (requires confirmation)
Complete workflow:
- Runs comprehensive quality analysis
- Checks quality threshold (default 80%)
- Shows merge plan with confirmation
- Merges to parent branch
- Deletes feature branch
⚠️ DESTRUCTIVE OPERATION - Always requires explicit "yes" confirmation
Use when:
- Feature is complete and tested
- Quality score meets threshold
- Ready to merge to main/production
Natural Language Commands
Just Talk to SpecSwarm
Instead of memorizing slash commands, describe what you want in plain English:
Build a Feature:
"Build user authentication with JWT"
"Create a payment processing system"
Fix a Bug:
"Fix the login button"
"Images don't load"
"Styles not showing up"
Modify Existing Features:
"Change authentication to use JWT"
"Add pagination to the API"
Ship Features:
"Ship this feature" ⚠️ (always requires confirmation)
"Merge to main" ⚠️ (always requires confirmation)
Skill-Based Routing
