superpowers-rails

Superpowers Rails

Superpowers Rails brings Superpowers — Jesse Vincent's software development methodology for coding agents — to Rails. The methodology is his; Superpowers Rails layers Rails on top:

• Eight Rails convention skills (models, controllers, views, policies, jobs, migrations, Stimulus, testing), enforced by a PreToolUse hook that blocks Rails file edits until the matching convention skill is loaded
• A Rails review stage in the subagent review pipeline (spec compliance → Rails conventions → code quality), plus a /codereview command that runs the full pipeline on demand
• A different planning philosophy: plans are vertical slices — every slice ships a user-visible capability — written at intent level, with exact code reserved for fragile operations

The full delta against upstream is documented in docs/fork-changes.md; release history is in RELEASE-NOTES.md. Report issues at fryga-io/superpowers-rails, not upstream. Superpowers Rails is funded by fryga.

Superpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them.

Quickstart

Give your agent Superpowers: Claude Code, Factory Droid, Gemini CLI, OpenCode, GitHub Copilot CLI. (Superpowers Rails is not published to the Codex or Cursor marketplaces — see those sections below.)

How it works

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 you've signed off on the design, your agent puts together an implementation plan with bite-sized tasks describing what to build and where. It uses intent-level steps for routine work and exact code only for fragile operations like migrations. 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, inspecting and reviewing their work, and continuing forward. 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.

There's a bunch more to it, but that's the core of the system. And because the skills trigger automatically, you don't need to do anything special. Your coding agent just has Superpowers.

Sponsorship

Superpowers Rails is built on Jesse Vincent's Superpowers. If it has helped you do stuff that makes money and you are so inclined, consider sponsoring his opensource work.

Installation

Installation differs by harness. If you use more than one, install Superpowers separately for each one.

Claude Code

• Register the Fryga marketplace:

  /plugin marketplace add fryga-io/claude-marketplace
  

• Install the plugin:

  /plugin install superpowers-rails@fryga
  

Migrating from the old plugin name (existing installs)

Before v5.1.2-rails this plugin was named superpowers and installed from this repo's own marketplace (superpowers-dev). Existing superpowers@superpowers-dev installs keep working unchanged — the marketplace keeps a deprecated superpowers entry frozen at 5.1.1-rails — but they receive no further updates.

Migrating is recommended but optional. Using the marketplace you already have:

/plugin marketplace update superpowers-dev
/plugin uninstall superpowers@superpowers-dev
/plugin install superpowers-rails@superpowers-dev

Or switch to the public fryga marketplace entirely: first /plugin uninstall superpowers@superpowers-dev so you are never running both plugins at once, then add the fryga marketplace and install from it (see Claude Code above).

Codex CLI

The official Codex plugin marketplace serves upstream Superpowers, not Superpowers Rails. Installing superpowers there gets you upstream, without the Rails additions. Superpowers Rails is not published to the Codex marketplace.

Codex App

Same as Codex CLI: the Codex plugin marketplace entry is upstream Superpowers, not Superpowers Rails.

Factory Droid

Untested on this harness — these commands mirror upstream's git-based install, re-pointed at this repo.

• Register the marketplace:

  droid plugin marketplace add https://github.com/fryga-io/superpowers-rails
  

• Install the plugin: