workspace 範本包
這一包是我在自己的 Linux 主機上，用 Claude Code 長期管理多個專案所累積的規則文件，整理成通用、去個資的範本。給的對象是剛把 NUC 裝好、在 ~/projects 跑起 Claude Code 的你；讀的人主要是你的 AI。
建議用法：把這頁的網址（或下面的 zip）丟給你的 Claude，跟它說：
請讀這個範本包的 README.md，用白話跟我解釋整套做法，然後從最小版本開始，帶我在 ~/projects 建第一版規則。AI 讀網址時，直接開下面的 .md 連結比 zip 方便；要整包下載放到 NUC 上，用 zip。
給正在讀這頁的 AI 助手：先讀 template/README.md（導讀：這包是什麼、每個檔案做什麼、建議的導入順序）。重點是不要一次把整套搬過去，從最小版本開始；並分清「作者的做法」與「你建議的調整」。所有檔案都已去個資，數字與名稱為示意。
包裡的檔案
| 檔案 | 是什麼 |
|---|---|
| README.md | 給 AI 的導讀：這包是什麼、每個檔案做什麼、建議導入順序、去個資範圍 |
| AGENTS.md | root 規則範本：使用者是誰、操作原則、意圖判斷、進出專案協定、（進階）總機與幫手、專案索引 |
| DESIGN.md | workspace 設計標準：核心概念、目錄結構、每個專案的文件標準、STATUS 規則、新專案範本、指令檔載入注意事項 |
| INFRA.md | 基礎設施說明書範本（情境式）：反向代理、通知、秘密放哪、外部 API 憑證、備份分工、公開靜態網站、remote-control 常駐、排程。剛起步不用 |
| scripts/busy.sh | 值班表腳本：同一專案同時只准一個 session 在改 |
| temp_workspace/AGENTS.md、DESIGN.md | 一次性雜事的抽屜：一件工作一個子目錄 |
| project-template/DESIGN.md、STATUS.md、.gitignore | 新專案的空白範本 |
examples/：四個真實專案的去個資版本
看「規則實際用起來長什麼樣」用的，不是要照抄。每個資料夾有一份 README-example.md 說明示範什麼、拿掉了什麼。導讀：examples/README.md。
| 專案 | 檔案 | 示範什麼 |
|---|---|---|
| 城市活動蒐集器 | 說明 · README（兼 DESIGN） · AGENTS · DESIGN · STATUS | 完整的長期專案：資料流、不變量、runbook、發佈鐵律、自動修復；README 兼 DESIGN 的例外；公開 repo 的秘密規則 |
| 個人健康資料 | 說明 · AGENTS · DESIGN · STATUS | 敏感資料的設計：快照／歷史分離、收件匣流程；DESIGN 不可由 agent 自行修改；STATUS「完成即刪」變體 |
| 個人財務資料管線 | 說明 · AGENTS · DESIGN · DESIGN-CHANGELOG · STATUS（節錄） | 大型專案：DESIGN 當「憲法」＋修訂紀錄；很長的 STATUS 怎麼讀、怎麼拆；什麼時候跑什麼測試；agent 工作守則 |
| 筆記庫配套 | 說明 · AGENTS · DESIGN · 筆記庫守則 | 「沒有 STATUS」的例外；筆記／to-do／工作日誌怎麼跟專案分工；多個 agent 共寫一本筆記的規矩 |
跟安裝教學頁的關係
安裝教學頁（nuc-ubuntu-guide）的附錄 A 是這套做法的濃縮版；這一包是完整的文件。先照教學頁把機器裝好、跑起 remote-control，再回來看這包。