
工程師離職那天,我們才發現:那座系統,原來沒有人真的「懂」它
工程師離開時,真正帶走的往往不是程式碼,而是那些沒被記錄下來的決策脈絡。文件不只是交接清單,也是讓下一個人和 AI 接得住系統的關鍵。
那天的訊息很短,只有兩句:「想跟你聊一下,下個月我可能要離開了。」
接著就是長長的,很客氣的,補滿一段文字的「最近想要轉換跑道」。
我們收到那則訊息的當下,第一反應其實不是難過,是一陣輕微的暈眩。腦袋裡瞬間跳出來的不是「他要去哪」,而是——
「那台系統,誰來顧?」
一個人的腦袋,撐起整個營運
每一家走到第三年的小公司,幾乎都會有一個這樣的角色。
可能是當初幫忙寫網站的工程師朋友,可能是後來進來的第一個技術夥伴,也可能是創辦人自己。他們不一定是最厲害的那個,但他們是唯一一個「知道為什麼那一段會這樣寫」的人。
某段判斷邏輯為什麼長這樣?因為三年前有一個老客戶下單卡住,臨時加上去的。為什麼後台的會員等級欄位有兩個?因為當時跟舊資料合併時對不齊,留了一份備份。為什麼結帳頁某個按鈕會在週二自動隱藏?因為那是某個促銷沒下檔,後來懶得改。
這些事,都不在文件裡。它們在那個人的腦袋裡。
我們以為自己擁有的是一台系統,其實我們擁有的是一段「靠記憶在跑」的營運經驗。
兩週的交接,補不上三年的記憶
收到離職訊息的那兩週,是最焦慮的兩週。
我們開始一邊請對方錄影、一邊寫文件、一邊排會議。每天看著一份份新生出來的 Markdown 檔,標題寫著「金流邏輯說明」「會員資料結構」「上下架流程」。
那一刻會以為一切都來得及。
但等到他真的離開、新的人接手、第一個月遇到突發狀況時,才發現:
那些文件講的是「現在系統是怎麼運作的」,沒有講「為什麼當初要這樣設計」。
而真正卡住我們的,從來都不是前者,是後者。
文件不是寫給工程師看的,是寫給未來的我們
很多人會以為「寫文件」是工程師的事,是技術人的潔癖。
但真正會讓我們在三年後感謝過去自己的,是那一份份沒有人看的「決策紀錄」——當初為什麼選這個金流?為什麼決定不接 LINE Pay?為什麼會員等級從三層改成兩層?
這些東西,看起來瑣碎。可是它們才是讓系統「能被別人接手」的關鍵。
也是讓我們在某個工程師離開的下午,不至於得從頭打掉重練的,最後一道防線。
(會走到這一步很正常——大部分小公司都是先活下來,才有餘力顧到這件事。沒寫過文件不代表做錯什麼,只是還沒被生活逼到那一刻而已。)
AI 時代,文件變得更重要,而不是更不重要
最近大家很常聊 AI 工具能幫工程師寫多少程式、能幫忙除多少錯。
但我們慢慢發現一件事:AI 真正能幫我們做事,前提是它「看得懂我們的系統」。
當文件夠完整,AI 可以快速讀懂程式碼、提出修改建議、甚至協助日常維運。當文件一片空白,AI 也只能跟我們一樣茫然——對著一段沒有註解的程式碼,皺眉。
換句話說,過去文件是寫給下一個工程師看的,現在文件是寫給「下一個工程師 + 一個能 24 小時待命的 AI 助手」看的。
我們不是要把每一行程式都寫成論文。只要每一個重要決策,留下一兩段「為什麼」,未來的人(或未來的 AI)就有機會接得住這個系統。
真正會留下來的,不是程式碼,是脈絡
工程師會離開,這件事沒有什麼好怪的。
人都會走,公司都會換階段,這是健康的。
不健康的,是當他離開的那天,整個團隊發現自己對著螢幕眨眼,連從哪裡開始看都不知道。
所以與其問「下一個工程師什麼時候才找得到」,更值得問的,可能是:
「如果今天他走了,我們留得住多少?」
留得住的,從來不是程式碼,是脈絡。
(順帶一提,這篇文章本身也是一種文件——寫給三年後可能會忘掉今天為什麼要焦慮的我們自己看的。)