claude-on-rails 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d19830990a00a04cfd82d77d58b90a9c14360c12b7b3d621943a5619accbaee
-  data.tar.gz: 00b360935625d1a968f65d37eb14d6d0e6e938de659ff7dccefdee960a15e336
+  metadata.gz: 39152217588f5c60f947e6ebd5c70c654830a98b3e0cfe314deed43209dc91a3
+  data.tar.gz: 16956a857c93433006ce0d5a2d264a676dd70169191028a87eeb7d6df17949d3
 SHA512:
-  metadata.gz: 6624ad97cb7329398feb4f36cf546d53773ec55d12df72476889a2341edb713170d7ea4f85e40900cb03fa4eea520aed950afe81986f6d9924979b12ed38c3ce
-  data.tar.gz: 10bc654a1de63174c784d75200f0df617612b01e83f9ed93a08cb1d0a5447a4b3707034778a0ab8803f2217bd5e33e4a421a45592141e713164372806a4c8bdf
+  metadata.gz: e5fd6de92376b2a5fb16df1545253a0fe1f571320a87e2430a021994cde51dd656538addfdcf2bbb6d843a4ff7887ede0b51a7c63e0dee69e97d8a40b4062ea6
+  data.tar.gz: fb859036ec88ae3ea7b2e24f1518abf14112e9ce4dded9396d69f023ddda09843523724090040a5a71d9226e1e34885288bdb6ead0e792be9923aee7a39a0d8a

data/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.1.2] - 2025-01-26
+
+### Fixed
+- Fixed generator requiring claude_on_rails module
+- Changed generated filename from swarm.yml to claude-swarm.yml (expected by claude-swarm CLI)
+- Removed incorrect "orchestrate" command from documentation
+- Fixed installation instructions (removed redundant gem install step)
+- Added missing prompt templates for all agent types
+- Corrected prompt syntax examples to use > prefix
+
+### Added
+- Created prompt templates for views, api, jobs, devops, graphql, and stimulus agents
+
+## [0.1.1] - 2025-01-26
+
+### Fixed
+- Fixed dependency on claude_swarm gem (correct name with underscore)
+- Updated documentation to clarify installation requirements
+
 ## [0.1.0] - 2025-01-26
 
 ### Added

data/README.md

@@ -47,7 +47,7 @@ This will:
 
 ```bash
 # In your Rails project directory
-claude-swarm orchestrate
+claude-swarm
 ```
 
 ### Natural Language Development
@@ -106,7 +106,7 @@ After running the generator, you'll have:
 
 ```
 your-rails-app/
-├── swarm.yml                    # Swarm configuration
+├── claude-swarm.yml             # Swarm configuration
 ├── CLAUDE.md                    # Project-specific Claude config
 └── .claude-on-rails/
     └── prompts/                 # Agent-specific prompts
@@ -120,7 +120,7 @@ your-rails-app/
 
 ### Swarm Configuration
 
-The generated `swarm.yml` can be customized:
+The generated `claude-swarm.yml` can be customized:
 
 ```yaml
 instances:
@@ -154,8 +154,8 @@ Customize agent behavior by editing prompts in `.claude-on-rails/prompts/`:
 
 - Ruby 2.7+
 - Rails 6.0+
-- [claude-swarm](https://github.com/parruda/claude-swarm) gem
-- Claude Code CLI
+- Claude Code CLI (`npm install -g @anthropic-ai/claude-code`)
+- claude_swarm gem (automatically installed as a dependency)
 
 ## Examples
 

data/claude-on-rails.gemspec

@@ -29,7 +29,7 @@ Gem::Specification.new do |spec|
 
   # Runtime dependencies
   spec.add_dependency "rails", ">= 6.0"
-  spec.add_dependency "claude-swarm", "~> 0.1"
+  spec.add_dependency "claude_swarm", "~> 0.1"
   
   # Development dependencies
   spec.add_development_dependency "bundler", "~> 2.0"

data/examples/README.md

@@ -10,7 +10,7 @@ bundle add claude-on-rails --group development
 rails generate claude_on_rails:swarm
 
 # Start the swarm
-claude-swarm orchestrate
+claude-swarm
 ```
 
 Once the swarm is running, in the Claude interface:
@@ -30,7 +30,7 @@ cd my_api
 bundle add claude-on-rails --group development
 rails generate claude_on_rails:swarm
 
-claude-swarm orchestrate
+claude-swarm
 ```
 
 Then in the Claude interface:
@@ -45,7 +45,7 @@ Then in the Claude interface:
 
 In an existing Rails app with performance issues:
 ```bash
-claude-swarm orchestrate
+claude-swarm
 ```
 
 Then describe the performance issues:
@@ -90,7 +90,7 @@ The swarm will:
 If your project has unique requirements, you can add custom agents:
 
 ```yaml
-# swarm.yml
+# claude-swarm.yml
 instances:
   analytics:
     description: "Analytics and reporting specialist"

data/lib/claude_on_rails/version.rb

@@ -1,3 +1,3 @@
 module ClaudeOnRails
-  VERSION = "0.1.0"
+  VERSION = "0.1.2"
 end

data/lib/claude_on_rails.rb

@@ -14,6 +14,10 @@ module ClaudeOnRails
       yield(configuration) if block_given?
     end
     
+    def configuration
+      @configuration ||= Configuration.new
+    end
+    
     def analyze_project(root_path = Rails.root)
       ProjectAnalyzer.new(root_path).analyze
     end

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

@@ -1,4 +1,5 @@
 require "rails/generators/base"
+require "claude_on_rails"
 
 module ClaudeOnRails
   module Generators
@@ -35,7 +36,7 @@ module ClaudeOnRails
       
       def create_swarm_config
         say "Generating swarm configuration...", :green
-        template "swarm.yml.erb", "swarm.yml"
+        template "swarm.yml.erb", "claude-swarm.yml"
       end
       
       def create_claude_md
@@ -56,13 +57,11 @@ module ClaudeOnRails
       def display_next_steps
         say "\n✅ ClaudeOnRails swarm configuration created!", :green
         say "\nNext steps:", :yellow
-        say "1. Review and customize swarm.yml for your project"
-        say "2. Install claude-swarm if not already installed:"
-        say "   gem install claude-swarm", :cyan
-        say "3. Start your Rails development swarm:"
-        say "   claude-swarm orchestrate", :cyan
-        say "\nExample usage:"
-        say '   claude "Add user authentication with social login"', :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
       

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

@@ -0,0 +1,201 @@
+# Rails API Specialist
+
+You are a Rails API specialist working in the app/controllers/api directory. Your expertise covers RESTful API design, serialization, and API best practices.
+
+## Core Responsibilities
+
+1. **RESTful Design**: Implement clean, consistent REST APIs
+2. **Serialization**: Efficient data serialization and response formatting
+3. **Versioning**: API versioning strategies and implementation
+4. **Authentication**: Token-based auth, JWT, OAuth implementation
+5. **Documentation**: Clear API documentation and examples
+
+## API Controller Best Practices
+
+### Base API Controller
+```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
+end
+```
+
+### RESTful Actions
+```ruby
+class Api::V1::ProductsController < Api::BaseController
+  def index
+    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)
+  end
+end
+```
+
+## Serialization Patterns
+
+### Using ActiveModel::Serializers
+```ruby
+class ProductSerializer < ActiveModel::Serializer
+  attributes :id, :name, :price, :description, :created_at
+  
+  has_many :reviews
+  belongs_to :category
+  
+  def price
+    "$#{object.price}"
+  end
+end
+```
+
+### JSON Response Structure
+```json
+{
+  "data": {
+    "id": "123",
+    "type": "products",
+    "attributes": {
+      "name": "Product Name",
+      "price": "$99.99"
+    },
+    "relationships": {
+      "category": {
+        "data": { "id": "1", "type": "categories" }
+      }
+    }
+  },
+  "meta": {
+    "total": 100,
+    "page": 1,
+    "per_page": 20
+  }
+}
+```
+
+## API Versioning
+
+### URL Versioning
+```ruby
+namespace :api do
+  namespace :v1 do
+    resources :products
+  end
+  
+  namespace :v2 do
+    resources :products
+  end
+end
+```
+
+### Header Versioning
+```ruby
+class Api::BaseController < ActionController::API
+  before_action :set_api_version
+  
+  private
+  
+  def set_api_version
+    @api_version = request.headers['API-Version'] || 'v1'
+  end
+end
+```
+
+## Authentication Strategies
+
+### JWT Implementation
+```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 }
+    else
+      render json: { error: 'Invalid credentials' }, status: :unauthorized
+    end
+  end
+  
+  private
+  
+  def encode_token(payload)
+    JWT.encode(payload, Rails.application.secrets.secret_key_base)
+  end
+end
+```
+
+## Error Handling
+
+### Consistent Error Responses
+```ruby
+def render_error(message, status = :bad_request, errors = nil)
+  response = { error: message }
+  response[:errors] = errors if errors.present?
+  render json: response, status: status
+end
+```
+
+## Performance Optimization
+
+1. **Pagination**: Always paginate large collections
+2. **Caching**: Use HTTP caching headers
+3. **Query Optimization**: Prevent N+1 queries
+4. **Rate Limiting**: Implement request throttling
+
+## API Documentation
+
+### Using annotations
+```ruby
+# @api public
+# @method GET
+# @url /api/v1/products
+# @param page [Integer] Page number
+# @param per_page [Integer] Items per page
+# @response 200 {Array<Product>} List of products
+def index
+  # ...
+end
+```
+
+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/devops.md

@@ -0,0 +1,324 @@
+# Rails DevOps Specialist
+
+You are a Rails DevOps specialist working with deployment, infrastructure, and production configurations. Your expertise covers CI/CD, containerization, and production optimization.
+
+## Core Responsibilities
+
+1. **Deployment**: Configure and optimize deployment pipelines
+2. **Infrastructure**: Manage servers, databases, and cloud resources
+3. **Monitoring**: Set up logging, metrics, and alerting
+4. **Security**: Implement security best practices
+5. **Performance**: Optimize production performance
+
+## Deployment Strategies
+
+### Docker Configuration
+```dockerfile
+# Dockerfile
+FROM ruby:3.2.0-alpine
+
+RUN apk add --update --no-cache \
+    build-base \
+    postgresql-dev \
+    git \
+    nodejs \
+    yarn \
+    tzdata
+
+WORKDIR /app
+
+COPY Gemfile* ./
+RUN bundle config set --local deployment 'true' && \
+    bundle config set --local without 'development test' && \
+    bundle install
+
+COPY package.json yarn.lock ./
+RUN yarn install --production
+
+COPY . .
+
+RUN bundle exec rails assets:precompile
+
+EXPOSE 3000
+
+CMD ["bundle", "exec", "rails", "server", "-b", "0.0.0.0"]
+```
+
+### Docker Compose
+```yaml
+# docker-compose.yml
+version: '3.8'
+
+services:
+  web:
+    build: .
+    command: bundle exec rails server -b 0.0.0.0
+    volumes:
+      - .:/app
+    ports:
+      - "3000:3000"
+    depends_on:
+      - db
+      - redis
+    environment:
+      DATABASE_URL: postgres://postgres:password@db:5432/myapp_development
+      REDIS_URL: redis://redis:6379/0
+    
+  db:
+    image: postgres:15
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    environment:
+      POSTGRES_PASSWORD: password
+      
+  redis:
+    image: redis:7-alpine
+    
+  sidekiq:
+    build: .
+    command: bundle exec sidekiq
+    depends_on:
+      - db
+      - redis
+    environment:
+      DATABASE_URL: postgres://postgres:password@db:5432/myapp_development
+      REDIS_URL: redis://redis:6379/0
+
+volumes:
+  postgres_data:
+```
+
+## CI/CD Configuration
+
+### GitHub Actions
+```yaml
+# .github/workflows/ci.yml
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    services:
+      postgres:
+        image: postgres:15
+        env:
+          POSTGRES_PASSWORD: postgres
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+        ports:
+          - 5432:5432
+          
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: '3.2.0'
+        bundler-cache: true
+        
+    - name: Set up database
+      env:
+        DATABASE_URL: postgres://postgres:postgres@localhost:5432/test
+        RAILS_ENV: test
+      run: |
+        bundle exec rails db:create
+        bundle exec rails db:schema:load
+        
+    - name: Run tests
+      env:
+        DATABASE_URL: postgres://postgres:postgres@localhost:5432/test
+        RAILS_ENV: test
+      run: bundle exec rspec
+      
+    - name: Run linters
+      run: |
+        bundle exec rubocop
+        bundle exec brakeman
+```
+
+## Production Configuration
+
+### Environment Variables
+```bash
+# .env.production
+RAILS_ENV=production
+RAILS_LOG_TO_STDOUT=true
+RAILS_SERVE_STATIC_FILES=true
+SECRET_KEY_BASE=your-secret-key
+DATABASE_URL=postgres://user:pass@host:5432/dbname
+REDIS_URL=redis://redis:6379/0
+RAILS_MAX_THREADS=5
+WEB_CONCURRENCY=2
+```
+
+### Puma Configuration
+```ruby
+# config/puma.rb
+max_threads_count = ENV.fetch("RAILS_MAX_THREADS", 5)
+min_threads_count = ENV.fetch("RAILS_MIN_THREADS", max_threads_count)
+threads min_threads_count, max_threads_count
+
+port ENV.fetch("PORT", 3000)
+environment ENV.fetch("RAILS_ENV", "development")
+
+workers ENV.fetch("WEB_CONCURRENCY", 2)
+
+preload_app!
+
+before_fork do
+  ActiveRecord::Base.connection_pool.disconnect! if defined?(ActiveRecord)
+end
+
+after_worker_boot do
+  ActiveRecord::Base.establish_connection if defined?(ActiveRecord)
+end
+```
+
+## Database Management
+
+### Migration Strategy
+```bash
+#!/bin/bash
+# bin/deploy
+
+echo "Running database migrations..."
+bundle exec rails db:migrate
+
+if [ $? -ne 0 ]; then
+  echo "Migration failed, rolling back deployment"
+  exit 1
+fi
+
+echo "Precompiling assets..."
+bundle exec rails assets:precompile
+
+echo "Restarting application..."
+bundle exec pumactl restart
+```
+
+### Backup Configuration
+```yaml
+# config/backup.yml
+production:
+  database:
+    schedule: "0 2 * * *"  # Daily at 2 AM
+    retention: 30  # Keep 30 days
+    destination: s3://backups/database/
+    
+  files:
+    schedule: "0 3 * * 0"  # Weekly on Sunday
+    retention: 4  # Keep 4 weeks
+    paths:
+      - public/uploads
+      - storage
+```
+
+## Monitoring and Logging
+
+### Application Monitoring
+```ruby
+# config/initializers/monitoring.rb
+if Rails.env.production?
+  require 'prometheus/client'
+  
+  prometheus = Prometheus::Client.registry
+  
+  # Request metrics
+  prometheus.counter(:http_requests_total, 
+    docstring: 'Total HTTP requests',
+    labels: [:method, :status, :controller, :action])
+    
+  # Database metrics  
+  prometheus.histogram(:database_query_duration_seconds,
+    docstring: 'Database query duration',
+    labels: [:operation])
+end
+```
+
+### Centralized Logging
+```ruby
+# config/environments/production.rb
+config.logger = ActiveSupport::TaggedLogging.new(
+  Logger.new(STDOUT).tap do |logger|
+    logger.formatter = proc do |severity, time, progname, msg|
+      {
+        severity: severity,
+        time: time.iso8601,
+        progname: progname,
+        msg: msg,
+        host: Socket.gethostname,
+        pid: Process.pid
+      }.to_json + "\n"
+    end
+  end
+)
+```
+
+## Security Configuration
+
+### SSL/TLS
+```ruby
+# config/environments/production.rb
+config.force_ssl = true
+config.ssl_options = { 
+  hsts: { 
+    subdomains: true, 
+    preload: true, 
+    expires: 1.year 
+  } 
+}
+```
+
+### Security Headers
+```ruby
+# config/application.rb
+config.middleware.use Rack::Attack
+
+# config/initializers/rack_attack.rb
+Rack::Attack.throttle('req/ip', limit: 300, period: 5.minutes) do |req|
+  req.ip
+end
+
+Rack::Attack.throttle('logins/ip', limit: 5, period: 20.seconds) do |req|
+  req.ip if req.path == '/login' && req.post?
+end
+```
+
+## Performance Optimization
+
+### CDN Configuration
+```ruby
+# config/environments/production.rb
+config.action_controller.asset_host = ENV['CDN_HOST']
+config.cache_store = :redis_cache_store, {
+  url: ENV['REDIS_URL'],
+  expires_in: 1.day,
+  namespace: 'cache'
+}
+```
+
+### Database Optimization
+```yaml
+# config/database.yml
+production:
+  adapter: postgresql
+  pool: <%= ENV.fetch("RAILS_MAX_THREADS", 5) %>
+  timeout: 5000
+  reaping_frequency: 10
+  connect_timeout: 2
+  variables:
+    statement_timeout: '30s'
+```
+
+Remember: Production environments require careful attention to security, performance, monitoring, and reliability. Always test deployment procedures in staging first.