rails-conventions

Define and enforce APRS platform coding standards for Rails development.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/signalblur/aprs-platform --skill rails-conventions-signalblur
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rails-conventions
Source: https://github.com/signalblur/aprs-platform/tree/main/.claude/skills/rails-conventions
Command: npx skills add https://github.com/signalblur/aprs-platform --skill rails-conventions-signalblur

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive reference for the coding standards, architectural patterns, and workflow requirements that all agents must adhere to within the APRS platform, ensuring consistency and quality.

Core Features & Use Cases

  • Coding Standards: Defines best practices for Ruby, RSpec, Pundit, PostGIS, and more.
  • Workflow Requirements: Outlines mandatory development processes like TDD and documentation.
  • Use Case: A new developer joining the APRS platform can use this Skill to quickly understand and implement the established conventions for building new features.

Quick Start

Refer to the rails-conventions skill for detailed guidance on TDD workflows and YARD documentation standards.

Frequently Asked Questions about rails-conventions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are the best practices for TDD and RSpec in Rails development?

Rails TDD best practices require mandatory test-first workflows using RSpec, covering service objects, API controller patterns, and time manipulation in tests to ensure consistent quality and architectural compliance.

How do I configure Pundit authorization and strong parameters in a Rails API?

Configuring Pundit authorization in a Rails API involves enforcing policy checks alongside strong parameters to secure API controller patterns, ensuring proper access control and permitted attribute handling.

What is the standard approach for handling Stripe webhooks and background jobs in Rails?

Handling Stripe webhooks in Rails follows standardized background job patterns for asynchronous processing, ensuring reliable event processing and consistent exception handling across the application architecture.

How do I use PostGIS with Rails migrations for spatial data?

Using PostGIS with Rails requires following specific migration conventions to properly define spatial columns and indexes, ensuring geospatial data integrates correctly with the established platform architecture.

Does this Rails conventions standard cover Devise configuration and YARD documentation?

Yes, this Rails conventions standard defines specific Devise configuration patterns and mandates YARD documentation for all development agents, ensuring comprehensive code documentation and consistent authentication setup.

What's the best way to structure Rails service objects and exception handling?

Structuring Rails service objects requires following established architectural patterns that encapsulate business logic, paired with standardized exception handling conventions to maintain consistent error management across the platform.