rails-dev-plugin: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Claude Code plugin that provides specialized agents and portable skills for Rails application development. Agents are lean orchestrators that load domain-specific skills via the skills frontmatter field. Skills are independently usable and exportable to other platforms.

Repository Structure

rails-dev-plugin/
├── .claude-plugin/
│   └── plugin.json                     # Plugin metadata (name, version, description)
├── agents/                              # lean agents (reference skills for knowledge)
│   ├── rails-model.md                   # skills: [rails-model-patterns]
│   ├── rails-controller.md              # skills: [rails-controller-patterns]
│   ├── rails-views.md                   # skills: [rails-views-patterns]
│   ├── rails-service.md                 # skills: [rails-service-patterns]
│   ├── rails-jobs.md                    # skills: [rails-jobs-patterns]
│   ├── rails-test.md                    # skills: [rails-testing-patterns]
│   ├── rails-hotwire.md                 # skills: [hotwire-patterns]
│   ├── rails-graphql.md                 # skills: [rails-graphql-patterns]
│   ├── rails-architect.md               # skills: [rails-architecture-patterns]
│   ├── rails-devops.md                  # skills: [rails-devops-patterns]
│   └── rails-api.md                     # skills: [rails-api-patterns, rails-controller-patterns]
└── skills/                              # portable skills (domain knowledge)
    ├── rails-model-patterns/            # ActiveRecord, associations, migrations
    ├── rails-controller-patterns/       # RESTful controllers, routing, params
    ├── rails-views-patterns/            # ERB, partials, helpers, caching
    ├── rails-service-patterns/          # Service objects, result pattern, DI
    ├── rails-jobs-patterns/             # ActiveJob, Sidekiq, idempotency
    ├── rails-testing-patterns/          # RSpec, Minitest, system tests
    ├── hotwire-patterns/                # Stimulus, Turbo frames/streams
    ├── rails-graphql-patterns/          # Schema, mutations, DataLoader
    ├── rails-architecture-patterns/     # Planning, design decisions, skill directory
    ├── rails-devops-patterns/           # Docker, CI/CD, monitoring, security
    ├── rails-api-patterns/              # API controllers, serialization, JWT
    ├── rails-stack-profiles/            # Architecture axis detection (logic placement, delivery)
    ├── rails-mailer-patterns/           # Action Mailer, email delivery, previews
    ├── rails-auth-patterns/             # Authentication (built-in vs Devise)
    ├── rails-caching-patterns/          # Fragment, low-level, HTTP caching
    ├── ruby-refactoring/                # Code smells, refactoring patterns
    ├── ruby-object-design/              # Class vs module, Struct, Data
    └── project-conventions/             # Auto-detect project-specific coding conventions