新規プロジェクト参画時はこれをやれ
目次
はじめに
11月から会社が変わり、新しいプロジェクトに参画して1ヶ月が経ちました。ありがたいことに良いフィードバックを頂けて、スムーズに進めることができています。
今回で3社目、関わったプロジェクト数も10件を超えて、エンジニアとしてのスタートダッシュの仕方や必要なマインドが分かってきました。
何事も初めが肝心。ということで今回私自身が新規プロジェクトへの参画で心掛けたことを順番に書いていきます。
新しい環境に変わった人、また新人に環境を用意しなければならない立場の人に少しでも役立てばうれしいです。
1. 環境構築は駄々をこねながら最速で
足りないって言いまくる
参画してすぐは、既にいるメンバーやリーダーが一番優しく答えてくれる時期。気持ち的には初めての人間関係と環境に戸惑う部分も多いですが、ここで質問を積極的にしないと、時間がかかっている印象を与えるし、後のコード関連など技術力や評価に関わる質問はますます出来なくなります。
新メンバー用に準備をした経験からも、主に権限やソフトウェア周りはどれだけ整備しても不足しがちです。
新規メンバーの環境が整わないのは間違いなく組織側の責任なんだから恐れることはありません(震え声)。
逆に与えてもらうだけのフェーズはほぼここだけで、環境構築が終わった先は、「どう貢献するか」常に意識する必要があります。そこへできるだけ早く切り替えるために求めている、というスタンスで図々しくいきましょう。
環境構築のゴールはテスト環境の再現
私はいつも、ローカルでテスト環境と同様のものが動くのを確認するのを最優先で進めています。これは当たり前と思う人も多そうですが、新しい環境で視野が狭くなっていたり、経験が少ないとここまでたどり着けないことも多いです。
- テスト環境がどこにあるのか、だれが知っているのか聞くのが気まずい
- 開発=コード作成、編集 という意識でエディタ周りの構築に気を取られがち
というところで躓いて、新人の頃は、なにを作っているか開発をはじめても把握できていない、という状況になった覚えがあります。
ローカル上に壊しても良いものをしっかりと再現して、ユーザーとしてたくさん触ると、サービスの理解度は格段に上がります。
またこれをやっておくと、過程で開発に必要な物は勝手にインストールされていくのもよいところです。
私自身は今回経験者枠だったので、権限周りや契約・人事関連を片付けながらでも、遅くとも3日以内くらいで分かるようになることを目安にして進めました。
準備する側も、その期間を目途に未経験者でもローカル上でテスト環境を動かして再現できる状況だと望ましいと思います。
2. キョロキョロ周りを見て状況を知る
チャット履歴は情報の宝庫
過去のやりとりは情報の宝庫です。
よく「仕様書とかだけで十分でしょ」と言われることはあると思います。私もプロジェクト関係なくよく言われていました。それにドキュメントを整備する側に回ってみると、せっかく作ったから活用してほしいという気持ちが働くので、そういった気持ちもよく分かります。
ただ、チャット履歴には、
・過去、何の課題に困った
・将来どんな構想を描いている
・なぜこのドキュメントが残っているのか
などの暗黙知が残っており、目を通すと時系列で状況を追うことができます。既存メンバーはリアルタイムで経験をしているので説明不要ですが、新参者は当然知りません。
時間を割いて読んでおくと、解像度は段違いです。
その後のミーティングや面談でも、「〇〇のDBの移管も来年くらいにやりたいらしいですね」「✕✕の部分って、ドキュメントは簡潔なのに『複雑』ってSlackのやりとり見かけたんですが、どういうところで作業止まりますか?」など、質問がすごく具体的になります。
私が今回参画したプロジェクトは1年前から始まったらしく、slackの履歴も1年分残っていたので全て目を通しました。
良く反応してくださる方のことや、チームの雰囲気も掴むことが出来て、不明瞭さはだいぶなくなりました。
設計書と仕様書の把握
当たり前すぎますが、新人の頃は困った記憶があります。
未経験から入った場合は、こういった書類があることも知らないケースがあると思いますが、まずこの二つの在りかを探したり聞きましょう。
特に「慣れるための時間」を長めにとってもらえる良い組織であればあるほど、空いた時間をこういう事に充てられるかどうかで、その後の過ごしやすさが格段に変わります。
関わるプロジェクトの全体像をまとめなおす
まとめなおしの良いところは、自身のロールや興味の深いところを主軸に別のドキュメントができる点です。
もしセキュリティポリシー的にAIの活用が可能なのであれば、AIに要約を出力させるのは大変有用で、初期段階は特に役立ちました。(その後のファクトチェックは必要です)
私の場合は、コードを読んだあと、マークダウン形式で気になるところの概略を出力させたり、mmdcli (マーメイド) というツールがあるので、まだ作成されていなかったクラス図を最終的にsvgで出力させたりしていました。
インプット・アウトプットの流れや、継承されている基底の中核クラスや構造体、並列処理はどこで起こるのかなど、流れのイメージが掴みやすいです。
私の場合は既存システムのリプレイスプロジェクトだったので、新旧でどのような違いがあるか、旧システムの複雑さを作っているのはどこか、なども見えて構成把握を効率的に行うことができました。
3. グワーッと手を動かす
コードめっちゃ読む
いよいよ作業できる段階ですが、まずは現状把握が大事です。細部や正確なことは全てここに書いてあります。仕様書は理想と全体像、コードは"今現在のすべて"です。
いまを知らないと、どう変えていくべきかは見えてこないので、入り込んでいきましょう。
できてない前提で自信のあるプルリクエストを投げまくる
コードがいきなり本番を壊してしまうことは稀です。大抵は現在の責任者や詳しい人がいてレビューがあります。
いきなり完璧を目指しても、事業ドメインやサービスの強みに深く精通しない段階のコードは、分かっている人からすれば不十分なのは当然なので、あまり時間をかけずにさっと投げましょう。
ずっと考えているよりインタラクティブにやりとりをする方が生産的です。
気まずい相手にメンションしまくる
徐々にビジネスロジックが関わる詳細に差し掛かってくると、知らないことがどんどん出てきます。また、今まで質問を答えてくれたりサポートしてくれたりしていた担当者だけでは答えられないことが増えていきます。
この時に質問する相手を増やせると徐々に組織になじんでいくことが出来ます。
多少気後れしても、必要な仕事の連絡でなにか軋轢が生まれることはほとんど無いので、メンションする相手はどんどん増やしていきましょう。
勝手に決めて次に進む
ここまで状況を理解し仕事としてタスクを進められている状況になったら、立派に組織の一員です。もう、"まずは様子を見る"というフェーズは終わっています。
質問をしても、「それはまだ決まっていない」「明確なルールはない」みたいな回答が返ってくるようになったらそれはGOサインです。
どこまでは決めて良く、どこからは相談が必要、というラインが少しずつ見えてきていると思いますので、曖昧なところは自分で整備しつつ決断して進めていきましょう。それが提案や改善につながっていきます。
最後に
昨今はエンジニア不要論などがあったりしますし、私自身もAIの活用量は大変に増えました。
でも、ドキュメントを読んでドメインを理解した分だけ信頼を得られますし、直しがあってもPRを数多く投げた方が、積極的な印象になります。結局はこなす物量が大事ですね。
スタートダッシュを決めて、最短で居場所や立場を確保できるように進めていきましょう!
Discussion