ethos-link/rails-conventions

철도

팀에 대한 실용적인 Rails 기술로 가치 일관성

빌드 및 검토 레일 8 코드를 일치하여 코드베이스를 이미 가지고, 앱에 적합하지 않는 일반적인 패턴을 강제하지 마십시오.

SKILL · 이름 *

---

이 기술이 도움이 되는 것

rails-conventions은 실존물이 있는 Rails codebases의 실제 생산 작업입니다.

그것은 대리인을 지시합니다:

• 로컬 패턴을 검사 (모델, 컨트롤러, 경로, 테스트, 배치 설정)
• 기존의 컨벤션과 연계된 naming 및 Architecture 유지
• backend-aware 작업 코드를 작성 (good_job 또는 solid_queue]) assumptions없이
• 보안, 성능 및 시험 적용에서 조기 위험 파악
• 책임에 의해 분할된 값 근거한 시험 쓰기 (deep 단위 적용, 얇은 요구 체크)
• 대신 마이그레이션 및 설치 파일을 생성
• 기존 Ruby, Rails 및 라이브러리 API를 사용하여 helpers를 작성하기 전에 재사용
• testable hypotheses를 통해 버그를 진단하고 전후 회귀를 확인합니다
• 턴 반복된 실수로 safeguards 및 측정 동등한 작업

적용

• Ruby 4.0+/Rails 8.1+ 기본, 안정적인 출시 및 기본 API 검색

rails-conventions

A practical Rails skill for teams that value consistency

Build and review Rails 8 code by matching the codebase you already have, not by forcing generic patterns that don’t fit your app.

SKILL.md · References

---

What this skill helps with

rails-conventions is for real production work in Rails codebases where consistency matters.

It guides agents to:

• inspect local patterns first (models, controllers, routes, tests, deploy setup)
• keep naming and architecture aligned with existing conventions
• write backend-aware job code (good_job or solid_queue) without assumptions
• catch risks early in security, performance, and test coverage
• write value-based tests split by responsibility (deep unit coverage, thin request checks)
• generate migrations and installer files instead of inventing them
• reuse existing Ruby, Rails, and installed library APIs before writing helpers
• diagnose bugs through testable hypotheses and verify regressions before/after
• turn repeated mistakes into safeguards and measure equivalent work

Coverage

• Ruby 4.0+/Rails 8.1+ baseline, stable releases, and native API discovery
• Naming, layering, and code organization
• Active Record modeling, PostgreSQL features, and migration discipline
• Controllers, params, and response semantics
• REST/resource-focused routing
• Hotwire/Turbo/Stimulus patterns (including realtime posture)
• Background jobs (adapter detection + backend-specific guidance)
• Webhook inbound/outbound delivery reliability
• Performance and caching strategy
• Security checklist (including SSRF hardening and tenancy)
• Testing strategy (value-based assertions, Minitest and Minitest::Mock)
• API and serialization conventions
• Evidence-driven debugging, review, and realistic skill evaluation
• Mailer composition and previews
• Maintenance tasks, one-off cleanup, and maintained documentation
• Optional 37signals-inspired profile
• Generator-owned files policy (migrations, installers — never invent them)

Validate, install, and update

Run the bundled validation script before publishing changes:

ruby scripts/validate_skill.rb

Install or update the skill with skills:

# install from source
npx skills add [email protected]:ethos-link/rails-conventions.git --skill rails-conventions

# update an existing install
npx skills update rails-conventions

Forward-test prompts

Use these prompts to check that the skill triggers correctly and loads only the references needed for the task:

Implement a new billing webhook endpoint in this Rails app, matching existing conventions and tests.

Review this Rails 8 pull request for production readiness, focusing on naming, data integrity, security, and missing tests.