ディレクション
投稿日:

AIコーディング外注を社内で説明するとき、何を比較するか

株式会社ファストコーディングで営業を担当しています長谷川と申します。お客様とお話ししていて気づいたことや、制作を依頼する際に知っておいていただきたいことを書いております。

以前の制作会社を選ぶ際の安心感についての記事で、「上司を説得するのにも、御社の資料が一番使いやすかった」というお客様の言葉をご紹介しました。作った後のことまで、具体的に説明した資料へのご感想でした。

AIコーディングの外注も、「AIを使うので速い」という説明だけでは、社内で判断しにくいと思います。何をAIで作り、どこまで検査し、どのような形で受け取るのか。そこが分かると、御社で必要な作業と比べられます。

今回は、製品情報のページを増やし、公開後は社内で更新したい案件を仮定して考えます。AIを使うことへの期待を、実際の制作範囲と確認できる資料へ置き換える話です。

AIが作る画面と、納品後に使う仕組みを分ける

Figmaを基にAIが画面のコードを生成しても、それだけで管理画面から製品情報を更新できるとは限りません。HTML・CSS・JavaScriptによる画面の実装と、CMSへの組み込みは、依頼範囲を分けて確かめたい内容です。

今回の例なら、見た目の完成に加えて、製品名、画像、説明文などを管理画面から更新できる形が必要です。AIで作るページ数だけを比べると、この運用の部分が抜けてしまいます。

AIが生成したHTML・CSS・JavaScriptの画面コードと、CMSへの組み込み、管理画面からの更新を区別する。CMS対応は依頼範囲を確認して実装する工程であり、コード生成だけで更新機能が完成するわけではない。
図1:画面コードの生成と、CMSへ組み込んで更新できる状態は別です。図は工程の区別を示すもので、依頼範囲は着手前に確認します。画像をタップすると拡大できます。

私なら、提案書には「AIがどの作業を進めるか」と「何を納品するか」を並べて載せます。例えば、次のような内容です。

比較すること今回の案件で確かめる内容
AIによる実装共通部品の定義を使って、どのテンプレートやページを生成するか
CMSへの組み込み製品名・画像・説明文など、何を管理画面から更新できるか
既存環境への対応既存テーマや実装ルール、ビルド環境へ合わせる作業を含むか
納品物選択した方式のソース、画像、共通部品、ビルド設定などをどこまで受け取るか

この区別があれば、片方は画面の実装まで、もう片方はCMSへの組み込みまで含む、という違いを説明できます。当社も、対象CMSと更新項目、既存環境を確認して対応範囲を整理しています。(*1) AIで生成することと、納品後に御社で扱える状態にすることを、一つの説明で済ませない方がよいと考えています。

「AIが作った」から、何を検査したかへ進める

もう一つ、社内説明で揃えたいのが品質の資料です。「AIが作り、AIがチェックします」と言われても、何を確かめたのかまでは分かりません。

製品ページが一度表示できても、長い製品名で文字が切れる、画像がないと余白が崩れる、といった状態が残るかもしれません。AIでページを増やす前に共通の実装ルールを定義し、生成後は実際の表示とコードを検査する工程まで確認します。

AIのコード生成後、ブラウザ表示をFigma・仕様と比較し、コードも別に検査する。差異や問題があれば修正して再検査し、対象ページ・画面幅・操作とともに結果を記録する。
図2:生成完了と検査完了を分け、指摘があれば修正後に再確認します。図中の検査項目は例で、動作確認や専任QCを含む実際の範囲は案件ごとに定めます。画像をタップすると拡大できます。

当社の公開している品質工程では、AIによるFigma分析や画面比較、スクリプトによる自動監査、AIレビューを組み合わせています。差異の修正や専任QC、修正後の再確認も含みます。(*2) すべてをAIへ任せるという説明ではなく、AIの出力をどの工程で確かめるかまでご覧いただければと思います。

今回の製品ページなら、私は次のような資料があるかを確かめます。

判断に使う資料そこから分かること
共通部品・実装ルールAIがページごとに別の構造を作らないための基準
表示・動作の検査結果対象ページ、画面幅、操作、期待する結果と実際の結果
指摘と再確認の記録修正した箇所を、修正後の版で確認し直したか
未確認・未対応の一覧何が残っており、納品前にどの確認が必要か

これなら、検査したという説明を、御社の製品ページに必要な確認と照合できます。検査記録があることだけで納品可否が決まるわけではありませんが、少なくとも「生成が終わった」と「確認が終わった」を区別できます。

制作時間の短縮を、そのまま公開日の短縮にしない

AIで制作が速くなるという提案は、魅力的です。ただ、どの工程を短くする話なのかは、分けて説明しておきたいと思います。

今回の例なら、共通する製品ページの反復実装と、CMSの更新項目を決める作業は別です。デザインの入稿や仕様の確定、生成後の検査も必要です。AIの実装が速いからといって、それらの期間まで同じ割合で縮むとは限りません。

社内向けの資料には、次の三つを分けて残すことをお勧めします。

  • 今回の確定条件:対象ページ、CMSへの対応範囲、納品物、提示された日程
  • 期待する効果:共通ページの制作を速めたい、公開後の製品情報を更新しやすくしたい
  • 未確認の条件:Figmaの入稿予定、例外状態の仕様、既存環境での動作確認

期待を、すでに確定した成果として書かない。この分け方なら、日程の前提が変わったときも、どの条件を見直せばよいか分かります。当社もお見積もり時に、対象ページ、実装内容、日程、確認方法、納品物を提示しています。(*3)

AIで任せる内容を、資料で見える形にする

AIによる実装範囲と納品物を分ける。生成後の検査を資料で確かめる。制作時間と公開日までの条件を分ける。この三つが揃うと、「AIを使うから」という説明から、御社の案件に必要な工程の比較へ進めます。

資料を増やすことが目的ではありません。例えば、今回の製品ページなら、CMSから更新できる項目と、長い製品名・画像なしを確かめる検査が見えるだけでも、質問は具体的になると思います。

社内で説明したい案件の概要と、比較に迷っている点を添えて、ファストコーディングへご相談ください。AIに任せる工程と、受け取る成果物が伝わる資料を、一緒に整理できればと思います。

参考情報

*1 AI駆動HTMLコーディング代行 よくある質問

*2 AI駆動HTMLコーディング代行 品質への取り組み

*3 AI駆動HTMLコーディング代行 ご依頼の流れ