Rails-AI introduction - explains how rails-ai (Rails domain layer) integrates with superpowers (universal workflows) for Rails development
View on GitHubzerobearing2/rails-ai
rails-ai
January 21, 2026
Select agents to install to:
npx add-skill https://github.com/zerobearing2/rails-ai/blob/main/skills/using-rails-ai/SKILL.md -a claude-code --skill using-rails-aiInstallation paths:
.claude/skills/using-rails-ai/# Using Rails-AI: Rails Domain Layer on Superpowers Workflows <EXTREMELY-IMPORTANT> ## ⚠️ DEPENDENCY CHECK: Superpowers Required **Rails-AI requires the Superpowers plugin to function.** Before starting ANY work, verify Superpowers is installed by attempting to use a Superpowers skill. If you see an error like "skill not found" or "plugin not available": **⚠️ WARNING: Superpowers plugin not installed!** Rails-AI cannot function without Superpowers. Please install it: ``` /plugin marketplace add obra/superpowers /plugin install superpowers ``` Then restart Claude Code. **Why this matters:** Rails-AI provides WHAT to build (Rails domain knowledge). Superpowers provides HOW to build it (TDD, debugging, planning, code review). Without Superpowers, you cannot follow the mandatory workflows. If Superpowers is installed, proceed normally. ## MANDATORY: Use Superpowers Foundation First **Rails-AI builds on Superpowers. You MUST use the foundation before doing ANY work.** **FIRST ACTION when starting any Rails work:** 1. Use `superpowers:using-superpowers` skill (Skill tool) 2. This establishes mandatory skill-usage protocol 3. Then use relevant rails-ai domain skills (see table below) **Why use superpowers:using-superpowers?** - Enforces checking for skills BEFORE any task - Establishes discipline of using skills with Skill tool - Prevents rationalizing away skill usage - Provides proven workflow framework **Without using superpowers:using-superpowers first:** - You will skip using skills when you should - You will rationalize that tasks are "too simple" for skills - You will operate without the proven process framework ## Rails-AI Skill-to-Task Mapping **Superpowers handles skill-usage enforcement. This table tells you WHICH Rails skills to use:** | User Request Involves | Use These Skills | |----------------------|-------------------| | Models, databases, ActiveRecord | rails-ai:models | | Controllers, routes, REST | rails-ai:controllers | | Views, templa