
【AI×社内システム開発 #2】9つの役割を持つAIチームで、プロダクトをつくるハナシ | NOT A HOTEL
この記事は、NOTAのテクノロジー連載「Tech Behind the Scenes」です。
こんにちは、中尾(@nakaohiroshi)です。NOTA(旧 NOT A HOTEL)でソフトウェアエンジニアをしています。
いよいよ冬本番に差し掛かって加湿器をフル稼働で対抗しています。
乾燥すると体調を崩しがちなので、乾燥には敏感です。
乾燥肌にならないように、50歳手前にしてスキンケアにも抜かりありません。
最近はこの無印のクリームと、ハイスキンのワセリン配合のジェルがが手放せません。今年はこのツートップで立ち向かいます。

さて1本目の記事では、AI に役割を分けて開発していることを書きました。今回は、その役割たちを、もう少し詳しく紹介します。
NOTA では、AI を使った開発のやり方を、チームごとに、人ごとに探りながら、やってみてよかったことを共有し合っています。
この記事に書くのは、そのなかで、わたしが現場と話しながら進める開発に、合っていた具体的なやり方です。
3年前の記事(運営システムをゼロから作るハナシ)では、現場の運営、建築、CS、PdM、エンジニアと議論を重ねながら、宿泊の運用システム(PMS)を作る楽しさを書きました。
いまは、その「議論しながら作る」チームを、AI の役割たちが手伝ってくれている感覚です。
NOTA では、宿泊のほかに、ガレージ(NOT A GARAGE)や住宅(NOT A HOUSE)など、扱う事業が増えています。事業が増えるたびに、開発には新しい課題が出てきます。それを、運営や CS の現場と話しながら、形にしています。
全部を1つの AI に任せない
最初は、1つの AI に仕様の整理から実装、確認までを全部お願いしていました。動きはするのですが、だんだん気づきました。
作った本人が、自分の作ったものをチェックしても、見落としが多い。
これは、人間でも AI でも同じです。人間のチームが、書いた人とは別の人にレビューを頼むのと同じ理由です。
そこで、役割ごとに AI を分けてみました。
9つの役割
1本目では8つの役割を紹介しました。今回は、1本目では触れていなかった、オーナー向けのモバイルアプリ担当を加えた9つです。
PM: 何を作るかを整理する。仕様や確認項目のレビューもする(実装はしない)
UI/UX デザイナー: 画面の構成や操作の流れを設計する。デザイン規約の番人(実装はしない)
調査担当: 他社サービスやモダンな SaaS の事例を調べて、「学び」と「適用案」にまとめる
バックエンド: API(システム同士がやり取りする窓口)の実装
フロントエンド: 画面の実装。まずモック(動く見本)を作り、次に API をつなぐ
モバイルアプリ: オーナー向けアプリの実装
QA: 確認項目の作成、実機テスト、不具合の切り分け
コードレビュー: PR(変更の提案)を出す前に、バグ・仕様とのズレ・テスト不足を指摘する
ドキュメント: 仕様書の清書、README(説明書)、リリースノート

人間の役割を置き換えるものではなく、開発の作業を分けて任せるための役割です。何を作るか、どこまで任せるかを最後に決めるのは人です。
名前を見ると、人間のチームの役割分担とほとんど変わらないと思います。あえて、人間のチームと同じ分け方にしました。チームの設計は、人間でも AI でも、同じ原則で考えられると思っています。
PM はコードを書かない: 役割ごとに「やらないこと」を決める
役割を分けるときは、「何をやるか」より、「何をやらないか」を決めることを重視しています。
PM・調査担当・QA は、コードを直接編集するのではなく、それぞれ仕様の整理や調査、動作の確認に集中します。QA は、不具合が見つかったときに原因を切り分け、実装を担当する役割に伝えます。
デザイナーは設計に、コードレビュー担当は問題の発見に集中するようにしています。実装まで一緒に任せるのではなく、役割を分けることで、それぞれの観点を生かせるようにしています。
決める人と作る人を分けておくと、「作りやすいから、仕様をこう変えよう」という流れを避けられると考えています。
仕事を始める前に、多くの役割に読ませる資料
実装や設計、レビューを担当する役割の多くには、仕事を始める前に NOT A HOTEL のドメイン知識(事業の前提知識)を共有しています。
ビジネスモデルや用語の定義、業務上守るべきルールなどをまとめたものです。AI が事業の背景を理解したうえで、それぞれの仕事に取り組めるようにしています。
AI は、放っておくと一般的な正解を出してきます。でも、NOT A HOTEL には、宿泊や契約に関わる独自の業務ルールがたくさんあります。
最初に共通の前提を渡しておくことで、「それは一般論としては正しいけれど、うちでは違う」というズレを減らすのが狙いです。
1つの機能ができるまでの流れ
大きめの機能を作るときの標準的な流れを、例で紹介します。
題材は、1本目で紹介した「よく使う画面を固定できる機能(ピン留め)」のような、画面まわりの新機能です。実際の経過をそのまま再現したものではなく、標準的な流れを例にしています。
PMが「何のための機能か」を整理する
「運営スタッフが、毎日同じ画面に何度もたどり着く」という課題を言葉にして、受け入れ基準(完成の条件)まで書く。QAが、仕様から確認項目を洗い出す
「固定できる数の上限は?」「ログアウトしたら残る?」など、観点を先に出す。それを PM がレビューする。UI/UX デザイナーが、画面と操作を設計する
置く場所、空の状態、どのキーで操作できるかを、フロントエンドが迷わない粒度で書く。フロントエンドが、その設計に沿ってモック(動く見本)を作り、実装を進める
コードレビュー担当が、変更内容を確認し、問題点を指摘する
レビューの結果を踏まえ、人が変更内容を確認してマージを判断する
マージ後に、QA が確認項目に沿って画面で動作を検証し、必要な修正を担当の AI に伝える
この流れでは、実装が始まる前に、「何ができたら完成か」が何度も文章になっています。実装する AI は、その文章に沿って作ればよいので、迷う場面を減らせると考えています。

AI 同士の受け渡しは、ファイルで行う
AI 同士の受け渡しは、ファイルで渡すことにしました。PM が仕様をまとめたら、一時的な場所にファイルとして書き出します。デザイナーが設計を書いたときも、同じです。次の役割は、そのファイルを読んで作業を始めます。
ファイルで渡すと、何が渡されたかが明確で、人間もその場で読めます。仕様や確認項目のように残したいものは、Notion に保存します。

宿泊の運用システム(PMS)と、オーナーさまの契約・収支の社内ツール(OMT)で、同じ機能を並行して実装してもらったことがありました。そのとき、2つの AI が同じ名前のファイルに完了メモを書いて、片方が上書きされてしまいました。
同じことが2回起きたので、ファイル名に「どちらのシステムの作業か」が分かる名前を入れることを、依頼文に1行足す運用にしました。小さな工夫ですが、並行で動かすなら、先に決めておきたい約束でした。
作業の大きさで、AI の使い方を変える
全部を毎回フルで回すと、小さな修正には重すぎます。そこで、規模でやり方を変えています。
小(1〜2ファイルの修正): メインの AI(いつも話している AI)で直接やる
中(1機能で3ファイル以上の変更): 担当の AI に単発でお願いする
大(新機能や複数の領域にまたがる変更): 上の流れを、段階ごとに順に進める

ちなみに、typo(誤字)の修正に、9つの役割を総動員することはありません。
役割ごとに、専用の記憶を持たせる
各役割の AI は、仕事で得られた知見を、次の作業にも生かせるようにしています。同じ失敗を繰り返さないように、気づいたことや改善したことを蓄積していく仕組みです。
よく動く役割ほど、仕事の進め方に関する知見も増えていきます。人間のメンバーが、仕事を通じて得意になっていく感じに近いです。
コードレビューは、確信度と証拠をつけて報告する
コードレビュー担当には、「確信度」と「証拠」をつけて報告するというルールがあります。
指摘ごとに、確信度(高・中・低)を明記する
該当するファイルと行、なぜ壊れるのかを書く
読んでいない場所を、読んだように書かない
「たぶん問題あります」と言われるより、根拠つきで報告してもらえるほうが、受け取る側が判断しやすくなると感じています。
AI に任せた仕事も、最後は人が確認する
チーム内で情報を共有するときにも、AI に下書きを手伝ってもらっています。内容や共有先が適切かどうかを自分で確認してから、共有するようにしています。
役割は後から増やせる
最初から9つの役割があったわけではありません。今年の6月には、UI/UX デザイナーと調査担当を新しく追加しました。
きっかけは、社内ツールの画面改善が増えて、設計、事例調査、画面の点検、デザイン規約の整理を、メインの AI が全部引き受けるようになっていたことでした。設計を専門に見る役割がいなかったのです。
コードレビューにも、画面まわりの観点として、見た目の崩れ、押しても動かないボタン、誰でも使えるか(アクセシビリティ)を足しました。
追加するときは、役割の定義ファイル(その役割の説明書き)を書いて、チームの表に足します。定義ファイルの骨格は、おおむね次の3つです。
何を担当するか
何をやらないか
最初に読む資

定義ファイルを書いて表に足すだけなので、新しい役割を気軽に試せます。
元がバックエンドだったから、やりやすかったこと
元がバックエンドエンジニアなので、AI が書いたロジックを読むことには慣れています。その慣れが、役割を設計するときにも、効いたと思っています。
出てきたものを、仕様と照らして読む: 条件分岐や計算を読んで、仕様とのズレを見つけます。
困ったことを、仕組みにする: 同じ失敗が2回起きたら、約束として依頼文に書いておきます。
壊してはいけない条件を、最初に渡す: ドメイン知識に不変条件を書いて、AI に先に読ませます。
どれも別々の力ではなく、「ロジックを読み解いて、守るべき条件に落とす」という1つの動きです。
作る側に回すより、出てきたものを検品する側に回れたことが、この形が合った理由のひとつでした。
まだ測れていないけれど、期待していること
作った AI とは別の目でレビューされるので、見落としを減らしたい
外部の自動レビューが来る前に、手元で直せる指摘を、先に直したい
役割ごとの責任をはっきりさせて、やり直しを減らしたい
ある2つの PR で、外部の自動レビューの指摘をあとから分類したところ、設計の判断が必要なもの以外は、PR を出す前に直せたはずのものでした。
どれも、効果はまだ測れていません。内部のレビューが見落とすこともあるので、外部の自動レビューと突き合わせる運用は続けています。
チームの作り方そのものが、エンジニアの仕事のひとつになってきました。
NOTAでは、一緒に働く仲間を募集しています。気になった方は、ぜひ採用ページものぞいてみてください。