為什麼「CLAUDE.md」變成 2026 年 GitHub 上被分叉最多的單一檔案——以及 PHP 團隊該偷的東西

本週 GitHub 上有一條看似冷門的小新聞，悄悄揭示了軟體架構未來的方向。2026 年成長最快的新 repo——目前已累積超過 10.1 萬顆星——竟然只是一個 Markdown 檔案。它叫做 CLAUDE.md，由開發者 Forrest Chang 把 Andrej Karpathy 那篇瘋傳的「LLM 寫程式時最容易踩的坑」濃縮成一份精煉文件。同一週，它的精神兄弟們——Hermes-Agent、「Skills for Real Engineers」（4.6 萬星）、以及更廣義的代理人技能框架（突破 17.5 萬星）——也輪番佔據 GitHub Trending 的頂端。這些 repo 沒有一個輸出二進位檔案，它們輸出的是「如何寫好上下文」。

如果你是 PHP、行動 App、或資料庫工程師，看到這個趨勢心裡想「這是 AI 人的事，跟我無關」——請暫停。這是新型專案文件的雛形，這一季把它做進專案的團隊，他們的 AI 代理人會自己跑完一張票；不做的團隊，還會繼續一句一句地哄 Cursor、Copilot、Claude Code 寫程式。

一、CLAUDE.md 到底是什麼

CLAUDE.md 是放在專案根目錄的一份檔案（在代理人時代，它等於 README + CONTRIBUTING + 資深工程師的入職口頭簡報合在一起），AI 代理人在每次任務開始時都會先讀它。Karpathy 那四條核心原則被密集寫進這份檔案：不要假設、優先選最簡單可行的程式碼、不要修改你還沒完全理解的程式碼、每次變更都要端到端驗證。整份檔案不到 200 行。十四週前它有 0 顆星，今天有六位數。

二、為什麼 PHP / Laravel / Node / Flutter 團隊都該重視這件事

代理人的行為是它能讀到什麼上下文的函數。一個沒有 CLAUDE.md 的 Laravel 專案，代理人會開始亂猜——錯誤的 Eloquent 關聯、捏造的 Facade 呼叫、忽然多出一個沒人要求的服務容器綁定。一個寫了 CLAUDE.md 並聲明「本專案使用 Repository pattern；Controller 不可直接查 Eloquent；所有時間戳一律 UTC；MySQL 8.0 strict 模式；每次變更後執行 php artisan test --parallel」的 Laravel 專案，代理人的行為會直接等於團隊裡的資深成員。

同樣的邏輯適用於任何 PHP/MySQL 技術棧、Flutter App、Node 服務。請停止把 AI 設定當成「工具設定」。它已經是專案的一部分，跟 Dockerfile 和 composer.json 一樣。

三、給 PHP/MySQL 專案的實用 CLAUDE.md 範本

照搬就行。放到 repo 根目錄、commit、每週迭代：技術棧與限制（PHP 8.3、Laravel 12、MySQL 8.0 strict、Redis 7、佇列驅動、部署目標）；架構守則（分層方式、業務邏輯放哪、不能放哪、命名規則）；資料庫不變量（migration 政策、索引哲學、軟刪除 vs 硬刪除、字元集、時區）；測試契約（哪個指令是正規入口、覆蓋率定義、整合測試什麼時候必寫）；安全底線（輸入驗證套件、驗證機制、機密處理規則、你主動防守的 OWASP 類別——建議從 A01 Broken Access Control 與 A03 Software Supply Chain Failures 開始）；以及一份「不可以」清單（不可繞過 query builder、不可寫死帳密、不可從腳本對 production DB 寫資料、不可關掉 CSRF）。六個段落、約 120 行。代理人會在每次規劃時引用，新進工程師也會。

四、更深層的趨勢——上下文是「第一級工件」

一個靜態 Markdown 檔之所以能成為今年最受歡迎的新 repo，是因為產業終於意識到一件事後諸葛的事：AI 寫程式的瓶頸已經不是模型，而是模型看不看得到「這個專案特有的事實」。模型早就夠聰明，是它沒被餵到對的資訊。CLAUDE.md、代理人技能框架、「真工程師的技能」都從不同角度把同一件事正規化。可以預期同樣的模式會擴散到別的場景：通用代理人 runtime 的 AGENTS.md、查詢代理人的 DB-CONTEXT.md、合作夥伴串接代理人的 api-context.md。

我的看法

二十年來大家都笑「沒人會看 README」。CLAUDE.md 是史上第一個會在每次 commit 都被讀的 README，而且讀它的那位「成員」真的會寫程式。光是這個性質，就把文件的經濟學從「有最好」改寫成「跟合併速度直接成比例」。如果到星期五你的主 PHP/MySQL repo 還沒加上 CLAUDE.md，每位工程師每週都在「上下文漂移」上漏掉真實的時數。這是這一季最便宜、槓桿最大的工程改動——成本只有一份 Markdown 檔加一杯下午茶的時間。