
AIエージェントにもオンボーディングを ── 新人を迎えるように、仕事の範囲を渡していく
こんにちは。
株式会社エムステージコミュニケーションズで、ヘルスケアプロダクトの開発を担当しているサーバサイドエンジニアの鳥井です。
AIの進化は凄まじくAIに関しての話を聞かない日はありません。自身として開発のほとんどを、AIに任せている感覚があります。
詳細設計も、テストと動作確認も、レビューも、コミットもです。
ただ最初からこう任せられたわけではありませんでした。任せられる範囲が広がったのは、AIを「システム」ではなく「人」として扱うようになってからでした。人は採用されると、オンボーディングを受け、仕事を任されながら一人前になっていきます。その過程を、AIにも同じように踏んでもらいます。この記事では、AIを人として迎えようと思った背景と、実際にやっているオンボーディングの方法を書きます。
AIで開発していて「どこまで任せていいのか」と迷っているエンジニアに、何かひとつ持ち帰ってもらえたらうれしいです。
AIを「システム」として使うのは、もったいない
以前の私は、AIに調査や「これやっておいて」という作業、たたき台づくりを頼むくらいでした。こちらから依頼するだけで、AIから提案を受けることはありませんでした。それで困っていたわけではありません。ただ、AIをシステムのように扱い、そこで閉じてしまうのはもったいないと強く感じていました。AIができることを「システムができること」と捉えると、任せようと思える仕事の範囲はかなり狭くなります。
半年ほど前は、AIとの仕事を、バリバリできる新入社員がいっぱい入ってきて、めちゃくちゃ質問されているリードエンジニアのような感覚で捉えていました。ただ、会話をしていると、会話の流れや、疑問、検討している内容の文脈を理解したうえで返答してくれます。そこに知性を感じました。それなら、システムとして閉じるより、人として扱ったほうが一緒に活動できるのではないか。人と一緒に仕事をするように、AIも成長できるのではないか。そう考えるようになりました。人は会社に採用されると、オンボーディングを受け、仕事を任され、日々の仕事の中で一人前になっていきます。AIも同じだと思っています。
この記事でいう「採用」は、人を採用してから育てていくように、AIを迎えて育てていくことを指しています。AIを採用するときに欠かせないのは、どういった仕事の範囲をAIに担当してもらうのかを決めることです。仕事の範囲を渡すには、自分たちの作業がしっかり言語化されている必要があります。言語化した作業を仕事の範囲として渡し、任せることができれば、人間とAIはよりシームレスに協力でき、お互いに仕事を進めやすくなると考えています。人の育成とAIの育成を並べると、次のようになります。

AIエージェントをオンボーディングする
現在は、主にClaude Codeを使って開発しています。AIには、開発するときの考え方や全体の開発プロセスのフローとして規約を渡して理解してもらい、その過程で問題が起きたら相談してもらい、さらに作業を進めてもらっています。
オンボーディング資料を用意する
AIと協業するために、AIを「メンバーとして一緒に働く人」として考えます。新しいメンバーを迎えるときと同じように、AIに対しても「どのような立場・役割なのか」「何を期待しているのか」「どのような知識や判断基準が必要なのか」を、AIにも渡さないといけません。会社ごとのルールは、AIのコンテキスト(作業中に参照できる情報)として最初から持っているわけではありません。そこで、必要なドキュメントを先に作り、AIが確認できる場所にルールとして置いています。
これは、人間でいうオンボーディングです。
入口にしているのは、Claude Codeがセッションの最初に読み込む指示ファイルのCLAUDE.mdです。ここには、プロダクトの概要、技術スタック、アーキテクチャの要点、レビューとテストの方針、開発のフェーズ、エージェントの構成、ルールファイルの置き場所を書き、そこからほかの資料へたどれるようにしています。たどった先には、用語集やよく出る業務用語、業務の知識といったドメイン知識と、開発で守る原則を5つにまとめたもの、役割ごとに分けたAI(エージェント)の定義があります。エージェントの定義には、それぞれの役割と使ってよいツールを書いていて、AIがしっかり参照できるようにしています。AIには、これらを前提知識として持ったうえで作業してもらいます。
オンボーディングで欠かせないのは、ドメイン知識、開発フローの説明、それにまつわるルールだと考えています。
人間の開発手順を、そのまま開発フローにする
AIに開発してもらうにあたって、まず人間がどういう手順で開発しているかを書き出してみました。案件が振られたら、確認して不明点をなくし、開発を進め、自分でレビューしてテストし、問題がなければプルリクエストを作る、という流れです。この順番を開発フローとしてドキュメント化し、AIが参照できるように各リポジトリにルールとして記載しました。開発はいくつかのフェーズに分けていて、節目ごとに承認しないと次のフェーズに進まないようにしています。
手順ごとに担当するAIも分けていて、担当ごとに役割を細かく決めています。全体の指示は指示役が出していて、メインのAIが手順書を読んでこの役を務めています。
案件の確認では、要件を確認するAIが受け取った内容を分析し、足りないところを質問します。開発では、バックエンドとフロントエンドの実装者のAIが、規約を参照しながら実装します。バックエンドとフロントエンドの間で確認が必要になったら、指示役が相手側に取り次ぎます。
テストでは、PRDがあるなら、AIに先に完了定義(何ができたら完成かを先に書き出したもの)を作ってもらい内容を詳しく聞きながら現在考えていることとすり合わせてからテストコードと実装に進みます。動作確認もPlaywrightやDevToolsでAIにやってもらい、ドメイン知識を渡して、要件に合っているかや異常系も確かめてもらいます。
レビューは、実装したAIではなく別のAIが、観点ごとに分けたレビュー用のスキル(バックエンドとフロントエンドでそれぞれ8本)でします。指摘は実装者が直し、決めた回数を繰り返しても通らなければ、最後は人間に判断が上がってきます。最終的なジャッジとしてマージに確認が要ります。
ブランチ戦略、テストコードのルール、コーディング規約は、規約ファイルとして残しています。AIに何度も確認させるのではなく、スキルに閉じ込め、スキルから直接参照するようにしています。スキルに落とし込んでおくと、指示役のコンテキストを使わずに、各エージェントが必要なときに閲覧できるので、読んでもらいやすくなります。ほかにガードレールとして、ファイルを編集するたびに整形とlintが走るようにし、自動テストも用意して、Hooksでしっかり確認されるようにしています。
流れそのものは、人間が開発するときの手順と同じです。足したのは、自分でやっていたレビューを別のAIに任せることと、守ってほしいことをスキルやガードレールにしておくことくらいだと思います。
振り返りでルールを育てる
いまの構成には、振り返りの仕組みを入れています。これは、人間でもふりかえりを行って自分たちのコードとしてどういったことを行うべきかわからない内容が多いと思います。それを振り返りを通じてよりコードとして作業が進めやすくなったり判断の観点を増やすことにより勘所を養うことができていると思っています。
具体的には、一定以上の変更をpushしたあとは、振り返りをしないとセッションを終えられないようにして、スキル・ルール・エージェントへの改善案をAIが検討した結果を提出して判断するって形です。振り返りで出た教訓は記録に残し、何回再発したかを数えながら必要に応じてルールに昇格させたあとに再発したら、そのルール自体が効いているのかもチェックするようにしています。
この流れを図にすると、次のようになります。

AIと壁打ちしてエージェントを作り、試しに実装して振り返る、というサイクルを何度か回していき使わないAgentやスキルを削除していきました。これは振り返りを行わなければデッドコードが増えて余計なコンテキストも増えている状態になっています。そのため定期的な振り返りは今後としても有用な活動になっていくと考えています。
これは、ドキュメントと同じように、ルールも日々の開発の中で増えたり、使われなくなったりしていくと思います。そのときは、しっかり話しながら決めていき作業として今後どういうルールが必要かを考えたり、使わなくなったルールは削除することを検討していくことが大事です。またソフトウェアとしてもどんどん機能が追加されていきその時にライブラリーがアップデートされて規約が増えれば、ルールも増やしたり減らしたりすることが必要になってきます。
こうしてルールを選び、育てる作業を、一緒にしていくことによりAIが活動できる幅を増やしていき活動しやすくしています。これは人間と人間が一緒に働いているときも同じだと思います。こうした作業をしながら、実装者として一緒に働く仲間を育てることが大事だと思っています。
まとめ:まずはオンボーディング資料を書いてみる
AIをオンボーディングし、振り返りでルールを育てるようになって、いまは詳細設計、テストと動作確認、レビュー、コミットなど、開発のプロセス全般をAIに渡しています。最終の判断は人間が行いますが、それまでの過程はAIにどんどん任せています。
AIで開発していて「どこまで任せていいのか」と迷っているなら、まずは新しく入ってきた人に渡すつもりで、自分のAIに向けたオンボーディング資料を書いてみてほしいです。最初にやったことは、AIが最初に読むCLAUDE.mdを入口にして、ドメイン知識やルールのファイルへたどれるようにすることです。
どういう立場で、何をしてほしいのか
どういう判断の拠り所を持ってほしいのか
仕事に必要なドメイン知識
自分がどういう手順で開発しているのか
その手順にまつわるルール
書くことが、そのまま私たちの作業を言語化することになります。そしてそれはオンボーディングとして残り今後AIが発展したとしても資産として残り続けていくものです。
ご興味があれば是非カジュアル面談等でお話しましょう。
ご連絡お待ちしております。