Imported from quanttide/quanttide-roadmap-of-business-entity (
AGENTS.md). Install upstream withnpx skills add quanttide/quanttide-roadmap-of-business-entity. Copyright stays with the author.
AGENTS.md — Roadmap 维护规范
本文档为在 roadmap 仓库（量潮科技工作蓝图）工作的 Agent 提供结构约定。
结构约定
roadmap/
├── index.md # 蓝图入口——不承载具体主题细节
├── {领域}/ # 如 qtclass/ qtrecurit/ qtcloud/ —— 领域各自路线图
│ ├── index.md # 领域整体路线图（全貌）
│ └── {专项}.md # 领域内专项（如 training-base.md 实训基地）
└── AGENTS.md
intro/（公司级层）已停用：跨领域主题全景迁至归属领域的意图仓库（实训基地 → quanttide-org/data/intention/training-base.md）。
放置规则（新增/移动主题时）
| 主题性质 | 放置位置 |
|---|---|
| 跨领域主题（串联多个领域） | 归属领域的意图仓库定义全景 |
| 领域内整体规划 | {领域}/index.md |
| 领域内专项（对应某跨领域主题的领域侧） | {领域}/{name}.md（与意图仓库全景同名同构） |
引用与重复规则
- 公共事实单一来源：跨领域全景只在归属领域的意图仓库写一次
- 领域文件只讲领域侧：qtclass/training-base.md 只写课堂路径；qtrecurit/training-base.md 只写招聘路径——不复制全景内容，引用意图仓库的全景文件
- 同名即同实体：多个领域目录下的同名文件（training-base.md）是同一实体的不同视角——修改时保持结构对称
2026-08-29 迁移：intro/training-base.md（实训基地公司级全景）已迁至
domains/quanttide-org/data/intention/training-base.md（组织管理意图仓库）——实训基地归属组织管理领域，公司级全景在那里维护。qtclass/qtrecurit 的领域侧文件保留在本仓库，引用指向新位置。
维护原则
- 结构即真实：roadmap 结构镜像组织真实结构——跨领域实体不塞进单一领域
- 验证先行：过时信息先核对最新事实（journal/profile/群聊记录）再改——不确定的不删（如"免费上课送实习"是双路径之一，非过时）
- 改动前确认：结构变更（移动/拆分/重写）先给方案，用户拍板后执行
- 概括核心：更新时概括核心主线，不堆细节