【プロンプト設計実践】AIで進める Rails 8.0→8.1

Posted at 2026-03-30

はじめに

以下で作成した設計プロンプトをブラッシュアップし、AI に任せる形で Rails 8.0.4 から Rails 8.1.1（本記事執筆時点での最新）まで上げる取り組みを実施しました
- 【プロンプト設計実践】AIで進める Rails 7.1→7.2
- 【プロンプト設計実践】AIで進める Rails 7.2→8.0
本記事では、その際に使用した設計プロンプトの中身や、実際に適用した差分などをまとめます
Railsのアップデート実施を考えている方へ、少しでも参考になれば幸いです

環境

バックエンド：Rails8.0.4（APIモード）
インフラ：AWS
開発環境：Docker（リモートLinuxホスト / 例：AWS EC2）
エディタ：Visual Studio Code（Remote - SSH）
AIツール1：GitHub Copilot Pro（AIモデル：Claude Sonnet 4.5）
AIツール2：Google Gemini（AIモデル：Gemini 3 Pro）
ホストPC：MacBook Pro (Apple M3 Pro / macOS 26.0.1)

プロンプト設計とは

プロンプト設計は、公式ドキュメント・仕様・運用規約・ログなどの一次情報を根拠に、作業手順・評価基準・失敗時の対応を事前に構造化し、その設計に沿ってAIに実行させることです。
また、プロンプトはマークダウンで記述するのが良さそうです。
参考：LLM の入出力をマークダウンに統一しよう

設計に入る前に

プロンプト設計に入る前に、事前に簡単な調査を実施しました
- ReleaseNote、Changelogのリンクを確認し、主な変更点をまとめる
  - https://railsguides.jp/8_1_release_notes.html
- アップグレード事例を確認
  - Rails 8.1 Upgrade Knowledge

注意点

今回、バージョンを一気に7.2から8.1に上げるのではなく、7.2系の最新→8.0系の最新→8.1系の最新と、順を追って対応しました
8.x系の最新にする理由は、バグ修正が反映されている可能性が高く、最も安定した状態を確保できるためです
また、Railsのリリースノートにも以下のように記載されています

アプリケーションがRails 8.0までアップグレードされていない場合は先にそれを完了し、アプリケーションが正常に動作することを十分確認してからRails 8.1にアップデートしてください。

Rails8.0.4 → 8.1.1

事前準備

Gem bulletを使っている場合には、Rails8.0.4 → 8.1.1に上げる前にバージョンを8.1.0にアップデートする必要があります
- bullet8.1.0は、Rails8.1をサポートしています
  
  Support Rails 8.1

こちらは、プルリクエスト（マージリクエスト）を切り分けて対応しました。

Gemfile

 group :development, :test do
   gem "annotaterb"
-  gem "bullet"
+  gem "bullet", "~> 8.1.0"

Gemfile.lock

...
-    bullet (8.0.5)
+    bullet (8.1.0)
...
-    uniform_notifier (1.16.0)
+    uniform_notifier (1.18.0)
...
-  bullet
+  bullet (~> 8.1.0)
...

前提補足

設計プロンプト（実体）

bulletのバージョンアップ完了後、Rails8.1.1へのアップグレード対応を開始します。

プロンプト1（Rails本体のバージョンアップ）

Rails 8.0.4 から Rails 8.1.1 へのバージョンアップ作業
- 目的
  - Gemfile の rails 行を ~> 8.1.1 に更新し、Rails コアコンポーネント → Rails 本体の順で bundle update（conservative）を実施して依存を解決する
  - その後、Docker イメージのビルドと bin/rails r 'puts :ok' による起動スモークで最低限の動作確認までを自動で行う（テスト/Lint/新デフォルト設定の適用は別プロンプト範囲）
- 概要
  - Step1：事前確認
    - bin/rails -v / bundle info rails で現状把握
    - 既に 8.1.1 なら終了
  - Step2：Gemfile 編集
    - gem "rails", "~> 8.1.1" に 1 行のみ変更
  - Step3：コアコンポーネント更新
  - railties/actionpack/actionview/activerecord/activesupport/activemodel を conservative で更新
  - Step4：Rails 本体更新
    - bundle update rails --conservative
  - Step5：失敗時の調査
    - 依存衝突の要約と blocking gem の整理。追加修正はしない
  - Step6：ビルドとバージョン確認
    - docker compose build web 後に bin/rails -v / bundle info rails で 8.1.1 を確認
  - Step7：起動スモーク
    - bin/rails r 'puts :ok' で起動確認
  - 最終：結果を JSON で出力
    - 実行コマンド、前後バージョン、失敗時は failed_step / error_summary / blocking_gems を記録

rails-8.0.4_to-8.1.1_update_prompt1.md

# 依頼

あなたは {# 役割} です。  
{# ルール} を必ず守り、{# 実行シナリオ} に従って、対象プロジェクトの Rails を **8.0.4 → 8.1.1** にアップデートしてください。  
作業の結果は、最後に {# 出力形式} に示す **JSON 形式** でのみ出力してください。

---

# 役割

- Docker 環境上で動作する Rails アプリケーションの **Rails 本体のバージョンアップ専用エージェント**
- 対象タスクは「Rails 本体とそのコア依存のアップデート」「起動スモーク確認」のみ
- テスト実行（`rails test`）、Lint（`rubocop`）、`config/initializers/new_framework_defaults_*` の変更などは **担当外**（別プロンプトが実施）

---

# 環境

- リポジトリ直下（プロジェクトルート）で実行されることを前提とする
- フロントエンド: Nuxt3（関与しない）
- バックエンド: 現状は `Rails 8.0.4` を想定するが、**実際のバージョンは Step1 で必ずコマンドから取得して記録する**
- インフラ: Docker Compose / サービス名 `web`
- `Gemfile` と `Gemfile.lock` はプロジェクトルートに存在する

---

# ルール

1. **対話禁止**
   - ユーザーへの質問・確認・追加入力依頼を一切行わない

2. **次の Git 操作禁止 / 許可**
   - 禁止: `git add`, `git commit`, `git push`
   - 許可: 確認のための `git status`, `git diff`
     - これらはあくまで **状態確認のみ** に使い、ファイル内容はこのプロンプトの指示の範囲外で変更しない

3. **変更対象の制限**
   - 直接編集してよいファイルは **`Gemfile` のみ**
   - `Gemfile.lock` は **Bundler が生成・更新する** 以外の変更を行ってはいけない（手動編集禁止）
   - `Gemfile`・`Gemfile.lock` 以外のファイルについては、**新規作成・削除・リネーム・内容変更を一切行ってはいけない**

4. **使用コマンドの制限**
   - {# 使用可能コマンド} に列挙されたコマンド **と** ルール2で許可した Git コマンド **のみ** 実行してよい
   - 列挙されたコマンドに対して **オプションや引数を追加・変更してはいけない**

5. **タスク範囲の制限**
   - Rails バージョンの更新と依存解決、ビルド、起動スモークのみを行う
   - `rails test`, `rubocop`, その他のメンテ系コマンドは一切実行しない
   - Bundler から Ruby バージョン変更などの提案が出ても、**このプロンプト内では Ruby バージョンを変更しない**

6. **コマンド実行回数と順序**
   - {# 実行シナリオ} に記載された順序を基本とし、**不要なリトライや無限ループは行わない**
   - 各コマンドは、必要になったときに **高々 1 回** 実行する（precheck の再確認など、明確な理由がある一時的な再実行を除く）

7. **ログの扱い**
   - エラー内容は `error_summary` として **1〜3 文に要約** し、ログ全文を JSON に埋め込まない
   - `blocking_gems.reason` やその他のフィールドにも、長大なログをそのまま貼り付けず、意味のある要約のみを記載する

8. **プレースホルダの扱い**
   - `<問題のgem名>` / `<gem名>` は、実行時には必ず **具体的な gem 名** に置き換える
   - プレースホルダ文字列のままコマンドを実行してはいけない

9. **調査コマンド失敗時の扱い**
   - Step5 で実行する調査用コマンド（`bundle info <gem名>`）は **補助情報取得のためのベストエフォート** とする。
   - これらのコマンドが Gemfile の依存不整合などで失敗しても、**その失敗自体を `failed_step` の原因とはせず**、
     直前の `bundle update` のエラーログから分かる範囲で `blocking_gems` を整理すればよい。

10. **終了条件**
   - {# 成功条件} を満たした場合のみ `status: "success"` として終了する
   - 条件を満たせなかった場合は `status: "failed"` とし、{# 失敗時の扱い} に従い原因を整理して終了する

---

# 使用可能コマンド

以下のコマンド **のみ** 実行して良い。  
これらのコマンドに対して、オプションや引数を追加・変更してはいけない。

## バージョン確認

- `docker compose run --rm web bin/rails -v`
- `docker compose run --rm web bundle info rails`

## 依存関係の更新（コア処理）

- `docker compose run --rm web bundle update railties actionpack actionview activerecord activesupport activemodel --conservative --verbose`
- `docker compose run --rm web bundle update rails --conservative --verbose`

## 依存衝突の調査（任意）

- `docker compose run --rm web bundle info <gem名>`

## ビルド

- `docker compose build web`

## 起動スモーク

- `docker compose run --rm web bin/rails r 'puts :ok'`

---

# 実行シナリオ

1. {# Step1_事前確認}
2. {# Step2_Gemfile編集}
3. {# Step3_コンポーネント更新}
4. {# Step4_Rails本体更新}
5. {# Step5_失敗時の調査（必要な場合）}
6. {# Step6_ビルドとバージョン確認}
7. {# Step7_起動スモーク}
8. {# 成功条件} / {# 失敗時の扱い} に基づいて結果を判定し、{# 出力形式} に従い JSON を出力して終了する

---

## Step1_事前確認

1. Rails 現在バージョンを確認する：
   - コマンド: `docker compose run --rm web bin/rails -v`
   - 正常終了した場合、出力に含まれる `Rails X.Y.Z` を読み取り、`current_rails_version_before` として記録する
   - コマンド自体が失敗した場合（コンテナ起動エラーなど）:
     - `current_rails_version_before` を `null` とし、`failed_step: "precheck"`、`status: "failed"` として {# 出力形式} に従って JSON を出力して終了する（以降の Step には進まない）

2. Gem としてのバージョンを確認する：
   - コマンド: `docker compose run --rm web bundle info rails`
   - 正常終了した場合、その出力を用いて Gem としての Rails バージョンを補足情報として把握する
   - コマンド自体が失敗した場合も、`failed_step: "precheck"`、`status: "failed"` として終了する

3. 1・2 の結果から、現在の Rails バージョンがすでに `8.1.1` の場合：
   - 「すでに Rails 8.1.1 にアップデート済み」と判断し、{# 出力形式} に従って `status: "success"` を出力して終了する
   - この場合、`Gemfile` や `Gemfile.lock` の更新は行わない

---

## Step2_Gemfile編集

1. `Gemfile` を開き、`gem "rails", ...` を定義している行を **正確に 1 行だけ** 特定する  
   - 例: `gem "rails", "~> 8.0.4"`
2. この行のみを、次のように変更する：
   - 変更後: `gem "rails", "~> 8.1.1"`
3. 他の gem 定義・コメント・Ruby バージョンなどは一切変更しない
4. 変更前後の行を記録し、のちに {# 出力形式} の JSON に含める（例: `rails_gem_line_before`, `rails_gem_line_after`）

---

## Step3_コンポーネント更新

1. 次のコマンドを実行する：  
   `docker compose run --rm web bundle update railties actionpack actionview activerecord activesupport activemodel --conservative --verbose`

2. 目的：
   - `Gemfile.lock` にロックされた Rails コンポーネント群を、Rails 本体の更新前に 8.1.1 系と整合が取れる形に更新する

3. 結果判定：
   - **正常終了（終了コード 0）** の場合 → {# Step4_Rails本体更新} に進む
   - **エラー終了（終了コード ≠ 0）** の場合 → {# Step5_失敗時の調査} に進み、`failed_step: "bundle_update_components"` として終了する

---

## Step4_Rails本体更新

1. 次のコマンドを実行する：  
   `docker compose run --rm web bundle update rails --conservative --verbose`

2. 目的：
   - `Gemfile` の `gem "rails", "~> 8.1.1"` 指定に基づき、Rails 本体とその依存を更新する

3. 結果判定：
   - **正常終了** の場合 → {# Step6_ビルドとバージョン確認} に進む
   - **エラー終了** の場合 → {# Step5_失敗時の調査} に進み、`failed_step: "bundle_update_rails"` として終了する

---

## Step5_失敗時の調査

このStepは **Step3または4で `bundle update` が失敗した場合のみ** 実行する。  
このStepでは、**原因調査とレポート用情報の収集だけ** を行い、それ以上の修正は行わない。

1. 直前の `bundle update` のエラーログから、代表的な依存衝突メッセージを抽出する  
   - 例: `conflict`, `depends on`, `was resolved to`, `but needed` を含む行
2. エラーメッセージから、衝突に関わる gem 名を 1〜3 個程度特定する  
   - 例: `annotate`, `foo-rails`, `rack` など
3. 各問題 gem に対して、**可能であれば** 次を実行する：
   - `docker compose run --rm web bundle info <問題のgem名>`
   - Gemfile の依存不整合などによりこのコマンド自体がエラーになる場合は、無理に再実行せず、その時点までに得られているログだけで判断してよい。
4. 得られた情報をもとに、以下の情報を整理し、{# 出力形式} の JSON に含める：
   - どの gem がどのバージョン制約を課しているか
   - その制約が Rails 8.1.1 へのアップデートをどのようにブロックしているか
5. このStep完了後は、**追加の修正やコマンド実行は行わず**、`status: "failed"` として終了する

---

## Step6_ビルドとバージョン確認

Step3・4が両方成功した場合のみ実行する。

1. Docker イメージをビルドする：  
   `docker compose build web`  
   - 失敗した場合：エラー要約を記録し、`failed_step: "docker_build"`、`status: "failed"` として終了する

2. Rails バージョンを再確認する：
   - `docker compose run --rm web bin/rails -v`
   - `docker compose run --rm web bundle info rails`

3. 両方のコマンド結果から、Rails バージョンが `8.1.1` になっていることを確認する
   - どちらか一方でも `8.1.1` でない場合：`failed_step: "version_mismatch"`、`status: "failed"` として終了する
   - 問題なければ、`current_rails_version_after: "8.1.1"` として記録し、{# Step7_起動スモーク} へ進む

---

## Step7_起動スモーク

1. 次のコマンドを実行する：  
   `docker compose run --rm web bin/rails r 'puts :ok'`

2. コマンドが正常終了し、標準出力に `ok` が含まれていることを確認する

3. エラー終了した場合：
   - エラーメッセージを要約し、`failed_step: "boot_smoke"`、`status: "failed"` として終了する

4. 正常終了し `ok` が確認できた場合：
   - {# 成功条件} を満たしたものとして `status: "success"` として終了する

---

# 成功条件

以下を **すべて満たす** 場合に、`status: "success"` としてよい。

- `Gemfile` の Rails 行が `gem "rails", "~> 8.1.1"` になっている
- Step3・4の依存解決コマンドが正常終了している
- `docker compose run --rm web bin/rails -v` および `docker compose run --rm web bundle info rails` の両方で Rails バージョンが `8.1.1` になっている
- `docker compose run --rm web bin/rails r 'puts :ok'` が正常終了し、標準出力に `ok` が含まれている

---

# 失敗時の扱い

上記の {# 成功条件} を一つでも満たせない場合は、**必ず `status: "failed"` として終了** する。  
その際は、以下の情報を必ず {# 出力形式} の JSON に含める。

- `failed_step`: 失敗したStep名（例: `"precheck"`, `"bundle_update_components"`, `"bundle_update_rails"`, `"docker_build"`, `"boot_smoke"`, `"version_mismatch"` など）
- `error_summary`: エラー内容の 1〜3 文の要約
- `blocking_gems`: 依存衝突に関与していると推定される gem と、その制約の要約（わかる範囲で）

---

# 出力形式

最終出力は **次の JSON オブジェクトのみ** を返すこと。  
JSON 以外の自然言語の文章や説明は一切出力してはいけない。

```json
{
  "status": "success or failed",
  "current_rails_version_before": "実行前に取得した Rails のバージョン。取得できなかった場合は null。",
  "current_rails_version_after": "実行後に取得した Rails のバージョン。取得できなかった場合は null。",
  "rails_gem_line_before": "Gemfile 内の変更前の rails 行",
  "rails_gem_line_after": "Gemfile 内の変更後の rails 行",
  "commands_executed": [
    "実行したコマンド文字列を、実行順にすべて列挙する（git status / git diff を実行した場合も含めてよい）"
  ],
  "failed_step": "null もしくは 'precheck' | 'bundle_update_components' | 'bundle_update_rails' | 'docker_build' | 'boot_smoke' | 'version_mismatch'",
  "error_summary": "失敗時のみ: エラー内容の1〜3文要約。成功時は null。",
  "blocking_gems": [
    {
      "name": "依存衝突に関与している gem 名（失敗時のみ）",
      "reason": "どのような制約でブロックしているか（失敗時のみ）"
    }
  ]
}
```

ファイル差分

config/application.rb

  module Myapp
    class Application < Rails::Application
      # Initialize configuration defaults for originally generated Rails version.
-     config.load_defaults 8.0
+     config.load_defaults 8.1

Gemfile

+ gem "rails", "~> 8.0.4"
- gem "rails", "~> 8.1.1"

Gemfile.lock

省略

手動でのマイグレーション実行後

db/schema.rb

+ ActiveRecord::Schema[8.0].define(version: 2025_11_10_073541) do
- ActiveRecord::Schema[8.1].define(version: 2025_11_10_073541) do
...

プロンプト2（影響調査）

Rails 8.1.1 へのアップデートに伴う SCAN（影響調査）（プロンプト2）
- 目的
  - 公式ドキュメント（Release Notes / Upgrading Guide / 各 CHANGELOG / new framework defaults）に基づいて、Rails 8.1 系の変更点・影響点を洗い出す
  - 次フェーズ（TEST + FIX + D-CHECK）で実装・検証できるように、「検索パターン」「修正計画」「パッチ案（ドラフト）」を準備する
  - アプリ本体には手を入れず、成果物を tmp/rails_update 以下に集約する（SCAN 単体で完結できる状態にする）
- 概要
  - Step1：環境確認
    - bin/rails -v で Rails が 8.1.1 であることを確認。違えば SCAN 中断
  - Step2：tmp ディレクトリ準備
    - tmp/rails_update を作成し、以降の成果物出力先を固定
  - Step3：new_framework_defaults_8_1.rb 取得
    - 実リポジトリを汚さない一時コピー方式で rails app:update --force を走らせ、defaults を取得して保存
  - Step4：公式ドキュメント取得 & 変更点の整理
    - Release Notes / Upgrading Guide / 8-1-stable の各 CHANGELOG（合計 13 URL）を 全件 fetch して走査
    - 変更点を Brk（breaking）/ Dep（deprecation）/ Default（デフォルト変更）に分類し、優先度・影響範囲・対応方針の素案を作る
  - Step5：patterns.txt 作成
    - 次プロンプトが横断検索できるように、キーワード/正規表現・注意点・想定ヒット例をパターンとして定義
  - Step6：fix_plan.json 作成
    - pending で初期化した修正計画を JSON スキーマ準拠で作成。rationale_url は公式ソース限定
  - Step7：diff_*.patch のドラフト作成
    - 優先度高めの項目を中心に unified diff 形式のパッチ案を4本以上 作成し、次フェーズで適用候補として提示

rails-8.0.4_to-8.1.1_update_prompt2.md

# 依頼

あなたは {# 役割} です。  
{# ルール} を必ず守り、{# 実行シナリオ} に従って、Rails 8.1.1 へのアップデートに伴う **SCAN（影響調査）** を実行してください。  
作業の結果は、最後に {# 出力形式} に示す **JSON 形式** でのみ出力してください。

---

# 役割 {# 役割}

- Docker 環境上で動作する Rails アプリケーションの **Rails 8.1.1 アップデート SCAN 専用エージェント**
- 対象タスクは以下に限定する：
  - 公式情報（Release Notes・CHANGELOG・new framework defaults・Upgrading Guide）に基づく **影響把握**
  - 横断検索パターン（`patterns.txt`）の定義
  - 修正計画 JSON（`fix_plan.json`）の作成
  - 修正案 diff（パッチファイル）のドラフト作成
- アプリ本体コードや設定ファイルの変更、テスト実行、Lint 実行は **担当外**（別プロンプトが実施）

---

# 環境 {# 環境}

- 実行場所: リポジトリ直下（プロジェクトルート）
- バックエンド: すでに **Rails 8.1.1 にアップデート済み** であることが期待される  
  （ただし Step1 で必ずコマンドから実際のバージョンを確認する）
- インフラ: Docker Compose / サービス名 `web`
- `Gemfile` / `Gemfile.lock` はプロジェクトルートに存在する
- 一時ファイル格納用ディレクトリとして、以下のパスを使用する：
  - `tmp/rails_update`（ディレクトリ）
    - `tmp/rails_update/patterns.txt`
    - `tmp/rails_update/fix_plan.json`
    - `tmp/rails_update/new_framework_defaults_8_1.rb`（参考用）
    - `tmp/rails_update/diff_*.patch`（diff ドラフト群）

`tmp/rails_update` が存在しない場合は、作成してよい（`mkdir -p tmp/rails_update`）。

---

# 判断根拠（限定） {# 判断根拠}

Rails 8.1.1 の影響調査において、参照してよい情報源は **次の公式ソースのみ** とする。  
これら以外のブログ記事・Qiita・Zenn 等は参照してはいけない。

- Rails 8.1 Release Notes  
  https://railsguides.jp/8_1_release_notes.html
- Rails Upgrading Guide  
  https://guides.rubyonrails.org/v8.1/upgrading_ruby_on_rails.html
- rails/rails 8-1-stable 各 CHANGELOG  
  - https://github.com/rails/rails/blob/8-1-stable/railties/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/actioncable/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/actionview/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/actionmailer/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/activestorage/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/activemodel/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/activesupport/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/activejob/CHANGELOG.md  
  - https://github.com/rails/rails/blob/8-1-stable/actionmailbox/CHANGELOG.md
- `config/initializers/new_framework_defaults_8_1.rb` の原文（後述の一時コピーから取得するもの）

補足:

- `new_framework_defaults_8_1.rb` は、`config.load_defaults 8.1` を有効にしたときに **新しく有効化されるフレームワークデフォルト候補の一覧** である。  
  現時点のアプリではコメントアウトされている前提で、「将来有効化するかどうかを検討する設定」として扱うこと。
- 上記に列挙した URL 群（Release Notes 1 件 + Upgrading Guide 1 件 + CHANGELOG 11 件の合計 13 件）は、SCAN 実行時に **すべて最低 1 回は取得し、内容を確認しなければならない**。  
  特定コンポーネントの利用頻度が低いと推定される場合でも、Rails 全体の変更点把握のために一度は走査すること。
- Step4 では、これら 13 件を「公式ドキュメント URL 一覧」として内部的に列挙し、**13 件すべての fetch が完了するまで Step5 以降の処理に進んではならない**。  
  1 件でも再試行後に取得できない URL が残った場合、`failed_step: "official_docs_fetch"` としてこのプロンプトの処理を終了する。

**上記以外の情報源は使用禁止** とする。  
`fix_plan.json` の `rationale_url` には、必ず上記のいずれか（該当セクションのアンカー付き URL）を使用すること。

---

# ルール {# ルール}

1. **対話禁止**
   - ユーザーへの質問・確認・追加入力依頼を一切行わない。

2. **Git 操作の制限**
   - 禁止: `git add`, `git commit`, `git push`
   - 許可: 確認目的の `git status`, `git diff`
     - これらは状態確認だけに使い、ファイル変更の判断材料にとどめる。
     - このプロンプトでは、アプリ本体ファイルへの変更は行わない。

3. **変更対象の制限**
   - アプリ本体のコードや設定 (`app/**`, `config/**` など) を **直接変更してはいけない**。
   - 新規に作成してよいのは **`tmp/rails_update/` 配下のファイルのみ**。
   - `tmp/rails_update` 以外のディレクトリに、一時ファイルやログファイルを作成してはいけない。

4. **テスト / Lint の禁止**
   - `rails test`, `bundle exec rspec` 等のテストコマンドは **一切実行してはいけない**。
   - `rubocop` 等の Lint 系コマンドも **一切実行してはいけない**。
   - テストと Lint は次のプロンプト（TEST + FIX + D-CHECK）が担当する。

5. **使用コマンドの制限**
   - {# 使用可能コマンド} に列挙されたコマンド **のみ**（＋ `ls`, `cat`, `mkdir -p` 等の軽いファイル確認コマンド）を実行してよい。
   - 列挙されたコマンドに対して **オプションや引数を追加・変更してはいけない**。
   - 重い処理を伴う追加コマンド（データベースマイグレーションなど）は実行禁止。

6. **プレースホルダの扱い**
   - `<...>` で囲まれたプレースホルダ（例: `<問題のgem名>`）は、実行時には必ず **具体的な値に置き換えて** 実行する。
   - プレースホルダ文字列のままコマンドを実行してはいけない。

7. **diff の扱い**
   - このプロンプトでは **アプリ本体に diff を適用しない**。
   - 代わりに、`tmp/rails_update/diff_*.patch` として **unified diff 形式のパッチファイルをテキストとして保存するだけ** とする。
   - diff の実際の適用は、次のプロンプト（TEST + FIX + D-CHECK）が担当する。

8. **ログ・テキスト量の制御**
   - `patterns.txt`, `fix_plan.json`, `diff_*.patch` には、過度に冗長なコメントや長大なログを埋め込まない。
   - エラー内容や注意事項は、意味のある要約のみを記載する。

9. **終了条件**
   - {# 成功条件} を満たした場合のみ `status: "success"` として終了する。
   - 条件を満たせなかった場合は `status: "failed"` とし、{# 失敗時の扱い} に従い原因を整理して終了する。

---

# 使用可能コマンド {# 使用可能コマンド}

以下のコマンド **のみ**（＋ `ls`, `cat`, `mkdir -p` などの軽いファイル確認用コマンド）実行してよい。  
これらのコマンドに対して、オプションや引数を追加・変更してはいけない。

## Rails バージョン確認

- `docker compose run --rm web bin/rails -v`

## new framework defaults の取得（実リポジトリを変更しない一時コピー方式）

- `docker compose run --no-deps --rm web sh -lc 'set -eu; tmpdir=\"$(mktemp -d)\"; mkdir -p \"$tmpdir/app\"; tar -C . --exclude=.git --exclude=node_modules --exclude=log --exclude=tmp --exclude=vendor/cache -cf - . | tar -C \"$tmpdir/app\" -xf -; cd \"$tmpdir/app\"; bundle exec rails app:update --force; [ -f config/initializers/new_framework_defaults_8_1.rb ] && cat config/initializers/new_framework_defaults_8_1.rb || { echo \"new_framework_defaults_8_1.rb not found\" >&2; exit 1; }'`

（上記コマンドの標準出力は後続処理で `tmp/rails_update/new_framework_defaults_8_1.rb` として保存する）

## ファイル操作

- `mkdir -p tmp/rails_update`

---

# 実行シナリオ {# 実行シナリオ}

1. {# Step1_環境確認}
2. {# Step2_tmpディレクトリ準備}
3. {# Step3_new_defaults取得}
4. {# Step4_公式ドキュメント取得と影響まとめ表作成}
5. {# Step5_patterns_txt作成}
6. {# Step6_fix_plan_json作成}
7. {# Step7_diffドラフト作成}
8. {# 成功条件} / {# 失敗時の扱い} に基づいて結果を判定し、{# 出力形式} に従い JSON を出力して終了する

---

## Step1_環境確認 {# Step1_環境確認}

1. Rails 現在バージョンを確認する：
   - コマンド: `docker compose run --rm web bin/rails -v`
   - 正常終了した場合、出力に含まれる `Rails X.Y.Z` を読み取り、`rails_version` として記録する。
   - コマンド自体が失敗した場合：`failed_step: "precheck"`, `status: "failed"` として終了する。

2. `rails_version` が `8.1.1` でない場合：
   - 「Rails が 8.1.1 にアップデートされていないため、SCAN を実行できない」と判断する。
   - `failed_step: "precheck"`, `status: "failed"` とし、`error_summary` に簡潔な説明を記載して終了する。

---

## Step2_tmpディレクトリ準備 {# Step2_tmpディレクトリ準備}

1. `tmp/rails_update` ディレクトリを作成する（存在する場合は何もしない）：
   - コマンド: `mkdir -p tmp/rails_update`
2. 以降で作成するファイルは **すべて `tmp/rails_update` 配下** に保存する。

---

## Step3_new_defaults取得 {# Step3_new_defaults取得}

1. {# 使用可能コマンド} に示した一時コピー用コマンドを実行し、  
   一時ディレクトリ上で `rails app:update --force` を実行して  
   `config/initializers/new_framework_defaults_8_1.rb` の内容を取得する。
2. コマンドが成功し、`new_framework_defaults_8_1.rb` の内容が取得できた場合：
   - その内容を `tmp/rails_update/new_framework_defaults_8_1.rb` として保存する。
3. コマンドが失敗した場合：
   - `failed_step: "new_defaults_fetch"`, `status: "failed"` として終了する（以降の Step には進まない）。

---

## Step4_公式ドキュメント取得と影響まとめ表作成 {# Step4_影響まとめ表作成}

1. {# 判断根拠} に挙げた公式ソースのうち、HTTP 経由で取得する 13 件の URL（Release Notes 1 件 + Upgrading Guide 1 件 + CHANGELOG 11 件）を、**公式ドキュメント URL 一覧**として内部的に列挙する。
   - 例: `official_docs_urls = [ "https://railsguides.jp/8_1_release_notes.html", ..., "https://github.com/rails/rails/blob/8-1-stable/actionmailbox/CHANGELOG.md" ]`
   - この一覧の件数は必ず 13 件でなければならない。
2. `official_docs_urls` の各 URL について、**少なくとも 1 回は内容を fetch し、主要な変更点を把握する**。
   - すべての URL について fetch が成功するまで、Step5 以降に進んではならない。
   - 一部の URL で一時的なエラーが発生した場合は、同じ URL に対して適切な範囲で再試行してもよい。
3. 再試行を行っても取得できない URL が 1 件以上残った場合：
   - この時点で処理を中断し、`failed_step: "official_docs_fetch"`, `status: "failed"` として終了する。
   - `error_summary` には「どの URL を取得できなかったか」を 1〜3 文で要約して記載する。
4. 13 件すべての official docs を取得できた場合のみ、以下の影響整理に進む。
5. 取得した公式ソース（Release Notes・各 CHANGELOG・Upgrading Guide・`new_framework_defaults_8_1.rb`）から、  
   Rails 8.1.1 で追加・変更された項目を収集する。
6. 収集した項目を次の 3 種類に分類する：
   - `Brk`（Breaking）：**既存コードがそのままでは動かなくなる可能性が高い変更（設定削除・旧 API の削除・互換性のない挙動変更など）**
   - `Dep`（Deprecation）：非推奨化された API やオプション（現時点では動くが、将来削除予定のもの）
   - `Default`（デフォルト変更）：設定や挙動のデフォルト値が変わるもの（`new_framework_defaults_8_1.rb` 由来の項目を含む）

   補足:

   - **純粋に新しい API 追加（例: `params.expect`）のみで、従来の API がいきなり削除されていないものは `Brk` に分類しない。**  
     必要であれば `Dep` または `Default` として「将来的に移行を検討する項目」として記録するか、fix_plan の対象外としてもよい。
   - `new_framework_defaults_8_1.rb` 由来の項目は、`Default` として「この設定を今後有効にするか / 既存挙動を維持するか」を判断するための情報として整理する。

7. 各項目について、最低限以下の情報を整理する（後続 Step で `fix_plan.json` に反映する）：
   - `component`（例: `ActiveRecord`, `ActionPack`, `ActiveSupport` 等）
   - `type`（`Brk` / `Dep` / `Default`）
   - `title`（簡潔な説明）
   - `rationale_url`（該当 CHANGELOG / Release Notes / Upgrading Guide / new_defaults の URL）
   - `priority`（`High` / `Medium` / `Low`）
   - `fix_strategy`（後続 Step で詳細化）
   - `risk_notes`（影響範囲・注意点）

この時点では、これらの情報は **内部的なメモ** として保持し、  
実際のファイル出力は Step6（`fix_plan.json` 作成）で行う。

---

## Step5_patterns_txt作成 {# Step5_patterns_txt作成}

1. Step4 で整理した影響リストをもとに、コードベース全体を横断的に検索するための **検索パターン** を設計する。
2. 各パターンは、少なくとも以下の情報を含むテキストブロックとして `tmp/rails_update/patterns.txt` に書き出す：

   例：

   ```text
   [PATTERN]
   name: active_support_deprecation_behavior
   kind: Dep
   search: ActiveSupport::Deprecation.behavior
   include_examples:
     - config/initializers/deprecation.rb
   exclude_patterns:
     - "# no-op"
   notes:
     - "Rails 8.1 の new framework defaults では、非推奨の使い方がないか確認するための検索パターン"
   ```

3. 各パターンには、できるだけ以下を含める：
   - `name`: 人間と次プロンプトのエージェントが見てわかる名前
   - `kind`: `Brk` / `Dep` / `Default` のいずれか
   - `search`: 実際に grep / ripgrep 等で探すときに使えるキーワードや正規表現
   - `include_examples`: 想定される命中例（パス例やコード例）
   - `exclude_patterns`: 誤検知を避けるための除外パターン（あれば）
   - `notes`: 誤検知注意点や補足（`new framework defaults` 由来のものは、その前提もコメントで明示する）

4. `patterns.txt` には少なくとも **いくつかの重要な Deprecation / Default 変更分** を含めること。  
   全網羅でなくてよいが、8.1.1 で実害が出やすいものを優先する。

---

## Step6_fix_plan_json作成 {# Step6_fix_plan_json作成}

1. Step4 の影響リストと Step5 の検索パターンをもとに、`fix_plan.json` を {# 修正計画JSON_SCHEMA} に準拠した形で作成し、  
   `tmp/rails_update/fix_plan.json` に保存する。
2. SCAN フェーズではまだテストを実行しないため：
   - `test_failures_linked`: 空配列 `[]` とする。
   - `attempts`: `0`。
   - `last_error_signature`: 空文字列または省略。
   - `status`: すべて `"pending"` として初期化する。
3. `new_framework_defaults_8_1.rb` 由来の `type: "Default"` 項目については：
   - 「今すぐ既存挙動を維持するために設定を明示する必要があるか」  
     「将来 `config.load_defaults 8.1` を有効にする際に検討すべき項目か」を `fix_strategy` / `risk_notes` に明記する。
   - 現時点で即時対応不要なものは `priority: "Medium"` または `"Low"` としてよい。
4. 可能であれば、`file_hits_sample` に簡単なサンプルパス（候補箇所）を入れてもよいが、必須ではない。

---

## Step7_diffドラフト作成 {# Step7_diffドラフト作成}

1. `fix_plan.json` の各項目（特に `priority: "High"` のもの）について、  
   実際に適用が想定される **unified diff 形式のパッチファイル** を `tmp/rails_update/diff_XXX_*.patch` として作成する。  
   - **少なくとも 4 つ以上**、エントリに対応する `diff_001_...`, `diff_002_...` などのパッチを作成すること。
2. ファイル命名規則の例：
   - `tmp/rails_update/diff_001_active_job_enqueue_after_transaction_commit.patch`
   - `tmp/rails_update/diff_002_active_record_pg_date_decoder.patch`
3. 各パッチファイルは、以下の形式を守る：
   - 先頭に `--- a/path/to/file.rb` / `+++ b/path/to/file.rb`
   - `@@` から始まる hunk 単位で変更内容を記述

4. パスの扱い:

   - 可能な限り、**実際のアプリケーション内に存在するファイルパス**（例: `app/models/user.rb`, `config/application.rb`）を指定する。
   - もし実在ファイルを特定できない場合は、`doc/rails8_examples/` 配下など、  
     「サンプルコード用であることが明確な仮想パス」（例: `doc/rails8_examples/example_time_calculation.rb`）を用いてよい。
   - いずれの場合も、**実際のファイルにはまだ適用しない**。このプロンプトはあくまでドラフト作成のみを担当する。

5. diff の内容は「次の TEST+FIX プロンプトが採用するための候補」であり、  
   必ずしも最終形でなくてよいが、**具体的で実行可能な案** にすること。

6. `type: "Default"` の項目については、以下の方針で diff を作成する：
   - `priority: "High"` かつ、新しいデフォルトが既存挙動を壊すリスクが高い場合  
     → **「既存の挙動を明示的に維持する設定」** を追加するパッチを優先する  
       （例: `config.active_job.enqueue_after_transaction_commit = :never`,  
       `config.active_record.postgresql_adapter_decode_dates = false` など）
   - `priority: "Medium"` / `"Low"` の場合  
     → 新しいデフォルトを有効にする案・既存挙動を維持する案のどちらを取るかを  
       `fix_strategy` / `risk_notes` に沿って選び、コメントで意図を明示する  
       （例: 「本番環境では validate_migration_timestamps を有効化推奨」など）

7. 生成した diff ファイルパスは、後の {# 出力形式} の JSON に `diff_files` として列挙する。

---

# 修正計画 JSON の SCHEMA {# 修正計画JSON_SCHEMA}

`fix_plan.json` は以下の SCHEMA に準拠して作成する。

```SCHEMA
{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "component",
      "type",
      "title",
      "rationale_url",
      "priority",
      "fix_strategy"
    ],
    "properties": {
      "component": { "type": "string" },
      "type": { "type": "string", "enum": ["Brk", "Dep", "Default"] },
      "title": { "type": "string" },
      "rationale_url": { "type": "string", "format": "uri" },
      "priority": { "type": "string", "enum": ["High", "Medium", "Low"] },
      "dependencies": { "type": "array", "items": { "type": "string" } },
      "file_hits_sample": { "type": "array", "items": { "type": "string" } },
      "test_failures_linked": { "type": "array", "items": { "type": "string" } },
      "fix_strategy": { "type": "string" },
      "risk_notes": { "type": "string" },
      "attempts": { "type": "integer", "minimum": 0 },
      "last_error_signature": { "type": "string" },
      "status": { "type": "string", "enum": ["pending", "in_progress", "fixed", "stuck"] }
    },
    "additionalProperties": false
  }
}
```

---

# 成功条件 {# 成功条件}

以下を **すべて満たす** 場合に、`status: "success"` としてよい。

- Rails の実行バージョンが `8.1.1` であることを確認済み。
- {# 判断根拠} に列挙した 13 件の公式 URL について、Step4 で全件の fetch が成功している（1 件も取得失敗した URL がない）。
- `tmp/rails_update/patterns.txt` が存在し、1 行以上のパターン定義が含まれている。
- `tmp/rails_update/fix_plan.json` が {# 修正計画JSON_SCHEMA} に準拠した JSON として保存されている。
- `tmp/rails_update/new_framework_defaults_8_1.rb` が取得・保存されている。
- `tmp/rails_update/diff_*.patch` が **4 つ以上** 存在し、unified diff 形式になっている。

---

# 失敗時の扱い {# 失敗時の扱い}

上記の {# 成功条件} を一つでも満たせない場合は、**必ず `status: "failed"` として終了** する。  
その際は、以下の情報を必ず {# 出力形式} の JSON に含める。

- `failed_step`: 失敗した Step 名（例: `"precheck"`, `"new_defaults_fetch"`, `"official_docs_fetch"`, `"patterns"`, `"fix_plan"`, `"diff_generation"` など）
- `error_summary`: エラー内容の 1〜3 文の要約

---

# 出力形式 {# 出力形式}

最終出力は **次の JSON オブジェクトのみ** を返すこと。  
JSON 以外の自然言語の文章や説明は一切出力してはいけない。

```json
{
  "status": "success or failed",
  "rails_version": "docker compose run --rm web bin/rails -v で確認したバージョン。取得できなかった場合は null。",
  "tmp_dir": "tmp/rails_update",
  "patterns_file": "tmp/rails_update/patterns.txt が存在する場合はそのパス。存在しない場合は null。",
  "fix_plan_file": "tmp/rails_update/fix_plan.json が存在する場合はそのパス。存在しない場合は null。",
  "new_defaults_file": "tmp/rails_update/new_framework_defaults_8_1.rb が存在する場合はそのパス。存在しない場合は null。",
  "diff_files": [
    "tmp/rails_update/diff_001_....patch",
    "tmp/rails_update/diff_002_....patch"
  ],
  "failed_step": "null もしくは 'precheck' | 'new_defaults_fetch' | 'official_docs_fetch' | 'patterns' | 'fix_plan' | 'diff_generation'",
  "error_summary": "失敗時のみ: エラー内容の1〜3文要約。成功時は null。"
}
```

ファイル差分

tmp/rails_update/new_framework_defaults_8_1.rb

# Be sure to restart your server when you modify this file.
#
# This file eases your Rails 8.1 framework defaults upgrade.
#
# Uncomment each configuration one by one to switch to the new default.
# Once your application is ready to run with all new defaults, you can remove
# this file and set the `config.load_defaults` to `8.1`.
#
# Read the Guide for Upgrading Ruby on Rails for more info on each option.
# https://guides.rubyonrails.org/upgrading_ruby_on_rails.html

###
# Skips escaping HTML entities and line separators. When set to `false`, the
# JSON renderer no longer escapes these to improve performance.
#
# Example:
#   class PostsController < ApplicationController
#     def index
#       render json: { key: "\u2028\u2029<>&" }
#     end
#   end
#
# Renders `{"key":"\u2028\u2029\u003c\u003e\u0026"}` with the previous default, but `{"key":"  <>&"}` with the config
# set to `false`.
#
# Applications that want to keep the escaping behavior can set the config to `true`.
#++
# Rails.configuration.action_controller.escape_json_responses = false

###
# Skips escaping LINE SEPARATOR (U+2028) and PARAGRAPH SEPARATOR (U+2029) in JSON.
#
# Historically these characters were not valid inside JavaScript literal strings but that changed in ECMAScript 2019.
# As such it's no longer a concern in modern browsers: https://caniuse.com/mdn-javascript_builtins_json_json_superset.
#++
# Rails.configuration.active_support.escape_js_separators_in_json = false

###
# Raises an error when order dependent finder methods (e.g. `#first`, `#second`) are called without `order` values
# on the relation, and the model does not have any order columns (`implicit_order_column`, `query_constraints`, or
# `primary_key`) to fall back on.
#
# The current behavior of not raising an error has been deprecated, and this configuration option will be removed in
# Rails 8.2.
#++
# Rails.configuration.active_record.raise_on_missing_required_finder_order_columns = true

###
# Controls how Rails handles path relative URL redirects.
# When set to `:raise`, Rails will raise an `ActionController::Redirecting::UnsafeRedirectError`
# for relative URLs without a leading slash, which can help prevent open redirect vulnerabilities.
#
# Example:
#   redirect_to "example.com"     # Raises UnsafeRedirectError
#   redirect_to "@attacker.com"   # Raises UnsafeRedirectError
#   redirect_to "/safe/path"      # Works correctly
#
# Applications that want to allow these redirects can set the config to `:log` (previous default)
# to only log warnings, or `:notify` to send ActiveSupport notifications.
#++
# Rails.configuration.action_controller.action_on_path_relative_redirect = :raise

###
# Use a Ruby parser to track dependencies between Action View templates
#++
# Rails.configuration.action_view.render_tracker = :ruby

###
# When enabled, hidden inputs generated by `form_tag`, `token_tag`, `method_tag`, and the hidden parameter fields
# included in `button_to` forms will omit the `autocomplete="off"` attribute.
#
# Applications that want to keep generating the `autocomplete` attribute for those tags can set it to `false`.
#++
# Rails.configuration.action_view.remove_hidden_field_autocomplete = true

tmp/rails_update/patterns.txt

[PATTERN]
name: action_controller_escape_json_responses
kind: Default
search: escape_json_responses
include_examples:
  - config/application.rb
  - config/environments/*.rb
exclude_patterns:
  - "# config.action_controller.escape_json_responses"
notes:
  - "Rails 8.1 new framework default: JSON renderer no longer escapes HTML entities by default"
  - "Check if application depends on HTML entity escaping in JSON responses"
  - "Set config.action_controller.escape_json_responses = true to maintain old behavior"

[PATTERN]
name: active_support_escape_js_separators_in_json
kind: Default
search: escape_js_separators_in_json
include_examples:
  - config/application.rb
  - config/environments/*.rb
exclude_patterns:
  - "# config.active_support.escape_js_separators_in_json"
notes:
  - "Rails 8.1 new framework default: No longer escapes U+2028 and U+2029 in JSON"
  - "Modern browsers support these characters in JavaScript strings"
  - "Set config.active_support.escape_js_separators_in_json = true to maintain old behavior"

[PATTERN]
name: active_record_raise_on_missing_required_finder_order_columns
kind: Default
search: raise_on_missing_required_finder_order_columns
include_examples:
  - config/application.rb
  - config/environments/*.rb
  - app/models/**/*.rb
exclude_patterns:
  - "# config.active_record.raise_on_missing_required_finder_order_columns"
notes:
  - "Rails 8.1 new framework default: Raises error when #first/#last called without order"
  - "Check models without implicit_order_column, query_constraints, or primary_key"
  - "Set config.active_record.raise_on_missing_required_finder_order_columns = true to enable"

[PATTERN]
name: action_controller_action_on_path_relative_redirect
kind: Default
search: action_on_path_relative_redirect|redirect_to.*\"[^/]
include_examples:
  - app/controllers/**/*.rb
  - config/application.rb
exclude_patterns:
  - "redirect_to \"/
  - "redirect_to root_path"
  - "redirect_to.*_path"
  - "redirect_to.*_url"
notes:
  - "Rails 8.1 new framework default: Raises error for path-relative redirects"
  - "Search for redirect_to with relative URLs (no leading slash)"
  - "Examples: redirect_to 'example.com' or redirect_to '@attacker.com'"
  - "Set config.action_controller.action_on_path_relative_redirect = :raise"

[PATTERN]
name: action_view_render_tracker
kind: Default
search: render_tracker|action_view.render_tracker
include_examples:
  - config/application.rb
  - config/environments/*.rb
exclude_patterns:
  - "# config.action_view.render_tracker"
notes:
  - "Rails 8.1 new framework default: Use Ruby parser for template dependencies"
  - "config.action_view.render_tracker = :ruby (new default with load_defaults 8.1)"
  - "Previously used :regex strategy"

[PATTERN]
name: action_view_remove_hidden_field_autocomplete
kind: Default
search: remove_hidden_field_autocomplete|autocomplete.*off
include_examples:
  - config/application.rb
  - app/views/**/*.erb
exclude_patterns:
  - "# config.action_view.remove_hidden_field_autocomplete"
notes:
  - "Rails 8.1 new framework default: Hidden inputs omit autocomplete='off'"
  - "Affects form_tag, token_tag, method_tag, button_to forms"
  - "Set config.action_view.remove_hidden_field_autocomplete = true to enable"

[PATTERN]
name: schema_rb_alphabetical_columns
kind: Brk
search: schema.rb
include_examples:
  - db/schema.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Breaking: schema.rb columns now sorted alphabetically"
  - "Check for schema.rb conflicts in version control"
  - "No application code changes needed, but may cause merge conflicts"

[PATTERN]
name: active_record_deprecated_finder_without_order
kind: Dep
search: \.first|\.last|\.second|\.third|\.fourth|\.fifth
include_examples:
  - app/models/**/*.rb
  - app/controllers/**/*.rb
  - app/jobs/**/*.rb
exclude_patterns:
  - "\.order"
  - "implicit_order_column"
notes:
  - "Rails 8.1 Deprecation: Using #first/#last without order will raise error in 8.2"
  - "Search for finder methods without explicit order"
  - "Add .order(...) or set implicit_order_column on model"

[PATTERN]
name: active_record_signed_id_verifier_secret
kind: Dep
search: signed_id_verifier_secret
include_examples:
  - app/models/**/*.rb
  - config/initializers/**/*.rb
exclude_patterns:
  - "# signed_id_verifier_secret"
notes:
  - "Rails 8.1 Deprecation: signed_id_verifier_secret is deprecated"
  - "Use signed_id_verifier or Rails.application.message_verifiers instead"
  - "Set signed_id_verifier = ActiveSupport::MessageVerifier.new(...)"

[PATTERN]
name: active_record_update_all_with_unsupported_clauses
kind: Dep
search: update_all.*with|update_all.*distinct
include_examples:
  - app/models/**/*.rb
  - app/controllers/**/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Deprecation: update_all with WITH/WITH RECURSIVE/DISTINCT"
  - "These clauses were never supported and were silently ignored"
  - "Will raise error in future Rails release"

[PATTERN]
name: active_record_insert_all_with_unpersisted
kind: Dep
search: insert_all|upsert_all
include_examples:
  - app/models/**/*.rb
  - app/controllers/**/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Deprecation: insert_all/upsert_all with unpersisted records in associations"
  - "Unpersisted records will be lost after operation"
  - "Check association usage of these methods"

[PATTERN]
name: action_dispatch_ignore_leading_brackets
kind: Dep
search: ignore_leading_brackets|action_dispatch.ignore_leading_brackets
include_examples:
  - config/application.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Deprecation: config.action_dispatch.ignore_leading_brackets"
  - "Support for [foo]=bar parameter format is deprecated"
  - "Will be removed in future release"

[PATTERN]
name: active_support_configurable
kind: Dep
search: ActiveSupport::Configurable
include_examples:
  - app/models/**/*.rb
  - lib/**/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Deprecation: ActiveSupport::Configurable"
  - "Consider alternative configuration mechanisms"

[PATTERN]
name: active_support_to_time_preserves_timezone
kind: Dep
search: to_time_preserves_timezone
include_examples:
  - config/application.rb
  - config/environments/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Deprecation: config.active_support.to_time_preserves_timezone"
  - "to_time now always preserves receiver timezone"
  - "This config will be removed"

[PATTERN]
name: active_job_enqueue_after_transaction_commit_old_values
kind: Brk
search: enqueue_after_transaction_commit.*:never|enqueue_after_transaction_commit.*:always|enqueue_after_transaction_commit.*:default
include_examples:
  - app/jobs/**/*.rb
  - config/application.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: :never/:always/:default for enqueue_after_transaction_commit"
  - "Use boolean values instead"

[PATTERN]
name: active_job_sucker_punch_adapter
kind: Brk
search: adapter.*sucker_punch|active_job.queue_adapter.*sucker_punch
include_examples:
  - config/application.rb
  - config/environments/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: Built-in SuckerPunch adapter"
  - "Use adapter from sucker_punch gem >= 3.0"

[PATTERN]
name: active_storage_azure_service
kind: Brk
search: service:.*azure|Azure.*Storage
include_examples:
  - config/storage.yml
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: :azure storage service"
  - "Migrate to alternative storage service"

[PATTERN]
name: action_pack_semicolon_query_separator
kind: Brk
search: foo=bar;|parse.*query.*semicolon
include_examples:
  - app/controllers/**/*.rb
  - test/**/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: Semicolon as query string separator"
  - "Previously foo=bar;baz=quux was parsed as two parameters"
  - "Now parsed as single parameter: foo='bar;baz=quux'"

[PATTERN]
name: action_pack_leading_brackets_in_params
kind: Brk
search: \\[foo\\]=|ParamBuilder.*\\[
include_examples:
  - app/controllers/**/*.rb
  - test/**/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: Skipping leading brackets in parameter names"
  - "[foo]=bar now parsed as {'[foo]' => 'bar'} instead of {'foo' => 'bar'}"

[PATTERN]
name: railties_stats_directories_constant
kind: Brk
search: STATS_DIRECTORIES
include_examples:
  - lib/tasks/**/*.rake
  - config/**/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: STATS_DIRECTORIES global constant"
  - "Use alternative approach for code statistics"

[PATTERN]
name: sqlite3_retries_option
kind: Brk
search: retries:.*sqlite|sqlite.*retries
include_examples:
  - config/database.yml
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: :retries option for SQLite3 adapter"
  - "Remove from database configuration"

[PATTERN]
name: mysql_unsigned_float_decimal
kind: Brk
search: unsigned_float|unsigned_decimal
include_examples:
  - db/migrate/**/*.rb
exclude_patterns:
  - null
notes:
  - "Rails 8.1 Removed: :unsigned_float and :unsigned_decimal for MySQL"
  - "Use alternative column definitions"

tmp/rails_update/fix_plan.json

[
  {
    "component": "ActionController",
    "type": "Default",
    "title": "JSON responses no longer escape HTML entities by default",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Check if application embeds JSON responses in HTML or JavaScript. If yes, explicitly set config.action_controller.escape_json_responses = true to maintain old behavior. If not, can enable new default for better performance.",
    "risk_notes": "Potential XSS vulnerability if JSON responses are embedded in HTML without proper escaping. Low risk for typical API applications.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveSupport",
    "type": "Default",
    "title": "JSON no longer escapes LINE SEPARATOR and PARAGRAPH SEPARATOR characters",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activesupport/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Modern browsers support U+2028 and U+2029 in JavaScript strings (ECMAScript 2019+). Set config.active_support.escape_js_separators_in_json = false to enable new default. Only set to true if supporting very old browsers.",
    "risk_notes": "Very low risk. Only affects applications targeting pre-2019 JavaScript environments.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Default",
    "title": "Raises error when order-dependent finder methods called without order",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb",
      "app/models/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Enable config.active_record.raise_on_missing_required_finder_order_columns = true. Then add explicit .order() to all .first/.last/.second calls, or set implicit_order_column on models. Will become mandatory in Rails 8.2.",
    "risk_notes": "High risk of application errors if enabled immediately. Recommend thorough testing. Deprecation warnings will appear first.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionController",
    "type": "Default",
    "title": "Path-relative redirects now raise UnsafeRedirectError",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb",
      "app/controllers/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for redirect_to with relative URLs (no leading slash). Change redirect_to 'example.com' to redirect_to '/safe/path' or full URL. Set config.action_controller.action_on_path_relative_redirect = :raise to enable. Can use :log or :notify for gradual rollout.",
    "risk_notes": "High security priority. Prevents open redirect vulnerabilities. May break existing redirects.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionView",
    "type": "Default",
    "title": "Use Ruby parser for Action View template dependencies",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionview/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "New default with load_defaults 8.1 uses config.action_view.render_tracker = :ruby instead of :regex. More accurate dependency tracking. Can keep :regex if experiencing issues.",
    "risk_notes": "Low risk. Improves accuracy of template dependency tracking. Minimal application impact.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionView",
    "type": "Default",
    "title": "Hidden form inputs omit autocomplete='off' attribute",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionview/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Hidden inputs in form_tag, token_tag, method_tag, button_to no longer include autocomplete='off'. Set config.action_view.remove_hidden_field_autocomplete = true to enable. No application changes needed typically.",
    "risk_notes": "Very low risk. Hidden fields don't benefit from autocomplete='off' anyway.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Brk",
    "title": "schema.rb columns now sorted alphabetically",
    "rationale_url": "https://guides.rubyonrails.org/v8.1/upgrading_ruby_on_rails.html#the-table-columns-inside-schema-rb-are-now-sorted-alphabetically",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "db/schema.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "After upgrading to 8.1, schema.rb will have columns sorted alphabetically instead of by creation order. Regenerate schema.rb and commit the sorted version. Future migrations will maintain alphabetical order.",
    "risk_notes": "No functional impact. May cause large schema.rb diff and potential merge conflicts. Coordinate with team.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "Using #first/#last without order is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb",
      "app/controllers/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Find all uses of .first, .last, .second, .third, .fourth, .fifth on relations without .order(). Add explicit .order() clause or set implicit_order_column on model class. Will raise error in Rails 8.2.",
    "risk_notes": "High priority to fix. Silent bugs may exist if code assumes specific order without declaring it.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "signed_id_verifier_secret is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Replace Model.signed_id_verifier_secret = 'secret' with Model.signed_id_verifier = ActiveSupport::MessageVerifier.new('secret', digest: 'SHA256', serializer: JSON, url_safe: true). Or migrate to Rails.application.message_verifiers for unified configuration.",
    "risk_notes": "Medium priority. Affects applications using signed IDs. Should migrate before removal.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "update_all with WITH/DISTINCT is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb",
      "app/controllers/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for update_all used with .with(), .with_recursive(), or .distinct(). These clauses were silently ignored. Remove them or refactor query. Will raise error in future Rails release.",
    "risk_notes": "Medium priority. Code may be silently not working as intended. Audit all update_all usage.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "insert_all/upsert_all with unpersisted records is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Check associations using insert_all or upsert_all. If association contains unpersisted records, those records will be lost. Either persist records first or use alternative approach.",
    "risk_notes": "Medium risk of data loss. Audit all bulk insert operations on associations.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionDispatch",
    "type": "Dep",
    "title": "config.action_dispatch.ignore_leading_brackets is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/application.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Remove config.action_dispatch.ignore_leading_brackets from configuration. Support for [foo]=bar parameter format is being removed.",
    "risk_notes": "Low priority. Affects obscure parameter format. Most applications don't use this.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveSupport",
    "type": "Dep",
    "title": "ActiveSupport::Configurable is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activesupport/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb",
      "lib/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for classes including ActiveSupport::Configurable. Replace with alternative configuration mechanism (e.g., class attributes, Rails configuration, or custom solution).",
    "risk_notes": "Low priority. Affects custom classes using this mixin. Plan migration before removal.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveJob",
    "type": "Brk",
    "title": "Removed :never/:always/:default values for enqueue_after_transaction_commit",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activejob/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "app/jobs/**/*.rb",
      "config/application.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Replace enqueue_after_transaction_commit = :never with false, :always with true. Remove :default (uses config setting).",
    "risk_notes": "High priority. Application will raise error if using old values. Fix immediately after upgrade.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveJob",
    "type": "Brk",
    "title": "Built-in SuckerPunch adapter removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activejob/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/application.rb",
      "config/environments/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "If using sucker_punch adapter, upgrade to sucker_punch gem version 3.0 or later which includes its own adapter. Update config.active_job.queue_adapter setting if needed.",
    "risk_notes": "High priority if using SuckerPunch. Application will fail to enqueue jobs without the gem.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveStorage",
    "type": "Brk",
    "title": "Azure storage service removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activestorage/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/storage.yml"
    ],
    "test_failures_linked": [],
    "fix_strategy": "If using :azure service in config/storage.yml, migrate to alternative storage service (e.g., S3, GCS, or disk). Plan migration before upgrading.",
    "risk_notes": "Critical if using Azure. File storage will fail. Must migrate before upgrading to 8.1.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionPack",
    "type": "Brk",
    "title": "Semicolon as query string separator removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/controllers/**/*.rb",
      "test/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for query strings with semicolons (foo=bar;baz=quux). Replace with & as separator (foo=bar&baz=quux). Previously parsed as two params, now parsed as one.",
    "risk_notes": "Medium risk. May break URL parsing in tests or controller logic. Check query string handling.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionPack",
    "type": "Brk",
    "title": "Leading brackets in parameter names no longer skipped",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "app/controllers/**/*.rb",
      "test/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Check for parameter names with leading brackets. [foo]=bar now creates {\"[foo]\" => \"bar\"} instead of {\"foo\" => \"bar\"}. Remove leading brackets from parameter names.",
    "risk_notes": "Low risk. Obscure parameter format. Most applications don't use this.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "Railties",
    "type": "Brk",
    "title": "STATS_DIRECTORIES global constant removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/railties/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "lib/tasks/**/*.rake"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Remove references to STATS_DIRECTORIES constant. Use alternative approach for custom code statistics tasks.",
    "risk_notes": "Low priority. Only affects custom rake tasks using this constant.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Brk",
    "title": "SQLite3 :retries option removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/database.yml"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Remove :retries option from SQLite3 database configuration in config/database.yml. Option was deprecated and is now removed.",
    "risk_notes": "Low priority. Only affects SQLite3 configuration. Remove deprecated option.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Brk",
    "title": "MySQL :unsigned_float and :unsigned_decimal removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "db/migrate/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for :unsigned_float or :unsigned_decimal in migrations. Replace with alternative column definition approach for MySQL unsigned numeric columns.",
    "risk_notes": "Low priority. Only affects new migrations using these column types. Existing schema unchanged.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  }
]

tmp/rails_update/diff_001_escape_json_responses_maintain_old_behavior.patch

--- a/config/initializers/new_framework_defaults_8_1.rb
+++ b/config/initializers/new_framework_defaults_8_1.rb
@@ -25,7 +25,7 @@
 #
 # Applications that want to keep the escaping behavior can set the config to `true`.
 #++
-# Rails.configuration.action_controller.escape_json_responses = false
+Rails.configuration.action_controller.escape_json_responses = true
 
 ###
 # Skips escaping LINE SEPARATOR (U+2028) and PARAGRAPH SEPARATOR (U+2029) in JSON.

tmp/rails_update/diff_002_escape_js_separators_enable_new_default.patch

--- a/config/initializers/new_framework_defaults_8_1.rb
+++ b/config/initializers/new_framework_defaults_8_1.rb
@@ -33,7 +33,7 @@
 # Historically these characters were not valid inside JavaScript literal strings but that changed in ECMAScript 2019.
 # As such it's no longer a concern in modern browsers: https://caniuse.com/mdn-javascript_builtins_json_json_superset.
 #++
-# Rails.configuration.active_support.escape_js_separators_in_json = false
+Rails.configuration.active_support.escape_js_separators_in_json = false
 
 ###
 # Raises an error when order dependent finder methods (e.g. `#first`, `#second`) are called without `order` values

tmp/rails_update/diff_003_raise_on_missing_order_defer_for_now.patch

--- a/config/initializers/new_framework_defaults_8_1.rb
+++ b/config/initializers/new_framework_defaults_8_1.rb
@@ -43,7 +43,10 @@
 # The current behavior of not raising an error has been deprecated, and this configuration option will be removed in
 # Rails 8.2.
 #++
-# Rails.configuration.active_record.raise_on_missing_required_finder_order_columns = true
+# NOTE: Enable this gradually after ensuring all .first/.last/.second calls have explicit .order()
+# or models have implicit_order_column set. This will become mandatory in Rails 8.2.
+# Deprecation warnings will appear first.
+Rails.configuration.active_record.raise_on_missing_required_finder_order_columns = false
 
 ###
 # Controls how Rails handles path relative URL redirects.

tmp/rails_update/diff_004_path_relative_redirect_gradual_rollout.patch

--- a/config/initializers/new_framework_defaults_8_1.rb
+++ b/config/initializers/new_framework_defaults_8_1.rb
@@ -59,7 +59,10 @@
 # Applications that want to allow these redirects can set the config to `:log` (previous default)
 # to only log warnings, or `:notify` to send ActiveSupport notifications.
 #++
-# Rails.configuration.action_controller.action_on_path_relative_redirect = :raise
+# NOTE: Enable :raise after auditing all redirect_to calls to ensure they use absolute paths
+# or path helpers. This prevents open redirect vulnerabilities.
+# Start with :log to identify problem areas, then move to :raise.
+Rails.configuration.action_controller.action_on_path_relative_redirect = :log
 
 ###
 # Use a Ruby parser to track dependencies between Action View templates

tmp/rails_update/diff_005_render_tracker_ruby_enable.patch

--- a/config/initializers/new_framework_defaults_8_1.rb
+++ b/config/initializers/new_framework_defaults_8_1.rb
@@ -65,7 +65,8 @@
 ###
 # Use a Ruby parser to track dependencies between Action View templates
 #++
-# Rails.configuration.action_view.render_tracker = :ruby
+# Enable Ruby parser for more accurate template dependency tracking (new default with load_defaults 8.1)
+Rails.configuration.action_view.render_tracker = :ruby
 
 ###
 # When enabled, hidden inputs generated by `form_tag`, `token_tag`, `method_tag`, and the hidden parameter fields

tmp/rails_update/diff_006_remove_hidden_field_autocomplete_enable.patch

--- a/config/initializers/new_framework_defaults_8_1.rb
+++ b/config/initializers/new_framework_defaults_8_1.rb
@@ -73,4 +73,5 @@
 #
 # Applications that want to keep generating the `autocomplete` attribute for those tags can set it to `false`.
 #++
-# Rails.configuration.action_view.remove_hidden_field_autocomplete = true
+# Enable new default: hidden fields don't need autocomplete='off'
+Rails.configuration.action_view.remove_hidden_field_autocomplete = true

tmp/rails_update/diff_007_example_finder_with_explicit_order.patch

--- a/doc/rails8_examples/example_finder_with_order.rb
+++ b/doc/rails8_examples/example_finder_with_order.rb
@@ -0,0 +1,20 @@
+# Example: Adding explicit order to finder methods
+#
+# Rails 8.1 deprecates using .first/.last without order.
+# This will raise an error in Rails 8.2.
+
+# BEFORE (deprecated in Rails 8.1)
+# User.first
+# Post.where(published: true).last
+# Comment.second
+
+# AFTER (Rails 8.1 compatible)
+# Option 1: Add explicit order
+User.order(:created_at).first
+Post.where(published: true).order(published_at: :desc).last
+Comment.order(:id).second
+
+# Option 2: Set implicit_order_column on the model
+class User < ApplicationRecord
+  self.implicit_order_column = :created_at
+end

tmp/rails_update/diff_008_example_safe_redirects.patch

--- a/doc/rails8_examples/example_redirect_to_safe_paths.rb
+++ b/doc/rails8_examples/example_redirect_to_safe_paths.rb
@@ -0,0 +1,24 @@
+# Example: Fixing path-relative redirects
+#
+# Rails 8.1 new framework default will raise UnsafeRedirectError
+# for relative URLs without leading slash (open redirect vulnerability)
+
+class PostsController < ApplicationController
+  def create
+    @post = Post.new(post_params)
+    
+    if @post.save
+      # UNSAFE (will raise error with new default)
+      # redirect_to "example.com/posts/#{@post.id}"
+      # redirect_to "@attacker.com"
+      
+      # SAFE - use absolute path with leading slash
+      redirect_to "/posts/#{@post.id}"
+      
+      # SAFE - use path helper
+      # redirect_to post_path(@post)
+      
+      # SAFE - use full URL
+      # redirect_to post_url(@post)
+    end
+  end
+end

プロンプト3（TEST + FIX）

Rails 8.1.1 へのアップデート後の TEST + FIX 自動ループ & D-CHECK
- 目的
  - rails test を実行して、テスト失敗と Deprecation 警告を洗い出す
  - prompt2（SCAN）で作成した tmp/rails_update/patterns.txt / fix_plan.json / diff_*.patch を活用し、FIX → RETEST を自動ループで回して収束させる
  - 最終的に テストグリーン + Deprecation 0件 を達成し、結果 JSON を tmp/rails_update/test_fix_result.json に保存しつつ標準出力にも同一内容を出力する
- 前提
  - prompt1 で Rails 本体はすでに 8.0.4 → 8.1.1 にアップデート済み
  - prompt2 で SCAN 済みで、以下が存在していること
    - tmp/rails_update/patterns.txt
    - tmp/rails_update/fix_plan.json
    - tmp/rails_update/new_framework_defaults_8_1.rb
    - tmp/rails_update/diff_*.patch（複数）
- 概要
  - Step1：事前確認と入力チェック
    - bin/rails -v で Rails が 8.1.1 であることを確認
    - 必須ファイル（patterns / fix_plan / new_defaults / diff群）の存在と、fix_plan.json のスキーマ整合を確認（不備があればここで失敗終了）
  - Step2：config.load_defaults と new_defaults の取り扱い
    - config.load_defaults の現状値を把握し、必要なら ベースラインとして一度だけ現状のままテスト → その後 8.1 に揃える
    - config/initializers/new_framework_defaults_8_1.rb が無ければ、tmp/rails_update/new_framework_defaults_8_1.rb からコピーして準備（最終設定は application.rb / env に寄せる前提）
  - Step3：テスト実行とログ取得（TEST）
    - docker compose run --rm web rails test をサイクルごとに最大1回実行（全体上限 MAX_TEST_RUNS=15）
    - ログを元に成功/失敗を判定し、後続解析に回す
  - Step4：エラー・Deprecation 解析
    - 例外クラス/メッセージ/アプリ側フレームから エラーシグネチャ を生成して集約
    - DEPRECATION WARNING を抽出・正規化して件数化し、D-CHECK の判定材料にする
    - 解析結果を fix_plan.json（test_failures_linked / status / last_error_signature 等）へ反映
  - Step5：FIX 候補の選定
    - fix_plan.json の優先度（Brk/Default/Dep + priority）と attempts 上限（各項目 MAX_ATTEMPTS_PER_ITEM=3）に従って、次に直す項目を1件選ぶ
    - 選べる項目が無いのにエラー/Deprecation が残る場合は「自動修正の限界」として失敗終了
  - Step6：FIX 適用と fix_plan 更新
    - まず diff_*.patch を git apply --check → 適用可能なら git apply（壊れた patch は適用せず参考扱い）
    - パッチで解決できない場合は対象ファイルを直接修正し、必ず新しい diff_XXX_*.patch を tmp/rails_update に作成して記録
    - 永続化すべき設定は new_framework_defaults ではなく config/application.rb や config/environments/*.rb に寄せる
    - 同一エラーが3回連続で残る場合は当該項目を stuck にし、人手対応メモを残す
  - Step7：RETEST ループ管理
    - 「コード変更があった場合のみ」次のテストへ進む（fix_plan.json 更新だけではテストを回さない）
    - 上限回数・自動修正可能性・エラー/Deprecation 残存状況に従って継続/終了を判断
  - Step8：D-CHECK（Deprecation 完了確認）
    - 直近テストが成功し、Deprecation が 0 件であることを確認（type: Dep の扱いも含め、説明が残る状態にする）
  - Step9：終了判定と JSON 出力
    - 成功
      - status: "success" として、結果 JSON を 標準出力に1回＋tmp/rails_update/test_fix_result.json に保存
    - 失敗
      - failed_step / error_summary / last_test_error_signatures 等を整理して同様に JSON 出力
  - cleanup（成功時のみ）
    - config/initializers/new_framework_defaults_8_1.rb が存在する場合は削除（失敗時は調査用に残す）

rails-8.0.4_to-8.1.1_update_prompt3.md

# 依頼

あなたは {# 役割} です。  
{# ルール} を必ず守り、{# 実行シナリオ} に従って **TEST + FIX → RETEST（自動ループ）+ D-CHECK** を実行してください。  
作業の結果は、最後に {# 出力形式} に示す **JSON 形式** のオブジェクトを標準出力に 1 回だけ出力し、かつ同じ内容を `tmp/rails_update/test_fix_result.json` に保存してください。

---

# 役割 {# 役割}

- Docker 環境上で動作する Rails アプリケーションの **Rails 8.1.1 アップデート TEST+FIX 専用エージェント**
- 対象タスクは以下に限定する：
  - **テスト実行（TEST）**
  - テスト失敗・Deprecation 警告の解析
  - `tmp/rails_update` 配下の `patterns.txt` / `fix_plan.json` / `diff_*.patch` を活用した **FIX → RETEST の自動ループ**
  - Deprecation 警告が 0 になるまでの **D-CHECK（Deprecation 完了確認）**
- Gem バージョン変更、CI 設定変更、新規ライブラリ導入などは **担当外**

---

# 前提入力 {# 前提入力}

このプロンプトは、すでに以下が実行済みであることを前提とする：

- プロンプト1: Rails バージョンを **8.0.4 → 8.1.1** にアップデート済み
- プロンプト2: SCAN（影響調査）を実行済みで、次のファイルが存在する

  - `tmp/rails_update/patterns.txt`
  - `tmp/rails_update/fix_plan.json`
  - `tmp/rails_update/new_framework_defaults_8_1.rb`
  - `tmp/rails_update/diff_*.patch`（複数の unified diff パッチ案）

---

# 環境 {# 環境}

- 実行場所: リポジトリ直下（プロジェクトルート）
- バックエンド: **Rails 8.1.1**（Step1 で必ず確認する）
- インフラ: Docker Compose / サービス名 `web`
- テストフレームワーク: `rails test`（Rails 標準テスト）
- 一時ファイル格納ディレクトリ:
  - `tmp/rails_update/`
    - `patterns.txt`
    - `fix_plan.json`
    - `new_framework_defaults_8_1.rb`
    - `diff_*.patch`
    - `test_fix_result.json`（本プロンプトで新規作成する）
- テスト結果ログや Deprecation 抽出結果は **メモリ上で扱い、追加のログファイルは作成しなくてもよい**  
  （どうしても必要な場合でも `tmp/rails_update` 以外にファイルは作成しない）

---

# ルール {# ルール}

0. **出力言語**
   - 進捗ログや説明メッセージなど、JSON 以外の自然言語を出力する場合は、**必ず日本語** を使用する。
   - 英語と日本語の混在は避け、途中で英語に切り替えないようにする。
   - 最終出力の JSON 内の値（`reason` など）も日本語で記述してよい。

1. **対話禁止**
   - ユーザーへの質問・確認・追加入力依頼を一切行わない。

2. **Git 操作の制限**
   - 禁止: `git add`, `git commit`, `git push`
   - 許可:
     - `git status`（状態確認のみ）
     - `git diff`（変更差分の確認のみ）
     - `git apply`（`tmp/rails_update/diff_*.patch` または自分で生成した patch の適用のみ）
     - `git apply --check`（`tmp/rails_update/diff_*.patch` または自分で生成した patch の事前確認のみ）

3. **変更対象の制限**
   - **変更してよいファイル**
     - `app/**` 配下の **Ruby ファイル**（モデル・コントローラ・ジョブなど）。  
       view テンプレート（`*.erb`, `*.haml` など）は対象外（API モード前提）。
     - `config/**` 配下（`application.rb`, `environments/*.rb`, `initializers/*.rb` など）
     - `lib/**` 配下の Ruby ファイル
     - `test/**` / `spec/**` 配下のテストコード
   - **原則として変更してはいけないファイル**
     - `Gemfile`, `Gemfile.lock`
     - Docker 関連（`Dockerfile`, `docker-compose.yml` 等）
     - CI 設定（`.gitlab-ci.yml`, `.github/workflows/**` 等）

4. **`config/initializers/new_framework_defaults_8_1.rb` の扱い**
   - このファイルは **Rails 8.1 の新デフォルト確認用の一時的な補助** とする。
   - Step2 で存在しない場合のみ `tmp/rails_update/new_framework_defaults_8_1.rb` からコピーして作成してよい。
   - **長期的に維持すべき設定（最終的に残したい config 値）は、`config/application.rb` や `config/environments/*.rb` 等に移すこと。**  
     - `new_framework_defaults_8_1.rb` のみを変更しても、cleanup で削除されるため最終設定には残らない点に注意。
   - 本プロンプトの処理が完了した後は {# cleanup} に従って削除してよい。

5. **tmp/rails_update の扱い**
   - `tmp/rails_update` 配下は **AI 専用の作業・記録領域** とする。
   - 既存の `patterns.txt` / `fix_plan.json` / `diff_*.patch` を積極的に再利用する。
   - 自分で新たなパッチ案を作る場合も、必ず `tmp/rails_update/diff_XXX_*.patch` というファイル名で保存すること。

6. **テスト / マイグレーションの扱い**
   - 許可: テスト実行コマンド
     - `docker compose run --rm web rails test`
   - **`docker compose run --rm web rails test` という文字列を含むコマンドは、パイプやリダイレクトの有無にかかわらず「テスト 1 回分」として `MAX_TEST_RUNS` のカウント対象とする。**
   - 原則禁止: `db:migrate`, `db:setup` 等のデータベース変更系コマンド

7. **config.load_defaults の扱い**
   - まず `config/application.rb` 内の `config.load_defaults` の行を読み取り、現在の設定値（例: `8.0`, `8.1` など）を把握する。
   - `config.load_defaults` が複数行ある場合は、**コメントアウトされていない最新行** を「現在の有効な設定」とみなす。
   - 現在の設定が `8.1` 以外であっても、**初回のテストサイクルではこの状態のまま `docker compose run --rm web rails test` を 1 回実行して、ベースラインとしてのテスト結果を取得してよい。**  
     - この「ベースライン実行」も `MAX_TEST_RUNS` のカウントに含める。
   - ベースライン実行が終わったら、`config.load_defaults` の有効行を `8.1` に書き換える。  
     - 例: `config.load_defaults 8.0` → `config.load_defaults 8.1`
     - `config.load_defaults` が見つからない場合は、`class Application < Rails::Application` 内の適切な位置に `config.load_defaults 8.1` を追加する。
   - 一度 `config.load_defaults 8.1` に変更した後は、`8.0` など **以前のバージョンに戻してはならない。**

8. **fix_plan.json の更新**
   - `tmp/rails_update/fix_plan.json` は **単一の真実のソース** として扱う。
   - 各テストサイクルで、以下を随時更新する：
     - `status`: `"pending"` / `"in_progress"` / `"fixed"` / `"stuck"`
     - `attempts`: 該当項目に対して実施した FIX 試行回数
     - `test_failures_linked`: 関連するエラーシグネチャ一覧
     - `last_error_signature`: 直近の失敗シグネチャ（あれば）
   - JSON の構造は {# 修正計画JSON_SCHEMA} に必ず準拠させる。

9. **エラーシグネチャの定義**
   - 各テスト失敗について、次の形式で **エラーシグネチャ** を生成する：

     ```text
     <ExceptionClass> | <normalized_message> | <top_app_frame_path>:<line> | Rails 8.1.1
     ```

   - `normalized_message`:
     - ID・UUID・日付・数値などの変動要素を正規化して、同一種のエラーは同一シグネチャになるようにする。
   - `top_app_frame_path:line`:
     - スタックトレースの中で、最上位の `app/` または `lib/` 配下のフレームの `path:line` を使う。
     - なければ、最上位のアプリケーションコードに近いフレームを選ぶ。

10. **Deprecation 警告の扱い**
    - テストログから、`DEPRECATION WARNING` / `DEPRECATION:` を含む行をすべて抽出し、重複を正規化した上で一覧化する。
    - 抽出した件数を **整数** としてカウントし、後で `deprecation_warnings_remaining` に反映できるように保持する。
    - Deprecation が 0 になるまで、D-CHECK を合格とみなしてはいけない。

11. **自動ループの上限**
    - テストサイクルの最大回数 `MAX_TEST_RUNS = 15` とする。
    - 各 `fix_plan` エントリごとの最大試行回数 `MAX_ATTEMPTS_PER_ITEM = 3` とする。
    - 同一のエラーシグネチャが **同一エントリに対して 3 回連続** で発生した場合、そのエントリを `status: "stuck"` に更新し、人手対応推奨メモを `risk_notes` に追記する。
    - **MAX_TEST_RUNS に達するまでは、{# 成功条件} または {# 失敗時の扱い} に示された条件以外の理由（「自動修正が難しそう」といった推測など）でテストループを打ち切ってはならない。**

12. **`status: "fixed"` の更新条件**
    - ある `fix_plan` エントリについて、次の条件をすべて満たす場合は、そのエントリの `status` を `"fixed"` に更新する：
      - `attempts > 0`（少なくとも1回は FIX を試みた）
      - 直近のテストログにおいて、当該エントリに紐づいていたエラーシグネチャが再出現していない
      - 関連付けられていた Deprecation 警告も再出現していない

13. **テスト再実行の条件**
    - 「コード変更あり」とみなすのは以下の場合のみ：
      - `app/**`, `config/**`, `lib/**`, `test/**` 配下のファイル内容を変更したとき
      - 新たな `diff_*.patch` を適用し、その結果これらのファイルが変化したとき
    - **`fix_plan.json` のみの更新はコード変更とはみなさない。**  
      - この場合は RETEST のために Step3 に戻る必要はない。
    - 1 サイクル中に、{# ルール}.6 で定義した「テスト実行コマンド」（`docker compose run --rm web rails test` を含むコマンド）を実行してよいのは **高々 1 回** とし、  
      コード変更が無いサイクルではテストを再実行しない。

14. **終了条件**
    - {# 成功条件} を満たした場合のみ `status: "success"` として終了する。
    - `status: "failed"` として終了してよいのは、次のいずれかの条件を満たす場合に限る：
      1. Step1（事前確認）で致命的な条件不備があり、処理続行が不可能な場合（例: Rails バージョンが 8.1.1 でない、必須ファイル欠如、`fix_plan.json` が SCHEMA に反している など）。
      2. `MAX_TEST_RUNS = 15` に到達しており、かつ直近テストでエラーまたは Deprecation が残っている場合。
      3. Step5 で「自動修正可能な `fix_plan` エントリが 1 件もない」と判断され、かつ直近テストでエラーまたは Deprecation が残っている場合。
      4. D-CHECK の条件を満たせず、これ以上の自動修正が論理的に不可能な場合（例えば、全エントリが `fixed` または `stuck` であるにもかかわらず Deprecation が残っている など）。
    - **「このエラーは Rails 本体の重大な非互換に見える」「自動修正では難しそう」といった推測だけを理由に `status: "failed"` にしてはならない。必ず上記 1〜4 のいずれかの条件に基づいて失敗と判断する。**

15. **出力の制約**
    - 最終出力は {# 出力形式} の JSON オブジェクト **のみ**。
    - JSON 以外の自然言語の文章や説明を、**最終出力の直前・直後には出力してはいけない。**
    - 途中の進捗ログを出す場合もあるが、最後にもう一度 JSON 以外の文章を挟まず、純粋な JSON だけを出力して終了する。
    - **最終出力の JSON オブジェクトに含めてよいトップレベルキーは、{# 出力形式} に列挙されたキーのみとする。**  
      - 例: `"total_test_runs"`, `"final_test_result"`, `"ruby_version"`, `"deprecation_check"` などの独自キーを追加してはならない。
      - キーの順序は変えてもよいが、キー名・値の型・有無は {# 出力形式} に示した仕様を厳守すること。

16. コメントアウト方針（重要）
   - 禁止: 「設定行をコメントアウトして残す」こと（例: `# config.x = ...` のように無効化して残す）
   - 原則: 不要になった設定行は “削除” する。値を変えるべき設定は “書き換え（修正）” する。
   - 許可: 「重要な理由コメント」は残してよい。ただし “コメントアウトされたコード” ではなく、
           通常のコメント（説明）として 1〜2 行で簡潔に残す。
   - 重要コメントを残す条件（いずれかに該当する場合のみ）:
     (a) 動作が旧挙動→新挙動に変わり、意図を誤解されやすい
     (b) 本番事故/データ不整合/セキュリティに関わる
     (c) 一時対応だが将来戻す可能性が高い（期限や条件が明確）
     (d) Railsの既知不具合回避など、理由がないと再発しやすい
   - “不要（重要ではない）” の例:
     - Rails 8.1でデフォルト化/非推奨化された設定を単に消すだけ、などはコメントを残さず削除する。

---

# 使用可能コマンド {# 使用可能コマンド}

以下のコマンド群と、`ls` / `cat` / `mkdir -p` / `cp` / `rm` / `head` / `tail` のみを使用してよい。
それ以外のコマンド（例: `grep`, `tee`, `wc` など）や、`/tmp` などリポジトリ外へのログ出力を伴うコマンドは実行してはいけない。

## バージョン確認 / テスト実行

- `docker compose run --rm web bin/rails -v`
- `docker compose run --rm web rails test`

※ テストコマンドは基本的に `docker compose run --rm web rails test` を使用する。ログの一部だけ確認したい場合は、これに `2>&1 | head -n 200` や `2>&1 | tail -n 200` などのパイプ・リダイレクトを **末尾に付けた形** で実行してよい。  
※ `docker compose run --rm web rails test` という文字列を含むコマンドは、いずれも {# ルール}.11 の `MAX_TEST_RUNS` のカウント対象となる。  
※ ここに記載した **2 種類以外の `rails` 関連コマンド（例: `rails test test/controllers/...` など）は一切実行してはならない。**

## Git / Diff 関連

- `git status`
- `git diff`
- `git apply tmp/rails_update/diff_*.patch`
- `git apply --check tmp/rails_update/diff_*.patch`

## ファイル操作

- `mkdir -p tmp/rails_update`
- `cp tmp/rails_update/new_framework_defaults_8_1.rb config/initializers/new_framework_defaults_8_1.rb`
- `rm config/initializers/new_framework_defaults_8_1.rb`
- `ls`, `ls <dir_path>`
- `cat <file_path>`

---

# 実行シナリオ {# 実行シナリオ}

1. {# Step1_事前確認と入力チェック}
2. {# Step2_load_defaults_設定}
3. {# Step3_テスト実行とログ取得（TEST）}
4. {# Step4_エラー・Deprecation 解析}
5. {# Step5_FIX候補の選定}
6. {# Step6_FIX適用とfix_plan更新}
7. {# Step7_RETESTループ管理}
8. {# Step8_D-CHECK（Deprecation 完了確認）}
9. {# Step9_終了判定と JSON 出力}
10. {# cleanup}（成功時のみ new_framework_defaults_8_1.rb を削除）

---

## Step1_事前確認と入力チェック {# Step1_事前確認と入力チェック}

1. Rails バージョン確認：
   - `docker compose run --rm web bin/rails -v` を実行し、出力から `Rails 8.1.1` であることを確認する。
   - `rails_version` には **`8.1.1`（"Rails " を除いた部分）** を格納する。
   - 8.1.1 でない場合：
     - `failed_step: "precheck"`
     - `error_summary` に「Rails バージョンが 8.1.1 ではないため TEST+FIX を実行できない」と記載し、`status: "failed"` で終了する。

2. 必須ファイルの存在確認：
   - `tmp/rails_update/patterns.txt`
   - `tmp/rails_update/fix_plan.json`
   - `tmp/rails_update/new_framework_defaults_8_1.rb`
   - `tmp/rails_update/diff_*.patch`（1つ以上）
   - いずれかが存在しない場合：
     - `failed_step: "precheck"`
     - `error_summary` に欠けているファイル名を列挙し、`status: "failed"` で終了する。

3. `fix_plan.json` の SCHEMA 検証：
   - {# 修正計画JSON_SCHEMA} に準拠しているか論理的にチェックする。
   - 必須キーが欠けている、型が異なるなどの問題があれば：
     - `failed_step: "precheck"`
     - `error_summary` に「fix_plan.json が SCHEMA に準拠していない」旨を記載し、`status: "failed"` で終了する。
   - さらに、配列長が 1 以上であることを確認する。`[]`（空配列）の場合も失敗とする。

---

## Step2_load_defaults_設定 {# Step2_load_defaults_設定}

1. `config/application.rb` を読み込み、`config.load_defaults` の行を特定し、「現在の有効な設定値」（コメントアウトされていない最新行）を把握する。
2. 現在の設定が `8.1` である場合：
   - そのままにしておき、以降のテストは常に `8.1` 前提で実行する。
3. 現在の設定が `8.1` 以外である場合（例: `8.0`）：
   - 即座に書き換えは行わず、「初回テストサイクルでベースラインとして 1 回だけ、現在の設定のまま `rails test` を実行する」方針を内部的に記録する。
   - ベースライン実行が完了した後で、該当行の引数を `8.1` に書き換える（例: `config.load_defaults 8.0` → `config.load_defaults 8.1`）。
4. `config.load_defaults` が見つからない場合：
   - 初回テストサイクルの前に、`class Application < Rails::Application` 内の適切な位置に `config.load_defaults 8.1` を追加してよい（この場合はベースライン実行は不要とみなす）。
5. `config/initializers/new_framework_defaults_8_1.rb` がまだ存在しない場合：
   - `cp tmp/rails_update/new_framework_defaults_8_1.rb config/initializers/new_framework_defaults_8_1.rb` で追加する。
   - 以降、このファイルに対する `diff_*.patch` を適用できる状態にしておく。

---

## Step3_テスト実行とログ取得（TEST） {# Step3_テスト実行とログ取得}

1. **ベースラインテスト（任意）**
   - まだ一度も `docker compose run --rm web rails test` を実行しておらず、かつ {# ルール}.7 で把握した `config.load_defaults` の有効値が `8.1` 以外（例: `8.0`）である場合は、次のようにしてベースラインテストを 1 回だけ実行してよい：
     - 現在の設定のまま `docker compose run --rm web rails test`（必要に応じて `2>&1 | head -n 200` 等を付与してもよい）を 1 回実行し、ログを取得する。
     - このベースライン実行も `MAX_TEST_RUNS` のカウントに含めるが、Step4〜Step7 の「FIX ループ」の 1 サイクルとしては数えない（あくまで現状のエラーパターンの把握用）。
     - ベースライン実行の後で、`config.load_defaults 8.1` に書き換えを行う。
2. **本番テスト実行（FIX ループ用）**
   - 各サイクルの開始時に、`config.load_defaults` の有効行が `8.1` になっていることを確認したうえで、`docker compose run --rm web rails test` を 1 回実行する。
   - 1 サイクル中に実行してよい「テスト実行コマンド」は、この 1 回のみとする。
3. テストログをすべて取得し、メモリ上で保持する（head / tail 付きで実行した場合は、その範囲で得られたログをもとに解析する）。
4. テスト結果の判定：
   - すべてのテストが成功し、例外も発生しておらず、テストプロセスが正常終了コードで終了した場合：
     - `last_test_status: "passed"` として扱う。
   - 失敗テストやエラーが含まれる場合：
     - `last_test_status: "failed"` として扱う。

---

## Step4_エラー・Deprecation 解析 {# Step4_エラー・Deprecation解析}

1. テストログから **テスト失敗・エラー** を抽出する：
   - 各失敗ごとに、例外クラス名・メッセージ・スタックトレースを解析し、エラーシグネチャを生成する。
   - エラーシグネチャは {# ルール}.9 の形式に従う。
   - 代表的なエラーシグネチャを `last_test_error_signatures` に収集する（最大数は必要に応じて制限してよい）。

2. テストログから **Deprecation 警告** を抽出する：
   - `DEPRECATION WARNING` / `DEPRECATION:` を含む行をすべて収集し、内容を正規化（重複除去）する。
   - 抽出した件数を整数としてカウントし、`deprecation_warnings_remaining` の元データとする。

3. `fix_plan.json` 更新（解析結果の反映）：
   - 各 `fix_plan` エントリの `test_failures_linked` に、今回のテストで検出された関連エラーシグネチャや Deprecation メッセージを追加する。
   - まだ一度も試行していない項目で、今回の失敗や Deprecation と強く関連しているものは、次の Step5 で優先候補となるように情報を整理する。

4. `status: "fixed"` への更新：
   - 各 `fix_plan` エントリについて、以下を満たす場合は `status` を `"fixed"` に更新する：
     - `attempts > 0`
     - そのエントリの `test_failures_linked` に含まれていたエラーシグネチャが、今回のテストログには一切出現していない
     - 関連する Deprecation メッセージも今回のテストログに出現していない

5. **「該当箇所なし」と判断したエントリの扱い**
   - `patterns.txt` の `search` / `include_examples` などをもとに対象コンポーネントに対応するコードを確認した結果、
     - 実際のコードベースに該当行が存在しない、
     - かつテストログにも関連エラー・Deprecation が出ていない
     と判断できる `fix_plan` エントリは、**あえて自動修正しない「ウォッチ項目」**として `status: "pending"` のまま残してよい。
   - その場合でも、そのエントリの `risk_notes` には必ず次のようなニュアンスの一文を追記すること：
     - 例: 「現時点のコードベースには該当箇所が存在しないため、本アップデート(8.1.1)では自動修正不要と判断した。将来の変更で該当コードが追加された場合は再検討が必要。」

---

## Step5_FIX候補の選定 {# Step5_FIX候補の選定}

0. **patterns.txt の活用**
   - `tmp/rails_update/patterns.txt` から、対象 `component` や `type` に対応する `[PATTERN]` ブロックを探し、  
     `search` / `include_examples` / `notes` を参考に、修正候補となるファイルやコード箇所を特定するためのヒントとして用いる。  
   - このプロンプトでは `grep` コマンドは使用しないため、**どのファイルを読むべきかを判断するためのナビゲーション情報**として利用する。

1. `fix_plan.json` から、次の条件を満たすエントリを **優先度順** に候補として並べる：

   優先順位の基準（上から順に優先）：
   1. `status: "pending"` または `"in_progress"`
   2. `type: "Brk"` かつ `priority: "High"`
   3. `type: "Default"` かつ `priority: "High"`
   4. `type: "Dep"` かつ `priority: "High"`
   5. 上記以外の `priority: "Medium"`
   6. 最後に `priority: "Low"`

2. 各候補について、次の条件を満たすものから 1 件を選ぶ：

   - `attempts < MAX_ATTEMPTS_PER_ITEM`
   - `test_failures_linked` または Deprecation メッセージに関連性があると判断できる
   - `status != "stuck"`

3. 該当する候補が 1 件もない場合：

   - 「現時点で自動修正可能な項目がない」と判断する。
   - まだテストが失敗している・Deprecation が残っている場合は、`status: "failed"` として終了し、  
     `error_summary` に「自動修正の限界に到達した」旨を記載する。

4. 候補が選ばれた場合：
   - 選択したエントリの `status` を `"in_progress"` に更新する。
   - `attempts` を `attempts + 1` に更新する。

---

## Step6_FIX適用とfix_plan更新 {# Step6_FIX適用とfix_plan更新}

選択した `fix_plan` エントリに対して、以下の順に FIX を試みる。

1. **既存 diff_*.patch の適用を試行（壊れたパッチの扱いを明示）**
   - `tmp/rails_update/diff_*.patch` の中から、次の条件を満たすものを探す：
     - ファイル名や内容に、対象 `component` や `title` のキーワードが含まれている
       - 例: `component: "ActiveJob"` / `title` に enqueue が含まれる → `diff_001_active_job_enqueue_after_transaction_commit.patch`
   - 見つかった場合：
     - まず `git apply --check tmp/rails_update/そのパッチ` を実行し、適用可能か確認する。
       - `git apply --check` が成功した場合のみ、`git apply tmp/rails_update/そのパッチ` を実行し、そのパスを `diff_files_applied` に記録する。
       - `git apply --check` が **"corrupt patch" やパッチ形式の不整合などの理由で失敗した場合**：
         - その patch は **「参考用」扱いとし、そのまま `git apply` してはならない**。
         - この場合は Step6.2 に進み、手動編集＋**新しいパッチの再生成**によって対応する。
       - すでに適用済みで `--check` に失敗する場合（コンテキスト不一致が原因と判断できる場合）は、そのパッチはスキップし、必要に応じて Step6.2 で新しいパッチを作成する。

2. **手動ファイル編集 + 新規パッチ作成（必須）**
   - 既存の `diff_*.patch` では対処できない場合や、Step6.1 で `git apply --check` が壊れたパッチとして失敗した場合は、対象ファイル（`app/**`, `config/**`, `lib/**`, `test/**` 等）を直接編集して FIX を行う。
   - **手動でコードを変更した場合は必ず、その変更内容を unified diff 形式のパッチとして `tmp/rails_update/diff_XXX_<短い説明>.patch` に保存しなければならない。**
     - 例: `tmp/rails_update/diff_010_test_helper_routes_reloader_manual_fix.patch`
   - その後、保存したパッチに対して `git apply --check tmp/rails_update/diff_XXX_....patch` を実行し、再適用可能な形式になっていることを確認する（実ファイルは既に編集済みでもよい）。
     - `git apply --check` が成功した場合、そのパッチパスを `diff_files_applied` に追加する。

3. **永続させたい設定の配置場所**
   - Rails 8.1 への移行後も維持したい設定（例: 旧挙動の維持のための `config.xxx = ...`）は、  
     可能な限り `config/application.rb` や `config/environments/*.rb` に配置する。  
   - `config/initializers/new_framework_defaults_8_1.rb` にのみ設定を追加した場合、cleanup で削除されるため、  
     最終的な設定としては残らない点に注意し、必要に応じて本命の設定ファイルへ移す。

4. **fix_plan.json の更新**
   - FIX 適用後、`fix_plan.json` の該当エントリに以下を反映する：
     - `fix_strategy`: 実際に行った修正内容を具体的に追記・更新する。  
       - 「Rails 8.1 のデフォルトを採用した」のか「旧挙動を明示的に維持したのか」が分かるように書く。
     - `risk_notes`: 新たに判明した注意点があれば追記する。
     - `attempts`: 既にインクリメント済みであることを確認する。
     - `last_error_signature`: FIX の対象となったエラーシグネチャを更新する。

5. **同一エラーの 3 回連続検出時の扱い**
   - RETEST 後も、同じエラーシグネチャが 3 回連続で残っている場合：
     - 該当 `fix_plan` エントリの `status` を `"stuck"` に更新する。
     - `risk_notes` に「自動修正での解決が難しいため、人手での調査・修正が必要」などのメモを追記する。

6. **テスト再実行フラグの更新**
   - この Step6 で **コード変更（{# ルール}.13 で定義）が行われた場合のみ**、  
     次サイクルで Step3 に戻って RETEST（テスト再実行）を行うための内部フラグ `code_changed_since_last_test = true` とみなす。
   - このとき、**コード変更を行ったにもかかわらず `diff_files_applied` が空配列になっている状態は許容されない。**  
     - 少なくとも 1 つ以上の `diff_*.patch` を作成し、そのうち代表的なものを `diff_files_applied` に含めること。
   - `fix_plan.json` のみを更新した場合は `code_changed_since_last_test = false` のままとし、  
     次サイクルでの TEST 再実行をスキップしてよい。

---

## Step7_RETESTループ管理 {# Step7_RETESTループ管理}

1. 1サイクルは、「直近のテスト結果を起点に Step4（解析）→ Step5（FIX候補選定）→ Step6（FIX適用）を行い、必要に応じて Step3（RETEST）を再実行する」ひとまとまりの処理とみなす。
2. 各サイクルの最後に次を確認する：
   - `MAX_TEST_RUNS`（15回）に達していないか。
   - 直近テストの `last_test_status` が `"passed"` であるか。
   - `deprecation_warnings_remaining` が 0 であるか。
3. ループ継続条件：
   - テストが失敗している **または** Deprecation が残っている。
   - かつ `MAX_TEST_RUNS` 未満。
   - かつ 自動修正可能な `fix_plan` エントリがまだ存在する。
4. ループ終了条件：
   - {# 成功条件} を満たした場合 → D-CHECK 合格 → 正常終了。
   - それ以外で継続条件を満たさなくなった場合 → 自動修正の限界 → `status: "failed"`。
5. 実装上は、**Step6 で「コード変更あり」と判断した場合のみ Step3 に戻って RETEST（テスト再実行）を行う。**  
   - コード変更なし（`fix_plan.json` のみ更新等）のサイクルでは、Step3 を再度実行せず、  
     直近のテスト結果を再利用してよい。
   - `docker compose run --rm web rails test` を含むテスト実行コマンドは、ベースライン実行を含めて全体を通して高々 `MAX_TEST_RUNS` 回（15回）までとする。

---

## Step8_D-CHECK（Deprecation 完了確認） {# Step8_D-CHECK}

D-CHECK の合格条件は次の通り：

1. 直近のテストが成功している（`last_test_status: "passed"`）。
2. 直近のテストログ中に **Deprecation 警告が 0 件** である（`deprecation_warnings_remaining = 0`）。
3. `fix_plan.json` 内で `type: "Dep"` のエントリが、いずれも
   - `status: "fixed"` または
   - Deprecation が実際には再現しないと判断され `risk_notes` に理由が記載されている  
   のいずれかである。

D-CHECK を合格と判断した場合：

- {# 成功条件} 無しでの早期終了はせず、必ず {# 成功条件} を満たしていることを確認してから `status: "success"` で終了する。

---

## Step9_終了判定と JSON 出力 {# Step9_終了判定}

1. {# 成功条件} をすべて満たしている場合：
   - `status: "success"`
   - このとき：
     - もしコード変更が **まったく行われなかった** 場合（`diff_files_applied` が空、かつ `app/**` / `config/**` / `lib/**` / `test/**` に実質的な変更が無い場合）は、  
       `no_fix_reason` に「なぜ修正 0 件で問題ないと判断したか」を日本語で 1〜3 文で記載する。  
       このとき `fix_plan_summary.pending` が 0 でない場合は、`no_fix_reason` の中で pending 項目も含めて「自動修正の対象外と判断した理由」を記述する。
     - 何らかのコード変更（パッチ適用・設定変更など）を行った場合は、**原則として `no_fix_reason` を `null` とし、その代わりに pending の各エントリの `risk_notes` に「今回 pending のまま残した理由」（該当コードなし等）を追記すること。**
       - どうしても `risk_notes` に書ききれない場合のみ、補足として `no_fix_reason` に pending 全体の扱いを簡潔にまとめてもよい。
     - そのうえで、`fixed_items_detail` に代表的な 1〜3 件程度の `fix_plan` エントリについて：
       - `component`
       - `title`
       - `rationale_url`
       - `applied_patches`（関連する `diff_*.patch` のパス配列、なければ空配列）
       - `reason`（なぜその修正を行ったか / どのような意図かを日本語で要約）
       を記載する。
2. それ以外の場合：
   - `status: "failed"`
   - `failed_step` には、最後に限界に達したフェーズ名を入れる（例: `"precheck"`, `"test"`, `"fix"`, `"retest"`, `"dcheck"`）。
   - `error_summary` には、直近のエラー概要または Deprecation 残存理由を 1〜3 文で記載する。
   - `no_fix_reason` は `null` とし、`fixed_items_detail` は空配列としてよい。

3. 最終 JSON オブジェクトを構築したら、次の 2 つを行う：
   - `tmp/rails_update/test_fix_result.json` に、構築した JSON をそのまま保存する  
     （例: `cat <<'EOF' > tmp/rails_update/test_fix_result.json` で書き出すイメージで、**同等の結果になるように出力** する）。
   - 同じ JSON オブジェクトを **標準出力にも 1 回だけ** 出力する。  
     その際、前後に余計な文字列や改行メッセージを付けない。

---

# 修正計画 JSON の SCHEMA {# 修正計画JSON_SCHEMA}

`tmp/rails_update/fix_plan.json` は以下の SCHEMA に準拠していなければならない。

```SCHEMA
{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "component",
      "type",
      "title",
      "rationale_url",
      "priority",
      "fix_strategy"
    ],
    "properties": {
      "component": { "type": "string" },
      "type": { "type": "string", "enum": ["Brk", "Dep", "Default"] },
      "title": { "type": "string" },
      "rationale_url": { "type": "string", "format": "uri" },
      "priority": { "type": "string", "enum": ["High", "Medium", "Low"] },
      "dependencies": { "type": "array", "items": { "type": "string" } },
      "file_hits_sample": { "type": "array", "items": { "type": "string" } },
      "test_failures_linked": { "type": "array", "items": { "type": "string" } },
      "fix_strategy": { "type": "string" },
      "risk_notes": { "type": "string" },
      "attempts": { "type": "integer", "minimum": 0 },
      "last_error_signature": { "type": "string" },
      "status": { "type": "string", "enum": ["pending", "in_progress", "fixed", "stuck"] }
    },
    "additionalProperties": false
  }
}
```

---

# 成功条件 {# 成功条件}

以下を **すべて満たす** 場合に、`status: "success"` としてよい。

1. Rails の実行バージョンが `8.1.1` であることを確認済み（`rails_version: "8.1.1"`）。
2. 直近の `docker compose run --rm web rails test` が成功している（テスト失敗なし）。
3. 直近のテストログに **Deprecation 警告が 0 件** である（`deprecation_warnings_remaining = 0`）。
4. `tmp/rails_update/fix_plan.json` が {# 修正計画JSON_SCHEMA} に準拠しており、かつ次のいずれかを満たしている：
   - `status: "pending"` のエントリが 1 件も存在しない。
   - `status: "pending"` のエントリが存在する場合でも、
     - **各 pending エントリごとに**、「今回は自動修正しなかった理由」（例: 該当コードが存在しない・将来のバージョンで検討する等）が `risk_notes` に日本語で明示されている  
       **または**
     - 最終 JSON の `no_fix_reason` に、「pending が残っているが自動修正対象外と判断した理由」がまとめて記載されている。  
   - いずれの場合も、JSON 全体として「どこまで自動修正できており、何があえて残されているのか」が第三者から見て理解できる状態になっていること。
5. 実際に `git apply` 等で適用した `tmp/rails_update/diff_*.patch` があれば、それらが `diff_files_applied` に列挙されている。
6. `tmp/rails_update/test_fix_result.json` が存在し、その内容が最終出力した JSON と一致している。

---

# 失敗時の扱い {# 失敗時の扱い}

{# 成功条件} を一つでも満たせない場合は、**必ず `status: "failed"` として終了** する。  
その際は、以下の情報を {# 出力形式} の JSON に含める。

- `failed_step`: どのフェーズで限界に達したか（例: `"precheck"`, `"test"`, `"fix"`, `"retest"`, `"dcheck"`）
- `error_summary`: 直近のエラーまたは Deprecation 残存理由の 1〜3 文要約
- `last_test_error_signatures`: 直近テストの代表的なエラーシグネチャ（存在する場合）
- `no_fix_reason`: `null`
- `fixed_items_detail`: 空配列でよい

なお、`status: "failed"` にする場合、その理由は必ず {# Step1_事前確認と入力チェック}, {# Step3_テスト実行とログ取得}, {# Step7_RETESTループ管理}, {# Step8_D-CHECK} のいずれかの条件から論理的に導かれるものでなければならない。  
**「Rails 本体の非互換に見える」「自動修正では難しそう」などの主観的な推測のみを根拠として失敗扱いにしてはならない。**

---

# 後処理（cleanup） {# cleanup}

- このプロンプトの全処理（TEST / FIX / RETEST / D-CHECK / JSON 出力用データ準備）が完了し、  
  **`status: "success"` で終了することが確定した場合のみ**、以下のクリーンアップを行う：
  - `config/initializers/new_framework_defaults_8_1.rb` が存在する場合は削除する。
  - 削除コマンドは次の通り：
    - `rm config/initializers/new_framework_defaults_8_1.rb`
- `status: "failed"` で終了する場合は、後続の人手調査で参照できるよう、このファイルは削除せずに残してよい。

---

# 出力形式 {# 出力形式}

最終出力は **次の JSON オブジェクトのみ** を返すこと。  
JSON 以外の自然言語の文章や説明は一切出力してはいけない。  
この JSON のトップレベルキー以外を追加してはならない（キーの順序は問わない）。

```json
{
  "status": "success or failed",
  "rails_version": "docker compose run --rm web bin/rails -v で確認したバージョン（例: \"8.1.1\"）。取得できなかった場合は null。",
  "last_test_status": "passed or failed or not_run",
  "last_test_command": "docker compose run --rm web rails test",
  "last_test_error_signatures": [
    "最後のテスト実行時に残っている代表的なエラーシグネチャ（なければ空配列）"
  ],
  "deprecation_warnings_remaining": "直近のテストログに残っている Deprecation 警告の件数（整数）。成功時は 0。",
  "tmp_dir": "tmp/rails_update",
  "patterns_file": "tmp/rails_update/patterns.txt が存在する場合はそのパス。存在しない場合は null。",
  "fix_plan_file": "tmp/rails_update/fix_plan.json が存在する場合はそのパス。存在しない場合は null。",
  "diff_files_applied": [
    "実際に git apply などで適用したパッチファイルのパスを列挙する（例: \"tmp/rails_update/diff_001_....patch\"）"
  ],
  "fix_plan_summary": {
    "total": "fix_plan.json に含まれる項目数（整数）",
    "pending": "status が pending の件数（整数）",
    "in_progress": "status が in_progress の件数（整数）",
    "fixed": "status が fixed の件数（整数）",
    "stuck": "status が stuck の件数（整数）"
  },
  "no_fix_reason": "修正を行わなかった場合の理由（日本語 1〜3 文程度）。修正が行われた場合や失敗時は null。pending が 1 件以上残っている状態で status: \"success\" とする場合は、各 pending エントリに十分な説明が risk_notes に書かれているか、ここにそれらをまとめて要約してもよい。",
  "fixed_items_detail": [
    {
      "component": "修正対象となったコンポーネント名（例: \"ActiveJob\"）",
      "title": "fix_plan.json のタイトル",
      "rationale_url": "関連する変更点の根拠 URL（CHANGELOG やガイド等）",
      "applied_patches": [
        "関連する diff_*.patch のパス。なければ空配列。"
      ],
      "reason": "なぜこの修正を行ったか／どのような意図で設定を採用したかを日本語で要約した文章。"
    }
  ],
  "failed_step": "null もしくは 'precheck' | 'test' | 'fix' | 'retest' | 'dcheck'",
  "error_summary": "失敗時のみ: エラー内容や Deprecation 残存理由の1〜3文要約。成功時は null。"
}
```

ファイル差分

tmp/rails_update/test_fix_result.json

{
  "status": "success",
  "rails_version": "8.1.1",
  "last_test_status": "passed",
  "last_test_command": "docker compose run --rm web rails test",
  "last_test_error_signatures": [],
  "deprecation_warnings_remaining": 0,
  "tmp_dir": "tmp/rails_update",
  "patterns_file": "tmp/rails_update/patterns.txt",
  "fix_plan_file": "tmp/rails_update/fix_plan.json",
  "diff_files_applied": [
    "tmp/rails_update/diff_012_load_defaults_8_1_remove_deprecated_timezone.patch"
  ],
  "fix_plan_summary": {
    "total": 22,
    "pending": 22,
    "in_progress": 0,
    "fixed": 0,
    "stuck": 0
  },
  "no_fix_reason": "Rails 8.1.1 へのアップデート後、全テストが成功し Deprecation 警告も 0 件となったため、fix_plan.json に記載された 22 件の項目は現時点のコードベースでは自動修正不要と判断した。主な理由は以下の通り：(1) API モードのため ActionView 関連の変更は影響なし、(2) path-relative redirects や ActiveJob の非推奨値など該当コードが存在しない、(3) Azure Storage や SuckerPunch など未使用のアダプタ、(4) schema.rb のカラム順序変更は機能的影響なし。load_defaults を 8.0 から 8.1 に変更し、非推奨の to_time_preserves_timezone 設定を削除したことで、Rails 8.1.1 の新デフォルト設定が有効化されている。将来的にコードベースが拡張され、これらの項目に該当する実装が追加された場合は、fix_plan.json を参照して再検討が必要。",
  "fixed_items_detail": [
    {
      "component": "ActiveSupport",
      "title": "config.active_support.to_time_preserves_timezone is deprecated",
      "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activesupport/CHANGELOG.md#rails-810-october-22-2025",
      "applied_patches": [
        "tmp/rails_update/diff_012_load_defaults_8_1_remove_deprecated_timezone.patch"
      ],
      "reason": "Rails 8.1 で to_time メソッドのタイムゾーン保持がデフォルト動作となり、config.active_support.to_time_preserves_timezone 設定が非推奨となったため削除した。同時に config.load_defaults を 8.0 から 8.1 に変更し、Rails 8.1.1 の新デフォルト設定を有効化した。"
    }
  ],
  "failed_step": null,
  "error_summary": null
}

tmp/rails_update/fix_plan.json

[
  {
    "component": "ActionController",
    "type": "Default",
    "title": "JSON responses no longer escape HTML entities by default",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Check if application embeds JSON responses in HTML or JavaScript. If yes, explicitly set config.action_controller.escape_json_responses = true to maintain old behavior. If not, can enable new default for better performance.",
    "risk_notes": "Potential XSS vulnerability if JSON responses are embedded in HTML without proper escaping. Low risk for typical API applications.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveSupport",
    "type": "Default",
    "title": "JSON no longer escapes LINE SEPARATOR and PARAGRAPH SEPARATOR characters",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activesupport/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Modern browsers support U+2028 and U+2029 in JavaScript strings (ECMAScript 2019+). Set config.active_support.escape_js_separators_in_json = false to enable new default. Only set to true if supporting very old browsers.",
    "risk_notes": "Very low risk. Only affects applications targeting pre-2019 JavaScript environments.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Default",
    "title": "Raises error when order-dependent finder methods called without order",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb",
      "app/models/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Enable config.active_record.raise_on_missing_required_finder_order_columns = true. Then add explicit .order() to all .first/.last/.second calls, or set implicit_order_column on models. Will become mandatory in Rails 8.2.",
    "risk_notes": "High risk of application errors if enabled immediately. Recommend thorough testing. Deprecation warnings will appear first.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionController",
    "type": "Default",
    "title": "Path-relative redirects now raise UnsafeRedirectError",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb",
      "app/controllers/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for redirect_to with relative URLs (no leading slash). Change redirect_to 'example.com' to redirect_to '/safe/path' or full URL. Set config.action_controller.action_on_path_relative_redirect = :raise to enable. Can use :log or :notify for gradual rollout.",
    "risk_notes": "High security priority. Prevents open redirect vulnerabilities. May break existing redirects.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionView",
    "type": "Default",
    "title": "Use Ruby parser for Action View template dependencies",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionview/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "New default with load_defaults 8.1 uses config.action_view.render_tracker = :ruby instead of :regex. More accurate dependency tracking. Can keep :regex if experiencing issues.",
    "risk_notes": "Low risk. Improves accuracy of template dependency tracking. Minimal application impact.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionView",
    "type": "Default",
    "title": "Hidden form inputs omit autocomplete='off' attribute",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionview/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/initializers/new_framework_defaults_8_1.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Hidden inputs in form_tag, token_tag, method_tag, button_to no longer include autocomplete='off'. Set config.action_view.remove_hidden_field_autocomplete = true to enable. No application changes needed typically.",
    "risk_notes": "Very low risk. Hidden fields don't benefit from autocomplete='off' anyway.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Brk",
    "title": "schema.rb columns now sorted alphabetically",
    "rationale_url": "https://guides.rubyonrails.org/v8.1/upgrading_ruby_on_rails.html#the-table-columns-inside-schema-rb-are-now-sorted-alphabetically",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "db/schema.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "After upgrading to 8.1, schema.rb will have columns sorted alphabetically instead of by creation order. Regenerate schema.rb and commit the sorted version. Future migrations will maintain alphabetical order.",
    "risk_notes": "No functional impact. May cause large schema.rb diff and potential merge conflicts. Coordinate with team.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "Using #first/#last without order is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb",
      "app/controllers/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Find all uses of .first, .last, .second, .third, .fourth, .fifth on relations without .order(). Add explicit .order() clause or set implicit_order_column on model class. Will raise error in Rails 8.2.",
    "risk_notes": "High priority to fix. Silent bugs may exist if code assumes specific order without declaring it.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "signed_id_verifier_secret is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Replace Model.signed_id_verifier_secret = 'secret' with Model.signed_id_verifier = ActiveSupport::MessageVerifier.new('secret', digest: 'SHA256', serializer: JSON, url_safe: true). Or migrate to Rails.application.message_verifiers for unified configuration.",
    "risk_notes": "Medium priority. Affects applications using signed IDs. Should migrate before removal.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "update_all with WITH/DISTINCT is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb",
      "app/controllers/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for update_all used with .with(), .with_recursive(), or .distinct(). These clauses were silently ignored. Remove them or refactor query. Will raise error in future Rails release.",
    "risk_notes": "Medium priority. Code may be silently not working as intended. Audit all update_all usage.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Dep",
    "title": "insert_all/upsert_all with unpersisted records is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Check associations using insert_all or upsert_all. If association contains unpersisted records, those records will be lost. Either persist records first or use alternative approach.",
    "risk_notes": "Medium risk of data loss. Audit all bulk insert operations on associations.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionDispatch",
    "type": "Dep",
    "title": "config.action_dispatch.ignore_leading_brackets is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/application.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Remove config.action_dispatch.ignore_leading_brackets from configuration. Support for [foo]=bar parameter format is being removed.",
    "risk_notes": "Low priority. Affects obscure parameter format. Most applications don't use this.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveSupport",
    "type": "Dep",
    "title": "ActiveSupport::Configurable is deprecated",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activesupport/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "app/models/**/*.rb",
      "lib/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for classes including ActiveSupport::Configurable. Replace with alternative configuration mechanism (e.g., class attributes, Rails configuration, or custom solution).",
    "risk_notes": "Low priority. Affects custom classes using this mixin. Plan migration before removal.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveJob",
    "type": "Brk",
    "title": "Removed :never/:always/:default values for enqueue_after_transaction_commit",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activejob/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "app/jobs/**/*.rb",
      "config/application.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Replace enqueue_after_transaction_commit = :never with false, :always with true. Remove :default (uses config setting).",
    "risk_notes": "High priority. Application will raise error if using old values. Fix immediately after upgrade.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveJob",
    "type": "Brk",
    "title": "Built-in SuckerPunch adapter removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activejob/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/application.rb",
      "config/environments/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "If using sucker_punch adapter, upgrade to sucker_punch gem version 3.0 or later which includes its own adapter. Update config.active_job.queue_adapter setting if needed.",
    "risk_notes": "High priority if using SuckerPunch. Application will fail to enqueue jobs without the gem.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveStorage",
    "type": "Brk",
    "title": "Azure storage service removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activestorage/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "High",
    "dependencies": [],
    "file_hits_sample": [
      "config/storage.yml"
    ],
    "test_failures_linked": [],
    "fix_strategy": "If using :azure service in config/storage.yml, migrate to alternative storage service (e.g., S3, GCS, or disk). Plan migration before upgrading.",
    "risk_notes": "Critical if using Azure. File storage will fail. Must migrate before upgrading to 8.1.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionPack",
    "type": "Brk",
    "title": "Semicolon as query string separator removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Medium",
    "dependencies": [],
    "file_hits_sample": [
      "app/controllers/**/*.rb",
      "test/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for query strings with semicolons (foo=bar;baz=quux). Replace with & as separator (foo=bar&baz=quux). Previously parsed as two params, now parsed as one.",
    "risk_notes": "Medium risk. May break URL parsing in tests or controller logic. Check query string handling.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActionPack",
    "type": "Brk",
    "title": "Leading brackets in parameter names no longer skipped",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/actionpack/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "app/controllers/**/*.rb",
      "test/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Check for parameter names with leading brackets. [foo]=bar now creates {\"[foo]\" => \"bar\"} instead of {\"foo\" => \"bar\"}. Remove leading brackets from parameter names.",
    "risk_notes": "Low risk. Obscure parameter format. Most applications don't use this.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "Railties",
    "type": "Brk",
    "title": "STATS_DIRECTORIES global constant removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/railties/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "lib/tasks/**/*.rake"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Remove references to STATS_DIRECTORIES constant. Use alternative approach for custom code statistics tasks.",
    "risk_notes": "Low priority. Only affects custom rake tasks using this constant.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Brk",
    "title": "SQLite3 :retries option removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "config/database.yml"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Remove :retries option from SQLite3 database configuration in config/database.yml. Option was deprecated and is now removed.",
    "risk_notes": "Low priority. Only affects SQLite3 configuration. Remove deprecated option.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  },
  {
    "component": "ActiveRecord",
    "type": "Brk",
    "title": "MySQL :unsigned_float and :unsigned_decimal removed",
    "rationale_url": "https://github.com/rails/rails/blob/8-1-stable/activerecord/CHANGELOG.md#rails-810-october-22-2025",
    "priority": "Low",
    "dependencies": [],
    "file_hits_sample": [
      "db/migrate/**/*.rb"
    ],
    "test_failures_linked": [],
    "fix_strategy": "Search for :unsigned_float or :unsigned_decimal in migrations. Replace with alternative column definition approach for MySQL unsigned numeric columns.",
    "risk_notes": "Low priority. Only affects new migrations using these column types. Existing schema unchanged.",
    "attempts": 0,
    "last_error_signature": "",
    "status": "pending"
  }
]

ここまでで全てのテストが通過し、非推奨警告の数も0になっています。
あとは、LINTを確認するだけです。

プロンプト4（LINT + TEST）

Rails 8.1.1 アップデート後の最終仕上げ（LINT + TEST + FINAL）
- 目的
  - RuboCop による LINT（自動修正含む）を行い、コードスタイルと静的解析の観点で問題を解消する
  - LINT 後に rails test を再実行し、テストグリーンと Deprecation 0件を維持できているか確認する
  - 最終状態を tmp/rails_update/lint_final_result.json と同一内容の JSON として標準出力する
- 前提
  - prompt3：TEST + FIX → RETEST + D-CHECK 完了済みで、tmp/rails_update/test_fix_result.json が
    - status: "success"
    - last_test_status: "passed"
    - deprecation_warnings_remaining: 0
    - rails_version: "8.0.4"
      になっている想定
- 概要
  - Step1：事前確認
    - Rails バージョンと TEST+FIX 結果の確認
  - Step2：LINT+TEST ループ
    - RuboCop 実行 → rails test 実行
  - Step3
    - Deprecation 再確認（D-CHECK）
  - Step4：最終判定と結果 JSON 出力

rails-8.0.4_to-8.1.1_update_prompt4.md

# 依頼

あなたは {# 役割} です。  
{# ルール} を必ず守り、{# 実行シナリオ} に従って **LINT + TEST（自動ループ）+ FINAL 判定** を実行してください。  
作業の結果は、最後に {# 出力形式} に示す **JSON 形式** のオブジェクトを標準出力に 1 回だけ出力し、かつ同じ内容を `tmp/rails_update/lint_final_result.json` に保存してください。

---

# 役割 {# 役割}

- Docker 環境上で動作する Rails アプリケーションの  
  **Rails 8.1.1 アップデート最終仕上げ（LINT + TEST + FINAL）専用エージェント**
- 対象タスクは以下に限定する：
  - RuboCop による **LINT（自動修正含む）**
  - LINT 後の **テスト実行（TEST）**
  - LINT と TEST の自動ループ制御
  - 最終状態のサマリ（成功 or 失敗）の JSON 出力
- Gem バージョン変更、CI 設定変更、新規ライブラリ導入などは **担当外**

---

# 前提入力 {# 前提入力}

このプロンプトは、すでに以下が実行済みであることを前提とする：

- プロンプト1: Rails バージョンを **8.0.4 → 8.1.1** にアップデート済み
- プロンプト2: SCAN（影響調査）を完了済み
- プロンプト3: TEST + FIX → RETEST + D-CHECK を完了済みで、  
  `tmp/rails_update/test_fix_result.json` が存在し、かつ以下を満たしていることが期待される：
  - `status: "success"`
  - `last_test_status: "passed"`
  - `deprecation_warnings_remaining: 0`
  - `rails_version: "8.1.1"`

---

# 環境 {# 環境}

- 実行場所: リポジトリ直下（プロジェクトルート）
- バックエンド: **Rails 8.1.1**（Step1 で必ず確認する）
- フレームワーク:
  - Rails API モード（view テンプレートの手動修正は不要）
- インフラ: Docker Compose / サービス名 `web`
- テストフレームワーク: `rails test`（Rails 標準テスト）
- LINT ツール: RuboCop
- 一時ファイル格納ディレクトリ（すべて同じ階層に集約する）:
  - `tmp/rails_update/`
    - （プロンプト2 / 3 からの既存ファイル：**読み取り専用**）
      - `patterns.txt`
      - `fix_plan.json`
      - `new_framework_defaults_8_1.rb`
      - `diff_*.patch`
      - `test_fix_result.json`
    - （本プロンプト4 で使用・作成するファイル）
      - `lint_final_result.json`（最終結果の JSON。必須）
      - 必要に応じて、任意のログファイルを追加で作成してもよい（ファイル名は自由）。  
        ただし、これら任意ログファイルの存在を **出力 JSON から参照する必要はない**。
- テスト結果ログや RuboCop 出力は **メモリ上で扱うことを基本** とし、  
  どうしても必要な場合のみ `tmp/rails_update` 配下に保存してよい。

---

# ルール {# ルール}

## 0. 出力言語

- 進捗ログや説明メッセージなど、JSON 以外の自然言語を出力する場合は、**必ず日本語** を使用する。
- 英語と日本語の混在は避け、途中で英語に切り替えない。
- 最終出力の JSON 内の値（`reason` や `error_summary` など）も **日本語で記述してよい**。

## 1. 対話禁止

- ユーザーへの質問・確認・追加入力依頼を一切行わない。
- 必要な判断は、すべて「与えられたログ」「ファイル内容」「ルール」に基づいて自律的に行う。

## 2. Git 操作の制限

- 禁止:
  - `git add`
  - `git commit`
  - `git push`
- 許可:
  - `git status`（状態確認のみ）
  - `git diff`（変更差分の確認のみ）
- Git は **確認専用**。履歴を書き換える操作は行わない。

## 3. 変更対象の制限

- **変更してよいファイル**
  - `app/**` 配下の **Ruby ファイル（`.rb`）**
  - `lib/**` 配下の Ruby ファイル
  - `config/**` 配下（`application.rb`, `environments/*.rb`, `initializers/*.rb` など Ruby ファイル）
  - `test/**` / `spec/**` 配下のテストコード
- **原則として変更してはいけない or 手動で触らないファイル**
  - `app/views/**` 配下の view テンプレート
  - `Gemfile`, `Gemfile.lock`
  - Docker 関連（`Dockerfile`, `docker-compose.yml` 等）
  - CI 設定（`.gitlab-ci.yml`, `.github/workflows/**` 等）
- RuboCop の自動修正により `.rb` 以外のファイルが変更されたように見える場合でも、  
  原則として `.rb` 以外のファイルを自分から直接編集しない。
  - 例外は不要と考えてよく、「view や YAML を自分の判断で書き換える」ことはしない。

## 4. `tmp/rails_update` の扱い

- `tmp/rails_update` は **プロンプト2〜4 全体の作業・記録領域** であり、次の方針で扱う：
  - `patterns.txt`, `fix_plan.json`, `new_framework_defaults_8_1.rb`, `diff_*.patch`,  
    `test_fix_result.json` は **読み取り専用**。このプロンプト4からは絶対に変更しない。
  - 本プロンプトで新たに作成・更新してよい必須ファイルは、次の 1 つのみ：
    - `tmp/rails_update/lint_final_result.json`
  - その他のログファイルを作成する場合は、**人間が調査に使うための補助** に限り、  
    `tmp/rails_update` 配下に任意のファイル名で作成してよい。  
    これら任意ログの存在は、出力 JSON に反映する必要はない。
- **クリーンアップ（削除）は不要**：
  - すべて `tmp/rails_update` 配下に集約し、人間が後でまとめて削除しやすい状態にする。
  - このプロンプト4の終了時に `rm tmp/rails_update/...` で削除してはいけない（上書きは可）。

## 5. テスト / Lint コマンドの扱い

- 許可されるテスト・Lint コマンドは次の 3 つのみ：
  - `docker compose run --rm web bin/rails -v`
  - `docker compose run --rm web rails test`
  - `docker compose run --rm web bundle exec rubocop -A`
- **パイプ (`|`) やリダイレクト (`>`, `>>`, `2>&1` 等) を付けて実行してはいけない。**
  - 例: `docker compose run --rm web rails test 2>&1 | cat` は禁止。
- テストログや RuboCop 出力をファイルに残す必要がある場合は、
  - すでにコンソールに出力された内容をもとに、
  - `cat <<'EOF' > tmp/rails_update/xxx.txt` のように **後から書き起こす** 形にする。

## 6. Deprecation 警告の扱い

- D-CHECK はプロンプト3で完了済みだが、**LINT によるコード変更後も Deprecation が発生していないかを再確認する**。
- 各テスト実行ごとにログを解析し、`DEPRECATION WARNING` / `DEPRECATION:` を含む行を抽出する。
- 抽出した件数を整数としてカウントし、`deprecation_warnings_remaining` に反映する。
- 最終的に `deprecation_warnings_remaining = 0` でない場合は、`status: "success"` として終了してはいけない。

## 7. テスト & Lint のループ上限とエラーシグネチャ

- ループ制御用の上限値：
  - `MAX_LINT_RUNS = 10`
  - `MAX_TEST_RUNS = 10`
  - `MAX_TOTAL_CYCLES = 10`（「Lint → Test」の 1 セットを 1 サイクルとカウント）
- テスト失敗時には、次の形式で **エラーシグネチャ** を生成する：

  ```text
  <ExceptionClass> | <normalized_message> | <top_app_frame_path>:<line> | Rails 8.1.1
  ```

  - `normalized_message`:
    - ID・UUID・日付・一部の数値などの変動要素を正規化し、同種エラーが同じシグネチャになるように調整する。
  - `top_app_frame_path:line`:
    - スタックトレースのうち、最上位の `app/` または `lib/` 配下のフレームの `path:line` を用いる。
    - 見つからない場合は、アプリケーションコードに最も近いフレームを選ぶ。

- 連続エラー判定：
  - 同じテストエラーシグネチャ集合が **3 回連続** で発生した場合、
    - これ以上の自動修正は困難とみなし、`status: "failed"` で終了する。
    - このとき `error_summary` と `manual_check_items` に、人手で確認すべきポイントや代替方針を日本語で記載する。

## 8. RuboCop の扱い（LINT）

- RuboCop コマンドは常に **次の固定コマンド** を使う：

  - `docker compose run --rm web bundle exec rubocop -A`

- 各 RuboCop 実行後に、以下を解析する：
  - 「inspected X files, Y offenses detected」などのサマリ行
  - 「Z offenses detected, Y offenses corrected」などの自動修正件数
  - 「no offenses detected」などのクリーン状態のメッセージ
- 1 サイクル内の RuboCop 実行ポリシー：
  1. まず 1 回 `rubocop -A` を実行する。
  2. 出力から「自動修正が行われた」または「まだ offenses が残っている」と判断した場合、  
     **必ず直後にもう 1 回 `rubocop -A` を実行**し、2 回目の結果で「no offenses detected」になっているか確認する。
  3. 2 回目実行後も offenses が残っている場合：
     - RuboCop の Cop メッセージに基づき、Ruby コードのみを対象に、  
       違反解消に必要な **最小限の差分** で手動修正してよい。
     - 手動修正後は、別サイクルとして再び RuboCop を実行し、クリーンになるかを確認する。
     - それでも `MAX_LINT_RUNS` を超えても offenses が 0 にならない場合は、`status: "failed"` として終了し、  
       `error_summary` に「Lint の自動修正では解消できない違反が残っている」旨を記載する。
- 最終的に `last_lint_status` を
  - `"clean"`（offenses 0・自動修正なし）
  - `"corrected"`（自動修正や手動修正を含むが最終的に offenses 0）
  - `"failed"`（offenses が残って終了）
  のいずれかで記録する。

## 9. テスト再実行の条件

- 各サイクルでの基本フローは次の通り：
  1. RuboCop 実行（必要に応じて 2 回以上）
  2. RuboCop 上の offenses が 0（Lint クリーン）になったら
  3. `docker compose run --rm web rails test` を 1 回実行
- テスト実行は、コードが変更されたサイクルでのみ行うことが望ましいが、  
  本プロンプトでは「LINT → TEST を常にセットで実行する」としてよい。
- `MAX_TEST_RUNS` および `MAX_TOTAL_CYCLES` を超えない範囲で、  
  テストが通るまで再度「RuboCop → Test」を繰り返す。

## 10. 終了条件

- {# 成功条件} を満たした場合のみ `status: "success"` として終了する。
- 満たせない場合は `status: "failed"` とし、{# 失敗時の扱い} に従って要約を出力する。

## 11. 出力の制約

- 最終出力は {# 出力形式} の JSON オブジェクト **のみ**。
- JSON 以外の自然言語の文章や説明を、**最終出力の直前・直後には出力してはいけない**。
- 途中の進捗ログ（日本語）は出力してよいが、最後は **JSON 単体** を出力して終了する。

---

# 使用可能コマンド {# 使用可能コマンド}

以下のコマンド群と、`ls` / `cat` / `mkdir -p` のみを使用してよい。  
それ以外のコマンド（例: `grep`, `tee`, `wc` など）や、`/tmp` など **リポジトリ外** へのログ出力を伴うコマンドは実行してはいけない。

## バージョン確認 / テスト / Lint

- `docker compose run --rm web bin/rails -v`
- `docker compose run --rm web rails test`
- `docker compose run --rm web bundle exec rubocop -A`

※ これら 3 コマンドには、パイプ (`|`) やリダイレクト (`>`, `2>&1` 等) を付与してはならない。

## Git / Diff 関連

- `git status`
- `git diff`

## ファイル操作

- `mkdir -p tmp/rails_update`
- `ls`
- `ls <dir_path>`
- `cat <file_path>`

---

# 実行シナリオ {# 実行シナリオ}

1. {# Step1_事前確認と入力チェック}
2. {# Step2_LINT+TESTループ（RuboCop → Test）}
3. {# Step3_D-CHECK再確認}
4. {# Step4_終了判定と JSON 出力}

---

## Step1_事前確認と入力チェック {# Step1_事前確認と入力チェック}

1. **Rails バージョン確認**
   - コマンド：
     - `docker compose run --rm web bin/rails -v`
   - 出力から `Rails 8.1.1` であることを確認する。
   - `rails_version` には `"8.1.1"` を格納する（"Rails " のプレフィックスは除く）。
   - 8.1.1 でない場合：
     - `failed_step: "precheck"`
     - `error_summary` に「Rails バージョンが 8.1.1 ではないため LINT+TEST を実行できない」と記載し、
     - 即座に `status: "failed"` で終了する。

2. **D-CHECK 完了状態の確認**
   - `tmp/rails_update/test_fix_result.json` の存在を確認し、次を満たすことを論理的に検証する：
     - `status: "success"`
     - `last_test_status: "passed"`
     - `deprecation_warnings_remaining: 0`
     - `rails_version: "8.1.1"`
   - いずれかが満たされない場合：
     - `failed_step: "precheck"`
     - `error_summary` に「プロンプト3（TEST+FIX+D-CHECK）が成功状態ではないため、本プロンプトを実行できない」旨を記載し、
     - `status: "failed"` で終了する。

3. **作業用ディレクトリの準備**
   - `mkdir -p tmp/rails_update` を実行する（既に存在していてもよい）。

---

## Step2_LINT+TESTループ（RuboCop → Test） {# Step2_LINT_TESTループ}

1. **ループ用カウンタと状態変数の初期化**
   - `lint_run_count = 0`
   - `test_run_count = 0`
   - `total_cycle_count = 0`
   - `last_test_error_signatures = []`
   - `consecutive_same_test_error_count = 0`
   - `last_lint_status = null`
   - `deprecation_warnings_remaining = null`

2. **メインループ**
   - 次の条件を満たす限りループを続ける：
     - `total_cycle_count < MAX_TOTAL_CYCLES`
     - まだ「最終成功条件」を満たしていない
   - 各ループは「1 サイクル」として扱い、以下を行う：

   ### 2-1. LINT（RuboCop 実行）

   1. **1 回目の RuboCop 実行**
      - コマンド：
        - `docker compose run --rm web bundle exec rubocop -A`
      - `lint_run_count` をインクリメント。
      - 出力を解析し、以下を判断する：
        - offenses が 0 かどうか
        - 自動修正（`offenses corrected` など）が発生したかどうか

   2. **2 回目の RuboCop 実行（必要な場合のみ）**
      - 1 回目の結果から、次のいずれかに当てはまる場合：
        - 自動修正が行われた
        - まだ offenses が残っている
      - 上記の場合のみ、**もう 1 回だけ** 同じコマンドを実行する：
        - `docker compose run --rm web bundle exec rubocop -A`
      - `lint_run_count` を再度インクリメント。
      - 2 回目の結果を解析し、offenses が 0 になっているか確認する。

   3. **Lint 結果の判定**
      - 2 回目までの実行結果を踏まえ、次のいずれかとして `last_lint_status` を更新する：
        - offenses 0・自動修正なし → `"clean"`
        - offenses 0・自動修正あり（または手動修正込み） → `"corrected"`
        - offenses が残っている → `"failed"`
      - offenses が残っている場合：
        - まだ `MAX_LINT_RUNS` や `MAX_TOTAL_CYCLES` に余裕があるなら、
          - Cop の指摘に従い Ruby コードのみを最小限で手動修正し、  
            次サイクルで再び RuboCop を実行してもよい。
        - しかし、明らかに自動修正や最小修正では解決できないと判断した場合、もしくは上限を超える場合：
          - `failed_step: "lint"`
          - `error_summary` に「RuboCop の違反を自動修正では解消しきれなかった」旨を記載し、
          - `status: "failed"` として Step4 に進む。

   ### 2-2. TEST（rails test 実行）

   4. **Lint がクリーンになっていることの確認**
      - `last_lint_status` が `"clean"` または `"corrected"` でない場合、テストを実行してはいけない。
      - `"failed"` の場合は、前述の通り `status: "failed"` として終了準備に入る。

   5. **テスト実行**
      - コマンド：
        - `docker compose run --rm web rails test`
      - `test_run_count` をインクリメント。
      - テスト出力を解析し、以下を判定する：
        - 全テスト成功（0 failures, 0 errors）かどうか
        - Deprecation 警告行（`DEPRECATION WARNING` / `DEPRECATION:`）の件数

   6. **テスト結果・エラーシグネチャの更新**
      - テスト成功の場合：
        - `last_test_status = "passed"`
        - `last_test_error_signatures = []`
        - `consecutive_same_test_error_count = 0`
      - テスト失敗の場合：
        - `last_test_status = "failed"`
        - 失敗ごとにエラーシグネチャを生成し、`last_test_error_signatures` に格納する。
        - 直前サイクルのエラーシグネチャ集合と比較し、同一であれば `consecutive_same_test_error_count` を +1、  
          異なれば 1 にリセットする。
        - `consecutive_same_test_error_count >= 3` の場合：
          - `failed_step: "test"`
          - `error_summary` に「同一のテストエラーが 3 回連続で発生したため、自動修正を打ち切った」旨を記載し、
          - 人手で確認すべきポイントを {# 出力形式} の `manual_check_items` に列挙して `status: "failed"` とする。

   7. **Deprecation 警告数の更新**
      - テストログから Deprecation 行数を数え、`deprecation_warnings_remaining` に設定する。

   ### 2-3. サイクル終了判定

   8. `total_cycle_count` を +1 する。
   9. 次の条件をすべて満たしている場合、この Step2 のループを終了する：
      - `last_lint_status` が `"clean"` または `"corrected"`
      - `last_test_status` が `"passed"`
      - `deprecation_warnings_remaining == 0`
   10. 上記を満たさず、かつ
       - `total_cycle_count >= MAX_TOTAL_CYCLES` または
       - `lint_run_count >= MAX_LINT_RUNS` または
       - `test_run_count >= MAX_TEST_RUNS`
       のいずれかに達した場合：
       - `failed_step` に `"lint"` または `"test"` を設定（より直近で限界となった方）
       - `error_summary` に「自動ループ上限に達したため終了した」旨を記載し、
       - `status: "failed"` として Step4 に進む。

---

## Step3_D-CHECK再確認 {# Step3_D_CHECK再確認}

- Step2 のループを抜けた後、**成功の可能性がある場合のみ** 以下を確認する：

1. `last_test_status == "passed"` であること。
2. `last_lint_status` が `"clean"` または `"corrected"` であること。
3. `deprecation_warnings_remaining == 0` であること。

- いずれかを満たさない場合は、すでに Step2 で `status: "failed"` としているはずだが、  
  もし未設定であれば `failed_step: "dcheck"` とし、`error_summary` に理由を記載して `status: "failed"` とする。

---

## Step4_終了判定と JSON 出力 {# Step4_終了判定}

1. **成功時 (`status: "success"`)**

   - 次の条件をすべて満たす場合に、`status: "success"` としてよい：
     1. `rails_version == "8.1.1"`
     2. `last_test_status == "passed"`
     3. `last_lint_status` が `"clean"` または `"corrected"`
     4. `deprecation_warnings_remaining == 0`
   - このとき、JSON には次を含める：
     - `no_fix_reason`:
       - **コードを一切変更しなかった場合**（Rubocop による自動修正も含め、実質的な変更がない場合）は、
         - 「なぜ修正 0 件で問題ないと判断したか」を日本語 1〜3 文で記載する。
       - Rubocop の自動修正や手動修正により **何らかの変更を行った場合** は `null` とする。
     - `fixed_items_detail`:
       - 代表的な修正内容を 0〜3 件程度、次の形式で記載してよい：
         - `component`: 例 `"Lint"`
         - `title`: 例 `"Style/MethodCallWithArgsParentheses の違反修正"`
         - `rationale_url`: 関連する RuboCop Cop ドキュメントなど（あれば）
         - `applied_to_files`: 修正が行われた代表的なファイルパス配列
         - `reason`: 「なぜこの修正を行ったか／どんな意図の修正か」を日本語で要約

2. **失敗時 (`status: "failed"`)**

   - {# 成功条件} をひとつでも満たさない場合は、必ず `status: "failed"` とする。
   - このとき JSON には次を含める：
     - `failed_step`: `"precheck"` | `"lint"` | `"test"` | `"dcheck"` | `"final"` のいずれか
     - `error_summary`: 失敗理由の 1〜3 文の日本語要約
     - `last_test_error_signatures`: 直近テストの代表的なエラーシグネチャ配列（無ければ空配列）
     - `manual_check_items`: 人手で確認すべき具体的なポイント（テスト名、ファイル名、Cop 名など）を日本語で列挙する配列
     - `no_fix_reason`: `null`
     - `fixed_items_detail`: 空配列でよい

3. **最終 JSON の保存と出力**

   - 構築した JSON オブジェクトを、**1 回だけ** 次の 2 つの形で出力する：
     1. `tmp/rails_update/lint_final_result.json` に書き出す  
        （例として `cat <<'EOF' > tmp/rails_update/lint_final_result.json` で出力されるような内容と同等になるようにする）
     2. 同じ JSON オブジェクトを、**標準出力にそのまま 1 回だけ** 出力する。
        - このとき、前後に余計なログ行や説明文を付けないこと。
        - 出力は純粋な JSON オブジェクトだけにする。

---

# 成功条件 {# 成功条件}

以下を **すべて満たす** 場合に、`status: "success"` としてよい。

1. Rails の実行バージョンが `8.1.1` である（Step1 で確認済み／`rails_version: "8.1.1"`）。
2. 直近の `docker compose run --rm web rails test` が成功している（`last_test_status: "passed"`）。
3. 直近の RuboCop 実行結果が、offenses 0 である（`last_lint_status: "clean"` または `"corrected"`）。
4. 直近のテストログに **Deprecation 警告が 0 件** である（`deprecation_warnings_remaining = 0`）。
5. `tmp/rails_update/lint_final_result.json` が存在し、その内容が最終出力した JSON と一致している。

---

# 失敗時の扱い {# 失敗時の扱い}

- {# 成功条件} を一つでも満たせない場合は、**必ず `status: "failed"` として終了** する。
- その際は、{# 出力形式} に定義する JSON の各項目を次のように設定する：
  - `status`: `"failed"`
  - `failed_step`: エラー発生フェーズ（例: `"precheck"`, `"lint"`, `"test"`, `"dcheck"`, `"final"`）
  - `error_summary`: 原因を端的に説明する 1〜3 文の日本語
  - `last_test_error_signatures`: 直近テストの代表的なエラーシグネチャ。テスト未実行であれば空配列。
  - `no_fix_reason`: `null`
  - `fixed_items_detail`: 空配列
  - `manual_check_items`: 人手で確認して欲しいポイント（テスト名、ファイル名、Cop 名など）を配列で列挙

---

# 出力形式 {# 出力形式}

最終出力は **次の JSON オブジェクトのみ** を返すこと。  
JSON 以外の自然言語の文章や説明は一切出力してはいけない。

```json
{
  "status": "success or failed",
  "rails_version": "docker compose run --rm web bin/rails -v で確認したバージョン（例: \"8.1.1\"）。取得できなかった場合は null。",
  "last_lint_status": "\"clean\" | \"corrected\" | \"failed\" のいずれか。Rubocop の最終状態。",
  "last_lint_command": "常に \"docker compose run --rm web bundle exec rubocop -A\"。",
  "lint_run_count": "Rubocop を実行した回数（整数）。",
  "last_test_status": "passed or failed or not_run",
  "last_test_command": "docker compose run --rm web rails test",
  "test_run_count": "rails test を実行した回数（整数）。",
  "last_test_error_signatures": [
    "最後のテスト実行時に残っている代表的なエラーシグネチャ（なければ空配列）"
  ],
  "deprecation_warnings_remaining": "直近のテストログに残っている Deprecation 警告の件数（整数）。成功時は 0。",
  "tmp_dir": "常に \"tmp/rails_update\"。",
  "lint_result_file": "常に \"tmp/rails_update/lint_final_result.json\"。",
  "diff_summary": "必要に応じて、主要な変更ファイルや変更種類を日本語で簡潔に要約した文字列。変更が無ければ空文字列か null。",
  "no_fix_reason": "修正を行わなかった場合の理由（日本語 1〜3 文程度）。修正が行われた場合や失敗時は null。",
  "fixed_items_detail": [
    {
      "component": "修正対象となったコンポーネント名（例: \"Lint\"）",
      "title": "代表的な修正内容のタイトル（例: \"Style/MethodCallWithArgsParentheses の自動修正\"）",
      "rationale_url": "関連する RuboCop Cop ドキュメントやガイドの URL（任意）。無ければ空文字列か null。",
      "applied_to_files": [
        "修正が行われた代表的なファイルパス（例: \"app/models/user.rb\"）"
      ],
      "reason": "なぜこの修正を行ったか／どのような意図の修正かを日本語で要約した文章。"
    }
  ],
  "manual_check_items": [
    "失敗時のみ: 人手で確認して欲しいポイント（テストケース名、ファイル名、Cop 名、再現手順など）を日本語で列挙。成功時は空配列。"
  ],
  "failed_step": "null もしくは 'precheck' | 'lint' | 'test' | 'dcheck' | 'final'",
  "error_summary": "失敗時のみ: エラー内容や Deprecation 残存理由の1〜3文要約。成功時は null。"
}
```

ファイル差分

tmp/rails_update/lint_final_result.json

{
  "status": "success",
  "rails_version": "8.1.1",
  "last_lint_status": "corrected",
  "last_lint_command": "docker compose run --rm web bundle exec rubocop -A",
  "lint_run_count": 2,
  "last_test_status": "passed",
  "last_test_command": "docker compose run --rm web rails test",
  "test_run_count": 1,
  "last_test_error_signatures": [],
  "deprecation_warnings_remaining": 0,
  "tmp_dir": "tmp/rails_update",
  "lint_result_file": "tmp/rails_update/lint_final_result.json",
  "diff_summary": "config/application.rb の空行削除（Layout/EmptyLines 違反の自動修正）",
  "no_fix_reason": null,
  "fixed_items_detail": [
    {
      "component": "Lint",
      "title": "Layout/EmptyLines の自動修正",
      "rationale_url": "https://docs.rubocop.org/rubocop/cops_layout.html#layoutemptylines",
      "applied_to_files": [
        "config/application.rb"
      ],
      "reason": "RuboCop が config/application.rb の33行目で余分な空行を検出し、自動削除した。これによりコードスタイルが Rails のベストプラクティスに準拠し、プロンプト3で適用された load_defaults 8.1 への変更と to_time_preserves_timezone 設定の削除が正しく保たれている。"
    }
  ],
  "manual_check_items": [],
  "failed_step": null,
  "error_summary": null
}

無事、LINT・再テストまで通過しました。
あとは人の手で修正内容をチェック → 動作確認を実施して問題なければ完了です✅

⚠️ActiveRecord::Relationをキャッシュしている場合は要注意

結論、『Rails8.0.4 の ActiveRecord::Relation（古いAR）』を Redis にキャッシュし、Rails8.1.1 でその古いARを読み出して blank? / empty? / to_a などを呼ぶと、NoMethodErrorが発生します。

そもそも ActiveRecord::Relation（AR）をキャッシュしないのがベストですが、パフォーマンスの観点から処理を残したい場合は対応が必須です。
なお、キャッシュ期間を1日にしている場合、1日以上経過すれば Redis 上の AR は Rails8.1.1 で生成されたものに置き換わるため、それ以降はエラーが発生しなくなります。

Rails8.0.4でキャッシュし、Rails8.1.1にバージョンを上げるとコンソール上でも確認可能です。

[1] pry(main)> Rails.version
=> "8.1.1"
[2] pry(main)> Rails.cache.redis.with { |conn| conn.keys("*RankingByGenresController*") }
=> ["V1::Title::RankingByGenresController_4_general_20_title_rankings_by_genre_25_12_22"]
[3] pry(main)> key = "V1::Title::RankingByGenresController_4_general_20_title_rankings_by_genre_25_12_22"
=> "V1::Title::RankingByGenresController_4_general_20_title_rankings_by_genre_25_12_22"
[4] pry(main)> cached_titles = Rails.cache.read(key)
=> #<Title::ActiveRecord_Relation:0x594c>
[5] pry(main)> cached_titles.class
=> Title::ActiveRecord_Relation
[6] pry(main)> cached_titles.blank?
NoMethodError: undefined method `<=' for nil:NilClass (NoMethodError)

          value && (@max <= value || @min > value)
                         ^^
from /usr/local/bundle/gems/activemodel-8.1.1/lib/active_model/type/integer.rb:105:in `out_of_range?'
[7] pry(main)> cached_titles.to_a
NoMethodError: undefined method `<=' for nil:NilClass (NoMethodError)

          value && (@max <= value || @min > value)
                         ^^
from /usr/local/bundle/gems/activemodel-8.1.1/lib/active_model/type/integer.rb:105:in `out_of_range?'

暫定対応であれば、以下のように例外が出たらキャッシュを作り直す形で良さそうです。

  def recover_invalid_cached_titles(titles:, cache_key:, params:, expires_in:)
    titles.blank?
    titles
  rescue StandardError => e
    Rails.logger.warn("警告文")
    regenerated_titles = ::TitleFinder.call(**params)
    Rails.cache.write(cache_key, regenerated_titles, expires_in:)

    regenerated_titles
  end

最後に

本記事では、Rails 8.0 → 8.1 のアップデートを AI に任せるための設計プロンプトと、適用差分の要点をまとめました
プロンプトへの指示はまだまだ色々な工夫の仕方があるので、プロンプトに技術を盛り込んだり、設計以外でプロンプトを実行する場合にも応用していきたいです
- LLMは「同じ質問を2回」入力すると精度が上がる
- サンドイッチ構造プロンプト
今後は、バージョンを渡すだけでアップデートできる設計にブラッシュアップしたり、Gem など他のアップデートにも対応するようなプロンプトを作成していきたいです

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up