# 產品文件（Spec-Driven）

本目錄是 **需求 → 規格 → 計劃 → 小任務** 的產物根，由專案 skill `/spec-driven` 驅動。

```text
docs/product/
  README.md                 # 本說明
  <slug>/
    README.md               # 目前 phase 與狀態
    requirements.md
    spec.md                 # 需求批准後
    plan.md                 # spec 批准後
    tasks/
      INDEX.md
      T001-....md
```

## 怎麼用

```text
/spec-driven                          # 開新的或繼續未完成
/spec-driven haixun-console           # 指定產品 run
/spec-driven haixun-console --status  # 只看進度
```

**規則：** 每階段寫完要等人批准，才能進下一階段；未批准 plan / tasks 前不寫業務程式。

模板與流程細節：`.grok/skills/spec-driven/`。

## 現有 run

| Slug | 說明 |
|------|------|
| [haixun-console](./haixun-console/) | 巡樓 Console **從零重寫**（`old/` 封存；地基 → FE mock → 後端） |

## 與其他 docs 的關係

| 路徑 | 角色 |
|------|------|
| `docs/architecture.md` | 程式怎麼長（現況） |
| `docs/improvement-notes.md` | 技術改進建議（非產品需求） |
| `docs/post-project-plan.md` | 文案流重做構想（輸入，須併入 requirements 才算正式） |
| `AGENTS.md` | 實作約束 |
| `docs/product/*` | **產品決策真相來源**（本流水線） |
