【コード哲学エッセイ】 夏の前にスコープを半分にする —— YAGNI を我慢じゃなく選択と呼ぶ

機能表がまた太った夜

7 月の終わり、エアコンの風だけが静かに回っている。
エディタの隣には、機能表のメモが開いたままだ。

「ダッシュボードのフィルタ（あとで）」
「設定画面のテーマ切替（いつか）」
「連携用の空エンドポイント（将来）」

どれも悪くない。
どれも、真面目に聞こえる。

「【コード哲学エッセイ】機能フラグは逃げ道じゃない」で、見せ方の柵は学んだ。

「【技術学習】「いつか使うかも」を切って出した」で、表を半分に切る実践もした。

それでも、7 月の空気は囁く。

「もっと足せばいい」
「あとで困らないように」
「今のうちに型だけ」

かつての僕は、ここで YAGNI を我慢の言葉だと思っていた。
欲しいものを我慢する。
未来の可能性を諦める。
——そう翻訳していた。

我慢だと思っていた頃

フリーランスになって数年、個人開発の構想を書くたびに同じパターンを繰り返した。

理想の完成形を先に描く。
「あったらいい」を、必要機能と同じ列に並べる。
リリースは、全部そろってから。

最初は賢く見えた。
「【コード哲学エッセイ】長く続くプロジェクトで、「やらないこと」を決める」で書いたように、軸はある。

拡張性もある。
将来の自分に優しい。

問題は、優しさの形が、前借りになっていたことだ。

「いつか使うかも」を今日のコードに入れる。
まだ来ていないユーザーの要望を想像で実装する。
足りない不安を機能で埋める。

YAGNI を聞くたび、胸のなかではこう訳されていた。

「我慢しろ」

我慢は、負けの言葉に聞こえる。
だからリストは太る。
切るたびに、「これで大丈夫か」と自分を責める。

吃音のある僕は、画面と文章で伝えることが多い。
足りない UI を恐れて、先に機能を足したくなる。
足りなさの正体は、しばしば説明不足であって、機能不足ではない——
それに気づくまで、YAGNI は我慢の呪文のままだった。

切るのは敗北じゃない

いまの僕は、YAGNI をこう捉えています。

未来の要件を、今日のコードに前借りしない宣言だ。

我慢ではない。
境界を引く選択に近い。

買い物のカートに、まだ必要のないものを入れない。
冷蔵庫に、今夜食べない食材を全部詰め込まない。
「【コード哲学エッセイ】キャッシュは速くする魔法じゃなく鮮度の妥協だ」で書いたように、鮮度の線を引かないと箱は倉庫になる。

スコープも同じだ。

「いつか使うかも」を入れた瞬間、まだ来ていない未来のメンテナンスを今日の自分が引き受ける。
名前を付けた機能は居座る。
フラグで隠してもコードは増える。

切るとは、可能性を捨てることじゃない。
今週の一本に必要な形だけを残すことだ。

フラグの隣に切る刃を置く

誤解してほしくない。
YAGNI は、品質を捨てることじゃない。
テストを書かないことでも、雑に出すことでもない。

「【コード哲学エッセイ】機能フラグは逃げ道じゃない」が扱うのは、作ったものをどう見せるかだ。

今回の話は、その隣の棚にある。

まだ要らないものを、どう切るか。

| | 機能フラグ | YAGNI |
|:---|:---|:---|
| 問い | 作ったものをどう見せるか | まだ要らないものをどう切るか |
| 敵 | 完成待ちの長いブランチ | 「いつか使うかも」の肥大 |
| 失敗の翻訳 | 粗いから出せない | 足りないから足す |

片方だけだと、こうなる。

フラグだけ → 隠しながら作り続ける。
YAGNI だけ → 切ったが、出し方の怖さは残る。

夏の前に、僕が手放したかったのは我慢の翻訳だった。
同じ道具で両方を済ませようとすると、またリストが太る。

機能を足す前に僕が置く三つの問い

行を書く前に、僕は三つだけ問います。

これは、今週の成功条件に必要か。
なくても、出せるか。
必要になったら、後から足せるか。

三つとも Yes なら、今は切る。
フラグの対象にすらしない。
作らない。

答えがはっきりしないなら、足すのは早いのかもしれない。
まだブランチの中に留める。
Issue に一行残すなら、someday で閉じる。
名前を付けた瞬間、また居座るからだ。

// 今週の一本: 一覧 → 詳細 → 保存。フィルタは v0.2 まで入れない
async function listItems() {
  return db.item.findMany({ orderBy: { updatedAt: 'desc' } });
}

findMany の前に、今週いらない条件を書かない。
それだけで、我慢は選択に近づく。

「いつか」 は未来への前借りだ

「いつか使うかも」は、悪意のある言葉じゃない。
むしろ、真面目な人ほど口にしやすい。

拡張性のために。
あとで困らないように。
会員が喜ぶかも。

正しそうな声ほど、切るのが難しい。
「【コード哲学エッセイ】上半期の終わりに、触らないコードを見つける」で書いた、触らない一本と同じ温度だ。

7 月の生活でも、増やさない二週間を触らない一つを選んだ。
コードの機能表だけ、まだ「いつか」が居座っていた。

夏の前に半分にする。
それは、勢いを殺すことじゃない。
勢いの形状を変えることに近い。

走り出したあとに要るのは、維持ではなく、形の選択だ。
全部載せようとする夏は重い。
一本だけ残す夏は続く。

切ったあとに残るもの

切ると、寂しさが一瞬よぎる。

「足しておけばよかった」
「この機能がないと、貧しく見える」

かつての僕は、その一瞬を実装に戻していた。
我慢の反動だ。
選択のあとには、そういう余韻もある。

けれど、切ったあとに残るものもある。

README が短くなる。
説明が一本道になる。
v0.2 の余白が、ちゃんと空く。

翌週すぐに「やっぱり要る」とは、だいたいならない。
必要になったとき、成功条件を書き直して足せばいい。
未来は、想像より遅く来る。

我慢だったら、切るたびに自分を責める。
選択だったら、切った線を残せる。

7 月のエディタの前で

下半期に入り、出したい気持ちは強い。
お盆の前、画面を整えたくなる。

「もっと載せたい」
「もっと直したい」

—— 7 月の空気は、そう囁く。

そのとき、僕は昔の自分に声をかけます。

「これは我慢か。それとも境界の選択か」

後者なら、成功条件を一行書いてから半分に切る。
前者に見えたら、足りなさの正体を README のほうから見る。

YAGNI は、未来を諦める言葉じゃない。
まだ来ていない要件を、今日に前借りしない言葉だ。

同じように、「いつか使うかも」でリストが太った誰かに届けばうれしいです。

ひとりごと

我慢だと訳していた頃があった。
切るたびに負けた気分になっていた。

7 月の終わり、機能表を半分にした夜は、それでも前に進んだ気がする。
選択と呼べる日が、少しずつ増えてきた。

あわせて読みたい

▼ 実践記録として同じ 7 月の話

今回の哲学の現場での実践版です。
切ったもの／残したものの具体が読めます。

▼ 見せ方側の姉妹の一本

作ったものをどう見せるか。
今回の「作らない」と同じ夏の設計の両面です。

▼ 軸を守る、やらないことの話として

YAGNI の前に何を守るか。
7 月のコード哲学の流れとして読めます。

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

スコープの切り方や YAGNI の置き方。
一人で抱えると、我慢と選択の境目がぼやけやすい。

作戦会議室では、現場で使える切り方を小さく分け合える場所にしたいです。
夏の前にリストを半分にしたい方は、のぞいてみてください。

参加する

Substack はじめました

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

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

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

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

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

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