# Research 目录 Agent 指南

## 目录职责

`docs/research/` 存放新技术、新技术栈、优秀 repo、工程范式和工具趋势的短篇研究。

这里的文档回答：

- 它是什么。
- 它解决什么问题。
- 为什么值得关注。
- 适合什么场景。
- 有什么风险和替代方案。

## 文件地图

```text
research/
├── README.md  # 线性总文档：研究笔记集合
└── AGENTS.md  # 本目录操作规则
```

## 修改规则

- 每篇研究笔记聚焦一个技术、repo、范式或工具，并追加到 `README.md`。
- 不再新增同级主题 `.md` 文件；如确需拆分，必须同步更新全仓链接和 `metadata/redirects.yml`。
- 研究内容稳定后，放入 `docs/concepts/`、`docs/references/` 或 `docs/philosophy/` 的对应章节。
- 外部项目、模型、工具、版本和事实状态可能变化，涉及最新信息时必须核验来源。

## 质量要求

- 不写新闻转述，要给出判断、边界、采用建议和后续观察点。
- 对不确定信息标注“待验证”或 TODO。
- 引入外部事实时优先引用官方文档、原始仓库、论文或可信一手来源。