# AGENTS.md

## 作用范围

- 本文件适用于 `docs/codex-harness-engineering/templates/` 整个模板树。
- 进入子目录后，继续读取该子目录自己的 `AGENTS.md`。

## 目录作用

- 这里是当前仓库最重要的模板 canonical 源。
- 影响 bootstrap、driver、docs、rules、prompt、truth source、package-assets 的改动，默认都先发生在这里。

## 结构索引

- `README.md`：模板目录总览。
- `bootstrap-codex-harness.ps1`：模板安装 / 复制主入口。
- `ci/`：CI 工作流模板。
- `config/`：配置示例、rules、agent 定义。
- `context/`：`docs/ai/*` 和计划上下文模板。
- `contracts/`：契约优先模板。
- `design/`：前端设计与图转前端规格模板。
- `docs/`：会复制到 `docs/harness/` 的说明文档模板。
- `governance/`：治理策略、风险分级、保护清单。
- `hooks/`：hook 模板。
- `knowledge/`：知识层模板。
- `package-assets/`：镜像到目标项目 `.agents/` 或相关文档面的资产。
- `product/`：产品预研 / 测试左移素材模板。
- `prompts/`：driver、review、worker prompt 模板。
- `runtime/`：driver、task、verify、doctor 等运行面模板。
- `scripts/`：辅助脚本模板。
- `spec/`：默认 `docs/spec/*` 规格模板。
- `testing/`：测试真相源模板。
- `tools/`：内容门禁脚本模板。
- `trace/`：trace schema 和样例。

## 特殊说明

- `runtime/AGENTS.md` 已经是“安装到目标项目根目录的 AGENTS 模板内容”，不要把它改造成目录级导航文件。
- `config/global-AGENTS.md` 是全局规则示例，不是本目录本地规则。

## 修改前先看

- `README.md`
- `bootstrap-codex-harness.ps1`
- `../doc-update-map.md`

## 修改规则

- 改动模板时，优先确认是否还需要同步当前仓库活跃副本、`tools/install/bootstrap-codex-harness.ps1`、`docs/harness/*` 或 package-assets 镜像。
- 不要只修某个镜像副本而漏掉模板 canonical。
- 如果一个目录已经有交付用同名文件（例如 `runtime/AGENTS.md`），目录规则写在上级 `AGENTS.md`，不要覆写交付模板。
