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! 🚀