【コード哲学エッセイ】 一人で書くコードと渡すコードは倫理が違う —— 「僕だけがわかる」 が許される範囲

短い名前で今夜は通じた

8 月の夜。
エアコンの音のなかで、個人開発のファイルを開いている。

変数は短い。
フォルダの並びは、手の癖だ。
「なぜこうしたか」は、まだ頭のなかにある。

テストは緑だ。
動く。
一人の部屋では、これで足りる。

足りる、は暖かい。
暖かければ、説明を足す理由が薄くなる。
薄い理由のままコミットすると、胸が少し軽い。
軽さは、速さの報酬だ。
報酬のあとで、誰かの地図になるとは、今夜はまだ思わない。

明日、同じ机に座るのは自分だ。
自分には、今夜の辞書が残っている。
残っているうちは、「僕だけがわかる」は罪に見えない。

胸の奥で、別の記憶もある。
辞書が消えた朝の、あの止まり方だ。

最初の他人は、 五日後の自分だった

お盆明けに、休みの前と同じファイルを開いた。
書いた直後は通じていた。
五日空けると、通じていない。

レビュアーは AI ではなかった。
空けた時間だった。

その朝、僕は初めてはっきりした。
一人で書くコードの読者は、今夜の自分だけではない。
明日の自分ですら、もう少し他人だ。

個人開発の tsurilog や flowtask でも、同じことが起きる。
Inbox の型は、書いた週は自明だ。
二週間後の自分は、自明を失っている。
失っているのに、短い名前だけが残る。
残った短さは、親切ではない。
当時の速度の痕跡だ。

「僕だけがわかる」が許されるのは、辞書が残っているあいだだけだ。
辞書の賞味期限は、思っているより短い。

渡すコードは、 閉じた部屋を出る

春に、鍵を預ける話を書いた。

あれは、誠実さの輪郭だった。
汚れ方に履歴を残せたか。
置いてきぼりなら、置いてきぼりだと書けたか。

今夜の話は、その手前にある。
履歴を残す前に、読者の人数が変わるという話だ。

一人の夜の最適解は、自分の脳内辞書に合わせることだ。
渡す朝の最適解は、辞書を持たない人に合わせることだ。
同じ人が書いても、倫理が分かれる。
分かれる理由は、スキルの差ではない。
読み手が変わるからだ。

フリーランスは、この切り替えを一人でやる。
受託のリポジトリに、共同編集が入る。
権限を渡す。
公開 API のフィールド名が、誰かの画面を支える。

内部の短い名前を、外に出して壊れた朝があった。
一人の都合は、窓の向こうでは約束になる。
約束の窓に、「僕だけがわかる」は置けない。

医療系の現場でも、似た温度があった。
「あとで直す」だけ残して、半年後に自分のメモが読めなくなった。
読めないメモは、雑さというより、読者不在の手紙だ。

許される範囲を先に決める

誤解されたくない。

一人のコードは雑でいい、という意味ではない。
テストが赤のまま置くのは、倫理の話以前だ。
壊れている。

許したいのは、速度のための省略だ。
短い名前。
頭のなかの前提。
今夜戻るつもりで残した、日付のないメモ。

許したくないのは、読者が変わったあとの同じ省略だ。
共同編集に入る前。
権限を渡す前。
五日以上、自分すら開かないと分かっている夜も、同じ側だ。

線は、きれいなルール表ではない。
僕がいま置いているのは、短い問いただ一つだ。

このファイルの次の読者は、今夜の自分か。

今夜なら、短くていい。
今夜でないなら、短い名前は負債になる。
負債にするなら、少なくとも「短い」と自分に言っておく。
言わずに渡すと、相手の迷子が、自分の速さの請求書になる。

締切の前で美しさを置く話とは、棚が違う。

あれは、何を諦めるかだった。
今夜は、誰に向けて省略するかだ。
美しさを置いても、読者が一人なら、まだ部屋の中だ。
読者が増えた省略は、部屋の外に漏れる。

コメントに意図を残す話も、隣にある。

意図は、渡す側の最低限だ。
最低限を、一人の夜に全部書けとは言わない。
書くタイミングは、読者が増える直前でいい。
直前を逃すと、玄関の README だけきれいで、中が暗い家になる。

八月の終わりに、 読者を一人足す

猛暑がゆるみ、手がまた動き始めている。
動き始めた手は、一人の速度に戻りやすい。
戻りながら、秋の案件は共同の顔をすることがある。

個人開発は、まだ一人でいい。
一人でいい夜は、短い名前を責めたくない。
責めない代わりに、渡す日が来たら線を越える。

越える作業は、リファクタの英雄譚にしなくていい。
名前を一つ戻す。
前提を一行残す。
「僕だけがわかる」を、僕以外が読める場所へ移す。

それが、倫理の差だと思う。
一人で書くことは、閉じた部屋を許す。
渡すことは、窓を開ける。
開けないまま鍵だけ渡すと、相手は暗がりの中で仕事を始める。

もし今、短い名前のままコミットしようとしているなら。
次の読者だけ、一度聞いてみてほしい。
今夜の自分なら、押していい。
今夜でないなら、短さに名前を付ける。

付けた短さは、雑さじゃない。
読者を知っている省略だ。

ひとりごと

一人の速さは、悪くなかった。
速さを、他人の地図にしないことだけが、難しかった。

辞書の賞味期限が切れる前に、窓を一枚開けたい。

あわせて読みたい

▼ 鍵を預ける朝の、誠実さの話として

今回の続きに近い前編。
汚れ方に履歴を残す、という側です。

▼ 最初の他人が、自分だった朝の記録として

辞書の賞味期限が、五日で切れた話です。

▼ 外に出す名前が、約束になるときに

一人の都合を、窓の向こうへ出して壊れた朝の話です。

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

短い名前のまま進む夜と、渡す前の線の引き方。
一人だと、「自分に通じていればいい」に戻りやすいときもある。

作戦会議室は、そんなときに次の読者を少し軽く持ち直す場所として使ってもらえたら嬉しいです。
気が向いたときだけ、覗いてみてください。

参加する

Substack はじめました

ここまで読んでくださり、ありがとうございました。

X では短い言葉で、note では整理した文章で発信していますが、Substack では、もっと途中経過の思考や削りきらなかった葛藤、技術者として日々考えていることを書いています。

もし興味があれば、覗いてみてください。

会社員（元システムエンジニア）からフリーランスとなり、15年目に突入しました。

納期と障害対応に追われる毎日の中で、「もっと自由に、もっと本質的にものづくりがしたい」そう思ったのが独立のきっかけです。

現在は、技術と文章を軸に、仕事がラクになる仕組みや続けられる働き方を発信しています。