レガシーのドキュメント化は「出力」ではなく「設計」から始まる
──業務で引ける・人もAIも読める・更新され続ける、3原則実践ガイド

高い費用をかけて数百ページの設計書を出力しても、共有フォルダの奥で誰も開かないまま眠る──これがAIリバースエンジニアリング活用で最もよく聞かれる声です。これはAIの性能不足ではなく、「設計書を出力すること」をゴールにした発注設計の問題であり、使われる設計書とは最初から「使われることを前提に設計された」ものだけです。本記事では、HITL5 REVERSEが定義する「業務で引ける／人もAIも読める／更新され続ける」3ドキュメント原則を、実践の視点から整理します。

1. 稟議を通し、費用を払い、数百ページが届いた。でも誰も開いていない

高い費用をかけて既存システムのコードをAIに解析させ、数百ページの設計書が出力された。プロジェクトは「完了」した。ところが半年後、その設計書は共有フォルダの奥に眠ったままだ。新機能開発の際にエンジニアが参照しない。現場担当者は「どこに何が書いてあるかわからない」と言う。経営者は「あの投資、何だったのか」と感じている。

これが2026年のAIリバースエンジニアリング活用で最もよく聞かれる声です。

この問題は、AIの性能不足ではありません。「設計書を出力すること」をゴールにした発注設計の問題です。使われる設計書とは、最初から「使われることを前提に設計された」ものだけ。この差が、投資の生死を分けます。

2. なぜレガシーシステムのドキュメント化は棚ざらしになるのか──3つの根本原因と見えないコスト

設計書が活用されない理由には、共通した3つのパターンがあります。

原因①：業務の言葉で引けない

コードの構造を技術的に文書化しただけでは、現場担当者が「今この機能を調べたい」というときに情報にたどり着けません。「受注処理フロー」「月次締め処理」という業務用語で検索しても、技術用語で書かれた設計書では答えが見つからない。

原因②：人間だけが読める・AIだけが読めるフォーマット

Word・PDFで作成された設計書は、次世代開発でAIに渡す素材として使いにくい。一方、機械可読性を重視した構造データは、人間には読みにくい。この両立ができていないと、設計書は「AIとの引き継ぎ」「人間同士の引き継ぎ」どちらにも使えない中途半端なものになります。

原因③：一度作ったら更新されない

システムは改修されるたびに設計書と乖離します。作成当初は正確だった文書も、3ヶ月後には「実際の動作と違う」記述が混じり、やがて誰も参照しなくなる。

3原因が引き起こす見えないコスト

「設計書が使われない」ことは、作成費用の損失だけで終わりません。その後の開発現場で毎回「現状把握のやり直し」が発生し続けます。当社支援実績では、エンジニアが設計把握に費やす無駄な時間が年間数百万円規模のコストになるケースが少なくありません。ドキュメント投資の失敗は、単発のコストではなく継続するコスト増として企業を圧迫します。

3. HITL5 REVERSEが定義する「使える設計書」の3原則

AIによる設計書の自動生成ツールが増える中、本記事が問うのは「生成後の活用設計」です。生成そのものは目的ではなく、手段です。

HITL5 REVERSEは、AIリバースエンジニアリングの品質規格として、ディレクトリジャパン株式会社が提唱するフレームワークです（AI-HITL5 Framework ／ ディレクトリジャパン株式会社 提唱 ／ 2026）。その根幹にある考え方が、以下の3ドキュメント原則です。

原則①：業務で引ける

設計書は「業務担当者が日常業務の中で必要な情報を即座に引き出せる」構造で作成します。業務プロセス・業務用語を索引軸とし、「月次在庫締め処理をしたい」「この取引先の割引ルールを確認したい」というユースケースから逆算した分類設計を行います。技術的な正確性よりも「現場で使える実用性」を優先することで、設計書の閲覧頻度と活用率が大きく変わります。

原則②：人もAIも読める

AIエージェントが設計書を参照して実装・テストを行うことが標準的なワークフローになりつつあります。人間が読みやすいナラティブな説明と、AIが解析しやすい構造化データ（スキーマ定義・依存関係リスト・API仕様）を同一ドキュメント内に共存させる「デュアル構造設計」を採用します。人間の開発者が引き継ぐ際にも、AIへのコンテキスト渡しにも、同じドキュメントを再利用できます。

原則③：更新され続ける

設計書を「プロジェクト完了物」として一度作って終わりにしない。コードが変更されるたびに設計書も自動更新される仕組みをパイプラインに組み込むか、定期的なAI再スキャンサイクルを設計します。「設計書とコードの乖離をゼロに近づける継続的更新」がこの原則の本質です。

当社支援実績では、3原則を導入したプロジェクトで、設計書の月間参照回数が従来比4〜7倍に増加し、新機能開発時の設計把握工数が65%以上削減されています。

自社のレガシーシステムに3ドキュメント原則が適用できるか、まずは初回診断をご相談ください。

AIリバースエンジニアリング支援ページ｜初回診断のご相談

4. 3原則の実装──誰が・何を・どのように担うか

3ドキュメント原則は、理念ではなく実装の指針です。実現には、技術者だけでなく業務担当者との協働と、専門的な実装支援が必要です。

ここで登場する「FDE（Forward Deployed Engineer）」とは、AIツールを使いこなしながらクライアントの現場に深く入り込み、業務文脈を理解した上でドキュメント設計を担う専門チームです。技術会社に丸投げして「誰も読まない設計書」ができあがる、という失敗を防ぐための役割です。

特に「業務で引ける」原則の実装では、業務担当者の参加が不可欠です。初期設計の数週間、週2〜3時間程度の現場関与が、設計書の長期活用を左右します。

5. 投資対効果──3原則で何が変わるか

3原則を実装した設計書は、単なる「記録」を超えた複数の用途で価値を発揮します。

• 新機能開発の設計把握工数削減：エンジニアが「このシステムはどう動いているか」を調べる時間を大幅短縮（当社支援実績：従来比65%以上削減）
• 外注先・オフショアチームへの引き継ぎコスト削減：デュアル構造により、日本語説明と機械可読仕様を一括共有
• 次世代AIエージェントへのコンテキスト渡しの効率化：HITL5 CODEフェーズでの実装速度向上に直結
• 属人化リスクの恒久的排除：担当者退職・異動後も設計書が更新され続けることで、知識継承が制度化される

ROIの詳細試算については、AIリバースエンジニアリングのROI試算ガイド2026もあわせてご覧ください。費用感・支援内容のご確認はAI DIRECTOR初回相談ページからご案内しています。

6. REVERSEの後、CODEへ引き渡す──エコサイクルで投資を活かし続ける

AI-HITL5が定義するエコサイクルは「生む（HITL5 DESIGN）→ 作る（HITL5 CODE）→ 活きる（HITL5 RUN）→ 解き直す（HITL5 REVERSE）」という循環です。HITL5 REVERSEフェーズ（解き直す）で生まれた3ドキュメント原則準拠の設計書は、そのまま次フェーズ「作る（HITL5 CODE）」のアーキテクチャ設計・テスト設計の起点になります。

「解読して終わり」ではなく、「解読からシームレスに刷新へ」。このサイクルを回すために、最初から3原則を意識したドキュメント設計が必要です。

内製との比較：なぜ外部伴走が有効か

3ドキュメント原則は、社内チームで実施することも可能です。ただし、原則①の「業務で引ける」実装に必要な索引設計と、原則③の自動更新パイプライン構築は、初回導入に限っても相応の設計工数がかかります。FDEとAI DIRECTORによる伴走は、この初期設計の失敗リスクと立ち上げ工数を大幅に圧縮します。

7. AI DIRECTORとFDEチームの役割──「戦略」と「実装」が一体になる理由

3ドキュメント原則を正しく機能させるには、「何を優先するか」を決める戦略と、「どう実装するか」を担う現場の両方が必要です。

AI DIRECTOR（戦略）は、3原則の設計方針を経営課題と照合し、「どの業務フローを優先するか」「どこまでの精度が必要か」を判断する上流伴走の役割を担います。AIリバースエンジニアリングプロジェクト全体の方向性を決める入口ブランドです。

FDEチーム（実装）は、AI DIRECTORの方針のもと、現場でHITL5 REVERSEを実施します。業務知識を持つエンジニアが直接関与することで、AIの出力を「使える設計書」へ変換します。

戦略（AI DIRECTOR）が方向性を決め、武器（HITL5 REVERSE）で品質を担保し、チーム（FDE）が現場で動かす──この3層構造が、活用される設計書を生み出します。

8. 最初の一歩──何から始めればよいか

AIリバースエンジニアリングを「設計書を作るプロジェクト」として捉えると、失敗します。「使われ続ける知的資産を設計するプロジェクト」として捉えると、投資が生きます。

ディレクトリジャパンでは、AI DIRECTORによる戦略伴走とFDEチームによるHITL5 REVERSE実装が一体となって、初期設計フェーズから支援します。

「うちのシステムに3ドキュメント原則は適用できるか」──まずは以下からご相談ください。

よくある質問（FAQ）