# root.md — 我們到底在做什麼（需求根文件）

> 這是**兩軌共享的唯一錨點**：PM 軌（[journeys.md](journeys.md)）和技術軌（各專案自己的規格）都從這裡長出來。
> **規矩**：一張卡一句白話 ＋ 來源標記 ＋ 紅綠燈。**禁止出現任何技術名詞**——技術是手段，寫進各專案自己的規格，不寫進根。
> **紅綠怎麼判**：能指著市場上活得好好的先例說「照這個做」＝🟢；不能、解法是猜的＝🔴。**紅卡必附對帳判準與對帳日。**
> **誰能寫**：只有總管。**誰來勾**：出資／決策的那個人——卡片真偽是他的第一道閘，這份文件的價值全在他點頭或搖頭。
>
> 立卷 [YYYY-MM-DD]。素材＝[列出你是從哪些文件／對話讀出這些卡的]。

---

## 一、[分節標題：例如「關於我怎麼工作」]

> 分節是為了讓人一眼看出「這幾張是同一類的事」。沒把握就先不分，卡多了再分。

- **P1** 🟢 [一句白話。不懂技術的人讀了能點頭或搖頭。]
  - ——（你說的：[出處]）

- **P2** 🔴 [一句白話。]
  - 【要驗證：[一句話判準，要能用真實世界的數字或事實判真假] ｜ 對帳日 [YYYY-MM-DD]】

- **P3** 🟢 [一句白話。]
  - ——（你舉的例子：[出處]）

## 二、[分節標題：例如「關於我在賣什麼」]

- **P4** 🔴 [一句白話。]
  - 【要驗證：[判準] ｜ 對帳日 [YYYY-MM-DD]】

- **P5** 🟢 [一句白話。]
  - ——（從你的抱怨反推：[出處]）

## 三、[分節標題：例如「關於產品要給誰」]

- **P6** 🟢 [一句白話。]
  - ——（我猜的，請確認）
  - 這張卡就是 [journeys.md](journeys.md) 的 **J-1**。 ← 卡片對應到某條旅程時這樣標

---

## 這份文件現在的狀態

> 這一段不是客套，是**交接資訊**。刪掉它，讀的人就不知道這份文件可信到什麼程度。

- **全部 N 張卡都還沒被勾過**（或：已勾 N/M）。紅綠燈是總管依「有沒有市場先例」判的，來源標記寫的是從哪裡讀到的。
- **請你做的只有一件事**：掃過去，看有沒有哪張卡「不是我的意思」或「這根本不重要」。搖頭的拿掉，你補的加上。
- ⚠️ 標明有沒有「我猜的」卡。凡是 PM／AI 推測補完、而非本人明示的內容，**必須帶「請確認」類標記**，不得混充原意。
- 紅卡的對帳日到了，會拿真實數據來對帳：**承諾成立，或換一個承諾**。賭錯不丟臉，賭了不認才是。

---

<!-- ════════ 寫這份文件的規矩（給總管看，不是內容的一部分）════════

【卡片格式】
  - **P<編號>** <🟢或🔴> <一句白話>。
    - ——（來源標記）                    ← 🟢 卡用這行
    - 【要驗證：<判準> ｜ 對帳日 <日期>】  ← 🔴 卡改用這行，**缺了就是格式錯誤，會被擋**

【來源標記怎麼寫】
  常見形式：（你說的）（你舉的例子：X）（從你的抱怨反推：X）（我猜的，請確認）
  形式不限於此，可依實際來源自由描述。
  唯一鐵律：**凡是推測補完、而非本人明示的內容，必須帶「請確認」類標記。**

【禁止技術名詞】
  不准出現：API、DB、資料庫、WASM、MCP、endpoint、schema、SDK、CLI…
  技術是達成手段，寫進各專案自己的規格，不寫進根。
  ⚠️ 自檢只掃**卡片本體**（`- **P...` 開頭那些行及其子項），
     不掃這段說明區與 <!-- --> 註解——否則你在解釋規矩時提到的詞會被自己抓到。

【紅綠怎麼判】
  能指著市場上活得好好的先例說「照這個做」＝🟢（輪子卡，考過即關）
  不能、解法是猜的＝🔴（賭注卡，考過轉「對帳中」，等對帳日拿真實數據判決）

【誰能寫】
  只有 orchestrator。engineer／subagent 寫這個檔會被 hook 擋下——考生不能改考卷。
════════════════════════════════════════════════════════ -->