
入社して2週間たつのに、まだ開発環境が動かない。既存コードを読んでおいてと言われたけれど、何のためのコードなのかわからない。初めてのレビューで20件指摘されて、次のPRを出すのが怖くなった。ITエンジニアの受け入れでは、業種が違ってもだいたい同じことが起きます。
技術力のある人を採っても、この会社のコードとチームになじむまでには、それとは別の手当てが要ります。初週に何をさせ、何を教え、レビューをどう書くか。連載「職種・働き方別オンボーディング」の第7回です。
立ち上がりは「最初のPRまでの日数」で測れる
エンジニアの受け入れには、他の職種にない利点があります。立ち上がりが「成果物」で見えることです。最初のPR(プルリクエスト)がマージされるまでの日数は、環境が整い、コードの文脈を理解し、チームの作法に沿って成果を出せた証拠であり、受け入れの質をそのまま映します。
この日数を延ばすものは、だいたい決まっています。まず環境です。リポジトリの権限、ローカル環境、CI、ステージングへのアクセス。どれか一つ欠けるだけで初週が消えます。次に文脈。既存コードは読めても、なぜこの設計になったのか、どこは触ってはいけないのか、誰が決めるのかがわからなければ、正しいPRは書けません。最後がレビューです。最初のPRへの指摘が評価のように見えると、新人は次のPRを小さく、遅く出すようになり、立ち上がりが止まります。
新人のなじみ具合を予測する役割の明確さ、自己効力感、周囲から受け入れられている感覚(Bauer et al., 2007)は、エンジニアの場合、何を任されているか、自分のコードが動いた実感、レビューで受け入れてもらえた感覚として表れます。最初のPRがマージされると、これが一度に満たされます。最初のPRまでを短くすることが受け入れの真ん中に来るのは、そのためです。
エンジニアの新人がつまずく5つの場面
| No. | つまずき | 何が起きるか | 設計で防ぐこと |
|---|---|---|---|
| 1 | 環境が整わない | 権限申請・環境構築で初週が終わる。「何もしていない」感覚で始まる | 入社前日までに権限とアカウントを用意し、環境構築手順を最新にしておく |
| 2 | 文脈がない | 既存コードの意図がわからず、正しい変更ができない。読むだけで数日消える | アーキテクチャ図・ADR(設計判断の記録)・「触ってはいけない箇所」を初週に渡す |
| 3 | レビューが評価に見える | 初PRに大量の指摘。次から萎縮し、PRが小さく遅くなる | 初PRは意図的に小さく。レビューは良い点を先に、must と nit を分ける |
| 4 | 質問のハードル | チャットに「初歩的なこと」を書けない。詰まったまま半日 | ペア・モブの時間を固定。「詰まったら30分で聞く」をルールにする |
| 5 | 即戦力扱い | 中途は「わかるでしょ」で放置される。技術はあっても、この会社の進め方は知らない | 中途にも同じ90日を適用する。省略するのは技術研修だけ |
初週:初日に環境、初週に最初のPR
初週の目標は一つ、「最初のPRを出す」です。そのために初日は環境、2〜3日目は文脈、4〜5日目にPRという順で組みます。
エンジニアの初週の設計
| No. | 日 | 主題 | すること | 誰が |
|---|---|---|---|---|
| 1 | 入社前 | 権限 | リポジトリ・チャット・課題管理・ステージングの権限を発行。環境構築手順を誰かが最新版で通しておく | EM+情シス |
| 2 | 1日目 | 環境 | 手順に沿って環境構築。詰まったらバディが隣(またはペアの画面共有)で解決。手順の不備はその場で直す | バディ |
| 3 | 2〜3日目 | 文脈 | アーキテクチャ図・主要な設計判断(ADR)・「触ってはいけない箇所」・レビューの作法を読む。テックリードと1時間、「なぜこの設計か」を聞く | テックリード |
| 4 | 4〜5日目 | 最初のPR | 意図的に小さいタスク(ドキュメント修正・小さなバグ・テストの追加)でPRを出す。バディが最初のレビュアー。当日中にマージ | バディ |
| 5 | 週末 | 振り返り | EMと30分。「初週でわかったこと・わからなかったこと」「環境構築で詰まった箇所」を記録し、手順に反映 | EM |
最初のPRをわざと小さくするのは、成果のためではなく、一周を経験してもらうためです。環境が動き、コードを変え、レビューを受け、マージされる。この一周を初週に経験すると、「この会社でもコードを出せる」という手応えが最初にできます。バディと90日で8回以上会った新人の97%が「早く戦力になれた」と答えたのに対し、1回では56%でした(HBR, 2019)。エンジニアのバディは、環境構築の隣と最初のレビュアーを担うことで、初週だけで数回の接点を持てます。バディ制度を開発チームに当てはめると、こうなります。
技術より、この会社の判断の基準を教える
エンジニアの受け入れでよくある思い込みが、技術を教えなければ、というものです。言語やフレームワークの使い方は、採用した時点で本人が持っているか、自分で学べます。教えなければならないのは、この会社の判断の基準です。なぜこの設計を選んだのか。速度と品質、互換性と簡潔さのどちらを優先するのか。どこまで自分で決めてよく、誰に相談すべきなのか。
エンジニアの受け入れで教えること・教えなくてよいこと
| No. | 区分 | 内容 | 渡し方 |
|---|---|---|---|
| 1 | 教えなくてよい | 言語・フレームワークの一般的な使い方、アルゴリズム、一般的な設計パターン | 本人が持っている。必要なら学習リソースを示すだけ |
| 2 | 教える(文脈) | このシステムの構造、主要な設計判断の理由、歴史的経緯(「なぜこの変な実装が残っているか」) | アーキテクチャ図・ADR・テックリードとの1時間 |
| 3 | 教える(判断基準) | 何を優先するか、どこまで自分で決めてよいか、いつ相談するか、どのくらいの粒度でPRを出すか | 役割の文書(ロールクラリティ)と、レビューでの言葉 |
| 4 | 教える(作法) | レビューの流儀、ブランチ運用、リリースの流れ、障害時の動き方 | 手順書と、初週の小さなPRでの実体験 |
新人がぶつかる予想外の出来事に、意味を教えてくれる相手がいるかどうかで、なじみ方は変わります(Louis, 1980)。エンジニアにとっての予想外は、コードの中にあります。「なぜここはこんな実装なのか」という疑問に、「3年前の障害の後にこうなった」と答えてくれる人がいれば、新人はコードを「歴史のある判断」として読めます。いなければ「変なコード」として読み、勝手に直して怒られます。
レビューを、試験にしない
コードレビューは、エンジニアの受け入れでいちばん回数の多い接点で、いちばん壊れやすい接点でもあります。上達には、やってみて直されるという練習が要ります(Ericsson et al., 1993)。ところがレビューが評価に見えた途端、それは練習ではなく試験になります。
新人のPRをレビューするときに守ること
- 良い点を先に書く。「ここの分割は読みやすい」の一言があると、続く指摘が「直せ」ではなく「もっと良くできる」に読める
- must(マージに必要)と nit(好み・提案)を分ける。20件の指摘のうち must が2件なら、そう書く。全部が同じ重さに見えると萎縮する
- 「なぜ」を添える。「この書き方にして」ではなく「この書き方だと障害時に追いやすいので」。判断基準を渡す機会にする
- 初PRは当日中にレビューし、当日中にマージする。最初の一周を長引かせない
恥ずかしい質問をしても大丈夫だと思えるかどうか(心理的安全性、Edmondson, 1999)は、開発チームでは、初歩的な質問をチャットに書けるか、わからないコードを「わからない」と言えるか、という形で表れます。Google の調査でも、成果を出すチームをいちばんよく言い当てていたのがこの要素でした(Google re:Work, 2015)。上のレビューの書き方と、「詰まったら30分で聞く」ペア・モブの固定枠は、心理的安全性を開発チームのやり方に置き換えたものです。
90日の流れと、EM の1on1
ITエンジニアの新人の90日
| No. | 時期 | 到達目標 | 支援 |
|---|---|---|---|
| 1 | 初週 | 環境構築完了。最初のPRがマージされる | バディが隣。テックリードと1時間。EMと30分 |
| 2 | 〜30日 | 小さな機能・バグ修正を一人で。PRの粒度がチームに合う | 週1回30分の1on1(EM)。週2回のペア・モブ。レビューは4原則で |
| 3 | 〜60日 | 中規模の機能を設計から担当。他の人のPRをレビューする側にも回る | 設計レビューにテックリードが同席。「なぜ」を言語化する練習 |
| 4 | 〜90日 | 一つの機能領域を担当。障害対応に参加できる。次の新人の環境構築を手伝う | 90日面談。3指標を確認。次の90日の担当領域 |
会社への愛着をいちばん強く左右するのは、つらいときに相談に乗ってくれる上司がいるかどうかでした(尾形真実哉『若年就業者の組織適応』白桃書房, 2020)。エンジニアのつらいときは、障害を起こしたとき、レビューで大量に指摘されたとき、見積もりを外したときです。EM との週1回30分の1on1は、コードの話ではなく、こういうときの気持ちを拾う場にしてください。コードの話はレビューとペアで足りています。
中途エンジニアにも、この90日をそのまま適用します。省略してよいのは技術研修だけで、環境・文脈・判断基準・レビューの作法は、経験年数に関係なく「この会社では初めて」です。中途採用者のオンボーディングで書いた「即戦力だから放っておかれる」失敗は、エンジニアでとくによく起きます。
最初のタスクは何を渡せばよいですか。
「1日で終わり、失敗しても影響がなく、レビューとマージまで一周できる」タスクです。ドキュメントの誤字修正、既知の小さなバグ、テストの追加が定番です。避けるべきは「まずコードを読んで理解して」という成果物のないタスクと、いきなりの機能開発です。前者は自己効力感が立たず、後者は初PRが大きくなりレビューが試験になります。
中途のエンジニアにも同じ受け入れが必要ですか。
必要です。中途が持っているのは技術であり、この会社のコードの文脈・判断基準・レビューの作法は持っていません。「経験があるから」と放っておくのは、中途エンジニアが早く辞める大きな原因です。技術研修だけを省き、初週の設計と90日はそのまま適用してください。中途はむしろ「聞けない」(経験者として聞きにくい)傾向があるので、ペアの枠を固定する価値が高いです。
レビューが厳しい文化で、新人だけ甘くするのは不公平では。
甘くするのではなく、分けるのです。must と nit を分け、良い点を先に書き、「なぜ」を添える。これは新人に限らず、チーム全員のレビューをよくするやり方です。厳しさとは指摘の量ではなく、must の基準の明確さです。新人のPRでこの書き方を試し、よければチームの標準にしてください。
フルリモートの開発チームではどうすればよいですか。
「バディが隣」を「画面共有をつなぎっぱなし」に置き換えます。環境構築の初日は必ず同期で行い、詰まった瞬間に画面を見てもらえる状態にしてください。ペア・モブは週2回の固定枠として予定に入れ、レビューは非同期でも当日中を守る。接点全般の組み方は[フルリモートのオンボーディング](/column/remote-onboarding/)に書きました。
連載:職種・働き方別オンボーディング
- 第1回フルリモートのオンボーディング|偶然の接点がゼロの前提で、接点の量と初週を設計する
- 第2回シフト勤務のオンボーディング|「誰も新人を見ていない日」をなくす、シフト表からの設計
- 第3回ハイブリッド勤務のオンボーディング|「出社したのに誰もいない」を防ぐ、出社日の設計
- 第4回事務・バックオフィスのオンボーディング|手順書があるのに立ち上がらない理由と例外の教え方
- 第5回営業職のオンボーディング|数字が出るまでの90日と、現場マネージャーの負担を減らす設計
- 第6回パート・アルバイトのオンボーディング|「すぐ辞めるから」の逆説と初日〜2週間の最低ライン
- 第7回ITエンジニアのオンボーディング|「最初のPR」までを短くし、技術ではなく判断基準を教える



