用途：规定智能体在某次会话中产出的工作文档（调查记录、根因分析、分析报告、计划、草稿消息、评审笔记等）应放在当前代码库的 _agent/docs/ 目录。永久性项目文档（docs/、README.md、ADR、RFC）不属于此约定，仍按各自仓库规则处理。_agent/ 用于存放智能体在仓库中留下的所有内容，_agent/docs/ 放这类文档，_agent/handoff/ 放 handoff 技能的步骤日志，且从不提交。
主要能力与用法：写入位置为 <repo-root>/_agent/docs/，其中根目录需通过 git 的 common dir 解析，以指向主检出目录而非 cwd 或 worktree 根；$ROOT/_agent 不存在时创建，并追加到 .git/info/exclude 使其不出现在 git status 中，三条命令每次执行： mkdir -p "$ROOT/_agent/docs" grep -qx _agent "$ROOT/.git/info/exclude" 2>/dev/null || echo _agent >> "$ROOT/.git/info/exclude" git -C "$ROOT" check-ignore -q _agent || echo "WARNING: _agent is not ignored" 文件按主题用 kebab-case 命名，可带工单号前缀。文档 H1 下加一行斜体会话链接，含日期与会话日志路径。
适用场景与限制：适用于任何代码库，尤其智能体常在临时 worktree 中运行的场景；无 git 仓库时 ROOT 即该文件夹。主题文档约超过四篇时应加 README.md 做索引，标注各文档状态、结论落点、被推翻的结论及证据，并列出 Handoff log 行。结论被推翻时在文首加 Superseded 引用块，说明仍有效与失效部分，正文不改写历史。与 handoff 日志分工：README 记录已知事实，handoff 记录下一步动作，二者互相链接。
其它限制：这些文档默认为草稿；若在别处成为正式版本，应在本地副本顶部加指向说明。仓库已有的旧笔记目录（llmtemp/、scratch/、notes/、.ai/ 等）只读取不新写，迁移需先征询，命令为 mv "$ROOT"/<old>/* "$ROOT"/_agent/docs/ && rmdir "$ROOT"/<old>。关于收费、价格暂未提供。