# PRD — Product Requirements Documents

产品设计层（参见 decisions/2026-04-23-add-prd-layer.md）。一个 PRD 回答 3 个问题：

1. **为什么做**（Why）— 问题 / 不做的代价 / 现在做的理由
2. **要做什么**（What）— 范围（in / out） / 用户流程 / 成功指标
3. **怎么做**（How，概要）— 方案选型 / 拆解到 FEAT

PRD **一对多** FEAT：一份 PRD 拆出多个 FEAT-NNN 由 `brain/features/` 承载实现契约。

## 三层关系

```
brain/prd/       ← 要不要做 · 为什么做 · 做到什么程度算赢
  ↓ 拆解
brain/features/  ← 单个功能实现契约（CLI 签名 / API / 测试 / AC）
  ↑ 跨功能叙事
brain/scenarios/ ← 用户 day-in-life 端到端路径
```

## 约定

- **文件名**：`PRD-<3位编号>-<英文 slug>.md`，例如 `PRD-001-realname-verification.md`
- **frontmatter**：`id` / `title` / `status` / `owner` / `created_at` / `linked_issue` / `linked_objective` / `linked_milestone` / `linked_features`
- **status**：`draft` / `approved` / `shipped` / `archived`
- 新 PRD 从 [_template.md](_template.md) 复制
- 归档：`status: shipped` 或 `archived` 后 `git mv` 到 `archive/`

## 当前 PRD

| # | 标题 | status | 创建日 | 关联 issue |
|---|---|---|---|---|
| [PRD-001](PRD-001-realname-verification.md) | 实名认证 | approved | 2026-04-23 | [#009](../issues/009-real-name-verification.md) |
| [PRD-002](PRD-002-distribution-strategy.md) | 分发渠道策略（主推 ClawHub） | draft | 2026-04-23 | [#030](../issues/030-distribution-channels-naming-and-strategy.md) |

## 不做（边界与现有层）

| 文档类型 | 为什么不做 | 替代 |
|---|---|---|
| Wireframe / Mockup | Markdown 画不出；CLI 当前无 UI | 用户流程段文字 swimlane 描述 |
| Information Architecture | 只一个 CLI | N/A |
| 情感曲线 | 过度设计 | 写在 scenarios 叙事里 |
| 竞品分析 | 一次性资料 | 进 raw/ 保留快照 |
| Feature Flag Plan | 小团队直接上线 + rollback | 按需加到 PRD 的"里程碑"段灰度策略 |

## 归档

见 [archive/](archive/index.md)（暂无归档；第一个 shipped/archived PRD 入时建 `archive/index.md`）。
