# 检索布局

## 来源优先级

1. 用户当前明确指令。
2. 目标目录适用的 `AGENTS.md`。
3. `.craftkit/project.json` 声明的项目边界和入口。
4. `.craftkit/agents/`、`.craftkit/standards/`、`.craftkit/knowledge/` 中的项目资料。
5. Skill 随附的中性公共基线。
6. 现有代码，只用于规范未覆盖时观察项目现状。

同一层出现冲突时，不静默选择：列出冲突文件、适用范围和需要用户决定的事项。

## 渐进加载

先读入口，再读路由，最后读正文：

```text
index.md
└─ domain/index.md
   ├─ layers/topic.md
   └─ rules/detail.md
```

- 第一跳只判断领域和候选路径。
- 第二跳只读取当前任务相关的层或横切主题。
- 第三跳只展开命中的规则正文。
- 高置信规则已经覆盖问题时停止，不为“完整”继续追踪无关链接。
- 索引无效时使用文件名、标题和关键词搜索，并在输出中标注使用了兜底检索。

## 项目目录

```text
.craftkit/
├─ project.json
├─ agents/
├─ standards/
├─ knowledge/
├─ handoff/
├─ local/
└─ cache/
```

前五项可以是共享项目资产。`local/` 和 `cache/` 应由 `.craftkit/.gitignore` 排除，不参与普通共享规范检索。