ce-dhh-rails-style

<objective> 37signals/DHH Rails の慣例を Ruby と Rails コードに適用します。このスキルは、37signals 本番コードベース (Fizzy/Campfire) の分析と DHH のコードレビューパターンから抽出された包括的なドメイン知識を提供します。 </objective>

<essential_principles>

コア哲学

「最良のコードは、書かないコードだ。次点は、明らかに正しいコードだ。」

Vanilla Rails で十分：

• サービスオブジェクトより豊かなドメインモデル
• カスタムアクションより CRUD コントローラー
• 水平方向のコード共有のための Concerns
• ブール列の代わりに状態としてのレコード
• すべてをデータベースで管理（Redis なし）
• gem に手を出す前に解決策を構築

意図的に避けること：

• devise（カスタム ~150 行の認証を代わりに使用）
• pundit/cancancan（モデル内のシンプルな役割チェック）
• sidekiq（Solid Queue はデータベースを使用）
• redis（すべてをデータベースで管理）
• view_component（パーシャルで十分）
• GraphQL（Turbo を使った REST で充分）
• factory_bot（フィクスチャのほうがシンプル）
• rspec（Minitest は Rails に付属）
• Tailwind（レイヤー付きネイティブ CSS）

開発哲学：

• リリース、検証、改良 - プロトタイプ品質のコードを本番環境にデプロイして学習
• 症状ではなく根本原因を修正
• 読み取り時の計算よりも書き込み時の操作
• ActiveRecord バリデーションよりもデータベース制約 </essential_principles>

<intake> 何に取り組んでいますか？

1. Controllers - REST マッピング、Concerns、Turbo レスポンス、API パターン
2. Models - Concerns、状態レコード、コールバック、スコープ、PORO
3. Views & Frontend - Turbo、Stimulus、CSS、パーシャル
4. Architecture - ルーティング、マルチテナンシー、認証、ジョブ、キャッシング
5. Testing - Minitest、フィクスチャ、統合テスト
6. Gems & Dependencies - 何を使うか、避けるか
7. Code Review - DHH スタイルに対してコードをレビュー
8. General Guidance - 哲学と慣例

番号を指定するか、タスクを説明してください。 </intake>

<routing>

Response	参照資料
1, controller	references/controllers.md
2, model	references/models.md
3, view, frontend, turbo, stimulus, css	references/frontend.md
4, architecture, routing, auth, job, cache	references/architecture.md
5, test, testing, minitest, fixture	references/testing.md
6, gem, dependency, library	references/gems.md
7, review	すべての参照資料を読んでからコードをレビュー
8, general task	コンテキストに基づいて関連する参照資料を読む

関連する参照資料を読んだ後、ユーザーのコードにパターンを適用します。 </routing>

<quick_reference>

命名規則

動詞： card.close、card.gild、board.publish（set_style メソッドではなく）

述語： card.closed?、card.golden?（関連レコードの存在から派生）

Concerns： 機能を説明する形容詞（Closeable、Publishable、Watchable）

Controllers： リソースに一致する名詞（Cards::ClosuresController）

Scopes：

• chronologically、reverse_chronologically、alphabetically、latest
• preloaded（標準的なイーガーローディング名）
• indexed_by、sorted_by（パラメータ化）
• active、unassigned（SQL 的ではなく、ビジネス用語）

REST マッピング

カスタムアクションの代わりに、新しいリソースを作成します：

POST /cards/:id/close    → POST /cards/:id/closure
DELETE /cards/:id/close  → DELETE /cards/:id/closure
POST /cards/:id/archive  → POST /cards/:id/archival

Ruby 構文の好み

# シンボル配列のブラケット内にスペース
before_action :set_message, only: %i[ show edit update destroy ]

# プライベートメソッドのインデント
  private
    def set_message
      @message = Message.find(params[:id])
    end

# 条件分岐にはケース式を使用
case
when params[:before].present?
  messages.page_before(params[:before])
else
  messages.last_page
end

# バングメソッドで即座に失敗
@message = Message.create!(params)

# シンプルな条件分岐には三項演算子
@room.direct? ? @room.users : @message.mentionees

キーパターン

状態としてのレコード：

Card.joins(:closure)         # 閉じられたカード
Card.where.missing(:closure) # オープンなカード

Current 属性：

belongs_to :creator, default: -> { Current.user }

モデル上の認可：

class User < ApplicationRecord
  def can_administer?(message)
    message.creator == self || admin?
  end
end

</quick_reference>

<reference_index>

ドメイン知識

references/ 内にあるすべての詳細パターン：

ファイル	トピック
references/controllers.md	REST マッピング、Concerns、Turbo レスポンス、API パターン、HTTP キャッシング
references/models.md	Concerns、状態レコード、コールバック、スコープ、PORO、認可、ブロードキャスティング
references/frontend.md	Turbo Streams、Stimulus コントローラー、CSS レイヤー、OKLCH カラー、パーシャル
references/architecture.md	ルーティング、認証、ジョブ、Current 属性、キャッシング、データベースパターン
references/testing.md	Minitest、フィクスチャ、ユニット/統合/システムテスト、テストパターン
references/gems.md	使用する gem vs 避ける gem、意思決定フレームワーク、Gemfile の例
</reference_index>

<success_criteria> 以下の場合、コードは DHH スタイルに従っています：

• コントローラーがリソースの CRUD 動詞にマッピングされている
• モデルが水平方向の動作に Concerns を使用している
• 状態がブール値ではなくレコードで追跡されている
• 不要なサービスオブジェクトや抽象化がない
• 外部サービスよりもデータベースバックアップのソリューションが好まれている
• テストは Minitest とフィクスチャを使用している
• インタラクティブ性には Turbo/Stimulus を使用している（重い JS フレームワークなし）
• ネイティブ CSS とモダン機能（レイヤー、OKLCH、ネスティング）を使用している
• 認可ロジックは User モデルに存在している
• ジョブはモデルメソッドを呼び出す浅いラッパーである </success_criteria>

<credits> [The Unofficial 37signals/DHH Rails Style Guide](https://github.com/marckohlbrugge/unofficial-37signals-coding-style-guide) by [Marc Köhlbrugge](https://x.com/marckohlbrugge) に基づいており、Fizzy コードベースの 265 個のプルリクエストの深い分析を通じて生成されました。

重要な免責事項：

• LLM 生成ガイド - 不正確さを含む可能性があります
• Fizzy からのコード例は O'Saasy ライセンスの下でライセンスされています
• 37signals に関連していないか、承認されていません

</credits>