# {{project_name}} 速查

本文件是 AI 工具的 **30 秒入口**。详细规范按需加载对应文档。

---

## 硬规则（不可妥协）

| # | 规则 | 详见 |
|---|------|------|
| 1 | 品牌 **{{project_name}}** | [BRAND.md](docs/BRAND.md) |
| 2 | 技术栈：{{tech_stack_summary}} | [ARCHITECTURE.md](docs/ARCHITECTURE.md) |
| 3 | 禁止项：{{tech_constraints}} | [DECISIONS.md](docs/DECISIONS.md) |
| 4 | 部署方式：{{deploy_method}} | [deploy/README.md](deploy/README.md) |
| 5 | 终端环境：{{terminal_env}} | [LOCAL-SETUP.md](docs/LOCAL-SETUP.md) |
| 6 | 禁止未经询问的破坏性操作（删库/停服/改 .env） | [PITFALLS.md](docs/PITFALLS.md) |

---

## 高频操作

| 操作 | 命令 |
|------|------|
| 启动开发 | `{{dev_start_cmd}}` |
| 编译检查 | `{{check_cmd}}` |
| 运行测试 | `{{test_cmd}}` |
| 部署生产 | `{{deploy_cmd}}` |

---

## 按需文档

| 场景 | 文档 |
|------|------|
| 产品范围与验收 | [PRD.md](docs/PRD.md) |
| 编码速查 | [quick-ref.md](docs/quick-ref.md)（完整规范见 DEVELOPMENT-STANDARDS） |
| 技术架构 | [ARCHITECTURE.md](docs/ARCHITECTURE.md) |
| 本地开发环境 | [LOCAL-SETUP.md](docs/LOCAL-SETUP.md) |
| 进度与焦点 | [STATUS.md](docs/STATUS.md) |
| 里程碑 | [ROADMAP.md](docs/ROADMAP.md) |
| 已拍板决策 | [DECISIONS.md](docs/DECISIONS.md) |
| 踩坑库 | [PITFALLS.md](docs/PITFALLS.md) |
| 项目治理与演进 | [GOVERNANCE.md](docs/GOVERNANCE.md) |

---

## 禁止清单

| ❌ 禁止 | 为什么 |
|---------|--------|
| 闷头猜需求 | 猜错 = 返工，双方浪费时间 |
| 顺手重构无关代码 | 引入新 bug，扩大 scope |
| 编造数据/进度 | 后续决策全错 |
| 跳过确认直接动手 | 用户拥有最终决策权 |
| 一次对话塞多个任务 | 质量下降 |
| 自行启动/停止服务 | 可能影响其他协作者 |
| 提交 `.env` / 密钥 | 安全红线 |

---

## 文档结构速览

```
{{project_name}}/
├── AGENTS.md          ← AI 助手首先读这里
├── QUICKREF.md        ← 30 秒速查（本文件）
├── docs/
│   ├── BRAND.md       ← 品牌规范
│   ├── PRD.md         ← 产品需求
│   ├── STATUS.md      ← 当前进度（每次会话后更新）
│   ├── ROADMAP.md     ← 里程碑
│   ├── DECISIONS.md   ← 架构决策记录（ADR）
│   ├── PITFALLS.md    ← 踩坑库
│   ├── GOVERNANCE.md  ← 项目治理与演进
│   ├── ARCHITECTURE.md← 技术架构
│   ├── LOCAL-SETUP.md ← 本地开发环境
│   └── quick-ref.md   ← 编码速查
└── src/               ← 源代码
```