claude-on-rails 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c54b004a79682a75a479c16d29933a76e7baca7f71a7af6d8378f77788ec90cd
-  data.tar.gz: fa1e7da87e5306defb8504d944f06d14bac72be1bc3b02bc5c011db95fec5e2c
+  metadata.gz: a54eaca693aeb4a066e7fae8112346681d1127d8b6c247f01d8cf56c4fe12f77
+  data.tar.gz: 3e7d637a4625cca7ef9a5886ed5c6aaef1464173b7bbb8735ebcdea5436ec583
 SHA512:
-  metadata.gz: 22d8cfa8073d281f30cec4347d3051e91eed508278d372a8a6f2ddbe41fea400fd800d7ad29669df9706f92cf8d017a7278b09dcbea5fc259b250892432e03c0
-  data.tar.gz: 229724023c7c511a60787f6164c8c5dce6421772d7c0aadd864b17c7833bf7e52e16c56e1f1b76c5a2f315bd04ebb835d6910179373103200ce58e16a01fe259
+  metadata.gz: e3845a7c2b042d3c35943fd859ea8286ecfe61434e42e90263b217de1f73bf431f04f9c02f5a492dc65f6a5922c77da6a65c433cc20a55f5520966b4ece914bd
+  data.tar.gz: e269424a844bacc0a1906ef7a44e350ccb3798dbfc081702c647b799d703d3d0fa0093cc61888c3c8180e19b19b6fc502723090eedcba4e7f9e3c9dc5658395c

data/.rubocop.yml

@@ -11,6 +11,11 @@ AllCops:
 plugins:
   - rubocop-rake
 
+# Allow hyphenated filename to match gem name
+Naming/FileName:
+  Exclude:
+    - 'lib/claude-on-rails.rb'
+
 
 # Relaxed metrics for DSL-heavy library code
 Metrics/MethodLength:

data/CHANGELOG.md

@@ -5,6 +5,35 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2025-01-02
+
+### Added
+- Rails MCP Server integration for enhanced documentation access
+- Interactive setup wizard with `rails claude_on_rails:setup_mcp`
+- Status checking with `rails claude_on_rails:mcp_status`
+- Automated MCP setup during swarm generation
+- Post-install message with setup instructions
+- Comprehensive SETUP.md documentation
+
+### Changed
+- Rails MCP Server is now a Ruby gem (not npm package)
+- MCP configuration automatically added to swarm.yml when available
+- All agent prompts enhanced with MCP-specific guidance
+- Simplified setup process - just press Y during generation
+
+### Fixed
+- RDoc version conflicts during gem installation
+- Use --no-document flag to avoid documentation generation issues
+- Improved MCP availability detection
+
+## [0.1.5] - 2025-01-27
+
+### Fixed
+- Fixed rake tasks not loading in Rails applications
+- Added explicit require for rails/railtie in railtie.rb
+- Changed Rails detection to check for Rails::Railtie instead of Rails
+- Removed circular dependency in rake task file
+
 ## [0.1.4] - 2025-01-27
 
 ### Fixed

data/CLAUDE.md

@@ -0,0 +1,59 @@
+# ClaudeOnRails Development
+
+## Project Overview
+
+ClaudeOnRails is a Ruby gem that leverages claude-swarm to create intelligent AI agent teams for Rails development. It generates swarm configurations that allow developers to describe what they want to build in natural language, and the swarm coordinates implementation across all Rails layers.
+
+## Guidelines
+
+### 1. File References in Claude
+- Use `@filepath` syntax for file references, not `/file:filepath`
+- File references are the preferred way to include content without duplicating it
+
+### 2. Never Overwrite User Configuration
+- Always check if CLAUDE.md exists before writing to it
+- Use file references to include framework content rather than appending
+- Store framework-specific content in separate files (e.g., `.claude-on-rails/context.md`)
+
+### 3. Claude-Swarm Integration
+- The default configuration file is `claude-swarm.yml`, not `swarm.yml`
+- Command is simply `claude-swarm`, not `claude-swarm orchestrate`
+- claude-swarm is a dependency, so no need to tell users to install it separately
+
+### 4. Documentation Clarity
+- Clearly distinguish between shell commands and Claude prompts
+- Use `>` prefix for Claude prompts to avoid confusion with bash commands
+- Be explicit about where commands should be run vs where prompts should be typed
+
+### 5. Ruby Gem Best Practices
+- Keep development dependencies in Gemfile, not gemspec (RuboCop rule)
+- Always run `bundle exec rake` before committing changes to catch syntax and style issues
+- Use `bundle exec rake release` for gem releases (creates tag, pushes to RubyGems)
+- ...then create GitHub releases separately with `gh release create`
+
+### 6. Generator Best Practices
+- Check for directory existence before creating agents
+- Make generators idempotent (running multiple times shouldn't duplicate content)
+- Provide clear next steps after generation
+- Show what will be created during the analysis phase
+
+### 7. Testing Considerations
+- Make sure that user confirms that they have tested changes with a real Rails project before releasing
+- Consider different Rails configurations (API-only, full-stack, with/without GraphQL)
+- **IMPORTANT**: This project uses RSpec exclusively for testing. NEVER use Minitest or any other testing framework. Do not add minitest gems, create test/ directories, or write any Minitest-style tests. All tests must be written in RSpec format and placed in the spec/ directory.
+
+## Workflow Guidance
+
+- For maximum efficiency, whenever you need to perform multiple independent operations, invoke all relevant tools simultaneously rather than sequentially.
+- When you're tempted to respond and return control to me with a message like "The codebase is now in excellent shape with 859 passing tests, 1 failing test, and 5 pending tests. The project is ready for the v0.2.0 release once the team decides how to handle the final test (either fix it or mark it as pending)." then instead, you should  decide how to handle the final test _first_.
+
+## Release Guidance
+
+- Note that releases are never ready if there are any tests failing in the test suites. Never tell me that a release is ready unless we have a clean build.
+
+## Architecture Notes
+
+- The gem analyzes Rails projects to detect patterns and frameworks
+- It generates customized swarm configurations based on project structure
+- Each agent works in a specific directory (MVC separation)
+- Agents communicate via MCP protocol in claude-swarm

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    claude-on-rails (0.1.4)
+    claude-on-rails (0.2.0)
       claude_swarm (~> 0.1)
       rails (>= 6.0)
 
@@ -258,14 +258,6 @@ GEM
     rspec-mocks (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-rails (5.1.2)
-      actionpack (>= 5.2)
-      activesupport (>= 5.2)
-      railties (>= 5.2)
-      rspec-core (~> 3.10)
-      rspec-expectations (~> 3.10)
-      rspec-mocks (~> 3.10)
-      rspec-support (~> 3.10)
     rspec-support (3.13.4)
     rubocop (1.77.0)
       json (~> 2.3)
@@ -281,28 +273,9 @@ GEM
     rubocop-ast (1.45.1)
       parser (>= 3.3.7.2)
       prism (~> 1.4)
-    rubocop-capybara (2.22.1)
-      lint_roller (~> 1.1)
-      rubocop (~> 1.72, >= 1.72.1)
-    rubocop-factory_bot (2.27.1)
-      lint_roller (~> 1.1)
-      rubocop (~> 1.72, >= 1.72.1)
-    rubocop-rails (2.32.0)
-      activesupport (>= 4.2.0)
-      lint_roller (~> 1.1)
-      rack (>= 1.1)
-      rubocop (>= 1.75.0, < 2.0)
-      rubocop-ast (>= 1.44.0, < 2.0)
     rubocop-rake (0.7.1)
       lint_roller (~> 1.1)
       rubocop (>= 1.72.1)
-    rubocop-rspec (2.31.0)
-      rubocop (~> 1.40)
-      rubocop-capybara (~> 2.17)
-      rubocop-factory_bot (~> 2.22)
-      rubocop-rspec_rails (~> 2.28)
-    rubocop-rspec_rails (2.29.1)
-      rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
     securerandom (0.4.1)
     stringio (3.1.7)
@@ -332,15 +305,10 @@ PLATFORMS
   x86_64-linux-musl
 
 DEPENDENCIES
-  bundler (~> 2.0)
   claude-on-rails!
   rake (~> 13.0)
   rspec (~> 3.0)
-  rspec-rails (~> 5.0)
-  rubocop (~> 1.0)
-  rubocop-rails (~> 2.0)
   rubocop-rake (~> 0.6)
-  rubocop-rspec (~> 2.0)
 
 BUNDLED WITH
    2.5.23

data/README.md

@@ -1,5 +1,9 @@
 # ClaudeOnRails
 
+[![Gem Version](https://badge.fury.io/rb/claude-on-rails.svg?cache_bust=0.1.4)](https://badge.fury.io/rb/claude-on-rails)
+[![CI](https://github.com/obie/claude-on-rails/actions/workflows/main.yml/badge.svg)](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.
@@ -35,8 +39,11 @@ 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
@@ -128,7 +135,7 @@ instances:
   architect:
     description: "Your project-specific architect description"
     connections: [models, controllers, custom_agent]
-  
+
   custom_agent:
     description: "Specialized agent for your domain"
     directory: ./app/custom
@@ -151,6 +158,47 @@ Customize agent behavior by editing prompts in `.claude-on-rails/prompts/`:
 - **Test-Driven**: Automatic test generation for all code
 - **Performance Focus**: Built-in optimization capabilities
 
+## Enhanced Documentation with Rails MCP Server
+
+ClaudeOnRails integrates with [Rails MCP Server](https://github.com/mariochavez/rails-mcp-server) to provide your AI agents with real-time access to Rails documentation and best practices.
+
+### Benefits
+
+- **Up-to-date Documentation**: Agents access current Rails guides matching your version
+- **Framework Resources**: Includes Turbo, Stimulus, and Kamal documentation
+- **Consistent Standards**: All agents share the same documentation source
+- **Reduced Hallucination**: Agents verify patterns against official documentation
+
+### Automated Setup
+
+When you run `rails generate claude_on_rails:swarm`, you'll be prompted to set up Rails MCP Server automatically. Just press Y!
+
+If you skipped it initially, you can set it up anytime:
+
+```bash
+bundle exec rake claude_on_rails:setup_mcp
+```
+
+This interactive command will:
+- Install the Rails MCP Server gem
+- Configure your environment for enhanced documentation access
+
+### Check Status
+
+To verify your Rails MCP Server installation:
+
+```bash
+bundle exec rake claude_on_rails:mcp_status
+```
+
+### How It Works
+
+When Rails MCP Server is available:
+- Each agent can query Rails documentation in real-time
+- Version-specific guidance ensures compatibility
+- Agents reference canonical implementations
+- Complex features follow official patterns
+
 ## Requirements
 
 - Ruby 2.7+
@@ -178,4 +226,4 @@ MIT License - see [LICENSE](./LICENSE) for details.
 
 - Powered by [claude-swarm](https://github.com/parruda/claude-swarm)
 - Built for [Claude Code](https://github.com/anthropics/claude-code)
-- Integrates with [Rails MCP Server](https://github.com/mariochavez/rails-mcp-server)
+- Integrates with [Rails MCP Server](https://github.com/maquina-app/rails-mcp-server)

data/SETUP.md

@@ -0,0 +1,132 @@
+# ClaudeOnRails Setup Guide
+
+This guide covers the complete setup process for ClaudeOnRails, including the optional Rails MCP Server integration.
+
+## Quick Start
+
+```bash
+# Add to your Gemfile
+gem 'claude-on-rails', group: :development
+
+# Install the gem
+bundle install
+
+# Generate swarm configuration (includes optional MCP setup)
+rails generate claude_on_rails:swarm
+# Press Y when prompted to set up Rails MCP Server!
+
+# Start your AI development team
+claude-swarm
+```
+
+## Enhanced Setup with Rails MCP Server
+
+Rails MCP Server provides your AI agents with real-time access to Rails documentation. While optional, it significantly improves the quality and accuracy of generated code.
+
+### Automated Setup
+
+The easiest way is during initial generation - just press Y when prompted!
+
+If you skipped it or want to set it up later:
+
+```bash
+bundle exec rake claude_on_rails:setup_mcp
+```
+
+This interactive command will:
+- Install the Rails MCP Server gem globally
+- Configure your environment for enhanced documentation access
+
+### Manual Setup
+
+If you prefer manual installation:
+
+1. **Install Rails MCP Server**
+   ```bash
+   gem install rails-mcp-server
+   ```
+
+2. **Regenerate Swarm Configuration**
+   ```bash
+   rails generate claude_on_rails:swarm
+   ```
+
+### Checking MCP Status
+
+To verify your Rails MCP Server setup:
+
+```bash
+bundle exec rake claude_on_rails:mcp_status
+```
+
+This shows:
+- Installation status
+- Downloaded resources
+- Missing resources
+
+## Configuration Options
+
+### Generator Options
+
+```bash
+# Skip MCP Server integration
+rails generate claude_on_rails:swarm --no-mcp-server
+
+# API-only application
+rails generate claude_on_rails:swarm --api-only
+
+# Skip test agent
+rails generate claude_on_rails:swarm --skip-tests
+
+# Include GraphQL support
+rails generate claude_on_rails:swarm --graphql
+```
+
+## Troubleshooting
+
+### Rails MCP Server Not Found
+
+If the generator doesn't detect Rails MCP Server:
+
+1. Verify installation: `gem list rails-mcp-server`
+2. Check PATH: `which rails-mcp-server`
+3. Reinstall: `gem install rails-mcp-server`
+
+### Documentation Access
+
+The Rails MCP Server gem includes built-in documentation for:
+- Rails framework and guides
+- Turbo and Stimulus frameworks
+- Kamal deployment tool
+
+No separate download steps are required!
+
+### Multiple Rails Projects
+
+MCP Server resources are shared globally, benefiting all your Rails projects:
+
+```bash
+# Install once
+bundle exec rake claude_on_rails:setup_mcp
+
+# Use in any Rails project
+cd my-rails-app
+rails generate claude_on_rails:swarm
+```
+
+## Getting Help
+
+- Check status: `bundle exec rake claude_on_rails:mcp_status`
+- View logs: `claude-swarm.log`
+- Report issues: [GitHub Issues](https://github.com/obie/claude-on-rails/issues)
+- Documentation: [README.md](./README.md)
+
+## Next Steps
+
+After setup:
+
+1. Review generated `claude-swarm.yml`
+2. Customize agent prompts in `.claude-on-rails/prompts/`
+3. Start building with `claude-swarm`
+4. Describe features in natural language
+5. Let your AI team implement them!

data/lib/claude-on-rails.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+# This file exists to match the gem name for Rails autoloading
+require 'claude_on_rails'

data/lib/claude_on_rails/mcp_installer.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module ClaudeOnRails
+  # Interactive installer for Rails MCP Server
+  class MCPInstaller
+    def run
+      puts "\e[32m🚀 ClaudeOnRails MCP Server Setup\e[0m"
+      puts "\e[32m#{'=' * 50}\e[0m"
+
+      if MCPSupport.available?
+        puts "\e[32m✓ Rails MCP Server is already installed\e[0m"
+      else
+        handle_installation
+      end
+
+      puts "\n\e[32m✅ Setup complete!\e[0m"
+      show_next_steps
+    end
+
+    private
+
+    def handle_installation
+      puts "\n\e[33mRails MCP Server provides your AI agents with:\e[0m"
+      puts "\e[36m  • Real-time Rails documentation access\e[0m"
+      puts "\e[36m  • Version-specific API references\e[0m"
+      puts "\e[36m  • Framework guides (Turbo, Stimulus, Kamal)\e[0m"
+      puts "\e[36m  • Best practices and examples\e[0m"
+
+      if prompt_yes_no?("\nWould you like to install Rails MCP Server? (Y/n)")
+        install_mcp_server
+      else
+        puts "\n\e[33mSkipping Rails MCP Server installation.\e[0m"
+        puts "\e[36mYou can run 'bundle exec rake claude_on_rails:setup_mcp' later to set it up.\e[0m"
+      end
+    end
+
+    def install_mcp_server
+      puts "\n\e[32mInstalling Rails MCP Server globally...\e[0m"
+
+      # Install without documentation to avoid RDoc conflicts
+      if system('gem install rails-mcp-server --no-document')
+        puts "\e[32m✓ Rails MCP Server installed successfully!\e[0m"
+      else
+        puts "\n\e[31m❌ Failed to install Rails MCP Server\e[0m"
+        puts "\e[33mPlease try running manually:\e[0m"
+        puts "\e[36m  gem install rails-mcp-server --no-document\e[0m"
+        exit 1
+      end
+    end
+
+    def show_next_steps
+      puts "\n\e[33mNext steps:\e[0m"
+
+      if MCPSupport.available?
+        puts "\e[36m1. Run the swarm generator to update your configuration:\e[0m"
+        puts "\e[36m   rails generate claude_on_rails:swarm\e[0m"
+        puts "\n\e[36m2. Start your enhanced Rails development swarm:\e[0m"
+        puts "\e[36m   claude-swarm\e[0m"
+        puts "\n\e[32mYour AI agents now have access to Rails documentation! 🎉\e[0m"
+      else
+        puts "\e[36m1. Complete the MCP Server setup when ready:\e[0m"
+        puts "\e[36m   bundle exec rake claude_on_rails:setup_mcp\e[0m"
+        puts "\n\e[36m2. Then run the swarm generator:\e[0m"
+        puts "\e[36m   rails generate claude_on_rails:swarm\e[0m"
+      end
+
+      puts "\n\e[36mFor more information:\e[0m"
+      puts "\e[36m  • Check status: bundle exec rake claude_on_rails:mcp_status\e[0m"
+      puts "\e[36m  • View documentation: https://github.com/obie/claude-on-rails\e[0m"
+    end
+
+    def prompt_yes_no?(question)
+      print "\e[32m#{question} \e[0m"
+      response = $stdin.gets.chomp.downcase
+      response.empty? || response.start_with?('y')
+    end
+  end
+end

data/lib/claude_on_rails/mcp_support.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module ClaudeOnRails
+  # Support module for Rails MCP Server integration
+  module MCPSupport
+    class << self
+      # Check if Rails MCP Server gem is available on the system
+      def available?
+        # Check if the gem is installed
+        system('gem list -i rails-mcp-server > /dev/null 2>&1') ||
+          # Also check if the executable is available
+          system('which rails-mcp-server > /dev/null 2>&1')
+      rescue StandardError
+        false
+      end
+
+      # Check if a specific resource is downloaded
+      def resource_available?(_resource_name)
+        # Rails MCP Server includes all resources in the gem
+        available?
+      end
+
+      # Get the MCP server configuration for swarm
+      def server_config(rails_env = 'development')
+        {
+          name: 'rails',
+          type: 'stdio',
+          command: 'rails-mcp-server',
+          args: [],
+          env: { 'RAILS_ENV' => rails_env }
+        }
+      end
+
+      # Check if we can download a resource (always true for gem-based server)
+      def download_resource?(_resource_name)
+        return false unless available?
+
+        # Rails MCP Server doesn't require separate resource downloads
+        # Documentation is built-in to the gem
+        true
+      end
+
+      # Get available resources that can be downloaded
+      def available_resources
+        %w[rails turbo stimulus kamal]
+      end
+
+      # Check which resources are currently downloaded
+      def downloaded_resources
+        # All resources are included in the gem
+        available? ? available_resources : []
+      end
+
+      # Check which resources are missing
+      def missing_resources
+        # No resources are missing if the gem is installed
+        available? ? [] : available_resources
+      end
+
+      # Check if common resources are set up
+      def common_resources_setup?
+        # No separate resource setup needed
+        available?
+      end
+
+      # Generate installation instructions
+      def installation_instructions
+        instructions = []
+
+        unless available?
+          instructions << "Install Rails MCP Server:"
+          instructions << "  gem install rails-mcp-server --no-document"
+          instructions << ""
+        end
+
+        instructions
+      end
+    end
+  end
+end

data/lib/claude_on_rails/railtie.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require 'rails/railtie'
+
+module ClaudeOnRails
+  # Railtie to load rake tasks in Rails applications
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      load File.expand_path('../tasks/claude_on_rails.rake', __dir__)
+    end
+  end
+end

data/lib/claude_on_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeOnRails
-  VERSION = '0.1.4'
+  VERSION = '0.2.0'
 end

data/lib/claude_on_rails.rb

@@ -4,6 +4,10 @@ require 'claude_on_rails/version'
 require 'claude_on_rails/configuration'
 require 'claude_on_rails/project_analyzer'
 require 'claude_on_rails/swarm_builder'
+require 'claude_on_rails/mcp_support'
+
+# Load railtie if Rails is defined
+require 'claude_on_rails/railtie' if defined?(Rails::Railtie)
 
 module ClaudeOnRails
   class Error < StandardError; end

data/lib/generators/claude_on_rails/swarm/swarm_generator.rb

@@ -20,6 +20,9 @@ module ClaudeOnRails
       class_option :turbo, type: :boolean, default: true,
                            desc: 'Include Turbo/Stimulus specialist agents'
 
+      class_option :mcp_server, type: :boolean, default: true,
+                                desc: 'Include Rails MCP Server for enhanced documentation access'
+
       def analyze_project
         say 'Analyzing Rails project structure...', :green
         @project_analysis = ClaudeOnRails.analyze_project(Rails.root)
@@ -31,9 +34,16 @@ module ClaudeOnRails
         @skip_tests = options[:skip_tests]
         @test_framework = @project_analysis[:test_framework]
 
+        # Check for Rails MCP Server
+        @include_mcp_server = options[:mcp_server] && ClaudeOnRails::MCPSupport.available?
+
         say "Project type: #{@api_only ? 'API-only' : 'Full-stack Rails'}", :cyan
         say "Test framework: #{@test_framework}", :cyan if @test_framework
         say "GraphQL detected: #{@has_graphql ? 'Yes' : 'No'}", :cyan
+        say "Rails MCP Server: #{@include_mcp_server ? 'Available' : 'Not available'}", :cyan
+
+        # Offer MCP setup if enabled but not available
+        offer_mcp_setup if options[:mcp_server] && !@include_mcp_server
 
         # Show which agents will be created
         say "\nAgents to be created:", :yellow
@@ -77,12 +87,20 @@ module ClaudeOnRails
 
       def update_gitignore
         say 'Updating .gitignore...', :green
+        gitignore_path = Rails.root.join('.gitignore')
+
+        # Create .gitignore if it doesn't exist
+        create_file '.gitignore', '' unless File.exist?(gitignore_path)
+
         append_to_file '.gitignore', "\n# ClaudeOnRails\n.claude-on-rails/sessions/\n.claude-swarm/\nclaude-swarm.log\n"
       end
 
       def display_next_steps
         say "\n✅ ClaudeOnRails swarm configuration created!", :green
         say "\nNext steps:", :yellow
+
+        # Remove this section since we now handle it interactively in analyze_project
+
         say '1. Review and customize claude-swarm.yml for your project'
         say '2. Start your Rails development swarm:'
         say '   claude-swarm', :cyan
@@ -120,6 +138,27 @@ module ClaudeOnRails
         list << 'devops' if File.directory?(Rails.root.join('config'))
         list
       end
+
+      def offer_mcp_setup
+        say "\n🎯 Rails MCP Server Enhancement Available!", :yellow
+        say "Rails MCP Server provides your AI agents with real-time Rails documentation.", :cyan
+
+        if yes?("Would you like to set it up now? (Y/n)", :green)
+          say "\nStarting Rails MCP Server setup...", :green
+          system('bundle exec rake claude_on_rails:setup_mcp')
+
+          # Re-check availability after setup
+          @include_mcp_server = ClaudeOnRails::MCPSupport.available?
+
+          if @include_mcp_server
+            say "\n✓ Rails MCP Server is now available!", :green
+          else
+            say "\nSetup was not completed. Continuing without MCP Server.", :yellow
+          end
+        else
+          say "\nYou can set it up later with: bundle exec rake claude_on_rails:setup_mcp", :cyan
+        end
+      end
     end
   end
 end

data/lib/generators/claude_on_rails/swarm/templates/prompts/api.md

@@ -16,24 +16,24 @@ You are a Rails API specialist working in the app/controllers/api directory. You
 ```ruby
 class Api::BaseController < ActionController::API
   include ActionController::HttpAuthentication::Token::ControllerMethods
-  
+
   before_action :authenticate
-  
+
   rescue_from ActiveRecord::RecordNotFound, with: :not_found
   rescue_from ActiveRecord::RecordInvalid, with: :unprocessable_entity
-  
+
   private
-  
+
   def authenticate
     authenticate_or_request_with_http_token do |token, options|
       @current_user = User.find_by(api_token: token)
     end
   end
-  
+
   def not_found(exception)
     render json: { error: exception.message }, status: :not_found
   end
-  
+
   def unprocessable_entity(exception)
     render json: { errors: exception.record.errors }, status: :unprocessable_entity
   end
@@ -47,26 +47,26 @@ class Api::V1::ProductsController < Api::BaseController
     products = Product.page(params[:page]).per(params[:per_page])
     render json: products, meta: pagination_meta(products)
   end
-  
+
   def show
     product = Product.find(params[:id])
     render json: product
   end
-  
+
   def create
     product = Product.new(product_params)
-    
+
     if product.save
       render json: product, status: :created
     else
       render json: { errors: product.errors }, status: :unprocessable_entity
     end
   end
-  
+
   private
-  
+
   def product_params
-    params.require(:product).permit(:name, :price, :description)
+    params.expect(product: [:name, :price, :description])
   end
 end
 ```
@@ -77,10 +77,10 @@ end
 ```ruby
 class ProductSerializer < ActiveModel::Serializer
   attributes :id, :name, :price, :description, :created_at
-  
+
   has_many :reviews
   belongs_to :category
-  
+
   def price
     "$#{object.price}"
   end
@@ -119,7 +119,7 @@ namespace :api do
   namespace :v1 do
     resources :products
   end
-  
+
   namespace :v2 do
     resources :products
   end
@@ -130,9 +130,9 @@ end
 ```ruby
 class Api::BaseController < ActionController::API
   before_action :set_api_version
-  
+
   private
-  
+
   def set_api_version
     @api_version = request.headers['API-Version'] || 'v1'
   end
@@ -145,10 +145,10 @@ end
 ```ruby
 class Api::AuthController < Api::BaseController
   skip_before_action :authenticate, only: [:login]
-  
+
   def login
     user = User.find_by(email: params[:email])
-    
+
     if user&.authenticate(params[:password])
       token = encode_token(user_id: user.id)
       render json: { token: token, user: user }
@@ -156,9 +156,9 @@ class Api::AuthController < Api::BaseController
       render json: { error: 'Invalid credentials' }, status: :unauthorized
     end
   end
-  
+
   private
-  
+
   def encode_token(payload)
     JWT.encode(payload, Rails.application.secrets.secret_key_base)
   end
@@ -198,4 +198,4 @@ def index
 end
 ```
 
-Remember: APIs should be consistent, well-documented, secure, and performant. Follow REST principles and provide clear error messages.
+Remember: APIs should be consistent, well-documented, secure, and performant. Follow REST principles and provide clear error messages.

data/lib/generators/claude_on_rails/swarm/templates/prompts/architect.md

@@ -38,6 +38,20 @@ Always ensure:
 - Security by default
 - Performance considerations
 
+## Enhanced Documentation Access
+
+When Rails MCP Server is available, you have access to:
+- **Real-time Rails documentation**: Query official Rails guides and API docs
+- **Framework-specific resources**: Access Turbo, Stimulus, and Kamal documentation
+- **Version-aware guidance**: Get documentation matching the project's Rails version
+- **Best practices examples**: Reference canonical implementations
+
+Use MCP tools to:
+- Verify Rails conventions before implementing features
+- Check latest API methods and their parameters
+- Reference security best practices from official guides
+- Ensure compatibility with the project's Rails version
+
 ## Communication Style
 
 - Be clear and specific when delegating to specialists

data/lib/generators/claude_on_rails/swarm/templates/prompts/controllers.md

@@ -21,7 +21,7 @@ You are a Rails controller and routing specialist working in the app/controllers
 ### Strong Parameters
 ```ruby
 def user_params
-  params.require(:user).permit(:name, :email, :role)
+  params.expect(user: [:name, :email, :role])
 end
 ```
 
@@ -84,4 +84,20 @@ end
 - Use constraints for advanced routing
 - Keep routes RESTful
 
-Remember: Controllers should be thin coordinators. Business logic belongs in models or service objects.
+Remember: Controllers should be thin coordinators. Business logic belongs in models or service objects.
+
+## MCP-Enhanced Capabilities
+
+When Rails MCP Server is available, leverage:
+- **Routing Documentation**: Access comprehensive routing guides and DSL reference
+- **Controller Patterns**: Reference ActionController methods and modules
+- **Security Guidelines**: Query official security best practices
+- **API Design**: Access REST and API design patterns from Rails guides
+- **Middleware Information**: Understand the request/response cycle
+
+Use MCP tools to:
+- Verify routing DSL syntax and options
+- Check available controller filters and callbacks
+- Reference proper HTTP status codes and when to use them
+- Find security best practices for the current Rails version
+- Understand request/response format handling

data/lib/generators/claude_on_rails/swarm/templates/prompts/models.md

@@ -77,4 +77,19 @@ class User < ApplicationRecord
 end
 ```
 
+## MCP-Enhanced Capabilities
+
+When Rails MCP Server is available, leverage:
+- **Migration References**: Access the latest migration syntax and options
+- **ActiveRecord Queries**: Query documentation for advanced query methods
+- **Validation Options**: Reference all available validation options and custom validators
+- **Association Types**: Get detailed information on association options and edge cases
+- **Database Adapters**: Check database-specific features and limitations
+
+Use MCP tools to:
+- Verify migration syntax for the current Rails version
+- Find optimal query patterns for complex data retrievals
+- Check association options and their performance implications
+- Reference database-specific features (PostgreSQL, MySQL, etc.)
+
 Remember: Focus on data integrity, performance, and following Rails conventions.

data/lib/generators/claude_on_rails/swarm/templates/swarm.yml.erb

@@ -2,6 +2,15 @@ version: 1
 swarm:
   name: "<%= Rails.application.class.module_parent_name %> Rails Development Team"
   main: architect
+<% if @include_mcp_server %>
+  mcps:
+    - name: rails
+      type: stdio
+      command: rails-mcp-server
+      args: []
+      env:
+        RAILS_ENV: <%= Rails.env %>
+<% end %>
   instances:
     architect:
       description: "Rails architect coordinating <%= @api_only ? 'API' : 'full-stack' %> development for <%= Rails.application.class.module_parent_name %>"

data/lib/tasks/claude_on_rails.rake

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+namespace :claude_on_rails do
+  desc 'Setup Rails MCP Server for enhanced documentation access'
+  task setup_mcp: :environment do
+    require 'claude_on_rails/mcp_installer'
+    ClaudeOnRails::MCPInstaller.new.run
+  end
+
+  desc 'Check Rails MCP Server status and available resources'
+  task mcp_status: :environment do
+    if ClaudeOnRails::MCPSupport.available?
+      puts '✓ Rails MCP Server is installed'
+
+      downloaded = ClaudeOnRails::MCPSupport.downloaded_resources
+      missing = ClaudeOnRails::MCPSupport.missing_resources
+
+      if downloaded.any?
+        puts "\nDownloaded resources:"
+        downloaded.each { |resource| puts "  ✓ #{resource}" }
+      end
+
+      if missing.any?
+        puts "\nMissing resources:"
+        missing.each { |resource| puts "  ✗ #{resource}" }
+        puts "\nRun 'bundle exec rake claude_on_rails:setup_mcp' to download missing resources."
+      else
+        puts "\n✓ All resources are downloaded"
+      end
+    else
+      puts '✗ Rails MCP Server is not installed'
+      puts "\nRun 'bundle exec rake claude_on_rails:setup_mcp' to install and configure it."
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: claude-on-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Obie Fernandez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-27 00:00:00.000000000 Z
+date: 2025-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: claude_swarm
@@ -50,16 +50,22 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - CONTRIBUTING.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
+- SETUP.md
 - examples/README.md
+- lib/claude-on-rails.rb
 - lib/claude_on_rails.rb
 - lib/claude_on_rails/configuration.rb
+- lib/claude_on_rails/mcp_installer.rb
+- lib/claude_on_rails/mcp_support.rb
 - lib/claude_on_rails/project_analyzer.rb
+- lib/claude_on_rails/railtie.rb
 - lib/claude_on_rails/swarm_builder.rb
 - lib/claude_on_rails/version.rb
 - lib/generators/claude_on_rails/swarm/swarm_generator.rb
@@ -77,6 +83,7 @@ files:
 - lib/generators/claude_on_rails/swarm/templates/prompts/tests.md
 - lib/generators/claude_on_rails/swarm/templates/prompts/views.md
 - lib/generators/claude_on_rails/swarm/templates/swarm.yml.erb
+- lib/tasks/claude_on_rails.rake
 homepage: https://github.com/obie/claude-on-rails
 licenses:
 - MIT
@@ -84,7 +91,11 @@ metadata:
   homepage_uri: https://github.com/obie/claude-on-rails
   source_code_uri: https://github.com/obie/claude-on-rails
   changelog_uri: https://github.com/obie/claude-on-rails/blob/main/CHANGELOG.md
-post_install_message:
+post_install_message: "========================================================================\n\U0001F680
+  ClaudeOnRails has been successfully installed!\n\nFor enhanced Rails documentation
+  access, you can set up Rails MCP Server:\n  bundle exec rake claude_on_rails:setup_mcp\n\nThis
+  optional setup will:\n  • Install the Rails MCP Server gem\n  • Enable real-time
+  documentation access for your AI agents\n\nGet started:\n  rails generate claude_on_rails:swarm\n\n========================================================================\n"
 rdoc_options: []
 require_paths:
 - lib