【技術学習】 5日空けて読み返した自分のコード

休みが炙り出した読みにくさを、 僕が分解する

エディタを開く。
ファイルは、休みの前と同じだ。
なのに、最初の画面で手が止まる。

書いた直後は通じていた。
5日空けると、通じていない。

結論を先に1行で書きます。

休みはレビュアーだ。
読みにくさの正体は、当時の頭が残っていないことだ。

昨日はエンジンを半分でかけた。
コード再読は、初日に完成させない、と置いた。
今日が、空けた目で開く日だ。
直す前に、止まった箇所を分解する。

同じファイルなのに読めない朝

みなさんは、休み明けに自分のコードを開いて、最初の何行で止まりますか。

僕は長いあいだ、それを下手さだと思っていた。
完成度の%が足りないからだ、とも思っていた。
デイリーには、まだこう並ぶ。

山の日に、標高で測ると書いた。

麓ではない。中腹にいる。
なのに空けた目は、%の前に、再開できるかが薄いか で詰まる。

通知を切った5日のあいだ、このファイルは開いていない。

仕事の箱を切っていた。
頭も、席を外していた。

今日見るのは、他人のレガシーではない。
先に詰まるのは、自分のファイルだ。

同じ日なら通じて、 空けた目で折れていた

かつての僕の再読は、だいたいこうだった。

コメントは意図で書いた通り、コードは結果しか残さない。

同じ日に読むと通る。
頭がまだ横にあるから。
5日空けると、頭が席を外す。
残るのは結果だけだ。

半年後に「なんでこうなってる？」で止まる話は、すでに持っている。
今回の粒度は、もっと短い。
たった5日でも、同じ穴が開く。
お盆の空白は、その実験台になった。

全部直しながら読むと、読みにくさは「今の自分の修正」に上書きされる。
炙り出しにならない。
エンジンを半分でかけた月曜に、再読を初日へ持ち込まなかったのは、そのためだ。

レビュアーを時間に座らせる

転機は、道具を増やす話ではなかった。

AI セルフレビューは、マージ前の別視点だ。

Cursor を座らせる。
バグや型の抜けを、今の自分以外に見てもらう。

休みは、別のレビュアーだ。
道具ではなく、空けた時間。
同じ日には見えなかった欠落を、頭が席を外したあとに炙り出す。

種②は、Vault に一手残す、だった。
増やさず種を三つの「届く一歩」。

火曜に触るなら、その一手だけ。
zip 完成も、機能の発明も、今日の仕事ではない。

転機を1行に圧縮すると、こうなる。

直す前に、止まった箇所を分解する。

何を開いたか

主対象は、メンバーシップ向け Obsidian Vault サンプル（v0.1）。
山の日に測った山の続きだ。

副次は、受託の外で育てている個人開発の城。
リポジトリ名は伏せてよい。
見るのは地点と、空けた目で止まった箇所。

最初に手が止まるのは、完成度の足りなさより先に、当時なぜこう切ったかが、画面から消えている箇所。

設計書の表には、まだ地点がある。
テンプレ側に、手紙が無い。
その隙間が、読みにくさだ。

読みにくさを4層で見る

炙り出されるのは、下手さだけではない。
当時の頭が、ファイルに残っていない。
Cursor に任せた塊ほど、見た目は整って、意図が薄い。

| 層 | 空けた目の症状 |
|:---|:---|
| 名前 | その場では通じた短い名前が、約束として残っていない |
| 意図 | 「何をしているか」は読める。「なぜそう切ったか」が無い |
| 境界 | 含めない側の理由が、設計書の表にしか無く、画面に手紙が無い |
| 再開 | 次の一手が「zip まで」になっていて、15分で届く地点になっていない |

名前は、未来の自分との約束だ。
意図は、なぜの1行だ。
境界は、含めない理由だ。
再開は、次の標高の大きさだ。

4つに印を付ける。
全部を今日直さない。
印が、分解だ。

分解ログの型

今日の成果物は、リファクタ完了ではない。
読みにくさの分解ログだ。

【5日空けた目・分解ログ】
日付:
山（プロジェクト）:
止まった箇所（ファイル／境界／1画面）:
層に印を付ける（複数可）:
- [ ] 名前（約束が残っていない）
- [ ] 意図（なぜが無い）
- [ ] 境界（含めない理由が画面に無い）
- [ ] 再開（次の一手が大きすぎる）
今日直すなら一手だけ（15〜45分）:
やらない: 全部直す / 機能を削る / zipまで完成 / %を埋める

山の日の標高ログは、「いまどこに立っているか」。
本記事は、空けた目が、どこで詰まったか。
測るものと、詰まるものは別だ。

15分で全部直さなくてよい。
印を付けて、一手だけ選ぶ。
手が伸びそうなら、エンジン半分の上限に戻る。

今日やる／今日やらない

| 今日やる | 今日やらない（別の棚） |
|:---|:---|
| 止まった箇所を4層で印 | 使われなかった機能を削る（08/25） |
| 意図の1行を足すなら、そこだけ | 他人のコードの開き方（哲学エッセイ） |
| 次の標高を一つに戻す | AI セルフレビューの型の再掲（05/19） |
| 種②に触るなら一手 | 受信の30分（08/19）／初日の全開（08/17） |

意図の1行は、説明のなぞりではない。
「本番コピーを出さないため、このフォルダは Exclude」
——なぜ、が残ればよい。
コードが変わっても、手紙として読める長さ。

再開の層に印が付いたら、一手を小さくする。
zip まで、を今日の地点にしない。
README の入口を1行足す、未決の理由を1行残す、で足りる。

既存記事との位置づけ

迷子にならないよう、地図だけ置く。

| レイヤー | 何を扱うか |
|:---|:---|
| 標高（08/11） | いまどこに立っているか |
| 通知カット（08/16） | 休みのあいだ、仕事の箱を切る |
| エンジン半分（08/17） | 明けの1日の上限、再読は持ち込まない |
| 本記事（分解） | 空けた目が、どこで詰まったか |
| コメントは意図 | なぜを残す手紙の原型 |
| AI セルフレビュー | マージ前の別視点、道具は AI |
| 他人のコード | 先に開くのは他人、今日は自分 |
| 引き算リリース（08/25） | 使われなかった機能を削る、今日は材料だけ |

本記事だけで、Vault を zip まで持っていかない。
分解ログと、一手があれば足りる。

やってはいけないこと

同じ日の勢いで、全部直しながら読む。
上書きされると、炙り出しが消える。

読みにくさを、下手さの証明にする。
同じ日なら通じていた。
残っていないのは頭だ。

% を埋めるために、機能を足す。
足すのは、だいたい再開の層の偽装だ。

08/25の削るを、今日先取りする。
印は材料。
判断は秋の前の記事の棚だ。

AI に「全部直して」と渡す。
塊は整って、意図はさらに薄くなる。
印を付けてから、一手だけ頼む。

誤解してほしくないこと

サボったから読めない、ではない。
同じ日なら通じていた。

他人のコードの話ではない。
先に詰まるのは、自分のファイルだ。

セルフレビュー記事の再掲ではない。
レビュアーは AI ではなく、5日の時間だ。

休み明けの全開で全部直す話ではない。
分解して、一手まで。

8月ずっとコードを触るな、でもない。
火曜の学習枠で、空けた目を使う。

頭が席を外したあとに手紙を残す

書いた直後は通じていた。
5日空けると、通じていない。
それは才能の判定ではない。
当時の頭が、ファイルに残っているかの判定だ。

休みは、邪魔ではない。
レビュアーだ。
直す前に、止まった箇所へ印を付ける。

もし今、自分のリポジトリの前で止まっているなら、全部直さなくてよい。
まずは1行だけ書いてみてください。

止まった箇所と、4層のうちどれか。

それだけで、読みにくさは自己嫌悪から、分解ログに変わる。

最後に、1行だけ残す。

お盆明けの火曜に、その印を一つ置けたら十分だ。

ひとりごと

8月18日。
技術学習の回です。

日曜は切る実験。
月曜はエンジン半分。
今日は、空けた目で自分のファイルを開く番です。

半年後に救われた1行の手紙を、5日後の自分にも渡したい。
読んでくれてありがとう。

あわせて読みたい

▼ いまどこに立っているか（標高）を先に置きたいときに

測る側の記事です。
本記事は、空けた目がどこで詰まったかの記事です。

▼ 5日の空白の作り方を思い出したいときに

切る側です。
開けない5日があったから、空けた目が残ります。

▼ 再読を初日に持ち込まない上限を持ちたいときに

かけ方です。
コード再読は今日やらない、と置いた続きが本記事です。

▼ 「なぜ」の1行の原型を読みたいときに

半年後の自分を救った手紙です。
今日は、その手紙を5日後にも渡す話です。

▼ マージ前の別視点（AI）を揃えたいときに

道具は AI です。
本記事のレビュアーは、空けた時間です。

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

休み明けに自分のコードで止まるとき、足りないのは才能より、止まった箇所の分解が多いです。
% を埋めず、4層に印を付け、一手だけ直す——その型を、Vault 配布や城づくりに合わせて整えられます。

作戦会議室では、種②の「届く一歩」から、再開できる入口の残し方まで、配布物づくりと一緒に進められます。
空けた目を、自己嫌悪ではなくログに変えたい人は、どうぞ。

参加する

Substack はじめました

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

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

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

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

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

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