0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

コードレビューと設計判断を支える5冊

0
Posted at

はじめに

去年、自分が担当していたAPIのリファクタリングで、二週間かけた実装をほぼ全部捨てたことがある。原因は技術力ではなかった。最初の設計レビューで「この分割でいきます」と口頭で合意した内容が、チーム内で三通りに解釈されていただけだ。

後から振り返ると、自分がつまずいた場所はコードの外側に集中していた。急いで出した判断を後で覆せなかったこと。設計意図をドキュメントに落とさず、レビューコメントで補おうとしたこと。割り込みだらけの一日の中で、設計を考える時間を三十分も確保できなかったこと。

こういう問題はフレームワークの本を読んでも解決しない。かといって精神論を読みたいわけでもない。自分が欲しかったのは、判断の手順や文章の削り方みたいに、明日の業務でそのまま試せる具体的なやり方だった。

そこで、エンジニアの実務に直結する部分だけを基準に本を選び直した。以下の5冊は、判断の土台をつくる本から順に並べてある。設計判断、レビューでの対話、ドキュメント、時間の確保、そして習慣化という流れだ。どれも日本語版があり、通勤時間でも読み進められる。

① CLEAR THINKING(クリア・シンキング)大事なところで間違えない「決める」ための戦略的思考法 — シェーン・パリッシュ

Amazonで見る

著者はカナダの情報機関でサイバーセキュリティに携わりながら、意思決定を扱うブログ Farnam Street を運営してきた。実務家が書いた意思決定論という立ち位置が、この本の読みやすさにつながっている。

中心にあるのは、判断を誤らせる四つの反応パターンの話だ。感情で即答する、周囲に合わせる、自分の立場を守る、慣れた手順に戻る。言われてみれば当たり前だが、設計レビューで自分の案を擁護しはじめた瞬間を思い出すと耳が痛い。

後半では、決める前の準備に紙幅を割く。選択肢を二つに絞らずに増やす、判断基準を先に書き出す、どこまで戻せる判断なのかを見極める。このあたりはアーキテクチャ選定の進め方とそのまま重なる。

自分に効いたのは「まず基準を文字にする」という一点だった。ライブラリ選定で迷ったとき、比較表の前に評価軸を三つ書くようにしたら、議論が好みの話で止まらなくなった。

こんな人に: 技術選定やアーキテクチャの決定で、後から判断理由を説明できなくなる人。

② 相手の声を聞く技術: 本当の信頼を育むために必要なたった1つのこと — デイヴィッド・ブルックス

Amazonで見る

著者はニューヨーク・タイムズのコラムニストで、長年アメリカ社会と人間関係について書いてきた。この本は人づきあいのテクニック集ではなく、相手を正確に理解するための本だ。

扱っているのは、質問の仕方と聞く姿勢の違いである。相手の答えを自分の解釈枠に入れずに受け取る、話を遮って結論を先取りしない、反対意見の背景にある前提を探す。コードレビューで起きるすれ違いの大半は、この三つのどれかを飛ばしたせいだと気づいた。

印象に残ったのは、相手が何に困っているかを質問で確かめる場面の描写だ。「なぜこう書いたのか」と聞くとき、自分の声には責める響きが混じっていなかったか。読みながら過去のレビューコメントを見返す羽目になった。

テクニックよりも姿勢の話が多いので、即効性を求めると物足りなく感じるかもしれない。ただ、チームでの衝突が続いている時期に読むと刺さり方が変わる。

こんな人に: レビューや要件ヒアリングで、相手の意図を取り違えやすいと感じている人。

③ 誰よりも、うまく書く: 心をつかむプロの文章術 — ウィリアム・ジンサー

Amazonで見る

著者は新聞記者を経てイェール大学で文章を教えた人物で、この本は40年以上読まれ続けている定番だ。小説ではなくノンフィクションの書き方を扱うので、設計ドキュメントやリリースノートを書く人と相性がいい。

主張はほぼ一貫して「削れ」である。修飾語、言い換え、格好をつけた言い回しを落として、主語と動詞を残す。原文は英語だが、日本語の技術文書を書くときにもそのまま効く。自分はこの本を読んでから、設計書の冒頭にあった前置き三段落を一文に縮めた。

構成の章も実用的だ。最初の段落で読者を引き込めなければ続きは読まれない、という前提で書き出しを設計する。レビュー依頼のPR説明文を書くときの考え方と同じだ。

弱点は例文が英語の雑誌記事中心なところ。日本語に置き換えて読む手間はかかるが、原則そのものは翻訳で失われていない。

こんな人に: ADRや設計ドキュメントを書いても「で、結論は?」と聞かれてしまう人。

④ とっぱらう――自分の時間を取り戻す「完璧な習慣」 — ジェイク・ナップ、ジョン・ゼラツキー

Amazonで見る

二人はGoogleとGoogle Venturesでデザインスプリントを設計した当事者で、短期間で成果を出す進め方を内側から見てきた。この本はその知見を個人の一日に落としたものだ。

構成は単純で、一日ひとつだけ最重要タスクを決める、集中を妨げる仕組みを物理的に遠ざける、エネルギーの波に合わせて作業を配置する、記録して翌日に調整する。この四段構えを、細かい実践案の束として提示している。

自分が採用したのは、Slackとメールの通知を午前中だけ切る方法と、前日の退勤前に翌日の「一番重要な一件」を書いておくやり方だ。これだけで、朝の一時間を設計検討に使えるようになった。

全部やろうとすると破綻する。好みに合うものを二つか三つ選んで残りは無視する、という読み方が正しい。

こんな人に: 会議と割り込みで、まとまった実装時間が消えていく人。

⑤ ジェームズ・クリアー式 複利で伸びる1つの習慣 — ジェームズ・クリアー

Amazonで見る

著者は習慣をテーマにしたニュースレターを数百万人に配信している。本書は行動を続ける仕組みを、きっかけ、欲求、反応、報酬という四段階に分解して説明する。

要点は、意志の強さに頼らず環境を変えるところにある。始めるハードルを下げる、行動を既存の習慣に紐づける、進捗を見える形で記録する。テストを書く習慣やリファクタリングの時間確保みたいに、重要だが後回しにされがちな作業に効く。

自分の場合、朝のコーヒーを淹れた直後に昨日のコードを五分読む、というルールを作った。五分なら逃げ場がない。半年続いて、レビュー前に自分で気づけるミスが明らかに増えた。

内容は有名すぎて目新しさは薄い。ただ、①から④の本で得た方針を定着させる段では、この本の仕組み化が一番役に立つ。

こんな人に: 良いやり方を知っているのに、二週間で元のやり方に戻ってしまう人。

まとめ

ステップ 読む本 得られるもの
判断の土台をつくる CLEAR THINKING 技術選定の評価軸を先に言語化できる
チームで通じ合う 相手の声を聞く技術 レビューと要件確認のすれ違いが減る
書いて残す 誰よりも、うまく書く 読まれる設計ドキュメントが書ける
時間を確保する とっぱらう 集中して設計を考える一時間を作れる
続ける仕組みにする 複利で伸びる1つの習慣 一度変えたやり方が定着する

今の課題から1冊だけ選ぶなら、次の基準で決めるといい。

  • アーキテクチャ選定の結論に自信が持てない: CLEAR THINKING
  • レビューコメントが毎回言い争いになる: 相手の声を聞く技術
  • 設計書を書いても読まれない、意図が伝わらない: 誰よりも、うまく書く
  • 実装時間が会議と通知で溶ける: とっぱらう
  • 改善策を導入しても二週間で元に戻る: 複利で伸びる1つの習慣

5冊とも、読んだ翌日に試せる具体策が入っている。順番に全部読む必要はない。今一番痛いところに対応する1冊から始めるのが早い。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?