メインコンテンツへスキップ
見出し画像

移行の見積もりは、Claude Codeで既存コードを調べてから出す──プランモードと読み取り専用の調査役で作る「テンプレート別の難度表」、要確認の一覧、調査費の計算例

    この記事は、jQueryや古いWordPressのサイトを移す前に、Claude Codeで既存コードを調べて、移行の見積もりを出す手順を扱います。

    「ページ数×単価」で出した移行の見積もりが、途中で崩れる

    トップと下層で30ページ。似たページが多いので、移行の見積もりはページ数で出した。
    作り始めると、1ページだけ独自のjQueryで動く検索があり、別のページには古い予約フォームが埋め込まれていた。


    移行の工数は、ページの数ではなく、ページの「作りの種類」と「隠れた動き」で決まります。
    それは、コードを読まないと見えません。

    移行の調査とは、既存コードを読み、ページを作りの種類ごとに束ね、それぞれの難度と「分からない点」を一覧にして、見積もりの根拠にする作業である

    黒字化の外科医です。既存コードの調査を、移行の見積もりの土台として解剖します。


    改修の見積もりの調査は、別の記事で扱いました。この記事は、それを「全部を移す」案件に広げた形です。

    ▶ 既存サイトの改修の見積もりを、Claude Codeの調査で速くする──プランモードで読ませる範囲、調べさせる項目、人が確かめる線と、リスクの上乗せを下げる計算例


    調査から見積もるべき理由は、三つあります。


    第一に、移行の手間は、テンプレートの種類で決まるから。
    同じ型のページが20枚あっても、作るのは1つの型です。逆に、1枚だけの特殊なページが、一番重いことがあります。


    第二に、jQueryの動きは、画面を見ても数えきれないから。
    スライダー、タブ、絞り込み、入力チェック。どのファイルのどの関数が動かしているかは、コードを読むと一覧にできます。


    第三に、調査の結果は、お客様への説明にそのまま使えるから。
    「この3つの機能は作り直しになります」と根拠つきで示せば、金額の話が早くなります。

    Claude Codeで使う機能:公式で確認したこと

    2026年10月29日に、公式ドキュメント(code.claude.com/docs の Common workflows、Subagents)で確認した内容です。

    プランモード
    ・ファイルを読み、計画を出すが、承認するまで編集しない
    ・claude --permission-mode plan で始めるか、作業中に Shift+Tab で切り替える
    
    調査をサブエージェントに任せる
    ・サブエージェントは自分の文脈でファイルを読み、要約だけを返す
    ・組み込みの Explore は、検索と分析向けの読み取り専用の役(Write と Edit は使えない)
    
    古い書き方の洗い出し
    ・公式の例に「非推奨のAPIの使用箇所を探す」頼み方がある


    調査の段階では、ファイルを書き換えない設定で動かします。お客様のコードを預かるときの扱いは、導入の設定で決めておきます。

    ▶ Claude Code導入設定キット、制作会社がそのまま置くファイル一式──チーム共有・個人・組織のsettings.json、CLAUDE.mdの雛形、hooksの守りの設定、席の割当表と運用表

    今すぐ試せる:移行の調査を頼むプロンプト

    プランモードで、リポジトリ(またはサーバーから取得したファイル一式)のフォルダで使います。

    このサイトを〔Next.js〕に移す見積もりのため、既存コードを調査してください。ファイルは編集しないでください。
    調査はサブエージェントに分けて、結果だけを返してください。
    
    1. ページを「作りの種類(テンプレート)」ごとに束ね、各種類のファイルと、該当するURLの例を挙げる。
    2. jQueryとプラグインの使用箇所を、機能(スライダー、タブ、フォームの入力チェックなど)ごとに一覧にする。版の記載があれば書く。
    3. フォーム、検索、会員、予約、外部サービス(地図、計測タグ、チャット)の箇所を挙げる。
    4. 各テンプレートに難度A(そのまま置き換え)/B(動きの作り直し)/C(仕様の確認が必要)をつけ、理由を1行で書く。
    5. コードだけでは分からない点を「要確認」として、お客様への質問の文に直す。
    6. データベース、サーバーの設定、外部の管理画面など、読めなかった範囲を最後に明記する。

    難度表工場:調査の結果を見積もりにつなぐ

    テンプレート別の難度表(型)

    テンプレート / 該当ページ数 / 難度 / 主な動き / 要確認の数 / 見込み工数
    トップ       / 1   / B / スライダー、お知らせ / 1 / 〔 〕時間
    下層の基本   / 18  / A / なし                 / 0 / 〔 〕時間
    お知らせ一覧 / 1   / B / 絞り込み             / 1 / 〔 〕時間
    予約フォーム / 1   / C / 外部の予約システム   / 3 / 〔 〕時間

    計算例(数字はすべて例)

    難度A:5種類 × 4時間 = 20時間
    難度B:4種類 × 8時間 = 32時間
    難度C:2種類 × 16時間 = 32時間
    テンプレートの合計:20 + 32 + 32 = 84時間
    時間単価 7,645円(例):84時間 × 7,645円 = 642,180円
    
    先に受ける調査費:8時間 × 7,645円 = 61,160円


    データの移し替え、URLの対応、検証、公開の工程は、この表の外に足します。WordPressからの移行の8工程は、こちらにまとめています。

    ▶ WordPress移行の見積もりを「ページ数×単価」で出すと赤字になる──調査・棚卸し・データ移行・URL・連携・検証の8工程で積む計算例と、前提条件の文例

    構造的なリスク

    逆説を指摘しておきます。


    Claude Codeの調査は速いので、無償の「ちょっと見ておきます」にしやすくなります。
    しかし、調査の結果に責任を持つのは、見積もりを出す自社です。


    また、AIが読めるのはファイルの中だけです。データベースの中身、サーバーの転送設定、外部サービスの契約は、人が確かめます。
    「読めなかった範囲」を報告から消さないでください。

    よくあるQ&A

    Q. サーバーにしかファイルがない古いサイトでも調べられるか?


    取得したファイル一式をフォルダに置けば、読ませられます。本番の認証情報やデータベースの書き出しは、読ませる前に扱いを決めます。


    Q. 調査費は、受注したら差し引くべきか?


    差し引くかどうかは、先に決めて書面に残します。差し引く場合も、断られたときに調査費だけは受け取れる形にします。


    Q. 調査の後、URLとSEOはどう扱うか?


    URLを変えるかどうかで、手順が大きく変わります。段階で移す進め方は、こちらに書きました。

    ▶ サイト移行のリダイレクトとSEO、「少しずつ移す」を誤解しない──中身は段階で入れ替え、URLは一度で変える。Google検索セントラルで確かめた手順、URL対応表の型、転送の工数の計算例

    最後に

    移行の見積もりは、ページ数ではなく、テンプレートの種類と隠れた動きで決まります。


    Claude Codeで読み取り専用の調査を先に有償で行い、難度表と要確認の一覧を根拠に見積もった会社だけが、途中で崩れない移行案件を受けられるのです。


    調査票と見積表の雛形は、受注キットにまとめました。

    ▶ レガシー移行の受注キット、jQuery・古いWordPressからNext.jsへ──調査票、Claude Codeの調査指示書、工程別の見積表、移行計画書、検証チェック40項目、契約の確認点

    これまでの記事は、メンバーシップ「黒字化オペ室」でまとめて読めます。月額1,980円、記事2本分の金額です。詳しくはプロフィールから。


    #Web制作会社 #ClaudeCode #Nextjs #サイト移行 #見積もり #jQuery #制作会社経営 #中小企業 #AI駆動開発 #レガシー移行

     
     
    Web制作・開発会社の「労働集約という病」をAIで冷徹に切除し、利益率を極限化する組織ハッキング術を公開。 人間の感情と作業を排除し、社長一人で莫大な富を搾取する「完全無人ファクトリー」を構築する覚悟を持つ経営者のみ、有料記事で圧倒的な暴利と勝利を手に入れてください。

    あなたへのおすすめ