誰も仕様を覚えていない？いるよ、私が（曖昧に）｜また私か日記 #01

今日の話：また私か、から始まる日常

今朝、現場の担当者から声をかけられました。

はい出ました、「ちょっと」案件。
この「ちょっと」って言葉ほど、カジュアルな顔して重量級パンチを繰り出す単語は他にありません。

経験則によると――
「ちょっと追加」＝まあまあガッツリ新規実装。
そしてそのまま調査地獄コース（ノーリターン）に突入します。

あのコードを書いたのは…誰だ？（私です）

該当システムは、5年前に業務変更で改修した記憶があります。
でもその記憶は、RPGでまだ地図が灰色になってる未踏エリアレベル。

ソースを開くと、見覚えがあるような…ないような…。
処理ロジックはややこしく、当時の私の思考は完全に暗黒ダンジョン化してます。

しかもこの画面、複数部門で共用。
つまり「ちょっと追加」すると、他部門の運用がドミノ倒しになる可能性大。
仕様書ではなく、部門間の空気を読み解く作業が発生するのです。

「仮」って書いたの誰だよ（私です）

コードを読み進めていると、出てきたのがこちら。

if (x == "QC" || x == "TMP" || x == "CHK" || x == "他いろいろ")
・
・
・

その上には、過去の私からのメッセージ。

// 一時的な対応（仮）

5年前の私へ。
「仮」って、5年も定住して“本社ビル”みたいになってるんだけど？
しかも今回の仕様変更にがっつり関係してる部分っぽいんだけど？

社内調整 × 記憶力 × 地雷コード ＝ 地獄の三重奏

検査部門にヒアリングしたら、こう言われました。

「この部分だけ追加してもらえればOKです！」

いやいや、そんな“部分”なんてないのよ。
だってこの処理、他部門とがっつり連動してるんだから。

つまり対応前に必要なのは：

• 他部門がどう使ってるかの確認
• 変更による影響範囲の洗い出し
• そもそもなぜこのロジックになったのかの再確認

これを知ってるのは誰？
私です。（でも全然思い出せません）

午後がまるっと“調整”で消滅した

各部門に確認連絡、古い仕様メモを発掘、ログを総チェック。

結果――
プログラムは1行も書いていません。

でもこれは「何もしてない」じゃなくて、
「地雷原を踏む前に撤去した」大事な成果なんです。

なのに進捗報告はこうなる。

「検査システム：仕様確認中（対応未着手）」

いやいやいや。手はつけた。むしろ擦り切れるほど使った。
ただ、まだ“コードに触っていい状態じゃない”だけ。
ただ、まだ“手を動かせる状態じゃない”だけ。

今日の教訓：コメントは未来の自分への道標

未来の自分が迷子にならないように書くべきは、「魂のこもったコメント」。

// 一時的な対応（仮）

↑ これは道標じゃなくて「置きメモ」。
未来の自分、確実に泣きます。
いや、今日泣きました。

残すべきは：

• 何でこの処理を入れたのか
• 何がトリガーだったのか
• 影響範囲はどこか
• 誰とどういう会話で決めたのか

コードじゃなくて、ドキュメントに残すべきだったな…と今さら反省。
というか、上から仕事降らされすぎて書く暇ない（言い訳）

結論：私しか知らない仕様は、未来の自分も知らない

ひとり担当は、何でもできる。
でも同時に、「何でも自分しかわからない」に陥りがち。

記憶力は有限。5年後の自分は他人同然。
「仮」「とりあえず」「あとで見直す」は、未来への死亡フラグ。

だから今日の教訓はこれ。

• コメントは真剣に書け
• ドキュメントは今残せ
• 未来の自分を信用するな

今日のまとめ

• 「ちょっと追加して」は、わりとガチ実装案件
• 共用されてるシステムは、変更前に社内調整が必須
• 昔の自分のコードが一番の敵
• プログラムは書かなくても、今日もちゃんと仕事した

---

📌 読んでくださってありがとうございました！
似たような経験をお持ちの皆さん、「あるある」と思って読んでいただければ嬉しいです。
あなたの会社にもきっとひとりはいる、「開発から保守まで全部担当の人」を大事にしてあげてください笑