claude-on-rails 0.1.3 → 0.1.4

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

@@ -1,104 +1,125 @@
-require "rails/generators/base"
-require "claude_on_rails"
+# frozen_string_literal: true
+
+require 'rails/generators/base'
+require 'claude_on_rails'
 
 module ClaudeOnRails
   module Generators
     class SwarmGenerator < Rails::Generators::Base
-      source_root File.expand_path("templates", __dir__)
-      
+      source_root File.expand_path('templates', __dir__)
+
       class_option :api_only, type: :boolean, default: false,
-                   desc: "Generate swarm for API-only Rails application"
-      
+                              desc: 'Generate swarm for API-only Rails application'
+
       class_option :skip_tests, type: :boolean, default: false,
-                   desc: "Skip test agent in swarm configuration"
-                   
+                                desc: 'Skip test agent in swarm configuration'
+
       class_option :graphql, type: :boolean, default: false,
-                   desc: "Include GraphQL specialist agent"
-                   
+                             desc: 'Include GraphQL specialist agent'
+
       class_option :turbo, type: :boolean, default: true,
-                   desc: "Include Turbo/Stimulus specialist agents"
-      
+                           desc: 'Include Turbo/Stimulus specialist agents'
+
       def analyze_project
-        say "Analyzing Rails project structure...", :green
+        say 'Analyzing Rails project structure...', :green
         @project_analysis = ClaudeOnRails.analyze_project(Rails.root)
-        
+
         # Auto-detect features
         @api_only = options[:api_only] || @project_analysis[:api_only]
         @has_graphql = options[:graphql] || @project_analysis[:has_graphql]
         @has_turbo = options[:turbo] && !@api_only
         @skip_tests = options[:skip_tests]
         @test_framework = @project_analysis[:test_framework]
-        
+
         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
-        
+
         # Show which agents will be created
         say "\nAgents to be created:", :yellow
         agents.each do |agent|
           say "  - #{agent}", :cyan
         end
       end
-      
+
       def create_swarm_config
-        say "Generating swarm configuration...", :green
-        template "swarm.yml.erb", "claude-swarm.yml"
+        say 'Generating swarm configuration...', :green
+        template 'swarm.yml.erb', 'claude-swarm.yml'
       end
-      
+
       def create_claude_md
-        say "Creating CLAUDE.md configuration...", :green
-        template "CLAUDE.md.erb", "CLAUDE.md"
+        # Always create the ClaudeOnRails context file
+        template 'claude_on_rails_context.md', '.claude-on-rails/context.md'
+
+        if File.exist?('CLAUDE.md')
+          say 'CLAUDE.md already exists - adding ClaudeOnRails file reference...', :yellow
+
+          existing_content = File.read('CLAUDE.md')
+
+          # Check if file reference already exists
+          if existing_content.include?('.claude-on-rails/context.md')
+            say '✓ CLAUDE.md already references ClaudeOnRails context', :green
+          else
+            file_reference = "\n/file:.claude-on-rails/context.md\n"
+            append_to_file 'CLAUDE.md', file_reference
+            say '✓ Added ClaudeOnRails context reference to existing CLAUDE.md', :green
+          end
+        else
+          say 'Creating CLAUDE.md configuration...', :green
+          template 'CLAUDE.md.erb', 'CLAUDE.md'
+        end
       end
-      
+
       def create_agent_prompts
-        say "Setting up agent-specific prompts...", :green
-        directory "prompts", ".claude-on-rails/prompts"
+        say 'Setting up agent-specific prompts...', :green
+        directory 'prompts', '.claude-on-rails/prompts'
       end
-      
+
       def update_gitignore
-        say "Updating .gitignore...", :green
-        append_to_file ".gitignore", "\n# ClaudeOnRails\n.claude-on-rails/sessions/\nswarm.log\n"
+        say 'Updating .gitignore...', :green
+        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
-        say "1. Review and customize claude-swarm.yml for your project"
-        say "2. Start your Rails development swarm:"
-        say "   claude-swarm", :cyan
+        say '1. Review and customize claude-swarm.yml for your project'
+        say '2. Start your Rails development swarm:'
+        say '   claude-swarm', :cyan
         say "\nOnce the swarm is running, just describe what you want to build:"
         say '   > Add user authentication with social login', :cyan
         say "\nThe swarm will automatically coordinate the implementation across all layers!"
       end
-      
+
       private
-      
+
       def agents
         @agents ||= build_agent_list
       end
-      
+
       def build_agent_list
-        list = ["architect"]
-        list << "models" if File.directory?(Rails.root.join("app/models"))
-        list << "controllers" if File.directory?(Rails.root.join("app/controllers"))
-        list << "views" if !@api_only && File.directory?(Rails.root.join("app/views"))
-        list << "api" if @api_only && File.directory?(Rails.root.join("app/controllers/api"))
-        list << "graphql" if @has_graphql && File.directory?(Rails.root.join("app/graphql"))
-        list << "stimulus" if @has_turbo && File.directory?(Rails.root.join("app/javascript"))
-        list << "services" if File.directory?(Rails.root.join("app/services"))
-        list << "jobs" if File.directory?(Rails.root.join("app/jobs"))
-        
-        if !@skip_tests
-          if @test_framework == 'RSpec' && File.directory?(Rails.root.join("spec"))
-            list << "tests"
-          elsif @test_framework == 'Minitest' && File.directory?(Rails.root.join("test"))
-            list << "tests"
+        list = ['architect']
+        list << 'models' if File.directory?(Rails.root.join('app/models'))
+        list << 'controllers' if File.directory?(Rails.root.join('app/controllers'))
+        list << 'views' if !@api_only && File.directory?(Rails.root.join('app/views'))
+        list << 'api' if @api_only && File.directory?(Rails.root.join('app/controllers/api'))
+        list << 'graphql' if @has_graphql && File.directory?(Rails.root.join('app/graphql'))
+        list << 'stimulus' if @has_turbo && File.directory?(Rails.root.join('app/javascript'))
+        list << 'services' if File.directory?(Rails.root.join('app/services'))
+        list << 'jobs' if File.directory?(Rails.root.join('app/jobs'))
+
+        unless @skip_tests
+          case @test_framework
+          when 'RSpec'
+            list << 'tests' if File.directory?(Rails.root.join('spec'))
+          when 'Minitest'
+            list << 'tests' if File.directory?(Rails.root.join('test'))
           end
         end
-        
-        list << "devops" if File.directory?(Rails.root.join("config"))
+
+        list << 'devops' if File.directory?(Rails.root.join('config'))
         list
       end
     end
   end
-end
+end

data/lib/generators/claude_on_rails/swarm/templates/CLAUDE.md.erb

@@ -1,101 +1,3 @@
-# <%= Rails.application.class.module_parent_name %> Rails Development with ClaudeOnRails
+## ClaudeOnRails Configuration
 
-This project uses ClaudeOnRails to create an intelligent swarm of AI agents specialized in different aspects of Rails development.
-
-## Project Overview
-
-- **Application**: <%= Rails.application.class.module_parent_name %>
-- **Rails Version**: <%= Rails.version %>
-- **Ruby Version**: <%= RUBY_VERSION %>
-- **Type**: <%= @api_only ? 'API-only' : 'Full-stack Rails application' %>
-- **Test Framework**: <%= @test_framework || 'Not detected' %>
-<% if @has_graphql -%>
-- **GraphQL**: Enabled
-<% end -%>
-
-## How to Use
-
-Simply describe what you want to build or fix, and the swarm will automatically coordinate the implementation:
-
-```bash
-# Start the swarm
-claude-swarm orchestrate
-
-# Then just describe your task
-claude "Add user authentication with email confirmation"
-claude "Optimize the dashboard queries that are running slowly"
-claude "Create an API endpoint for mobile app integration"
-```
-
-## Swarm Architecture
-
-The following specialized agents work together to implement your requests:
-
-- **Architect**: Coordinates all development and makes high-level decisions
-- **Models**: Handles ActiveRecord models, migrations, and database design
-- **Controllers**: Manages request handling, routing, and controller logic
-<% unless @api_only -%>
-- **Views**: Creates and maintains views, layouts, and partials
-<% end -%>
-<% if @api_only -%>
-- **API**: Designs RESTful endpoints and handles serialization
-<% end -%>
-<% if @has_graphql -%>
-- **GraphQL**: Manages GraphQL schemas, types, and resolvers
-<% end -%>
-<% if @has_turbo -%>
-- **Stimulus**: Implements interactive features with Stimulus controllers
-<% end -%>
-- **Services**: Extracts business logic into service objects
-- **Jobs**: Handles background processing and async tasks
-<% unless @skip_tests -%>
-- **Tests**: Ensures comprehensive test coverage with <%= @test_framework %>
-<% end -%>
-- **DevOps**: Manages deployment and production configurations
-
-## Project Conventions
-
-### Code Style
-- Follow Rails conventions and best practices
-- Use RuboCop for Ruby style enforcement
-- Prefer clarity over cleverness
-- Write self-documenting code
-
-### Testing
-<% if @test_framework == 'RSpec' -%>
-- RSpec for all tests
-- Factory Bot for test data
-- Request specs for API endpoints
-- System specs for user interactions
-<% else -%>
-- Minitest for all tests
-- Fixtures or factories for test data
-- Integration tests for user flows
-- Unit tests for models and services
-<% end -%>
-
-### Git Workflow
-- Feature branches for new work
-- Descriptive commit messages
-- PR reviews before merging
-- Keep main branch deployable
-
-## Custom Patterns
-
-Add your project-specific patterns and conventions here:
-
-```yaml
-# Example: Custom service object pattern
-Services:
-  Pattern: Command pattern with Result objects
-  Location: app/services/
-  Naming: VerbNoun (e.g., CreateOrder, SendEmail)
-  Testing: Unit tests with mocked dependencies
-```
-
-## Notes
-
-- This configuration was generated by ClaudeOnRails
-- Customize agent prompts in `.claude-on-rails/prompts/`
-- Update this file with project-specific conventions
-- The swarm learns from your codebase patterns
+You are working on <%= Rails.application.class.module_parent_name %>, a <%= @api_only ? 'Rails API' : 'Rails' %> application. Review the ClaudeOnRails context file at @.claude-on-rails/context.md

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

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: claude-on-rails
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Obie Fernandez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-06-26 00:00:00.000000000 Z
+date: 2025-06-27 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,13 +48,14 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
+- ".rubocop.yml"
 - CHANGELOG.md
 - CONTRIBUTING.md
 - Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
-- claude-on-rails.gemspec
 - examples/README.md
 - lib/claude_on_rails.rb
 - lib/claude_on_rails/configuration.rb
@@ -161,6 +64,7 @@ files:
 - 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
@@ -188,7 +92,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