AI Pods に戻る

Legacy Modernization Pod · Forge Modernization

Legacy Migration & Modernization

記憶ではなく、証跡から作り直す。

そのシステムの仕組みを知る人はもう残っておらず、ドキュメントは最初から存在しませんでした。Legacy Modernization Pod が、それが実際に何をしているのかを復元し、それを基準に置き換えを設計し、構築し、検証します。4 つのフェーズそれぞれを、名前のある人が承認します。Forge Modernize は、すでにお使いの AI コーディングエージェントの上で動きます。

フェーズ、分析からテスト済みの再構築まで
4フェーズ、分析からテスト済みの再構築まで
ゲート、それぞれを名前のある人が閉じます
4ゲート、それぞれを名前のある人が閉じます
コマンド、うち 11 がクリティカルパス上
20コマンド、うち 11 がクリティカルパス上
種類のレガシー資産に対応
3種類のレガシー資産に対応

状況

心当たりはありませんか。

たいてい、二つのことが同時に起きています。

なぜ今なのか

  • フレームワークがサポート終了を迎え、セキュリティパッチも一緒に止まりました。
  • そのスタックでは採用ができず、コンプライアンスからも問い合わせが来はじめました。

なぜまだ実現していないのか

  • そのシステムを理解していた最後の一人が、辞めてしまいました。
  • ドキュメントは、何年も前にリリースされたバージョンを説明しています。
  • 業務ルールを列挙できる人がいないので、どの見積もりも当て推量です。

期限は現実で、知識は失われています。いまやそのシステム自体が、自分に関する唯一残った仕様書になっています。

誰のためのキットか

Forge Modernization はあなたのチームに向いていますか?

システムそのものが唯一の仕様書になってしまった場合のためのキットです。ゼロから作るプロジェクト向けではありません。

向いているケース

  • 残っている誰も説明できない稼働中のシステム — ドキュメントは最初から存在しないか、古いバージョンを説明している。
  • サポートが終了したフレームワーク — セキュリティパッチは途絶え、コンプライアンスが問い始めている。
  • 誰もビジネスルールを列挙できないために、これまでの見積もりがすべて推測だったシステム。
  • 一発切り替えではなく、各フェーズの前に署名済みのゲートを求める責任者。

向いていないケース

  • 復元するものがない新規構築 — Forge Spec から始めてください。
  • コードはそのままにホスティングだけを移すリフト&シフト。
  • ソースコードへのアクセスを提供できないシステム。復元は記憶ではなくコードを読みます。
  • 分析なしで再構築だけを求める場合。仕様が先に来るのは設計上の順序です。

フェーズ 1 の成果物

まず、誰も書かなかった仕様書を。

サブシステム一つ分を Markdown で。受信箱ではなく、社内 Wiki にそのまま収まります。

deliverables/
INDEX.md— start here — every output, by concern
01-understanding/
OVERVIEW.md— modules, data flows, external systems
BUSINESS_RULES.md— one row per rule, with its source line
AI_UNCERTAINTY.md— what we could not determine
REQUIREMENTS.md
MIGRATION_STRATEGY.md— and what not to carry forward
BATCH_WORKFLOWS.md
02-data-model/
DATA_CATALOG.md— entities, field dictionary, CRUD
03-security/
SECURITY_ISSUES.md— adjudicated, not raw scanner noise
04-operations/
DEPLOYMENT.md
LOGGING.md
05-testing/
CHARACTERIZATION.md— the plan for proving parity
TRACEABILITY.md
COVERAGE_GATE.md
06-governance/
REVIEW_CRITERIA.md— what each role must sign
single-page/one per screen
AS-IS_order-entry.md
AS-IS_error-screens.md
wireframes/
navigation-map.html— clickable, pan and zoom
er-diagram.md— declared keys solid, inferred dashed

AS-IS_<screen>.md

すべての画面に、これが一つずつ。

  1. 1レイアウトと画面遷移の図
  2. 2フィールド定義と入力チェックのルール
  3. 3触れるテーブルと、CRUD の対応表
  4. 4業務ルール、コード値、アクセス制御
  5. 5未解決の項目と、移行時の注意

最後の節から読んでください。私たちが解き明かせなかったことを教えてくれる節です。

再構築が行うことはすべて、この文書群と突き合わせて測られます。だからこそフェーズ 2 から 4 は、期待ではなく監査できる作業になります。

移行

レガシーのソースから、テスト済みの再構築へ。

4 つのフェーズがあり、署名せずに次へ進む人はいません。ゲートは通知ではなく停止です。前のフェーズが未署名なら、そのフェーズの作業は拒否されます。

Gate G1

調査

In
ソースコード、あるいは残っていた文書
Runs
ソースを分岐単位まで呼び出しグラフに分解します。ルールを抽出し、何かが書き留められる前に 2 回目のパスがそれを突きます。
Out
  • BUSINESS_RULES.md
  • DATA_CATALOG.md
  • AS-IS_<screen>.md
  • AI_UNCERTAINTY.md
  • er-diagram.md

Signs: 検証リード · アーキテクト · ビジネスアナリスト

Gate G2

設計

In
署名された仕様
Runs
モジュールごとの基本設計と詳細設計、そして利用者が実際に触れるすべての画面のクリックできるプロトタイプ。
Out
  • BasicDesign.md
  • DetailDesign.md
  • prototype.html
  • IMPLEMENT_PLAN.md

Signs: ソリューションアーキテクト · PM

Gate G3

実装

In
署名された実装計画
Runs
作業単位を分解し、アプリケーションのリポジトリへ実装して、単位ごとに証跡を記録します。
Out
  • TASKS.md
  • source in your repo
  • G3_evidence.md

Signs: エンジニアリングリード

Gate G4

テスト

In
再構築されたアプリケーション
Runs
Forge QA がテストを生成して実行します。失敗はすべて切り分けます。移行の問題か、テストの問題か。
Out
  • TEST_HANDOFF.md
  • test suite in your repo
  • G4_evidence.md

Signs: QA · お客様の最終受け入れ

人が G1 を見る前に、機械による確認が 2 つ走ります。文書がすべて揃っていても差し戻されることがあります。揃っていることと、質が伴っていることは別だからです。

Members only

Who signs which gate

7 roles · G1–G4 · the customer is accountable throughout

Sign in to unlock

Members only

What blocks, and what only advises

3 blocking checks · 1 advisory prompt

Sign in to unlock

すべてのコマンドと、その役割。

コマンドは 20 あり、うち 11 がクリティカルパス上にあります。ゲートレビューがフェーズごとに 1 回走るため、移行 1 件あたりおよそ 14 回の呼び出しになります。残りは、本筋の流れが代わりに呼び出す連携とユーティリティです。

お客様自身のコーディングエージェントの上で動き、独自のモデル呼び出しは行いません。別立ての推論費用は発生せず、ソースコードがすでに信頼している環境の外へ出ることもありません。

コマンドリファレンスを開く

なぜ信頼できるのか

どのルールも、こちらの確信度を添えて示します。

各ルールは、それが由来する構造に紐づけられ、その紐づけはリファクタリングを越えて残ります。「これはどこから来たのか」に、場所で答えます。

実証済み
コード上で確認し、作用のチェックとも一致しました。
確定した前提として、そのまま設計へ引き継がれます。
推定
ルール自体は実在します。ただし実行時の作用は独立に確認されていません。
G1 が閉じる前に、その領域を担当するレビュアーへ名指しで回されます。
矛盾
コードは、そのルールが言うとおりには動いていません。
「残すか直すか」の判断まで止まります。黙って直すことも、そのまま写すこともしません。

ほとんどのルールは「推定」に落ち着きます。そこが肝心です。「実証済み」は二度勝ち取る必要があります。一度はコードを読むことで、もう一度はコードがルールの主張どおりに動くかを確かめることで。

It finds the bugs you were about to rebuild.

2 回目のパスが、1 回目に反論します。片方はすべての引用を確認し直します。もう片方は主張を無視し、どのルールでも説明できない挙動がコードにないかを問います。

これによって、レガシー側の本物の不具合が見つかります。範囲が絞られていなかった削除、実行を止めないリダイレクト、もう存在しない関数への呼び出しなどです。それらが新しいシステムの仕様になってしまう前に、お知らせします。

欠陥ゼロを主張するレポートは発行しません。稼働中のシステムに対する静的解析が、その主張をする資格を得たことは一度もないからです。

何を移行するのか

3 つの資産、そしてそこに当てはまらないときの道。

資産が混在しているのが普通です。設計文書のあるサブシステムが 1 つ、コードしかないものが 4 つ — ごく当たり前の出発点です。

  • PHP

    フレームワークの有無を問いません。ファイル単位の手続き型ページも含みます。

  • COBOL

    メインフレームの資産、画面とバッチ。

  • .NET

    レガシーな ASP.NET と VB.NET。

解析できるソースがない場合は?

文書だけで進める道は、言語を問いません。仕様書、PDF、表計算、スクリーンショット — 残っていたものが何であれ、同じパイプラインに入り、同じ成果物一式を生みます。

何の上に作り直すのか

スコープを決める段階で合意した、お客様の選択に従います。この方法論は移行先を問いません。

セキュリティの現状も、あわせて手に入ります

10 年もののシステムには、10 年分の露出が積み上がっています。ルールを復元するのと同じパスが、ノイズを裁いたうえで、レガシー側の優先度つきセキュリティ所見を生み出します。

Questions we get asked

The ones that decide it.

ドキュメントがまったくありません。それは前提条件を満たさないということですか。
それがふつうの状況で、このキットが存在する理由です。典型的な資産では、5 つのうち 4 つがコードしかありません。ここではリバースエンジニアリングが代替策ではなく、本筋です。
AI がルールを捏造していないと、どう分かるのですか。
どのルールにも等級と出典の紐づけがあり、1 回目を突くための 2 回目のパスがあります。裏づけられないルールが、裏づけられたルールのように見えることはありません。
これはブラックボックスですか。
いいえ。当社のエンジニアがエージェントの成果物をレビューし、指名されたレビュアーは文書全体ではなく個々の検出に割り当てられ、各ゲートの受け入れはお客様が握ります。
引き継ぎ後、私たちのチームだけで運用できますか。
できます。ステージングでワークフローを実証したうえで、標準的なツールで再現できる方法をお渡しします。当社自身の実行を速くしている自動化そのものは、当社に残ります。

Members only

How to audit a bundle, in order

7 steps · what a verification team checks first

Sign in to unlock

Members only

Limitations, stated plainly

6 limits · read as carefully as the capability copy

Sign in to unlock

はじめる

いちばん取り繕いにくいところから始めてください。

サブシステムを一つお預けください。その本当の業務ルール、本当のデータモデル、そして私たちに判断がつかなかったものの正直な一覧をお返しします。本格的な移行が土台にするのと同じ、フェーズ 1 の成果物です。