From 747c6f24afd0fbb9e9016536d2d866e758aa51aa Mon Sep 17 00:00:00 2001 From: Qiu Yuzhou Date: Tue, 29 Sep 2026 12:04:30 +0800 Subject: [PATCH] docs(agents): mark docs/research as point-in-time research reports MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A research doc was treated as an adopted in-flight design and a design round was built on its proposal until corrected: nothing in the repo documents said docs/research/ holds capability studies rather than project state, so the directory's semantic status had to be inferred. State it beside the other domain-truth pointers — research reports record what was investigated at writing time, current state and adopted designs live in code, CONTEXT.md and docs/adr/, and a report cited as implementation basis must be verified in code first. --- AGENTS.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 06a2887a..63e12e91 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -15,3 +15,5 @@ triage 标签使用五个默认角色名作为标签字符串(needs-triage / nee ### Domain docs single-context:根目录一个 `CONTEXT.md` + `docs/adr/`,按需惰性创建。见 `docs/agents/domain.md`。 + +`docs/research/` 收录研究报告:各文档记录写作时点调研的上游能力、候选方案与结论,不描述项目现状,也不代表已采纳的设计。现状与已定设计以代码、`CONTEXT.md` 和 `docs/adr/` 为准;把研究报告当实现依据前,先在代码里核实。