Nstockの開発における 「認知負荷」へのアプローチ CHUO_Tech 2024-06-19 Yuki SHIMA

自己紹介 Make the startup ecosystem AWESOME 02 © Nstock Yuki SHIMA Nstock 株式会社のソフトウェアエンジニア 最近上野に引っ越しました。富山県出身。 先週末に２人で韓国行く予定だったんですが 友達の寝坊で一人旅になりました。 参鶏湯美味しかった。

Nstockにおける 開発生産性

いろいろやってます Make the startup ecosystem AWESOME 07 © Nstock 生産性を上げる努b u ドメイン勉強 u ユビキタス言語の整‚ u モブプロ、ペアプロの利V u GitHub CopilotやChat GPTな どLLMの利V u 読書 u 各自の得意な領域の共有会 生産性を下げない努b u 言語やライブラリの定期的な バージョンアッ} u 技術的Issueの洗い出x u Toilの解ˆ u Design DocやFigmaを使った図 式化

Nstockにおける開発生産性 Make the startup ecosystem AWESOME 08 © Nstock その中でも本日は コードを書くときの「認知負荷」 の話をします

開発生産性の妨げになる 「認知負荷」

Make the startup ecosystem AWESOME 10 © Nstock プログラマー脳 出版社：秀和システム ページ数：288ページ コードを「読む」ときの認知プロセス について記載されている書籍 ガチおすすめ

認知負荷へのアプローチ Make the startup ecosystem AWESOME 11 © Nstock VT 課題内在性負H ET 課題外在性負H CT 学習関連負荷

認知負荷へのアプローチ Make the startup ecosystem AWESOME 12 © Nstock IG 課題内在性負荷 取り組むタスク自体の難しさ これ自体を大きく減らすことはできない事が多い。分割するのが効果的。 例）ドメイン知識が求められるもの（Nstockでいうとストックオプション そのものの知識）

認知負荷へのアプローチ Make the startup ecosystem AWESOME 13 © Nstock IG 課題外在性負荷 タスクそのものとは別の難しさ 各々の習熟度や手順の複雑さからくるもの。 読み手が持っている知識によって大きく異なる！！ 例）Java初心者。なんでこのテーブルだけ他と違って非正規化してあるん だ？など

認知負荷へのアプローチ Make the startup ecosystem AWESOME 14 © Nstock HG 学習関連負荷 学習やタスクを遂行するために必要な負荷 この負荷を高くしても問題ないように、課題内在性負荷と課題外在性負荷 を小さく保つ必要がある 例）新機能の開発。セキュリティ知識の習得。（シチュエーションによって かわる）

「認知負荷」へのアプローチ

Nstockにおける開発生産性 Make the startup ecosystem AWESOME 16 © Nstock コメントを書く

あるとおもいます Make the startup ecosystem AWESOME 17 © Nstock コードは読む時間が7割〜8… b スタートアップであれば相対的に書く時間が長e b しかし、時間が経ってメンバーが増えて利用しているお客様が増えれh b 自分が書いていないコードを読C b 自分が書いた記憶のないコードを読む（！）

Make the startup ecosystem AWESOME 18 © Nstock コードを読むときの 2つの認知負荷を低減できれば 生産性に効くはず！ Nstockにおける開発生産性

Nstockの認知負荷を分類 Make the startup ecosystem AWESOME 19 © Nstock 課題外在性負‘ y 直感的でない命Y y 実装の妥協† y 不慣れなJav„ y 仕様や機能の妥協† y バイテンポラルデータモデ• y 使われていないフィールドやカラム 課題内在性負‘ y 株式報酬にまつわる用| y ストックオプションの計算ロ ジッ~ y 「ほふり」や証券会社との連携 スキーw y 株式分割の効力発揮タイミング

Nstockの認知負荷を分類 Make the startup ecosystem AWESOME 20 © Nstock 課題外在性負‘ y 直感的でない命Y y 実装の妥協† y 不慣れなJav„ y 仕様や機能の妥協† y バイテンポラルデータモデ• y 使われていないフィールドやカラム 課題内在性負‘ y 株式報酬にまつわる用| y ストックオプションの計算ロ ジッ~ y 「ほふり」や証券会社との連携 スキーw y 株式分割の効力発揮タイミング 課題内在性負荷を直接 減らすのは難しい コメントでのアプローÑ Ð 用語をJavaDocで説明す× Ð 計算ステップを自然言語でも説明す× Ð ドキュメントへのリンクを置Ö y コードに近いと参照しやすい

Nstockの認知負荷を分類 Make the startup ecosystem AWESOME 03 © Nstock 課題外在性負‘ y 直感的でない命Y y 実装の妥協† y 不慣れなJav„ y 仕様や機能の妥協† y バイテンポラルデータモデ• y 使われていないフィールドやカラム 課題内在性負‘ y 株式報酬にまつわる用| y ストックオプションの計算ロ ジッ~ y 「ほふり」や証券会社との連携 スキーw y 株式分割の効力発揮タイミング 課題外在性負荷は 減らしやすい（人や習熟度にもよる） コメントでのアプローf d TODOやFIXMEなどのタグをいれB y VS CodeならExtensionがありま d Why not、「なぜそうしなかったか」を書p d ドキュメントへのリンクを置p y コードに近いと参照しやすい

Make the startup ecosystem AWESOME 22 © Nstock 具体例の紹介 「わかっちゃいるけどゴメンナサイ」の言い訳

すまぬ・・・ Make the startup ecosystem AWESOME 23 © Nstock 未来へのメッセージ（TODO / FIXMEu q あと何が必要かを記載していQ q 仕様上の前提を明記することで、「分岐足りてるんだっけ？」の疑問を 解決できる

わかっていたのよ Make the startup ecosystem AWESOME 24 © Nstock なぜそうしなかったのか（Why nots q あえてこの実装にしたことを記載していP q 標準とは違うコンポーネントを使っている理由を説明

Make the startup ecosystem AWESOME 25 © Nstock コードコメントで どういう意味だ（課題そのものがムズい） なんでこうなってないの？（Why not、過去経緯） を解消する

Make the startup ecosystem AWESOME 26 © Nstock コードコメントの 使い分けと工夫の紹介 実践編は大幅カットしました

いわゆるコメントって２つあるよね？ Make the startup ecosystem AWESOME 27 © Nstock ドキュメンテーションとしてのコメントとコード中のコメンp ˜ ドキュメンテーショ† ˜ JavaDocとか、IDEやEditorでいい感じに見れU ˜ コード中のコメンv ˜ デバッグやコードを追加・修正するときによく分かる 自分はIDE上にどう表示させたいかどうかで使い分けています メソッドのスコープ内で要注意 or メソッドを使うときの事前条件

働きたくないでござる Make the startup ecosystem AWESOME 28 © Nstock LLMにやってもらƒ d 単純な説明やJavaDoc（体感7w d 固有名詞もコメントを書いていけばかなりの精度がでY d 複雑な仕様やWhy notの記載（体感2w d 完全に任せるのは難しいが書きっぷりとかは合わせやすい 単調な説明はGitHub Copilotに任せっ切り Copilotが不正確な説明をするということは怪しい

子曰く Make the startup ecosystem AWESOME 29 © Nstock 一方f ‘ 「コードそのものがドキュメントであるべきt ‘ 「コメントを書く必要性を感じたらまずはリファクタリングしましょ うt ‘ “When you feel the need to write a comment, first try to refactor the code so that any comment becomes superfluous.” — Martin Fowler

※諸説あります Make the startup ecosystem AWESOME 30 © Nstock いいから！！！かけ！！！ ※1 個人の意見です ※2 もちろん書くべきでないコメントもあります

まとめ

コードコメント Make the startup ecosystem AWESOME 32 © Nstock コメントを使った認知負荷へのアプローx v 課題内在性負荷は難しいので助ける精w u ややこしいドメインロジックや固有名詞の説e v 課題外在性負荷は下げやすい（ときもあるS u 過去経緯の説明、Why noD u 将来必要になることや留意点、TODO

Nstockにおける開発生産性 Make the startup ecosystem AWESOME 33 © Nstock コメントを効果的に使って ２つの認知負荷を下げるようにしている 認知負荷の増大による生産性の低下のダメージを最小限 に抑えるテクニックの一つ

Make the startup ecosystem AWESOME 34 © Nstock 自分が迷ったということは 他の誰かも迷うポイント 未来の自分もどうせ迷うのだ Nstockにおける開発生産性

Make the startup ecosystem AWESOME 35 © Nstock みんなもコメント書こうぜ！バグらないから！ ※3 あまりに間違ったコメントはバグの要因になります Nstockにおける開発生産性