**claude-on-rails**

ClaudeOnRails

[](https://badge.fury.io/rb/claude-on-rails) [](https://github.com/obie/claude-on-rails/actions/workflows/main.yml)

A Rails development framework that leverages [claude-swarm](https://github.com/parruda/claude-swarm) to create an intelligent team of AI agents specialized in different aspects of Rails development.

Instead of managing personas manually, ClaudeOnRails automatically orchestrates a swarm of specialized agents that work together like a real development team. Simply describe what you want to build, and the swarm handles the rest.

How It Works

ClaudeOnRails creates a team of specialized AI agents:

• Architect: Coordinates development and makes high-level decisions
• Models: Handles ActiveRecord, migrations, and database design
• Controllers: Manages routing and request handling
• Views: Creates UI templates and manages assets
• Services: Implements business logic and service objects
• Tests: Ensures comprehensive test coverage
• DevOps: Handles deployment and infrastructure

Each agent works in their specific domain (directory) and can collaborate with other agents to implement complex features.

Installation

Add to your Rails application's Gemfile:

group :development do
  gem 'claude-on-rails'
end

Then run:

bundle install
rails generate claude_on_rails:swarm

During generation, you'll be offered to set up Rails MCP Server for enhanced documentation access. Simply press Y when prompted!

This will:

• Analyze your Rails project structure
• Optionally set up Rails MCP Server (recommended)
• Generate a customized swarm configuration
• Create agent-specific prompts
• Set up your development environment

For detailed setup instructions, see [SETUP.md](./SETUP.md).

Usage

Start Your Development Swarm

# In your Rails project directory
claude-swarm

Natural Language Development

...