claude-on-rails 0.1.3 → 0.2.0

data/lib/generators/claude_on_rails/swarm/templates/claude_on_rails_context.md

@@ -0,0 +1,32 @@
+# ClaudeOnRails Context
+
+This project uses ClaudeOnRails with a swarm of specialized agents for Rails development.
+
+## Project Information
+- **Rails Version**: <%= Rails.version %>
+- **Ruby Version**: <%= RUBY_VERSION %>
+- **Project Type**: <%= @api_only ? 'API-only' : 'Full-stack Rails' %>
+- **Test Framework**: <%= @test_framework || 'Not detected' %>
+<% if @has_graphql -%>
+- **GraphQL**: Enabled
+<% end -%>
+<% if @has_turbo && !@api_only -%>
+- **Turbo/Stimulus**: Enabled
+<% end -%>
+
+## Swarm Configuration
+
+The claude-swarm.yml file defines specialized agents for different aspects of Rails development:
+- Each agent has specific expertise and works in designated directories
+- Agents collaborate to implement features across all layers
+- The architect agent coordinates the team
+
+## Development Guidelines
+
+When working on this project:
+- Follow Rails conventions and best practices
+- Write tests for all new functionality
+- Use strong parameters in controllers
+- Keep models focused with single responsibilities
+- Extract complex business logic to service objects
+- Ensure proper database indexing for foreign keys and queries

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,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: claude-on-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Obie Fernandez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-26 00:00:00.000000000 Z
+date: 2025-07-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '6.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: claude_swarm
   requirement: !ruby/object:Gem::Requirement
@@ -39,103 +25,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.1'
 - !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '13.0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-- !ruby/object:Gem::Dependency
-  name: rspec-rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: rubocop
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rails
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: rubocop-rspec
+  name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :development
+        version: '6.0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '6.0'
 description: ClaudeOnRails leverages claude-swarm to create an intelligent team of
   AI agents specialized in different aspects of Rails development. Simply describe
   what you want to build, and the swarm handles the rest.
@@ -146,21 +48,29 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
+- ".rubocop.yml"
 - CHANGELOG.md
+- CLAUDE.md
 - CONTRIBUTING.md
 - Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
-- claude-on-rails.gemspec
+- 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
 - lib/generators/claude_on_rails/swarm/templates/CLAUDE.md.erb
+- lib/generators/claude_on_rails/swarm/templates/claude_on_rails_context.md
 - lib/generators/claude_on_rails/swarm/templates/prompts/api.md
 - lib/generators/claude_on_rails/swarm/templates/prompts/architect.md
 - lib/generators/claude_on_rails/swarm/templates/prompts/controllers.md
@@ -173,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
@@ -180,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
@@ -188,7 +103,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/claude-on-rails.gemspec

@@ -1,45 +0,0 @@
-require_relative "lib/claude_on_rails/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "claude-on-rails"
-  spec.version = ClaudeOnRails::VERSION
-  spec.authors = ["Obie Fernandez"]
-  spec.email = ["obiefernandez@gmail.com"]
-
-  spec.summary = "Rails development framework powered by Claude swarm intelligence"
-  spec.description = "ClaudeOnRails leverages claude-swarm to create an intelligent team of AI agents specialized in different aspects of Rails development. Simply describe what you want to build, and the swarm handles the rest."
-  spec.homepage = "https://github.com/obie/claude-on-rails"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.7.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor .github])
-    end
-  end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Runtime dependencies
-  spec.add_dependency "rails", ">= 6.0"
-  spec.add_dependency "claude_swarm", "~> 0.1"
-  
-  # Development dependencies
-  spec.add_development_dependency "bundler", "~> 2.0"
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "rspec-rails", "~> 5.0"
-  spec.add_development_dependency "rubocop", "~> 1.0"
-  spec.add_development_dependency "rubocop-rails", "~> 2.0"
-  spec.add_development_dependency "rubocop-rspec", "~> 2.0"
-  
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end