Rails Development Router Skill

Rails Development Router

Welcome! I'll help route your Rails development task to the appropriate specialist.

🎯 How This Works

Based on your request, I'll automatically activate the right specialist skill:

| Your Task | Specialist Activated | |-----------|---------------------| | Writing tests, TDD | → rails-testing | | UI components, Turbo | → rails-viewcomponents | | Security, encryption | → rails-security | | Business logic, workflows | → rails-business-logic | | Background jobs | → rails-background-jobs | | REST API | → rails-api | | GraphQL | → rails-graphql | | Inertia.js SPA | → rails-inertia | | Docker, deployment | → rails-devops | | Performance, optimization | → rails-analyst | | Documentation | → rails-technical-writer | | Project planning | → rails-project-manager |

🚀 Quick Start

Just describe what you want to build:

✅ "Create User model with email validation"
✅ "Add authentication with Devise"
✅ "Build a dashboard component"
✅ "Setup CI/CD pipeline"
✅ "Optimize slow queries"

I'll analyze your request and activate the right specialist!

📚 Core Rails Principles

All specialists follow these NON-NEGOTIABLE principles:

1. Test-First Development (TDD)

Every feature MUST follow Red-Green-Refactor:

# 1. RED - Write failing test FIRST
RSpec.describe User do
  it "validates email presence" do
    user = User.new(email: nil)
    expect(user).not_to be_valid
  end
end

# 2. Run test - MUST fail
# 3. GREEN - Write minimal code to pass
# 4. REFACTOR - Improve while tests pass

Rules:

✅ Tests written BEFORE implementation
✅ Never commit failing tests
✅ Never skip/disable tests to pass builds
✅ Red-Green-Refactor cycle strictly enforced

2. YAGNI Principle

You Aren't Gonna Need It - Don't create abstractions until needed.

# ❌ Don't create prematurely
# app/services/      (until pattern emerges)
# app/presenters/    (use decorators instead)
# config/constants.rb (for values used once)

# ✅ Create when actually needed
# app/interactions/  (ActiveInteraction)
# app/components/    (ViewComponents)

3. Convention Over Configuration

Follow Rails conventions unless compelling reason:

Naming: Models singular, Controllers plural
Routes: RESTful design
Structure: Standard Rails directories
Patterns: Rails way first

4. Security by Design

Always:

✅ Strong parameters in controllers
✅ Authorization on all actions (Pundit)
✅ Encrypt sensitive data (Lockbox)
✅ HTTPS in production
✅ Rate limiting on APIs

5. Incremental Progress

Each commit should:

✅ Compile successfully
✅ Pass all tests
✅ Be deployable
✅ Represent complete feature slice

📖 Available Specialists

For detailed information about each specialist, see SKILLS_REGISTRY.md

🎯 Coordination

rails-project-manager - Plans features, coordinates specialists

💻 Development

rails-testing - RSpec, FactoryBot, TDD
rails-viewcomponents - ViewComponent, Turbo, Stimulus
rails-business-logic - ActiveInteraction, AASM, decorators

🌐 API & Frontend

rails-api - REST APIs, JWT, serialization
rails-graphql - GraphQL schemas, mutations
rails-inertia - Inertia.js SPAs

🏗️ Infrastructure

rails-background-jobs - Solid Queue, jobs
rails-devops - Docker, CI/CD, deployment
rails-security - Pundit, Lockbox, authentication

📊 Analysis

rails-analyst - Performance, optimization
rails-technical-writer - Documentation

🔍 Need Help Choosing?

Ask yourself:

What am I building?

Data/logic → rails-business-logic
UI component → rails-viewcomponents
API endpoint → rails-api or rails-graphql
Background task → rails-background-jobs

What am I fixing?

Slow queries → rails-analyst
Security issue → rails-security
Test failure → rails-testing
Deployment problem → rails-devops

What am I documenting?

README → rails-technical-writer
Code comments → rails-technical-writer

What am I planning?

Complex feature → rails-project-manager
Architecture decision → rails-project-manager

💡 Example Workflows

Simple Task (One Specialist)

YOU: "Add email validation to User model"

CLAUDE: [Activates rails-testing]
        Writing test first (TDD)...
        Test fails (RED) ✓
        Adding validation...
        Test passes (GREEN) ✓

Complex Task (Multiple Specialists)

YOU: "Build comment system for articles"

CLAUDE: [Activates rails-project-manager]
        Analyzing requirements...

        Plan:
        Stage 1: Model & Tests (rails-testing)
        Stage 2: Business Logic (rails-business-logic)
        Stage 3: API (rails-api)
        Stage 4: UI Components (rails-viewcomponents)

        Starting Stage 1...

🛠️ Tech Stack Reference

Our specialists support:

Core Framework

Rails 7.0, 7.1, 7.2, 8.0, 8.1
Ruby 3.2, 3.3+
PostgreSQL 14+

Frontend

ViewComponent 3.x
Hotwire (Turbo 8.x, Stimulus 3.x)
Tailwind CSS
Inertia.js 1.x

Backend

ActiveInteraction 5.x
AASM 5.x
Pundit 2.x
Lockbox 1.x
Solid Queue (Rails 7.1+)

DevOps

Docker
GitHub Actions / GitLab CI
Kamal 2.x (Rails 8.0+)

📋 Quality Checklist

Before any commit, specialists ensure:

# All must pass:
bundle exec rspec                    # Tests
bundle exec rubocop                  # Linting
bundle exec erblint --lint-all       # ERB linting
bundle exec brakeman --no-pager      # Security
bundle exec bundle-audit check       # Vulnerabilities

🔄 Continuous Improvement

This system is:

✅ Extensible - Easy to add new specialists
✅ Updatable - Each specialist versioned independently
✅ Open Source - Community contributions welcome
✅ Documented - All patterns and practices recorded

See SKILLS_REGISTRY.md for:

Complete specialist catalog
Version history
Extension guide
Contributing guidelines

🎬 Ready to Start?

Just tell me what you want to build, and I'll activate the right specialist!

Examples:

"Create an Article model with validations"
"Setup authentication system"
"Build a commenting feature"
"Optimize slow dashboard queries"
"Deploy to production with Docker"

Let's build something great! 🚀

Agent Skills: Rails Development Router

Skill Files