【コード哲学エッセイ】 技術的負債の返済は気合いじゃなく予定だ —— 先延ばしと同じ構造から抜けるための返済計画

「いつか直す」 は、 まだ予定じゃない

8 月の午後。
エアコンの音だけが、部屋を小さく満たしている。

エディタを開くと、古いコメントが目に入る。

// TODO: あとで直す

日付はない。
Issue もない。
「あとで」だけが、静かに残っている。

動いている。
だから今日は触らない。
胸の奥では、知っている。

これは、まだ予定じゃない。
気合いの予約枠だ。

借りる話の続きを書く

春に、僕はこう書いた。

借りた理由を説明できるなら、それは戦略の痕跡だ、と。
物語のある負債は、返済計画を立てられる、とも。

あれは、借り方の話だった。

8 月は、手が少しゆるむ。
お盆の前、クライアントも静かに止まる週がある。
その静けさのなかで、別の問いが浮かぶ。

この負債、いつ返すつもりだったのか。

借り方を認めたあとに残るのは、返す日だ。
理由の付箋だけ増えて、カレンダーが空のままなら、戦略は途中で止まったままになる。

気合いで返そうとした週末

いちばん覚えている失敗は、気合いの週末だ。

納期前に増やした重複関数。
暫定の分岐。
「動けばいい」で残した util。

全部を、土日できれいにしようとした。

金曜の夜、リポジトリを開く。
「今回こそ返す」と決める。
Slack は静かで、案件の催促もない。
だからこそ、正義感が増える。

土曜の朝から、大きなリファクタに入る。
最初の二時間は気持ちがいい。
名前が整う。
分岐が減る。
自分が正しい側に戻った気がする。

午後になると、テストが赤くなる。
想定外の呼び出しが見つかる。
「ついでに」直した場所が、別の場所を壊す。

日曜の夜、差分は大きいのに、本番に出せる形ではない。
月曜は案件が待っている。
ブランチは、また眠る。
眠ったブランチは、二週間後には怖い顔をして戻ってくる。

気合いは、熱量としては本物だった。
熱量は、期限のないマラソンと同じで、途中で息が切れる。

一気に返すは、一気に片づける先延ばしタスクと同じ顔をしている。
完璧な空き時間を待ち、来たら全部やろうとして、途中で止まる。
止まると、また「いつか」に戻る。
「いつか」は、気合いの別名だ。

先延ばしと同じ構造

負債の外でも、僕は同じ型を繰り返してきた。

「忙しいから来週」
「まとまった時間ができたら」
「ちゃんと直せるまで着手しない」

コードでも、文章でも、設定でも、似ている。
罪悪感はある。
でも日付がない。
日付がないと、罪悪感だけが利息になる。

「TODO コメントを「借金」のまま放置しない」で書いた、医療系開発の夜を思い出す。

「後で直す」だけ残して半年後、自分が書いたメモの意味が分からなくなった。

先延ばしの本体は、怠けというより期限のない善意だと思う。
善意は美しい。
善意は、カレンダーに乗らない。

機能フラグにも、同じ罠がある。

期限のないスイッチは、未来の自分を迷子にする。
期限のない TODO も、同じ倉庫をつくる。

利息が見えたら、 返す側に回る

全部を平等に返す必要はない。

上半期の終わりに、僕は触らないコードを見つける話を書いた。

核心と縁を分ける。
手を入れていい場所を限る。

返済も同じだ。
利息が見えない負債は、しばらく借りたままにしていいことがある。
触るたびに調査時間が増える。
同じバグが二度出る。
新しい人が「ここ、怖い」と言う。

そういう利息が見えたら、返す側に回る。

気合いで全部返済しようとしない。
利息の高い一枚だけ、予定に置く。

キャッシュの話でも、似たことを書いた。
速さを借りたなら、鮮度の返済計画もセットで書く、と。

負債も、借りた瞬間に返す日の輪郭が欲しい。
なければ、後からでもいい。
今日、カレンダーに三十分配けば、もう気合いではない。

予定に落とすと小さく返せる

うまくいった日は、だいたい地味だった。

納品の翌日の午前。
毎週金曜の一時間。
Issue に日付を書いた TODO。

大きなリファクタではなく、分岐を一つ減らす。
名前を一つ直す。
テストを一本足す。

それだけだと、英雄譚にならない。
でも月曜の自分が、少し楽になる。
調査時間が短くなる。
「ここ、怖い」の声が、ひとつ減る。

予定があると、完璧を待たなくていい。
「今週はここまで」が言える。
途中で止められる。
止められる返済は、続く。

気合いは、止め方を知らない。
予定は、止め方を先に決める。

フリーランスは、レビュアーがいない日が多い。
だから自分で、返す枠を守るしかない。
枠がないと、案件の波に全部飲まれる。
枠があると、波のあいだに小さな返済が残る。

僕にとっての返済計画は、立派なロードマップじゃない。
カレンダーの白いマスに、三十分の名前を書くことだ。
名前があるだけで、気合いは予定に降りる。

8 月の静けさで、 返す日を置く

猛暑とお盆で、コードを書く手がゆるむ季節がある。
そのゆるみを、自己嫌悪で埋めなくてもいい。

静けさは、気合いを貯める時間じゃない。
予定を書く時間だと思う。

借りた理由があるなら、返す日も一行でいい。

// TODO(2026-08-15): 重複した集計を共通化する。今は納期優先で残置

日付があるだけで、「いつか」は予定に変わる。
予定に変わると、先延ばしの倉庫から一枚だけ出せる。

技術的負債の返済は、気合いじゃなく予定だ。
気合いは熱い。
予定は地味だ。

地味なほうを、8 月のカレンダーに置く。
それが、先延ばしと同じ構造から抜ける、いちばん短い道だと思っている。

ひとりごと

「いつか直す」と書くたびに、少しだけ誠実な顔をしていた。
誠実さは、日付がないと蒸発する。

返す日を置けた朝は、気合いより静かだった。
コードの利息が、少しだけ小さくなった気がする。

あわせて読みたい

▼ 借り方の話から、返す話へ続くときに

今回の前編。
物語のある負債は返済計画を立てられる、という一文の続きです。

▼ 「あとで」を借金にしない小さな作法として

期限か Issue を付ける話。
予定に落とす実務の入口です。

▼ 期限のない逃げ道を増やさないために

期限のないスイッチと、期限のない TODO は同じ倉庫をつくります。

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

負債の返し方や、先延ばしとの向き合い方。
一人だと、気合いの週末に戻りやすいときもある。

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

参加する

Substack はじめました

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

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

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

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

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

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