claude-ruby-grape-rails

CONTRIBUTOR TOOL - Track CC changelog, extract new versions since last check, analyze impact on plugin (breaking changes, opportunities, deprecations). Run periodically or before releases. NOT part of the distributed plugin.

CONTRIBUTOR TOOL - Check the plugin against current cached Claude Code docs. Use before releases or after Claude docs changes to separate real schema drift from stale local assumptions. Not part of the distributed plugin.

Guide plugin development workflow for this repo. Use when editing shipped plugin files under plugins/ruby-grape-rails/, release/docs metadata, or contributor tooling under .claude/.

Analyze observational skill-effectiveness signals across scanned sessions. Use for exploratory monitoring and recommendation triage, not as a release gate.

Initializing the Ruby/Rails/Grape plugin: writes stack notes (queues, ORM-per-package, layout) into CLAUDE.md. Triggers: "initialize plugin", "setup ruby plugin", "configure Claude for Rails".

Walking a user through the Ruby/Rails/Grape plugin commands, capabilities, and workflow. Tutorial-style intro for newcomers who want to learn what the plugin offers rather than tackle a specific task.

Running a project-wide audit of a Ruby/Rails/Grape codebase: architecture, security, performance, testing coverage, ops risk. Emits findings to .claude/audit/.

Reviewing Ruby/Rails/Grape changes via parallel specialists: correctness, security, tests, AR, Grape, Sidekiq. Triggers: "review my changes", "code review", "check this PR".

Walking through a Ruby/Rails/Grape plan, diff, or review in a concise summary. Triggers: "explain plan", "summarize review", "walk me through".

Configuring Rails deployment: Kamal, Docker, Thruster, Solid Queue, Procfile, container layout.

Generating documentation for implemented Ruby/Rails/Grape features: YARD/RDoc method docs, README updates, ADRs. Runs after /rb:review passes.

Running the end-to-end Ruby/Rails/Grape lifecycle in one shot: plan → work → verify → review → compound, chained. Autonomous on happy path; halts on /rb:verify --full failure (HALTED_VERIFY_FAILED), BLOCKED review (HALTED_REVIEW_BLOCKED), REQUIRES CHANGES review (HALTED_REVIEW_REQUIRES_CHANGES), or unparsable review (HALTED_REVIEW_UNKNOWN).

Root-cause analysis for Ruby/Rails/Grape bugs whose cause is unknown. Triggers: "why is this broken", "root cause", "error analysis". Do NOT use for: perf, tracing.

Iron Laws of Ruby/Rails/Grape (AR, Sidekiq, security, Ruby, Hotwire, verify). Non-negotiable rules. Triggers: "iron law", "non-negotiable rule", "iron-law-judge".

Planning Ruby/Rails/Grape features, Sidekiq, migrations before code. Accepts plan.md, interview.md, REQUIRES CHANGES review. Triggers: "plan this feature", "implementation plan", "design before code".

Plain Ruby idioms: value objects, error handling, pattern matching, ractors, YJIT. Triggers: "frozen string literal", "plain Ruby code", "endless method", "value object". Do NOT use for: Rails patterns.

Zero-downtime Rails migrations: strong_migrations, backfill, locking, multi-step rename/drop/add-NOT-NULL. Triggers: "is migration safe", "will it lock table", "backfill strategy", "add NOT NULL prod".

Scanning a Ruby/Rails/Grape codebase for tech-debt items: overgrown services, query repetition, callback sprawl, decorative abstractions, dead code, missing tests around legacy seams. Read-only — logs items, routes fixes elsewhere.

Authoring Ruby/Rails/Grape/Sidekiq tests: request specs, factories, anti-flake. Triggers: "RSpec patterns", "factory setup", "flaky test". Do NOT use for: running tests, executing rspec.

Triaging review findings: pick fix now, skip, or defer. Prioritizes Blockers (Iron Law violations, security). Triggers: "triage", "which to fix", "prioritize findings".

Strongest check stack on Ruby/Rails/Grape: CI wrapper if present, else Zeitwerk + lint + tests + Brakeman. Stops at first failure. Triggers: "verify my work", "run checks", "CI check".

Executing a Ruby/Rails/Grape plan checklist: reads plan.md, runs tasks, ticks checkboxes. Resumes newest active plan. Triggers: "implement plan", "resume work", "execute plan".

Exploring approaches, comparing options, and gathering requirements for a vague Ruby/Rails/Grape feature idea before /rb:plan. Interview-style discovery; emits interview.md.

Evidence-based research on Ruby/Rails/Grape gems, upgrade paths, security choices, architecture. Cites sources. Triggers: "research this gem", "upgrade path", "evidence for".

Active Record patterns: models, queries, associations, transactions, locking, migrations. Triggers: "AR scope", "has_many through", "polymorphic". Do NOT use for: Sequel, N+1.

Running rigorous adversarial scrutiny on Active Record changes, Hotwire/Turbo events, or PR readiness — devil's-advocate questioning before approval.

Hotwire in Rails: Turbo Frames, Streams, Stimulus, Action Cable. Triggers: "live update no reload", "broadcast model", "stimulus controller". Do NOT use for: native mobile, jobs.

Routing Ruby/Rails/Grape/Sidekiq/AR/Sequel/Hotwire work to the correct /rb: command BEFORE doing it. Pushy gateway, never blocks. Triggers: "my Rails app", "which command", multi-step task. Do NOT use when user typed /rb:<name>.

Rails/Grape security review: authz, injection, output sanitization, SSRF. Triggers: "is this vulnerable", "SQL injection", "XSS", "Brakeman warning". Do NOT use for: secret scans.

Diagnosing Active Record constraint failures: unique-index, foreign-key, NOT-NULL violations. Triggers: "constraint error", "unique violation", "foreign key", "PG::UniqueViolation".

Diagnosing N+1 query patterns in Rails/Grape: slow index pages, serializers, nested API responses. Triggers: "N+1", "includes", "preload", "bullet warning".

Implementing Ruby fiber concurrency: async gem, Falcon server, I/O-bound parallelism, fiber-safe locking.

Capturing a solved Ruby/Rails/Grape problem as reusable knowledge. YAML solution doc. Triggers: "compound this", "save this solution", "capture this fix".

Drafting an anonymized GitHub-issue-ready report from verify-output compression telemetry: PII-redacted, actionable, user copies into a maintainer issue.

Applying dry-rb gems: dry-validation contracts, dry-types coercion, dry-monads Result/Maybe, dry-struct value objects, dry-transaction pipelines, dry-system DI.

Surfacing representative example areas and patterns inside the current Ruby/Rails/Grape codebase.

Grape APIs: endpoint design, param coercion, versioning, grape-entity. Triggers: "API versioning", "param coercion", "endpoint design", "Grape::Entity". Do NOT use for: Rails controllers.

Building native iOS/Android shells with Hotwire Native: path configuration, bridge components, native navigation, Turbo Native bridges.

Building Kafka consumers and producers with Karafka in Rails: multi-threaded batch processing, message handlers, OffsetStore.

Capturing in-flight lessons when the user corrects your approach or teaches a pattern: ActiveRecord, Rails, Grape, Sidekiq mistakes during work. Writes lightweight learning notes.