sp-ecc

SP-ECC

An integration project combining Superpowers by Jesse Vincent and Everything Claude Code by Affaan Mustafa.

This project merges the systematic workflows from Superpowers with the battle-tested production tools from Everything Claude Code, creating a comprehensive development toolkit for Claude Code with a three-layer architecture.

Credits

• Jesse Vincent - Original Superpowers v4.1.1 author (systematic workflows, TDD, debugging)
• Affaan Mustafa - Original Everything Claude Code v1.7.0 author (agents, commands, hooks, patterns)
• Faisal Alqarni - Integration work and enhancements

Source Versions: Superpowers 4.1.1 + Everything Claude Code 1.7.0

What This Project Provides

Three-Layer Architecture:

• Layer 1 (from Superpowers): Systematic workflows (brainstorming → planning → execution → review)
• Layer 2 (integrated): Mode skills and pattern extraction (auto-invoked by workflows)
• Layer 3 (from ECC): Quick tools (26 commands, 13 specialist agents)

Enhanced Language Support:

• Ruby/Rails with 1,404 lines on Rails Engines (added in this integration)
• Dart/Flutter with state management decision matrices (added in this integration)
• Python/Django, Go, Java/Spring Boot (from both projects)

Git Safety (from ECC): Destructive git operations (force push, reset --hard, rebase) are blocked. Normal operations allowed.

Opt-Out-Able (integrated): All auto-features can be disabled. See docs/integration/OPT-OUT.md.

How It Works

For Complex Features (Layer 1 Workflows):

It starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it doesn't just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do.

Once it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest. After the design is presented, you choose from four options: Ready (proceed to planning), Revise (refine the design), Save & exit (bookmark for later), or Discard & start fresh.

After you've signed off on the design, your agent puts together an implementation plan that's clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI (You Aren't Gonna Need It), and DRY.

Next up, once you say "go", it launches a subagent-driven-development process, having agents work through each engineering task. Each task passes through a multi-stage review pipeline — spec compliance, code quality, and security checks, with a conditional gate before proceeding. After all tasks complete, after-all-tasks stages run automatically: E2E test generation, doc updates, a verification loop, final review, and refactor cleanup.

It's not uncommon for Claude to be able to work autonomously for a couple hours at a time without deviating from the plan you put together. See docs/integration/ARCHITECTURE.md for the full pipeline details.

For Quick Tasks (Layer 3 Tools):

Need to fix a build error? /sp-ecc:build-fix Want test coverage? /sp-ecc:test-coverage Security audit needed? @security-auditor

Quick, focused, no ceremony. Use when you know exactly what you need.

Best of Both Worlds: Systematic workflows when you need structure. Quick tools when workflow is overkill.

Support the Original Authors

This project builds on the excellent work of:

Superpowers by Jesse Vincent:

• Sponsor: github.com/sponsors/obra
• Project: github.com/obra/superpowers

Everything Claude Code by Affaan Mustafa:

• Project: github.com/affaan-m/everything-claude-code
• Twitter: @affaanmustafa

Installation

Quick Install (Recommended)

In Claude Code, run these two commands:

# 1. Register the marketplace
/plugin marketplace add FaisalAlqarni/sp-ecc

# 2. Install the plugin
/plugin install sp-ecc@sp-ecc

That's it! The plugin will be installed automatically.

Manual Installation (Alternative)

If you prefer manual installation:

1. Clone the repository:

git clone https://github.com/FaisalAlqarni/sp-ecc
cd sp-ecc

2. Install dependencies (optional, for linting):

npm install

3. Create symlink to Claude Code plugins directory:

Windows:

mklink /D "%USERPROFILE%\.claude\plugins\sp-ecc" "D:\path\to\sp-ecc"

macOS/Linux:

ln -s /path/to/sp-ecc ~/.claude/plugins/sp-ecc

4. Restart Claude Code

Verify Installation