igmarin/rails-agent-skills
Curated library of AI agent skills for Ruby on Rails development. Covers code review, architecture, security, testing (RSpec), engines, service objects, DDD patterns, and workflow automation.
98
99%
Does it follow best practices?
Impact
98%
1.38xAverage score across 26 eval scenarios
Passed
No known issues
BOUNDARY_GUIDE.mdrails-bug-triage/
Bug Triage Boundary Guide
Maps common bug shapes to the highest-value first failing spec.
| Bug shape | Likely first spec | Path |
|---|---|---|
| Wrong status code, params handling, JSON payload | Request spec | spec/requests/ |
| Invalid state transition, validation, calculation | Model or service spec | spec/models/ or spec/services/ |
| Async side effect missing or duplicated | Job spec | spec/jobs/ |
| Engine routing/install/generator regression | Engine spec | Dummy app path |
| Third-party mapping/parsing issue | Integration or client-layer spec | spec/services/module_name/ |
Diagnosing the Right Layer
- HTTP symptoms (wrong status, wrong JSON shape, redirect loops): start at request level
- Data symptoms (wrong value saved, wrong validation message): start at model or service
- Timing symptoms (missing email, job not enqueued): start at job or service spec
- Engine symptoms (routes not found, generator broke): use dummy app request spec
When the Boundary Is Unclear
- Write the spec at the highest visible symptom boundary first.
- Run it — if it fails for the wrong reason (e.g., factory error), move down a layer.
- The correct boundary is where the failure message directly names the missing behavior.
api-rest-collection
create-prd
ddd-boundaries-review
ddd-rails-modeling
ddd-ubiquitous-language
docs
evals
scenario-1
scenario-2
scenario-3
scenario-4
scenario-5
scenario-6
scenario-7
scenario-8
scenario-9
scenario-10
scenario-11
scenario-12
scenario-13
scenario-14
scenario-15
scenario-16
scenario-17
scenario-18
scenario-19
scenario-20
scenario-21
scenario-22
scenario-23
scenario-24
scenario-25
scenario-26
generate-tasks
mcp_server
rails-architecture-review
rails-background-jobs
rails-bug-triage
rails-code-conventions
rails-code-review
rails-engine-compatibility
rails-engine-docs
rails-engine-extraction
rails-engine-installers
rails-engine-release
rails-engine-reviewer
rails-engine-testing
rails-graphql-best-practices
rails-migration-safety
rails-review-response
rails-security-review
rails-skills-orchestrator
rails-stack-conventions
rails-tdd-slices
refactor-safely
rspec-best-practices
rspec-service-testing
ruby-service-objects
strategy-factory-null-calculator
ticket-planning
yard-documentation