mcpField
3
37signals-style

37signals-style

github.com/lucianghindaDevelopment42555 installsUpdated today
Repository

About 37signals-style

A reference skill documenting Rails and application-development patterns observed in 37signals' Fizzy codebase. It is intended for developers seeking guidance across backend, Hotwire, infrastructure, testing, and team practices; the guide describes observed conventions, not official 37signals standards.

Key features

  1. 01Rails controller, model, and view patterns
  2. 02Hotwire and Stimulus conventions
  3. 03Database and performance guidance
  4. 04Security and infrastructure references
  5. 05Testing and team-practice guidance

Use cases

  1. 01Consulting Rails architecture patterns
  2. 02Building Hotwire interfaces
  3. 03Reviewing application security and performance
  4. 04Finding testing and team conventions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/lucianghinda/superpowers-ruby --skill 37signals-style

After installing, type/37signals-stylein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
accessibility.md
action-text.md
actioncable.md
active-storage.md
ai-llm.md
authentication.md
background-jobs.md
caching.md
configuration.md
controllers.md
css.md
database.md
development-philosophy.md
dhh.md
email.md
filtering.md
hotwire.md
jason-zimdars.md
jorge-manrubia.md
mobile.md
models.md
multi-tenancy.md
notifications.md
observability.md
performance.md
rails-engineering-standards-and-practices.md
routing.md
security-checklist.md
stimulus.md
testing.md

Details

From the project README

37signals Style Guide

Patterns derived from analysis of 37signals' Fizzy codebase. Representative, not authoritative — these reflect observed conventions, not an official 37signals document.

Topic Map

Core Rails Patterns
  • references/controllers.md — Thin controllers, concerns, authentication, authorization
  • references/models.md — Fat models, scopes, query objects, concerns
  • references/views.md — Presenters, partials, view helpers, template conventions
  • references/routing.md — RESTful design, nested resources, custom routes
  • references/database.md — Schema design, indexes, migrations, query optimization
Frontend & Hotwire
  • references/hotwire.md — Turbo Drive, Turbo Frames, Turbo Streams patterns
  • references/stimulus.md — Stimulus controller conventions, value API, targets
  • references/css.md — CSS organization, naming conventions, component patterns
  • references/action-text.md — Rich text integration patterns
  • references/actioncable.md — WebSocket channel patterns
Application Features
  • references/authentication.md — Session management, password reset, remember me
  • references/background-jobs.md — Solid Queue/ActiveJob patterns, retry strategies
  • references/caching.md — Fragment caching, counter caches, cache keys
  • references/email.md — Mailer conventions, transactional email patterns
  • references/notifications.md — In-app notifications, notification objects
  • references/filtering.md — Search and filter patterns, query objects
  • references/workflows.md — Multi-step processes, state machines
  • references/webhooks.md — Inbound/outbound webhook handling
Infrastructure
  • references/active-storage.md — File upload conventions, image variants
  • references/configuration.md — Environment config, credentials, feature flags
  • references/observability.md — Logging, error tracking, instrumentation
  • references/performance.md — N+1 prevention, caching strategies, query optimization
  • references/security-checklist.md — OWASP checklist, Brakeman, safe patterns
  • references/multi-tenancy.md — Account scoping, current attributes
  • references/mobile.md — Mobile-specific patterns, PWA considerations
  • references/ai-llm.md — LLM/AI integration patterns
Testing
  • references/testing.md — 37signals testing approach, fixtures, minitest conventions
Philosophy & Team
  • references/development-philosophy.md — Basecamp Way, calm technology, YAGNI
  • references/what-they-avoid.md — Patterns 37signals deliberately avoids
  • references/dhh.md — DHH's Rails principles and design opinions
  • references/jorge-manrubia.md — Jorge Manrubia's contributions and patterns
  • references/jason-zimdars.md — Jason Zimdars' design and UX conventions
  • references/accessibility.md — Accessibility patterns and ARIA usage
  • references/watching.md — Activity feeds, event tracking patterns
  • references/rails-engineering-standards-and-practices.md — Engineering standards

Comments

Markdown supported