# 政策包（policy pack）＝ 官方 plugin，以及它什麼時候被載入

> 這份是**約定**，不是實作。它回答一件事：機制是怎麼在 agent 醒來之前就已經在場的。

---

## 鐵律：政策包一律做成 Claude Code 官方 plugin

- 框架**不發明平行的外掛格式**。官方 plugin 已經涵蓋 hooks／skills／agents／commands／
  MCP server 的打包、安裝與版本分發——自造一套等於重寫一個市場上活得好好的輪子。
- 要寫政策包的人，**動手前先讀官方文件**，照現行 schema 實作，
  不要憑記憶寫設定檔格式。官方會改，記憶不會跟著改。

---

## 三層是什麼（別把層搞混，混了就回不去）

- **框架（L1）**：方法論——雙軌、wiki、封路、階梯、儀表
  - 判準：**換一家公司照樣成立**
  - 住這裡：本 template
- **政策包（L2）**：一家之言的技術棧政策
  - 判準：**換一家公司就不成立**
  - 住這裡：獨立的 plugin repo
- **實例（L3）**：資料——卡片內容、wiki、sprint、指標
  - 判準：**換一個 repo 就不成立**
  - 住這裡：各實例自己

> 框架範本裡出現具體專案名 ＝ 格式錯誤（有 CI 擋）。政策包不受此限——專名是它的內容。

---

## 載入順序（agent 醒來時世界已就位）

1. **profile 憲法**（scope 軸：這個資料夾的 CLAUDE.md——總管版或成員版）
2. **框架 hooks 上鏈**（common ＋ profile）
3. **已安裝的政策包注入**——必讀推到眼前、白名單 hook 排入鏈尾、skill 就緒
4. **接關**（wiki 快照）

- 執行期的總管／engineer **不需要知道** plugin 是官方機制還是框架機制——
  hooks 在鏈上就會攔、skill 在庫裡就會觸發。
- **機制不靠認知，靠結構在場。** 唯一需要懂 plugin 規格的角色，是「改框架／寫政策包的人」。

---

## 框架這一側只做兩件事

1. 文件化上面這個約定與順序（就是這份檔）
2. 在兩部憲法裡留 **must-read 注入點**——政策包的 SessionStart hook 有地方把必讀推進來

注入點長這樣（兩部憲法末尾都有）：

```markdown
## 政策包必讀（policy pack must-read）
<!-- policy-pack:must-read -->
```

- 沒裝政策包時它是空的，不影響任何事。
- 框架**不需要為此新造機制**——官方 hook 就做得到。