AI駆動開発
投稿日:

AIの「実装済み」と「納品できる」を分けて進捗を管理する

株式会社ファストコーディングでフロントエンド開発と技術戦略を担当している黒田です。

AIがページの実装を終えると、進捗表にも完了の印を付けたくなります。コードが揃い、ブラウザにも画面が出ている。そこまで進んだことは、きちんと成果として捉えたいところです。

ただ、私が工程を考えるときに気になるのは、その印の中身です。検査をまだ実行していないページと、修正後の再検査まで終えたページ。同じ「実装済み」でも、納品までに残る作業は違います。

AIがコードを生成した件数だけでは、この違いが見えません。今回は、AIの作業結果をどう進捗へ反映するか、という話です。

実装の完了と、検査の状態を分ける

以前、オフショア開発からAIへ工程を展開した話を書きました。作業の開始条件と完了条件を明文化してきた経験は、AIを使う工程でも土台になっています。

一方で、その記事でも触れたように、曖昧な判断基準が原因でAIが想定外の動きをすることもありました。手順があるだけでは足りず、何を確認したら次へ進めるかまで決める必要があります。

進捗の「完了」も同じです。私なら、まずページ一覧に、実装の状態と検査の状態を別々に持たせます。最初から複雑な管理表にする必要はありません。

例えば、AIが実装を終えたページA・B・Cを考えてみます。ここでは、状態の違いを説明するための仮定例とします。

Aは、ブラウザでの検査をまだ実行していません。Bは、スマートフォンで見出しの重なりが見つかり、修正と再検査が残っています。Cは、案件で定めた必要な検査に合格し、最終承認を待っています。

AI実装済みのページAは検査待ち、Bは差異が残り修正と再検査待ち、Cは必要検査に合格し最終承認待ち。
進捗状態の比較(仮定例)

この三つを同じ完了欄に入れると、次に何を動かすべきかが見えにくくなります。Aでは検査の実行、BではAIへの修正指示と再検査、Cでは最終確認を進めます。

AIの実装が進んだことを過小評価する必要はありません。実装済みの範囲と、検査を通過した範囲を、それぞれ示せばよいと考えています。

AIの返答より、実行した結果を残す

状態を分けても、更新の根拠がAIの「確認しました」という返答だけなら、同じ問題が残ります。

例えば、AIにメニューを実装させた場合です。コードを読み直したのか、ブラウザを開いたのか、実際にメニューを操作したのか。この違いを、進捗の記録から追えるようにします。

私なら、検査の依頼には対象の版とページ、画面幅、操作、期待する結果を含めます。AIや検査ツールが返した実行記録と照合して、状態を更新するためです。

先ほどのBなら、次のような記録にします。

  • 対象は商品一覧の修正版。比較するFigmaと実装の版を指定する
  • 案件で決めたスマートフォン幅で、長い商品名を表示する
  • 期待する結果は、見出しと隣の要素が重ならないこと
  • 実際の表示と検査結果を残し、差異があればその箇所を記録する

こうしておけば、AIが何を確認したかだけでなく、どの条件が未確認かも分かります。画像を取得しただけなら、操作の検査まで終わったことにはしません。

もう一つ、未実行と不合格は分けたいところです。確認環境へ接続できず検査できなかった場合、実装に問題があると判定したわけではありません。ただし、合格の根拠もありません。

この場合は、実行できなかった理由と必要な対応を残します。未確認を合格へ繰り上げなければ、検査の結果と、検査を動かすための問題を分けて追えます。

AIへ修正を頼んだ後も、再検査を残す

Bの見出しの重なりを、AIに修正させるとします。このとき「直しました」という返答で指摘を閉じると、修正したつもりの状態が進捗へ入り込みます。

AIへ渡したいのは、対象の版、問題が起きる条件、実際の表示、期待する結果です。生成し直したコードだけでなく、確認環境へ反映された版まで対応付けます。

その後、問題が起きた条件で検査を実行し直します。共通部品を変えたなら、その部品を使う関連ページや画面幅も確認対象に含めます。どこまで戻るかは、変更内容から決めます。

検査の指摘と期待値をAIに渡し、AIの修正後にブラウザで再検査する。差異が残れば修正へ戻り、条件不明や上限到達は判断待ち、合格は最終確認待ちへ進む。
修正・再検査(設計例)

私は、自動修正を際限なく繰り返す進め方も避けたいと考えています。同じ条件で直らないのか、仕様が曖昧なのか、検査環境の問題なのか。原因が違えば、次に取る対応も違います。

そのため、自動修正には回数の上限を決めます。上限に達した場合や仕様を確定できない場合は、原因と試した対応を添えて判断待ちにします。これは記事で提案する運用の考え方で、サービスの一律の修正回数を示すものではありません。

止まっている項目を記録すると、進捗が悪く見えるかもしれません。それでも、残った問題を見えなくするより、何が解決すれば進むのかを示すほうが、日程を考える材料になります。

納品までに残るものを、進捗の中に置く

当社のAI駆動HTMLコーディング代行の品質工程でも、AIの生成後に検査、修正、再確認を行います。AIMESは、その検査待ちや判断待ち、修正、再確認と完了条件を管理するための基盤です。

AI駆動開発でも、人による設計判断や専任QC、納品可否の確認は残ります。AIの作業が終わったこと、必要な検査が通ったこと、最終承認を得たことを混ぜずに追う、という関係です。

進捗を見直すなら、最初は次の三つで十分だと思います。

  • AIの実装済み範囲と、検査に合格した範囲を分ける
  • 未実行、差異あり、修正後の再検査待ちを、根拠と一緒に残す
  • 必要な検査の合格と、最終の納品承認を分ける

これなら、ページ数の報告に加えて、納品までに何が残っているかを説明できます。まずは御社のページ一覧で、「実装済み」の後に残る作業を見直してみてください。

検査や修正の状態まで追える工程を整えたい場合は、ページ構成と現在の確認方法を基に、ファストコーディングへご相談ください。