【コード哲学エッセイ】 技術的負債は悪じゃない 〜 借りた理由を説明できるなら、 それは戦略だ 〜

負債というラベルが怖かった

レビューで、あるいは自分の脳内で、こう呟かれた日のことを覚えています。

「ここ、技術的負債ですよね」

言葉は正しい。
でも、胸のあたりには裁きみたいな冷たさが残る。

かつての僕は、その一言を「お前は先延ばしした」と受け取っていました。
優しさのある指摘でも、自分の中では道徳の赤点に変換されていたのです。

フリーランスだと、なおさらです。
納期は現実で、クライアントの事情は複雑で、理想の設計図はいつもあと一歩手の届かないところにある。

そんな場所で生まれたコードに、悪のレッテルを貼り続けるのは、あまりに辛い。

だから僕は、言葉を少しだけ持ち上げてみることにしました。

負債は、必ずしも堕落の証じゃない。
説明できる負債と、説明できない雑さは、別物なのです。

借金には契約書がある

金融の話をしているわけじゃありません。

「いつまでに」
「何と引き換えに」
「誰が責任を持って」

その輪郭が、言葉かチケットかコミットログのどこかに残っているかどうか。

納期前夜に、重複した関数を増やしたのは、二日後の本番を守るためだった。
あのライブラリを古いまま固定したのは、一度上げたら検証が間に合わないと分かっていたからだ。

後から見れば、きれいじゃないかもしれない。
でも、当時の最善の借り方だったなら、それは恥ではなく、判断の記録に近い。

問題は、借りたことを忘れたまま利息だけが膨らむパターンです。
説明が消えると、負債は性格の欠陥に見えてしまう。

だから僕は、雑でもいいから理由を残すほうを選びます。
コメントでも、Issue でも、README の既知の制約でも。

それは美談じゃない。
未来の誰かへの、最低限の礼儀なのです。

戦略って、 きれいな地図だけじゃ描けない

戦略という言葉は、プレゼン資料みたいに整っていないことも多いです。

「今月はこの山を越える。装備は足りないが、天候の窓が狭い」

現場の戦略は、だいたいそんな顔をしています。
足りないものを認めたうえで、何を捨てて何を守るかを決める。

技術的負債も同じだと思います。

捨てたのは、理想の抽象度かもしれない。
守ったのは、ユーザーのデータか、チームの睡眠か、会社の信用か。

その交換が、言葉になっているなら、それは堕落した結果ではなく、当時の地形に合わせたルート選びです。

後から地図を広げ直せるのは、ルートを記録しているからに他なりません。

説明できない雑さだけが本当に怖い

ここで誤解してほしくないのは、だから何でも許されるという話ではないということです。

説明できない。
理由が思い出せない。
誰の承認もなく、ただ疲れてコピペした。

それは負債というより事故の種に近い。

戦略としての負債と注意散漫の産物は、見た目は似ています。
違いは、物語があるかどうかです。

物語のある負債は、返済計画を立てられる。
物語のない雑さは、返済の仕方すら見えない。

僕が恐れているのは、言葉では前者を後者に呼んでしまう瞬間です。
ラベル一つで、人とコードを軽蔑しないようにしたい。

負債は返すためのメモから始まる

完璧な設計を、今日ここで約束することはできません。

でも、今日の一行になぜそうしたかを添えることはできる。

それができるなら、技術的負債という言葉は、赤ペンではなく付箋として使えるのだと思います。

「ここは借りています。理由はこれ。いつまでに触るなら、ここを見て」

借りた理由を説明できるなら、それは戦略の痕跡です。

恥じる前に、履歴にしよう。
僕自身への、そんな週初のメモでした。

ひとりごと

負債という言葉は、きれいじゃない。
でも、仕事の現場では、きれいだけでは届かない日がある。

借りたことを隠さず、理由を残す。
それだけで、明日の自分が少しだけ楽になるなら、筆を取る価値はあるのだと思います。

あわせて読みたい

▼ 汚いと感じたコードとどう向き合うか

過去の実装への見方を、否定から理解へ寄せる話です。
今日の負債の感情面とつながります。

▼ 借りを放置しないための小さな習慣

コメントに残すという具体的な作法と響き合います。

▼ プロジェクトの表札としての README

制約や前提をどこに書くか。
玄関と履歴の話が重なります。

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

納期と品質のあいだで揺れるのは、フリーランスだけの話じゃありません。
でも一人だと、その揺れを言語化する相手が少なくなりがちです。

作戦会議室では、そんな現場の言い訳じゃない説明を、テンプレや習慣に落とし込む話も共有したいです。

必要なときだけ、覗いてみてください。

参加する