はじめに
去年、自分が担当していたAPIのリファクタリングで、二週間かけた実装をほぼ全部捨てたことがある。原因は技術力ではなかった。最初の設計レビューで「この分割でいきます」と口頭で合意した内容が、チーム内で三通りに解釈されていただけだ。
後から振り返ると、自分がつまずいた場所はコードの外側に集中していた。急いで出した判断を後で覆せなかったこと。設計意図をドキュメントに落とさず、レビューコメントで補おうとしたこと。割り込みだらけの一日の中で、設計を考える時間を三十分も確保できなかったこと。
こういう問題はフレームワークの本を読んでも解決しない。かといって精神論を読みたいわけでもない。自分が欲しかったのは、判断の手順や文章の削り方みたいに、明日の業務でそのまま試せる具体的なやり方だった。
そこで、エンジニアの実務に直結する部分だけを基準に本を選び直した。以下の5冊は、判断の土台をつくる本から順に並べてある。設計判断、レビューでの対話、ドキュメント、時間の確保、そして習慣化という流れだ。どれも日本語版があり、通勤時間でも読み進められる。
① CLEAR THINKING(クリア・シンキング)大事なところで間違えない「決める」ための戦略的思考法 — シェーン・パリッシュ
著者はカナダの情報機関でサイバーセキュリティに携わりながら、意思決定を扱うブログ Farnam Street を運営してきた。実務家が書いた意思決定論という立ち位置が、この本の読みやすさにつながっている。
中心にあるのは、判断を誤らせる四つの反応パターンの話だ。感情で即答する、周囲に合わせる、自分の立場を守る、慣れた手順に戻る。言われてみれば当たり前だが、設計レビューで自分の案を擁護しはじめた瞬間を思い出すと耳が痛い。
後半では、決める前の準備に紙幅を割く。選択肢を二つに絞らずに増やす、判断基準を先に書き出す、どこまで戻せる判断なのかを見極める。このあたりはアーキテクチャ選定の進め方とそのまま重なる。
自分に効いたのは「まず基準を文字にする」という一点だった。ライブラリ選定で迷ったとき、比較表の前に評価軸を三つ書くようにしたら、議論が好みの話で止まらなくなった。
こんな人に: 技術選定やアーキテクチャの決定で、後から判断理由を説明できなくなる人。
② 相手の声を聞く技術: 本当の信頼を育むために必要なたった1つのこと — デイヴィッド・ブルックス
著者はニューヨーク・タイムズのコラムニストで、長年アメリカ社会と人間関係について書いてきた。この本は人づきあいのテクニック集ではなく、相手を正確に理解するための本だ。
扱っているのは、質問の仕方と聞く姿勢の違いである。相手の答えを自分の解釈枠に入れずに受け取る、話を遮って結論を先取りしない、反対意見の背景にある前提を探す。コードレビューで起きるすれ違いの大半は、この三つのどれかを飛ばしたせいだと気づいた。
印象に残ったのは、相手が何に困っているかを質問で確かめる場面の描写だ。「なぜこう書いたのか」と聞くとき、自分の声には責める響きが混じっていなかったか。読みながら過去のレビューコメントを見返す羽目になった。
テクニックよりも姿勢の話が多いので、即効性を求めると物足りなく感じるかもしれない。ただ、チームでの衝突が続いている時期に読むと刺さり方が変わる。
こんな人に: レビューや要件ヒアリングで、相手の意図を取り違えやすいと感じている人。
③ 誰よりも、うまく書く: 心をつかむプロの文章術 — ウィリアム・ジンサー
著者は新聞記者を経てイェール大学で文章を教えた人物で、この本は40年以上読まれ続けている定番だ。小説ではなくノンフィクションの書き方を扱うので、設計ドキュメントやリリースノートを書く人と相性がいい。
主張はほぼ一貫して「削れ」である。修飾語、言い換え、格好をつけた言い回しを落として、主語と動詞を残す。原文は英語だが、日本語の技術文書を書くときにもそのまま効く。自分はこの本を読んでから、設計書の冒頭にあった前置き三段落を一文に縮めた。
構成の章も実用的だ。最初の段落で読者を引き込めなければ続きは読まれない、という前提で書き出しを設計する。レビュー依頼のPR説明文を書くときの考え方と同じだ。
弱点は例文が英語の雑誌記事中心なところ。日本語に置き換えて読む手間はかかるが、原則そのものは翻訳で失われていない。
こんな人に: ADRや設計ドキュメントを書いても「で、結論は?」と聞かれてしまう人。
④ とっぱらう――自分の時間を取り戻す「完璧な習慣」 — ジェイク・ナップ、ジョン・ゼラツキー
二人はGoogleとGoogle Venturesでデザインスプリントを設計した当事者で、短期間で成果を出す進め方を内側から見てきた。この本はその知見を個人の一日に落としたものだ。
構成は単純で、一日ひとつだけ最重要タスクを決める、集中を妨げる仕組みを物理的に遠ざける、エネルギーの波に合わせて作業を配置する、記録して翌日に調整する。この四段構えを、細かい実践案の束として提示している。
自分が採用したのは、Slackとメールの通知を午前中だけ切る方法と、前日の退勤前に翌日の「一番重要な一件」を書いておくやり方だ。これだけで、朝の一時間を設計検討に使えるようになった。
全部やろうとすると破綻する。好みに合うものを二つか三つ選んで残りは無視する、という読み方が正しい。
こんな人に: 会議と割り込みで、まとまった実装時間が消えていく人。
⑤ ジェームズ・クリアー式 複利で伸びる1つの習慣 — ジェームズ・クリアー
著者は習慣をテーマにしたニュースレターを数百万人に配信している。本書は行動を続ける仕組みを、きっかけ、欲求、反応、報酬という四段階に分解して説明する。
要点は、意志の強さに頼らず環境を変えるところにある。始めるハードルを下げる、行動を既存の習慣に紐づける、進捗を見える形で記録する。テストを書く習慣やリファクタリングの時間確保みたいに、重要だが後回しにされがちな作業に効く。
自分の場合、朝のコーヒーを淹れた直後に昨日のコードを五分読む、というルールを作った。五分なら逃げ場がない。半年続いて、レビュー前に自分で気づけるミスが明らかに増えた。
内容は有名すぎて目新しさは薄い。ただ、①から④の本で得た方針を定着させる段では、この本の仕組み化が一番役に立つ。
こんな人に: 良いやり方を知っているのに、二週間で元のやり方に戻ってしまう人。
まとめ
| ステップ | 読む本 | 得られるもの |
|---|---|---|
| 判断の土台をつくる | CLEAR THINKING | 技術選定の評価軸を先に言語化できる |
| チームで通じ合う | 相手の声を聞く技術 | レビューと要件確認のすれ違いが減る |
| 書いて残す | 誰よりも、うまく書く | 読まれる設計ドキュメントが書ける |
| 時間を確保する | とっぱらう | 集中して設計を考える一時間を作れる |
| 続ける仕組みにする | 複利で伸びる1つの習慣 | 一度変えたやり方が定着する |
今の課題から1冊だけ選ぶなら、次の基準で決めるといい。
- アーキテクチャ選定の結論に自信が持てない: CLEAR THINKING
- レビューコメントが毎回言い争いになる: 相手の声を聞く技術
- 設計書を書いても読まれない、意図が伝わらない: 誰よりも、うまく書く
- 実装時間が会議と通知で溶ける: とっぱらう
- 改善策を導入しても二週間で元に戻る: 複利で伸びる1つの習慣
5冊とも、読んだ翌日に試せる具体策が入っている。順番に全部読む必要はない。今一番痛いところに対応する1冊から始めるのが早い。