moai-adk 0.8.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-lang-ruby/SKILL.md

@@ -1,124 +1,183 @@
 ---
-name: moai-lang-ruby
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: Ruby 3.4+ best practices with RSpec 4, RuboCop 2, Bundler, and Rails 8 patterns.
-keywords: ['ruby', 'rspec', 'rubocop', 'bundler', 'rails']
+name: "moai-lang-ruby"
+description: "Ruby 3.3+ development specialist covering Rails 7.2, ActiveRecord, Hotwire/Turbo, and modern Ruby patterns. Use when developing Ruby APIs, web applications, or Rails projects."
+version: 1.1.0
+category: "language"
+modularized: true
+user-invocable: false
+tags: ["language", "ruby", "rails", "activerecord", "hotwire", "turbo", "rspec"]
+updated: 2026-01-11
+status: "active"
 allowed-tools:
   - Read
+  - Grep
+  - Glob
   - Bash
+  - mcp__context7__resolve-library-id
+  - mcp__context7__get-library-docs
 ---
 
-# Lang Ruby Skill
+## Quick Reference (30 seconds)
 
-## Skill Metadata
+Ruby 3.3+ Development Specialist - Rails 7.2, ActiveRecord, Hotwire/Turbo, RSpec, and modern Ruby patterns.
 
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-lang-ruby |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Language |
+Auto-Triggers: Files with .rb extension, Gemfile, Rakefile, config.ru, Rails or Ruby discussions
 
----
+Core Capabilities:
 
-## What It Does
+- Ruby 3.3 Features: YJIT production-ready, pattern matching, Data class, endless methods
+- Web Framework: Rails 7.2 with Turbo, Stimulus, and ActiveRecord
+- Frontend: Hotwire including Turbo and Stimulus for SPA-like experiences
+- Testing: RSpec with factories, request specs, and system specs
+- Background Jobs: Sidekiq with ActiveJob
+- Package Management: Bundler with Gemfile
+- Code Quality: RuboCop with Rails cops
+- Database: ActiveRecord with migrations, associations, and scopes
 
-Ruby 3.4+ best practices with RSpec 4, RuboCop 2, Bundler, and Rails 8 patterns.
+### Quick Patterns
 
-**Key capabilities**:
-- ✅ Best practices enforcement for language domain
-- ✅ TRUST 5 principles integration
-- ✅ Latest tool versions (2025-10-22)
-- ✅ TDD workflow support
+Rails Controller Pattern:
 
----
+Create UsersController inheriting from ApplicationController. Add before_action for set_user calling only on show, edit, update, and destroy actions. Define index method assigning User.all to instance variable. Define create method creating new User with user_params. Use respond_to block with format.html redirecting on success or rendering new with unprocessable_entity status, and format.turbo_stream for Turbo responses. Add private set_user method finding by params id. Add user_params method requiring user and permitting name and email.
+
+ActiveRecord Model Pattern:
 
-## When to Use
+Create User model inheriting from ApplicationRecord. Define has_many for posts with dependent destroy and has_one for profile with dependent destroy. Add validates for email with presence, uniqueness, and format using URI::MailTo::EMAIL_REGEXP. Add validates for name with presence and length minimum 2 maximum 100. Define active scope filtering where active is true. Define recent scope ordering by created_at descending. Create full_name method returning first_name and last_name joined with space and stripped.
 
-**Automatic triggers**:
-- Related code discussions and file patterns
-- SPEC implementation (`/alfred:2-run`)
-- Code review requests
+RSpec Test Pattern:
 
-**Manual invocation**:
-- Review code for TRUST 5 compliance
-- Design new features
-- Troubleshoot issues
+Create RSpec.describe for User model type. In describe validations block, add expectations for validate_presence_of and validate_uniqueness_of for email. In describe full_name block, use let to build user with first_name John and last_name Doe. Add it block expecting user.full_name to eq John Doe.
 
 ---
 
-## Tool Version Matrix (2025-10-22)
+## Implementation Guide (5 minutes)
 
-| Tool | Version | Purpose | Status |
-|------|---------|---------|--------|
-| **Ruby** | 3.4.0 | Primary | ✅ Current |
-| **RSpec** | 4.0.0 | Primary | ✅ Current |
-| **RuboCop** | 2.0.0 | Primary | ✅ Current |
-| **Rails** | 8.0.0 | Primary | ✅ Current |
+### Ruby 3.3 New Features
 
----
+YJIT Production-Ready:
+
+YJIT is enabled by default in Ruby 3.3 providing 15 to 20 percent performance improvement for Rails applications. Enable by running ruby with yjit flag or setting RUBY_YJIT_ENABLE environment variable to 1. Check status by calling RubyVM::YJIT.enabled? method.
+
+Pattern Matching with case/in:
+
+Create process_response method taking response parameter. Use case with response and in for pattern matching. Match status ok with data extracting data variable and puts success message. Match status error with message extracting msg variable. Match status with guard condition checking pending or processing. Use else for unknown response.
+
+Data Class for Immutable Structs:
+
+Create User using Data.define with name and email symbols. Add block defining greeting method returning hello message with name. Create user instance with keyword arguments. Access name property and call greeting method.
+
+Endless Method Definition:
+
+Create Calculator class with add, multiply, and positive? methods using equals sign syntax for single expression methods.
+
+### Rails 7.2 Patterns
+
+Application Setup in Gemfile:
+
+Set source to rubygems.org. Add rails version constraint for 7.2, pg for 1.5, puma for 6.0 or later, turbo-rails, stimulus-rails, and sidekiq for 7.0. In development and test group add rspec-rails for 7.0, factory_bot_rails, faker, and rubocop-rails with require false. In test group add capybara and shoulda-matchers.
+
+Model with Concerns:
+
+Create Sluggable module extending ActiveSupport::Concern. In included block add before_validation for generate_slug on create and validates for slug with presence and uniqueness. Define to_param returning slug. Add private generate_slug method setting slug from parameterized title if title present and slug blank. Create Post model including Sluggable with belongs_to user, has_many comments with dependent destroy, has_many_attached images. Add validations and published scope.
+
+Service Objects Pattern:
+
+Create UserRegistrationService with initialize accepting user_params. Define call method creating User, using ActiveRecord::Base.transaction to save user, create profile, and send welcome email. Return Result with success true and user. Rescue RecordInvalid returning Result with success false and errors. Add private methods for create_profile and send_welcome_email. Define Result as Data.define with success, user, and errors, adding success? and failure? predicate methods.
+
+### Hotwire Turbo and Stimulus
 
-## Inputs
+Turbo Frames Pattern:
 
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
+In index view, use turbo_frame_tag with posts id and iterate posts rendering each. In post partial, use turbo_frame_tag with dom_id for post, containing article with h2 link and truncated content paragraph.
 
-## Outputs
+Turbo Streams Pattern:
 
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
+In controller create action, build post from current_user.posts. Use respond_to with format.turbo_stream and format.html for redirect or render based on save success. In create.turbo_stream.erb view, use turbo_stream.prepend for posts with post, and turbo_stream.update for new_post form partial.
 
-## Failure Modes
+Stimulus Controller Pattern:
 
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
+In JavaScript controller file, import Controller from hotwired/stimulus. Export default class extending Controller with static targets array for input and submit. Define connect method calling validate. Define validate method checking all input targets have values and setting submit target disabled accordingly.
 
-## Dependencies
+### RSpec Testing Basics
 
-- Access to project files via Read/Bash tools
-- Integration with `moai-foundation-langs` for language detection
-- Integration with `moai-foundation-trust` for quality gates
+Factory Bot Patterns:
+
+In factories file, define factory for user with sequence for email, Faker::Name.name for name, and password123 for password. Add admin trait setting role to admin symbol. Add with_posts trait with transient posts_count defaulting to 3, using after create callback to create_list posts for user.
 
 ---
 
-## References (Latest Documentation)
+## Advanced Implementation (10+ minutes)
+
+For comprehensive coverage including:
+
+- Production deployment patterns for Docker and Kubernetes
+- Advanced ActiveRecord patterns including polymorphic, STI, and query objects
+- Action Cable real-time features
+- Performance optimization techniques
+- Security best practices
+- CI/CD integration patterns
+- Complete RSpec testing patterns
 
-_Documentation links updated 2025-10-22_
+See:
+
+- modules/advanced-patterns.md for production patterns and advanced features
+- modules/testing-patterns.md for complete RSpec testing guide
 
 ---
 
-## Changelog
+## Context7 Library Mappings
 
-- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
-- **v1.0.0** (2025-03-29): Initial Skill release
+- rails/rails for Ruby on Rails web framework
+- rspec/rspec for RSpec testing framework
+- hotwired/turbo-rails for Turbo for Rails
+- hotwired/stimulus-rails for Stimulus for Rails
+- sidekiq/sidekiq for background job processing
+- rubocop/rubocop for Ruby style guide enforcement
+- thoughtbot/factory_bot for test data factories
 
 ---
 
 ## Works Well With
 
-- `moai-foundation-trust` (quality gates)
-- `moai-alfred-code-reviewer` (code review)
-- `moai-essentials-debug` (debugging support)
+- moai-domain-backend for REST API and web application architecture
+- moai-domain-database for SQL patterns and ActiveRecord optimization
+- moai-workflow-testing for TDD and testing strategies
+- moai-essentials-debug for AI-powered debugging
+- moai-foundation-quality for TRUST 5 quality principles
 
 ---
 
-## Best Practices
+## Troubleshooting
+
+Common Issues:
+
+Ruby Version Check:
+
+Run ruby with version flag for 3.3 or later. Check YJIT status by running ruby -e with puts RubyVM::YJIT.enabled? command.
+
+Rails Version Check:
+
+Run rails with version flag for 7.2 or later. Run bundle exec rails about for full environment information.
 
-✅ **DO**:
-- Follow language best practices
-- Use latest stable tool versions
-- Maintain test coverage ≥85%
-- Document all public APIs
+Database Connection Issues:
+
+- Check config/database.yml configuration
+- Ensure PostgreSQL or MySQL service is running
+- Run rails db:create if database does not exist
+
+Asset Pipeline Issues:
+
+Run rails assets:precompile to compile assets. Run rails assets:clobber to clear compiled assets.
+
+RSpec Setup Issues:
+
+Run rails generate rspec:install for initial setup. Run bundle exec rspec with specific file path for single spec. Run bundle exec rspec with format documentation for verbose output.
+
+Turbo and Stimulus Issues:
+
+Run rails javascript:install:esbuild for JavaScript setup. Run rails turbo:install for Turbo installation.
+
+---
 
-❌ **DON'T**:
-- Skip quality gates
-- Use deprecated tools
-- Ignore security warnings
-- Mix testing frameworks
+Last Updated: 2026-01-11
+Status: Active (v1.1.0)