Fix generator issues and prepare v0.1.2 release

- Required claude_on_rails module in generator
- Fixed generated filename to claude-swarm.yml
- Removed orchestrate command references
- Fixed redundant installation instructions
- Added all missing agent prompt templates
- Updated documentation with correct command syntax

Author: obie

CHANGELOG.md

@@ -5,6 +5,19 @@ 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

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:

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"

lib/claude_on_rails.rb

@@ -14,6 +14,10 @@ def configure
       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

lib/claude_on_rails/version.rb

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

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 @@ def analyze_project
 
       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 @@ def update_gitignore
       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
 

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.