入職第八天，我開始為 AI 寫文件

入職第五天，我拿到了 Claude Code ，開始試著和 AI 同事協作。 第八天，我決定為 AI 寫文件——不是以往的 README.md，是專門餵給 AI 讀的 LLM.md。 第十四天，我把第一個 PR 送出去，同事一看大量的新增檔案，當場傻眼。沒想到幾天後換我審他的 PR 的時候，發現他也開始寫 LLM.md，不只如此，他還寫了一份「文件的文件」，把整套做法立成規範。 這場分享，想講的就是這六十天裡發生的真實故事，以及我們意外發展出的「雙軌文件」玩法： 一份 README 給人類看，另一份 LLM.md 給 AI 看。兩份文件重視的內容完全不一樣。 從這個起點出發，我們一路延伸到架構規範、流程文件、設計 token 系統，慢慢拼出一套團隊能複製的方法論。

我會分享以下幾件事：

• 為什麼 AI 需要跟人類不一樣的文件？
• 雙軌文件怎麼設計、怎麼演化？
• 個人小習慣是如何變成團隊規範的？
• 以及這套做法真正的代價與限制

實踐來自一個 Kotlin / Android 團隊，但核心概念適用於任何 JVM 專案。

無論你是正準備把 AI 工具引入團隊，還是單純對「人跟 AI 一起寫程式」時的工程實踐感興趣，都歡迎來聽聽這段狂踩油門的經歷。