ss

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 drift
• quality-standards.md - Quality gates and budgets
• constitution.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:

1. Creates specification
2. Asks clarifying questions
3. Generates implementation plan
4. Breaks down into tasks
5. Implements all tasks
6. 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:

1. Creates regression test
2. Analyzes root cause
3. Implements fix
4. Validates with tests
5. 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:

1. Analyzes impact on existing code
2. Identifies breaking changes
3. Creates migration plan
4. Updates specification and plan
5. Implements modifications
6. 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:

1. Runs comprehensive quality analysis
2. Checks quality threshold (default 80%)
3. Shows merge plan with confirmation
4. Merges to parent branch
5. 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