rails-hyperdrive-martian-sidekiq

Companion gem for rails-hyperdrive — Sidekiq guidance for AI coding agents working in Rails projects.

Ships four artifacts, all gated on sidekiq >= 7.0, < 9.0 being in the app's bundle:

• martian-sidekiq skill — a lazily-loaded playbook for writing idempotent, well-retried, transactionally-safe Sidekiq jobs: idempotency strategies, retry/backoff design, uniqueness, queue layout, multi-tenant fairness, testing, escalation ladders.
• martian-sidekiq guideline — the non-negotiable rules (no Sidekiq::Testing.inline!, small primitive arguments, no enqueue inside a transaction, …), loaded eagerly.
• martian-sidekiq-transactions guideline — how to enqueue from a service with after_commit_everywhere.
• martian-sidekiq-fair-tenant guideline — keeping one tenant from starving the queue with sidekiq-fair_tenant.

The last two are additionally gated on their gem being in the bundle, so apps without it never carry them in context.

Both are ERB templates: sections for Sidekiq Pro/Enterprise, sidekiq-fair_tenant, and rspec-sidekiq render against the app's bundle — apps that have the gem get usage guidance, apps that don't get a suggestion where it would help.

# Gemfile
group :development do
  gem "rails-hyperdrive"
  gem "rails-hyperdrive-martian-sidekiq"
end

Then run bin/rails hyperdrive:init. Artifacts install to .claude/skills/martian-sidekiq/SKILL.md and .claude/hyperdrive/guidelines/.

MIT — see LICENSE.txt.