claude-code-templates 1.21.12 → 1.21.14

package/cli-tool/templates/ruby/examples/rails-app/CLAUDE.md

@@ -0,0 +1,376 @@
+# Rails 8 Project Configuration
+
+This file provides specific guidance for Ruby on Rails 8 web application development using Claude Code.
+
+## Project Overview
+
+This is a Ruby on Rails 8 web application project optimized for modern web development with the latest Rails features. The project follows Rails 8 conventions and leverages new capabilities like native authentication, Solid trifecta, and Kamal 2 deployment.
+
+## Rails 8 Specific Development Commands
+
+### Project Creation & Setup
+- `rails new myapp` - Create new Rails 8 application
+- `rails new myapp --skip-kamal` - Create app without Kamal deployment
+- `rails new myapp --database=postgresql` - Create app with PostgreSQL
+- `rails new myapp --css=tailwind` - Create app with Tailwind CSS
+- `rails new myapp --javascript=esbuild` - Create app with esbuild
+
+### Server Management
+- `bin/rails server` or `bin/rails s` - Start development server
+- `bin/rails server -p 4000` - Start server on port 4000
+- `bin/rails server -e production` - Start in production mode
+- `bin/dev` - Start development server with asset compilation (if available)
+
+### Database Management
+- `bin/rails db:create` - Create database
+- `bin/rails db:migrate` - Run pending migrations
+- `bin/rails db:rollback` - Rollback last migration
+- `bin/rails db:reset` - Drop, create, and migrate database
+- `bin/rails db:seed` - Run database seeds
+- `bin/rails db:setup` - Create, migrate, and seed database
+
+### Generation Commands
+- `bin/rails generate model User name:string email:string` - Generate model
+- `bin/rails generate controller Users index show` - Generate controller
+- `bin/rails generate migration AddIndexToUsers email:index` - Generate migration
+- `bin/rails generate authentication` - Generate Rails 8 native authentication (NEW)
+- `bin/rails generate solid_queue:install` - Install Solid Queue (NEW)
+- `bin/rails generate solid_cache:install` - Install Solid Cache (NEW)
+
+### Rails 8 Native Authentication
+- `bin/rails generate authentication User` - Generate authentication for User model
+- `bin/rails generate authentication:views` - Generate authentication views
+- `bin/rails generate authentication:controllers` - Generate authentication controllers
+
+### Background Jobs (Solid Queue)
+- `bin/rails solid_queue:start` - Start Solid Queue worker
+- `bin/rails solid_queue:install` - Install Solid Queue configuration
+- `SampleJob.perform_later(user)` - Enqueue background job
+
+### Caching (Solid Cache)
+- `Rails.cache.write("key", "value")` - Write to cache
+- `Rails.cache.read("key")` - Read from cache
+- `Rails.cache.delete("key")` - Delete from cache
+- `bin/rails solid_cache:clear` - Clear all cached data
+
+### Asset Management (Propshaft)
+- `bin/rails assets:precompile` - Precompile assets for production
+- `bin/rails assets:clobber` - Remove compiled assets
+- Assets are automatically served in development
+
+### Testing Commands
+- `bin/rails test` - Run all tests
+- `bin/rails test:models` - Run model tests
+- `bin/rails test:controllers` - Run controller tests
+- `bin/rails test:system` - Run system tests
+- `bin/rails test test/models/user_test.rb` - Run specific test file
+
+### Console & Debugging
+- `bin/rails console` or `bin/rails c` - Start Rails console
+- `bin/rails console --sandbox` - Start console in sandbox mode
+- `bin/rails dbconsole` or `bin/rails db` - Start database console
+
+### Code Quality & Security (Rails 8 Defaults)
+- `bin/rails rubocop` - Run RuboCop with Rails 8 Omakase config
+- `bin/rails brakeman` - Run security scan (included by default)
+- `bundle audit` - Check for vulnerable gems
+
+## Deployment with Kamal 2 (Rails 8 Default)
+
+### Kamal 2 Commands
+- `kamal setup` - Initial server setup
+- `kamal deploy` - Deploy application
+- `kamal redeploy` - Redeploy without setup
+- `kamal rollback` - Rollback to previous version
+- `kamal logs` - View application logs
+- `kamal logs --follow` - Follow logs in real-time
+- `kamal shell` - SSH into deployed container
+- `kamal details` - Show deployment details
+
+### Kamal 2 Configuration
+Configuration is automatically generated in `config/deploy.yml`:
+
+```yaml
+# config/deploy.yml
+service: myapp
+image: myapp
+servers:
+  - 192.168.1.1
+registry:
+  server: registry.digitalocean.com
+  username: myusername
+  
+env:
+  clear:
+    RAILS_ENV: production
+  secret:
+    - RAILS_MASTER_KEY
+    
+builder:
+  multiarch: false
+```
+
+## Rails 8 Project Structure
+
+```
+myapp/
+├── app/
+│   ├── models/              # ActiveRecord models
+│   ├── controllers/         # ActionController controllers
+│   ├── views/              # ERB/HAML templates
+│   ├── helpers/            # View helpers
+│   ├── mailers/            # ActionMailer mailers
+│   ├── jobs/               # ActiveJob jobs (Solid Queue)
+│   ├── assets/             # Application assets (Propshaft)
+│   └── javascript/         # JavaScript files
+├── config/
+│   ├── application.rb      # Application configuration
+│   ├── routes.rb           # URL routing
+│   ├── database.yml        # Database configuration
+│   ├── deploy.yml          # Kamal 2 deployment config (NEW)
+│   └── environments/       # Environment-specific configs
+├── db/
+│   ├── migrate/            # Database migrations
+│   └── seeds.rb           # Database seeds
+├── test/                   # Test files (default in Rails 8)
+│   ├── models/
+│   ├── controllers/
+│   ├── integration/
+│   └── system/
+├── bin/                    # Binstubs
+├── config.ru              # Rack configuration
+├── Gemfile                 # Gem dependencies
+├── Gemfile.lock           # Locked gem versions
+└── Dockerfile             # Docker configuration (if using containers)
+```
+
+## Rails 8 New Features Integration
+
+### 1. SQLite Production Enhancements
+Rails 8 makes SQLite production-ready:
+
+```ruby
+# config/database.yml
+production:
+  adapter: sqlite3
+  database: storage/production.sqlite3
+  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
+  timeout: 5000
+  # New Rails 8 SQLite configurations
+  pragmas:
+    busy_timeout: 1000
+    journal_mode: WAL
+    synchronous: NORMAL
+    foreign_keys: true
+```
+
+### 2. Solid Trifecta Configuration
+
+#### Solid Queue (Background Jobs)
+```ruby
+# config/application.rb
+config.active_job.queue_adapter = :solid_queue
+
+# app/jobs/sample_job.rb
+class SampleJob < ApplicationJob
+  queue_as :default
+  
+  def perform(user)
+    # Background job logic
+  end
+end
+```
+
+#### Solid Cache (Caching)
+```ruby
+# config/application.rb
+config.cache_store = :solid_cache_store
+
+# Usage in controllers/models
+Rails.cache.fetch("user_#{user.id}", expires_in: 1.hour) do
+  expensive_calculation(user)
+end
+```
+
+#### Solid Cable (WebSockets)
+```ruby
+# config/application.rb
+config.action_cable.adapter = :solid_cable
+
+# app/channels/chat_channel.rb
+class ChatChannel < ApplicationCable::Channel
+  def subscribed
+    stream_from "chat_#{params[:room]}"
+  end
+end
+```
+
+### 3. Native Authentication (Rails 8)
+```ruby
+# Generate authentication
+bin/rails generate authentication User
+
+# app/models/user.rb (generated)
+class User < ApplicationRecord
+  has_secure_password
+  
+  validates :email, presence: true, uniqueness: true
+  normalizes :email, with: ->(email) { email.strip.downcase }
+end
+
+# app/controllers/application_controller.rb
+class ApplicationController < ActionController::Base
+  before_action :authenticate_user!
+  
+  private
+  
+  def authenticate_user!
+    redirect_to login_path unless current_user
+  end
+  
+  def current_user
+    @current_user ||= User.find(session[:user_id]) if session[:user_id]
+  end
+end
+```
+
+### 4. Propshaft Asset Pipeline
+```ruby
+# config/application.rb
+# Propshaft is now the default - no configuration needed
+
+# Assets are automatically fingerprinted and served
+# Use asset helpers in views:
+<%= asset_path("application.css") %>
+<%= asset_path("logo.png") %>
+```
+
+## Testing in Rails 8
+
+### Default Test Suite Setup
+Rails 8 includes comprehensive testing setup by default:
+
+```ruby
+# test/test_helper.rb
+ENV["RAILS_ENV"] ||= "test"
+require_relative "../config/environment"
+require "rails/test_help"
+
+module ActiveSupport
+  class TestCase
+    # Run tests in parallel with specified workers
+    parallelize(workers: :number_of_processors)
+    
+    # Setup all fixtures in test/fixtures/*.yml
+    fixtures :all
+    
+    # Add more helper methods to be used by all tests here...
+  end
+end
+```
+
+### System Testing with Capybara
+```ruby
+# test/system/users_test.rb
+class UsersTest < ApplicationSystemTestCase
+  test "creating a user" do
+    visit new_user_path
+    
+    fill_in "Name", with: "John Doe"
+    fill_in "Email", with: "john@example.com"
+    click_button "Create User"
+    
+    assert_text "User was successfully created"
+  end
+end
+```
+
+## Security Best Practices (Rails 8)
+
+### Built-in Security Features
+- **Brakeman** - Included by default for security scanning
+- **Credential Management** - Use `rails credentials:edit`
+- **Content Security Policy** - Configure in `application_controller.rb`
+- **Force SSL** - Enable in production environment
+
+```ruby
+# config/environments/production.rb
+config.force_ssl = true
+config.content_security_policy do |policy|
+  policy.default_src :self, :https
+  policy.font_src    :self, :https, :data
+  policy.img_src     :self, :https, :data
+  policy.object_src  :none
+  policy.script_src  :self, :https
+  policy.style_src   :self, :https, :unsafe_inline
+end
+```
+
+## Performance Optimization
+
+### Database Optimization
+```ruby
+# Use includes to avoid N+1 queries
+@users = User.includes(:posts).all
+
+# Use counter_cache for associations
+class Post < ApplicationRecord
+  belongs_to :user, counter_cache: true
+end
+```
+
+### Caching Strategies
+```ruby
+# Fragment caching in views
+<% cache @user do %>
+  <%= render @user %>
+<% end %>
+
+# Action caching in controllers
+class UsersController < ApplicationController
+  caches_action :index, expires_in: 1.hour
+end
+```
+
+## Production Deployment Checklist
+
+### Environment Configuration
+- [ ] Set `RAILS_ENV=production`
+- [ ] Configure `RAILS_MASTER_KEY` or `config/credentials.yml.enc`
+- [ ] Set up database (PostgreSQL/MySQL for production)
+- [ ] Configure email delivery
+- [ ] Set up error monitoring (Sentry, Bugsnag)
+- [ ] Configure logging and log rotation
+
+### Kamal 2 Deployment
+- [ ] Update `config/deploy.yml` with production servers
+- [ ] Set up Docker registry access
+- [ ] Configure environment variables and secrets
+- [ ] Run `kamal setup` for initial deployment
+- [ ] Deploy with `kamal deploy`
+
+### Performance & Monitoring
+- [ ] Enable asset precompilation
+- [ ] Configure CDN for static assets
+- [ ] Set up application performance monitoring (APM)
+- [ ] Configure health checks
+- [ ] Set up backup strategies for database
+
+## Upgrading to Rails 8
+
+### Migration Steps
+1. Update Gemfile: `gem 'rails', '~> 8.0.0'`
+2. Run `bundle update rails`
+3. Run `bin/rails app:update` to update configuration files
+4. Review and update deprecated code
+5. Update test suite to use new defaults
+6. Consider migrating to Solid trifecta adapters
+7. Optionally migrate authentication to native Rails 8 system
+
+### Breaking Changes to Consider
+- Ruby 3.2+ requirement
+- Propshaft replaces Sprockets by default
+- Some deprecated ActiveRecord methods removed
+- Updated default configurations for new applications
+
+This Rails 8 configuration provides a modern, production-ready foundation with the latest Rails features and best practices.

package/cli-tool/templates/rust/.mcp.json

@@ -0,0 +1,78 @@
+{
+  "mcpServers": {
+    "rust-sdk": {
+      "name": "Rust MCP SDK",
+      "description": "Asynchronous, high-performance SDK for Rust",
+      "command": "rust_mcp_server",
+      "args": [],
+      "env": {}
+    },
+    "ht-mcp": {
+      "name": "HT MCP",
+      "description": "Pure Rust implementation for headless terminal interaction",
+      "command": "ht-mcp",
+      "args": [],
+      "env": {}
+    },
+    "rust-docs": {
+      "name": "Rust Docs MCP",
+      "description": "Prevents outdated code suggestions by providing updated Rust docs",
+      "command": "rust-docs-mcp-server",
+      "args": [],
+      "env": {}
+    },
+    "substrate": {
+      "name": "Substrate MCP",
+      "description": "MCP server for interacting with Substrate-based blockchains",
+      "command": "substrate-mcp-rs",
+      "args": [],
+      "env": {
+        "NODE_URL": "..."
+      }
+    },
+    "mcp-proxy": {
+      "name": "MCP Proxy",
+      "description": "Fast Rust-based proxy between stdio and SSE",
+      "command": "mcp-proxy",
+      "args": [],
+      "env": {}
+    },
+    "memory-bank": {
+      "name": "Memory Bank MCP",
+      "description": "Centralized memory system for AI agents",
+      "command": "server-memory",
+      "args": [],
+      "env": {}
+    },
+    "sequential-thinking": {
+      "name": "Sequential Thinking MCP",
+      "description": "Helps LLMs decompose complex tasks into logical steps",
+      "command": "code-reasoning",
+      "args": [],
+      "env": {}
+    },
+    "brave-search": {
+      "name": "Brave Search MCP",
+      "description": "Privacy-focused web search tool",
+      "command": "server-brave-search",
+      "args": [],
+      "env": {}
+    },
+    "google-maps": {
+      "name": "Google Maps MCP",
+      "description": "Integrates Google Maps for geolocation and directions",
+      "command": "server-google-maps",
+      "args": [],
+      "env": {
+        "GOOGLE_MAPS_API_KEY": "..."
+      }
+    },
+    "deep-graph": {
+      "name": "Deep Graph MCP (Code Graph)",
+      "description": "Transforms source code into semantic graphs via DeepGraph",
+      "command": "mcp-code-graph",
+      "args": [],
+      "env": {}
+    }
+  }
+}

package/cli-tool/templates/rust/README.md

@@ -0,0 +1,26 @@
+# Rust Claude Code Templates
+
+## Coming Soon! 🚧
+
+We're actively working on creating comprehensive Claude Code templates for Rust development.
+
+### What to Expect
+- Best practices for Rust project structure
+- Integration with popular Rust tools and frameworks
+- Workflow optimizations for Rust development
+- Testing and benchmarking configurations
+- Cross-compilation and deployment setups
+- Memory safety and performance guidelines
+
+### Meanwhile...
+You can use the [common templates](../common/README.md) as a starting point for your Rust projects. The universal guidelines and git workflows will work well with Rust development.
+
+### Stay Updated
+⭐ Star this repository to get notified when the Rust templates are released!
+
+### Contributing
+Interested in helping build these templates? We welcome contributions! Please check the main repository's contribution guidelines and feel free to open an issue or pull request.
+
+---
+
+*Expected release: Coming soon*

package/cli-tool/test-commands.sh

@@ -0,0 +1,85 @@
+#!/bin/bash
+
+# Test script for claude-code-templates CLI
+set -e
+
+echo "🧪 Starting CLI Testing Suite..."
+
+# Create test directories
+TEST_DIR="/tmp/claude-test-$(date +%s)"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+
+echo "📂 Test directory: $TEST_DIR"
+
+# Test 1: Help command
+echo "🔸 Test 1: Help command"
+claude-code-templates --help > /dev/null && echo "✅ Help command works" || echo "❌ Help command failed"
+
+# Test 2: Version command
+echo "🔸 Test 2: Version command"
+claude-code-templates --version > /dev/null && echo "✅ Version command works" || echo "❌ Version command failed"
+
+# Test 3: Dry run with JavaScript/TypeScript + React
+echo "🔸 Test 3: Dry run - JavaScript/TypeScript + React"
+claude-code-templates --language javascript-typescript --framework react --dry-run --yes > /dev/null && echo "✅ JS/TS + React dry run works" || echo "❌ JS/TS + React dry run failed"
+
+# Test 4: Dry run with Common language
+echo "🔸 Test 4: Dry run - Common language"
+claude-code-templates --language common --dry-run --yes > /dev/null && echo "✅ Common language dry run works" || echo "❌ Common language dry run failed"
+
+# Test 5: Actual installation to test directory
+echo "🔸 Test 5: Actual installation"
+mkdir react-test-project
+cd react-test-project
+claude-code-templates --language javascript-typescript --framework react --yes > /dev/null
+
+if [ -f "CLAUDE.md" ] && [ -d ".claude" ]; then
+    echo "✅ Installation creates required files"
+else
+    echo "❌ Installation failed to create files"
+fi
+
+# Test 6: Check created commands
+echo "🔸 Test 6: Check created commands"
+if [ -f ".claude/commands/component.md" ] && [ -f ".claude/commands/test.md" ]; then
+    echo "✅ React-specific commands created"
+else
+    echo "❌ React-specific commands missing"
+fi
+
+# Test 7: Check hooks functionality
+echo "🔸 Test 7: Check hooks functionality"
+if [ -f ".claude/settings.json" ]; then
+    if command -v jq >/dev/null 2>&1; then
+        if jq '.hooks' ".claude/settings.json" > /dev/null 2>&1; then
+            hook_count=$(jq '.hooks | keys | length' ".claude/settings.json")
+            if [ "$hook_count" -gt 0 ]; then
+                echo "✅ Hooks are properly configured ($hook_count hook types)"
+            else
+                echo "❌ No hooks found in settings.json"
+            fi
+        else
+            echo "❌ Invalid hooks structure in settings.json"
+        fi
+    else
+        echo "⚠️ jq not available, skipping detailed hook validation"
+        if grep -q '"hooks"' ".claude/settings.json"; then
+            echo "✅ Hooks section found in settings.json"
+        else
+            echo "❌ No hooks section found in settings.json"
+        fi
+    fi
+else
+    echo "❌ settings.json not found"
+fi
+
+# Test 8: Interactive mode simulation (dry run)
+cd "$TEST_DIR"
+echo "🔸 Test 8: Interactive mode dry run"
+# This will start interactive mode but we'll cancel it quickly
+timeout 5s claude-code-templates --dry-run || echo "✅ Interactive mode starts correctly"
+
+echo "🎉 All tests completed!"
+echo "🧹 Cleaning up test directory: $TEST_DIR"
+rm -rf "$TEST_DIR"