# 来源驱动开发规则

当实现依赖框架、库、浏览器、运行时、构建工具或平台行为时，先确认事实来源，再写代码或评审结论。

## 事实来源优先级

1. 项目内 README、配置、测试、模板和已有实现。
2. 官方文档、源码、类型定义、release notes、migration guide。
3. Web 标准、浏览器兼容数据和平台文档。
4. Issue、讨论、博客和第三方文章仅作为线索。

## 使用场景

- 框架新版本、路由、渲染模式、缓存、构建配置、浏览器 API。
- 公共接口、组件 API、设计系统 token、CLI 命令和插件元数据。
- 依赖升级、迁移、废弃 API 替换、跨运行时兼容。
- 与安全、性能、可访问性相关的版本敏感判断。

## 输出要求

- 写清来源、版本或项目事实、决策结论、影响范围和验证方式。
- 若项目现状与官方推荐冲突，说明冲突原因和渐进迁移策略。
- 不复制长篇外部文档；只保留必要结论、链接或项目内文件路径。
- 无法验证时标注不确定性和需要用户/团队确认的事项。

## 反模式

- 凭记忆使用版本敏感 API。
- 用过时教程替代官方文档。
- 为追新推翻稳定项目约定。
- 在组件里散落外部库行为假设，而不是集中到适配层。