Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

3.2 KB
Raw Blame

paths: - "/*.rb" - "/.rake" - "/Gemfile" - "/app/**/.erb" - "**/config/routes.rb"

Ruby パターン

このファイルは common/patterns.md を Ruby および Rails 固有のコンテンツで拡張します。

まず Rails Way

  • 小規模および中規模の機能には、プレーンな Rails MVC と Active Record の規約から始める。
  • モデル/コントローラの境界が複数の責務を担っている場合に、サービスオブジェクト、クエリオブジェクト、フォームオブジェクト、デコレータ、またはプレゼンターを導入する。
  • 抽出したオブジェクトには Manager や Processor のような汎用的なレイヤー名ではなく、実行するビジネス操作にちなんだ名前を付ける。

永続化

  • マルチホスト本番 Rails アプリでは、既存プラットフォームが MySQL や SQLite を使用する明確な理由がない限り PostgreSQL を優先する。
  • Rails 8 の SQLite ベースのデフォルトは、シングルホストまたは小規模なデプロイメントに適しているが、共有マルチサービスシステムに自動的に適合するわけではない。
  • 生の SQL はクエリオブジェクトまたはモデルスコープの背後に配置し、すべての動的値をパラメータ化する。

バックグラウンドジョブとランタイムサービス

  • グリーンフィールドの Rails 8 アプリで、適度なスループットとシンプルなデプロイメントが必要な場合は Solid Queue を使用する。
  • 成熟したオブザーバビリティ、高スループット、既存の Redis インフラストラクチャ、または Pro/Enterprise 機能が必要な場合は Sidekiq を使用する。
  • Solid Cache と Solid Cable はそのデプロイメントモデルがアプリに適合する場合に使用する。共有クロスサービス動作、高ファンアウト、または高度なデータ構造が重要な場合は Redis を使用する。

フロントエンド

  • サーバーレンダリングの Rails アプリには Turbo、Stimulus、Importmap、Propshaft を使用した Hotwire を優先する。
  • インタラクションの複雑さ、既存のプロダクトアーキテクチャ、またはチームのオーナーシップが追加のクライアントサーフェスを正当化する場合は、React、Vue、Inertia.js、または個別の SPA を使用する。
  • ビューコンポーネント、パーシャル、プレゼンターはレンダリングの判断に集中させる。永続化と認可をテンプレートに含めない。

認証

  • シンプルなセッション認証とパスワードリセットのニーズには Rails 8 認証ジェネレータを使用する。
  • OAuth、MFA、confirmable/lockable フロー、マルチモデル認証、または大規模な既存 Devise フットプリントが要件に含まれる場合は Devise または他の確立された認証システムを使用する。

参考

サービス境界とアダプターパターンについてはスキル: backend-patterns を参照。