【コード哲学エッセイ】 一人で書いたコードを誰かに渡す日 〜 引き継ぎで試される設計の誠実さ 〜

鍵を預ける朝

最後のコミットを押して、画面を閉じる。
あるいは、管理者権限のチェックボックスから自分の名前を外す。

どちらの形でも、胸のあたりには似た感触が残ります。

倉庫の鍵を、そっとテーブルに置いたみたいな。

フリーランスだと、この幕引きは特に短いことが多いです。
チームの歴史のなかで何年も育ててきたというドラマより、契約の区切りとともに静かに扉が閉まる感じに近い。

それでも、渡す側に立った日の空気は重くないわけじゃない。

一人書きの部屋は暖かい

一人で書くのは、快適です。

変数名は自分の脳内辞書で通じる。
ディレクトリの並びは、手の動きに合わせて固まっている。
「あのとき、なぜこうしたか」は、説明しなくても自分の中で完結している。

その快適さは、同時に閉じた部屋でもあります。

窓は一枚しかなく、光の入り方も偏る。
来客が入ってきた瞬間に初めて、換気が足りなかったことに気づく。

引き継ぎは、その換気口をあけに来る日だと思っています。

次の読者が扉を叩く

新しい担当の人は、悪意を持って倉庫を漁りに来るわけじゃない。
ただ、仕事を続けるために地図が欲しい。

そこで目に入るのは、きれいな抽象度だけじゃない。

意味の薄いコメント。
理由の抜けた FIXME。
当たり前の環境変数。

僕が恐いのは、相手を責めることじゃありません。
昨日までの自分の手抜きが、今日の誰かの迷子になる光景です。

誠実さは、 きれいさと同義じゃない

設計の誠実さを、リファクタリングの美しさだけに置き換えてしまうと、息苦しくなります。

現場には納期がある。
要件は途中で曲がる。
完璧なモジュール分割は、いつも明日に延期される。

だから僕が言いたいのは、「最初から汚さないで」という綺麗事ではなく、汚れ方に履歴を残せたかの話です。

借りたなら、契約書を残す。
妥協したなら、妥協の理由を残す。
置いてきぼりにするなら、少なくとも置いてきぼりであることを明示する。

それができるコードは見た目が荒くても、引き継ぎでは立ち上がりやすい。

逆に見た目が整っていても、沈黙だけが増えているリポジトリは渡す瞬間に冷たい。

引き継ぎは成績表じゃない、 とも言い切れない

ここで誤解してほしくないのは、引き継ぎを審判の場にしたいわけではないということです。

相手の人格を試す試験でも、自分の価値を一発で決めるオーディションでもない。

それでも、共同責任への入り口ではある。

次の人が同じ轍を踏まなくて済むか。
同じ不安を夜に持ち帰らなくて済むか。

そこに少しでも手を添えられたなら、それはスキルの勝ち負けより態度の話に近い。

僕は何度か渡す側に立って、足りなかったと思う。
README を書けば足りると思っていた時期もあった。

玄関を磨いても、奥の部屋に地図がない家は、やっぱり迷子をつくる。

倉庫に残すもの

渡す前夜に、僕が意識するのはごく簡単なリストです。

魔法の杖じゃない。
次の人の最初の一歩が暗闇じゃなく薄い灯りになる。

一人で書いたコードは、いつか他人のものになる。
その事実から目を逸らさないでおくほうが、長い目では自分にもやさしい。

引き継ぎで試されるのは、設計の誠実さなのだと思います。
完璧さではなく言葉にしなかったことを、どこまで言葉に戻せたか。

倉庫の鍵を置く朝に、そんなことを考えていました。

ひとりごと

渡すことは失うことじゃない。
関係が一段長くなるという見方もできる。

それでも、一度は自分の机の上にあったものが、別の机に移る瞬間には寂しさが混ざる。

だからこそ、残せるものを残したい。
次の読者へのささやかな礼儀として。

あわせて読みたい

▼ 渡す前に整える玄関の話

引き継ぎでいちばん最初に触れる場所の話。
今回の倉庫の鍵と響き合います。

▼ 負債や妥協をどう履歴にするか

説明できるかどうかが、渡す側・受け取る側の両方の安心に直結する話です。

▼ 受け取る側の視点でレガシーと出会う

渡す日の次に来る誰かの視点へ、視点を補う一本です。

次の一歩を一緒に決める 「作戦会議室」 へ

引き継ぎは、テンプレ一枚では終わりません。
「何を残すか」の習慣にすると、次の案件の自分も楽になります。

作戦会議室では、現場で使うドキュメントの型や振り返りの仕方も共有しています。
必要なときだけ、覗いてみてください。

参加する