# 代码语义与导航层

本文定义项目里的导航顺序，帮助 agent 先找到入口，再进入具体实现。

## 默认顺序

1. `docs/ai/repo-map.md`
2. `docs/ai/architecture-brief.md`
3. `docs/ai/CURRENT_TASK.md`
4. 代码语义工具或全文搜索
5. `docs/knowledge/*`

## 职责边界

- `docs/ai/*`: 文档导航层
- 代码语义工具: 定义、引用、调用链、影响面
- `docs/knowledge/*`: 历史经验和长期可复用知识

## `docs/ai/*` 最低字段

- `repo-map.md`
  - 关键目录
  - 阅读顺序
  - 代码入口
  - 调用链提示
  - 测试入口
  - 配置入口
  - 禁改区
- `CURRENT_TASK.md`
  - 任务目标
  - 验收标准
  - owned paths
  - 模块归属
  - 类似实现
  - 影响调用方
  - 验证命令
  - no-touch 区域
- `API_MAP.md`
  - 路由、命令、脚本或接口入口
  - 配置接口
  - 错误/认证入口
- `DB_SCHEMA.md`
  - 数据入口
  - 关键实体
  - 约束或持久化边界

## 影响面分析最少回答

- 入口在哪里
- 上游是谁
- 下游是谁
- 受影响文件有哪些
- 受影响测试和验证命令有哪些
- 路由、权限、中间件、环境变量、build/deploy 是否会受影响
