1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Java 11の約15万行を「4日」でJava 21+Jakarta EE 10へ——AWSジャパン公開のAI移行フローに学ぶ「AIを止める条件」の決め方

1
Posted at

「AIにJavaのバージョンアップを任せたら、ビルドは通ったのに画面が動かない」。そんな経験がある方に読んでほしい国内の公開事例です。

AWSジャパンのソリューションアーキテクトが2026年10月6日、AIエージェントに移行作業を“決められた手順で”進めさせるワークフロー「AI Modernization Flow(AIMF)」をGitHubで公開しました。あわせて、OSSのブログCMS「Apache Roller」約15万行を実際に移行した記録も出ています。

ツール紹介ではなく、人がどこで判断し、何をもって完了とするかが具体的に書かれているので、自社のJava案件にそのまま持ち込めます。

事例の規模

  • 対象:Apache Roller(Java製ブログCMS)約15万行
  • 移行前:Java 11 / Java EE(javax)/ Struts 2.5 / Spring 5
  • 移行後:Java 21 / Jakarta EE 10 / Struts 7 / Spring 6 / PostgreSQL 17
  • 期間:分析から最終確認まで4日間(人とのやり取り込み、作業は日中のみ)
  • エージェント:Kiro または Claude Code、分析には AWS Transform custom

なお、Rollerの課題管理には「javax.* のimportが約305箇所残っている」という記載があり、名前空間移行だけでも相応の量があったことが分かります。

手順1:6つのPhaseで「途中で止められる」ようにする

AIMFは作業を次の6段階に分けます。

  1. Phase 0a 分析:構成と技術的負債の把握
  2. Phase 0b 移行判断の材料:移行先候補・概算規模・リスク・方針案
  3. Phase 1 準備:現新比較の方式、非機能要件の範囲を決める
  4. Phase 2 計画:作業計画と成功基準を確定
  5. Phase 3 実施:段階的に移行し、段階ごとに検証
  6. Phase 4 最終確認:全機能を別視点で検証

ポイントはPhase 0bで止められることです。ここまでで移行先の比較と規模感が出るので、稟議や予算判断の材料として「まずアセスメントだけ」回せます。公式ブログでは、数十万行規模でも分析は1〜2時間程度とされています。

もうひとつ、移行先は分析を見てから決めるという原則も明記されています。先にゴールを決めると前提を誤る、という考え方です。

手順2:人の判断を「後戻りコスト」で3段階に分ける

全部を人がレビューすると承認待ちで止まり、全部をAIに任せると事故が起きます。AIMFの線引きはこうです。

  • ユニット内部の実装:検証が通ればAIがそのまま進める
  • インターフェース・データ形式の変更、機能の除外、Phaseの境界:AIが止まり、選択肢と影響を示して人に判断を求める
  • 止まるかどうかはAI自身に決めさせず、事前に決めた条件で判定する

さらに、技術的な問題は「一定回数試して解決しなければ止まって別タスクに切り出す」、計画外のまとまった作業は「提案→人が承認したら計画に追加」というルールもあります。AIが沼にはまって時間を溶かすのを防ぐ、実務的な工夫です。

手順3:完了は「自己申告」ではなく検証スクリプトで判定する

ここが一番真似したいところです。

  • ビルド成功は完了ではない。アプリを動かし、自動テストで確かめて初めて完了
  • 文章のルールはAIが「守りました」と自己申告するだけで通ることがある。だから守らせたい規律はできるだけ検証スクリプトに置き換える
  • AIの分析結果は仮説扱い。実コードで裏取りしてから計画に入れる

Rollerの完了報告では、成功基準ごとに確認方法が並びます。

  • 既存単体テスト:157件成功(OAuth 1.0除去に伴い1件を正当に削減)
  • javax→jakarta:検証スクリプトで残存0件
  • 主要画面:ブラウザE2Eでユーザー登録、ログイン、ブログ作成、記事投稿、画像アップロード、コメントまで確認
  • セキュリティ既定値によるサイレント障害:実際に見つかった複数件を修正し、再発検出スクリプトを追加
  • 性能・リソースリーク・耐障害性:移行後の独立タスクとして延期(人が判断しADRに記録)

「やらなかったこと」も理由付きで報告に残る点が、レビューする側にとって非常にありがたい設計です。

手順4:判断と作業をファイルに残し、誰でも再開できるようにする

  • 設計判断はADR(なぜこの技術か、なぜこの機能を外したか)
  • 作業内容はworklog、現在の状態はsession-context
  • 最後に、コンテキストを隔離した別エージェントが完了宣言を1回だけ検証し、指摘を1件ずつ閉じる

担当者交代や日またぎ、エージェントの異常終了があっても再開できます。人に判断を求める仕組みは、業務知識を保守担当へ引き継ぐ場にもなる、という説明も印象的でした。

自社案件に持ち込むなら

  1. まず手元のJava 8/11資産でPhase 0aだけ回し、負債と規模を数字で出す
  2. 「AIが止まる条件」(I/F変更、機能削除、N回失敗)を先に文書化する
  3. 完了条件を「grep残存0件」「E2Eシナリオ通過」などスクリプトで書く
  4. 延期した非機能要件は、ADRに残して別タスクで必ず回収する

注意点として、公開元自身が「最適なモダナイゼーションが自動で完成する魔法の道具ではない」と明記しています。移行先が自社で保守し続けられるかは、既存システムに詳しい人と新技術に詳しい人が一緒に判断する前提です。また今回はOSSでの検証であり、業務システム固有の帳票や外部連携は別途の検証が必要になります。

それでも「AIに任せる範囲」と「止める条件」と「完了の証拠」を先に決める、という型は、どの規模のJava移行にも効くはずです。


出典

1
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?