- 連載:AIに、仕事の流れごと任せる
- AI技術
AIは設計書と照らし続ける。コードを読まない私が、品質を任せられた理由

※この記事は、noteで連載している「AIに、仕事の流れごと任せる」の第8回を転載したものです。元の記事はnoteでお読みいただけます。
株式会社Smallitの足立です。連載「AIに、仕事の流れごと任せる」の8回目です。
第4回で、「私はコードを読みません」と書きました。では、作られたものが正しいかを、私はどうやって確かめていたのか。今回はその話です。
コードの品質は、仕組みが見張る
【エンジニア募集中】フルリモート可◎、売上/従業員数9年連続UP、平均残業8時間、有給取得率90%、年休124日以上 etc. 詳細はこちらから>
まず、コードそのものの品質です。
SMAL WAYには、コードの書き方の決まりと、書いたコードを機械が自動で検査する仕組みが、最初から組み込まれています。AIが書いたコードは、この決まりと検査を通らないと先に進めません。
正直に言うと、この決まりは、私がエンジニアとして現場にいたころに自分で守っていたものより、ずっと厳しいです。人が目で見て確かめるより、品質は高く保たれます。しかも、AIが書くコードの品質は、これからも猛スピードで上がっていきます。ここで人が勝負する理由は、もうありません。
だから、人がコードを1行ずつ見張る必要はありません。人が見張るべきなのは、ただ1つ。作られたものが、仕様や要件に合っているかどうかです。
物差しは、最初に書いた3つの設計書
では、「合っているか」は何で測るのか。
第5回で、作り始める前に決めたことを書きました。そのうち3つが、ここで効いてきます。
– ① やりたいこと(何のために作るのか)- ② 実現すること(使う人から見て、何ができればよいか)- ③ 全体の地図(画面やデータが、どうつながっているか)
この3つを、最初に設計書にしておきます。細かい設計も、作ることも、試すことも、すべてこの3つに照らして確かめる。3つの設計書が、品質の物差しになっているのです。
変えるときは、さかのぼって確かめる
作っている途中で、細かい仕様を変えたくなることはよくあります。
そのとき、AIは変えた部分だけを見て終わりにしません。③全体の地図と食い違わないか、②実現することと合っているか、①やりたいことからずれていないか。下から上へ、順にさかのぼって確かめてくれます。
確かめるのは設計書だけではありません。「この変更を入れると、ここの作業が増えて、本番稼働日に影響します」と、スケジュールへの響きまで含めて助言してくれます。変えてよいかを決めるための材料が、最初からそろって届くのです。
これを人が毎回やろうとすると、大変です。何本もの設計書を読み返して突き合わせるのは、手間がかかるうえに疲れます。忙しいときほど、「このくらいなら大丈夫だろう」と、どこかで妥協が入ります。想定外のずれは、たいていそういうところから生まれます。
AIは、疲れませんし、妥協もしません。毎回、地道に設計書と照らし合わせて、違いがあれば指摘してくれます。
ただ、これが少しめんどくさいこともあります。私は頭の中で「これは上の定義まで含めて考えたうえで、末端の仕様だけ変えている」とわかっているのに、AIは律儀に「これだと、やりたいことが変わりますが、よろしいですか?」と聞いてきます。わかってるって、と言いたくなる。でも、この律儀さのおかげで、ずれが入り込まないのも確かです。
作った側と、確かめる側を分ける
もう1つの工夫は、作るAIと、確かめるAIを分けていることです。
人でも、自分が書いた文章の誤字は見つけにくいものです。AIも同じで、自分が作ったものの抜けには気づきにくい。だから、確かめる役は別のAIに任せています。
実際に、こんなことがありました。案件を絞り込む機能の1つが、作った側のAIの試験には、きちんと合格していました。ところが、実際に使うときと同じ形で動かしてみると、その絞り込みがまったく効いていなかったのです。作った側が試験のために用意したデータが偏っていて、うまく動く場合しか試せていませんでした。作った本人は、自分の用意したデータの偏りには気づきにくいものです。
見つけたのは、確かめる役を任された別のAIでした。そのまま営業に渡していたら、「絞り込んだのに、関係ない案件ばかり出てくる」と言われていたはずです。
人のチームでは、確かめる人を別に立てる余裕がなく、作った人が自分で確かめて終わることも少なくありません。AIなら、確かめる役をもう1人立てるのに、人を増やす必要がありません。
最後は、人が動くもので確かめる
それでも、最後に判断するのは人です。
仕様を作っている段階では、AIが複数の案を試作の画面にして見せてくれます。私はそれを見比べて、「使う人にとってどれが正しいか」を選びます。言葉の説明だけで決めるより、ずっと迷いません。作り終わったら、実物を触って、業務として正しく動くかを確かめます。

コードは仕組みが見張り、設計書とのずれはAIが見張る。人は、動くものを見て、業務として正しいかを決める。コードを読まない私でも品質を任せられたのは、この役割分担があったからです。
今回の問い
品質を守るために、人が見るべきところと、仕組みに任せてよいところ。皆さんの現場では、どこで線を引いていますか?
次回は、型を自分の現場に合わせる話です。使ってみてやりにくかったところを、どう直したかを書きます。
SMAL WAYの話を30分で聞きたい方へ:https://smallit.co.jp/smalway-adachi/
足立 高洋|株式会社Smallit 取締役
LinkedIn:https://www.linkedin.com/in/t-adachi/
X:https://x.com/smallitadachi
Facebook:https://www.facebook.com/smallit.adachi
【エンジニア募集中】フルリモートも◎(リモート率85.7%)、平均残業8時間、年休124日以上、有給取得率90% etc. 詳細はこちらから>



