引き継ぎゼロの地獄を脱出 ― Claude Codeで既存コードベースをリバースエンジニアリング

「このシステム、誰も分からない」問題

前任者が退職し、ドキュメントもない。コードだけが残されたプロジェクト。これは多くのエンジニアが経験する悪夢です。Claude Codeはプロジェクト全体を一度に読み込んで構造を解析できるため、この問題を劇的に解決します。

ステップ1：全体像の把握

# プロジェクトルートでClaude Codeを起動
cd /path/to/mystery-project
claude

# まず全体構造を把握
> このプロジェクトの全体構造を分析してください。
  ディレクトリ構成、使用技術、アーキテクチャパターン、
  主要なエントリーポイントを一覧にしてください。

Claude Codeはファイルを次々と読み込み、依存関係を追跡し、プロジェクトの全体像を数分でまとめてくれます。

ステップ2：データフローの追跡

# 特定の機能のデータフローを追跡
> 「ユーザーログイン」機能のデータフローを追跡してください。
  フロントエンドのフォーム送信から、APIエンドポイント、
  認証処理、データベースアクセスまでの流れを図解してください。

# 結果：Mermaid形式のフローチャートが生成される

ステップ3：ドキュメントの自動生成

# READMEを自動生成
> このプロジェクトのREADME.mdを作成してください。
  セットアップ手順、環境変数、APIエンドポイント一覧、
  データベーススキーマを含めてください。

# API仕様書を生成
> 全APIエンドポイントを調査して、OpenAPI形式の仕様書を生成してください。

# ER図の生成
> データベースのスキーマを分析して、Mermaid形式のER図を作成してください。

ステップ4：危険箇所の特定

# セキュリティリスクの洗い出し
> このプロジェクトのセキュリティリスクを分析してください。
  SQLインジェクション、XSS、認証の問題、ハードコードされた
  シークレットなどをチェックしてください。

# 技術的負債の特定
> このコードベースの技術的負債をリストアップしてください。
  非推奨のライブラリ、重複コード、テストのないモジュールを
  優先度順に整理してください。

CLAUDE.mdに調査結果を蓄積する

解析結果はCLAUDE.mdに記録することで、次回以降のClaude Codeセッションでも活用できます。

> ここまでの分析結果をCLAUDE.mdにまとめて保存してください。
  次回のセッションで参照できるようにしてください。