Files
Genarrative/docs/project-memory
lhk229 6119060dc0 文档:作废 D6,立项策划改为 Supervisor 下游工作流节点
产品侧确定「做方案」入口独立成链后复核代码,D6 的前提逐条不成立:
autonomous-game-build 对 user.input_request 的禁令按 run profile 生效、
父子皆不可提问;硬闯会把 runtime.status 写成 failed,而根活跃判定不认
failed,导致整条 16 节点工作流永久瘫痪;子 Run 又不能切换父 Run 的
profile;作为下游的策划节点带 parent,也不能自己提问。

新增 D9 / D10 取代 D6:策划是独立 agentId 的下游工作流节点,父子同为
standard;问询走 Runtime 直投——策划节点提交结构化决策字段,Runtime
创建 owner 为 Supervisor 的 pending。这不是新造机制,现役
AgentRuntimeUserInputRecord 本就两路投影(会话消息 + observation),
直投只是让两路分别落到 Supervisor 与策划节点,从而满足「用户侧只有一个
对话对象」与「对话内容必须物理存在于 Supervisor 会话」两条产品约束。

新增第 1.1 节承载变更说明与 M0 修订计划(工作包 M0A-3),按是否被
agentId/source 命名裁决阻塞分两批。三个代码工作包零回退——无一行按 D6
编写;但 M0A-2 的 owner 验证四重绑死且要求 parent,standard 路径必须
另建物理独立实现,不可扩展。

Goal Contract 四方案随之作废,替换为三条实测约束,其中「验收 evidence
锚 game/fast_gdd.md、不得指向 .agent/planning」是为了避开
reject_agent_runtime_private_control_path 不区分读写的陷阱。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-12 12:13:04 +00:00
..

项目记忆目录

本目录保存可以进入 Git 的项目级长期知识,供开发者和 Agent 读取。.hermes/ 只保留 Hermes 工具专用资源,不再作为项目知识库。

目录结构

docs/project-memory/
├─ README.md
├─ shared-memory/
│  ├─ project-overview.md
│  ├─ team-conventions.md
│  ├─ development-workflow.md
│  ├─ document-map.md
│  ├─ decision-log.md
│  ├─ pitfalls.md
│  └─ handoff-template.md
├─ plans/
└─ todos/

使用原则

  • 开发前先读 AGENTS.md;复杂任务继续读取 docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md,再按任务读取 docs/project-memory/shared-memory/ 和当前 docs/ 文档。
  • 长期有效的架构约定、接口变化、排障经验、开发流程和协作规则写入 shared-memory/
  • 阶段性计划写入 plans/,已确定但暂未实施的共享 TODO 写入 todos/
  • 如果本目录内容与代码或最新 docs/ 冲突,以代码和最新 docs/ 为准,并同步修正过期记忆。
  • 禁止写入个人配置、API Key、Token、Cookie、会话记录、认证文件、本地私密路径、构建产物、日志、缓存和数据库 dump。

RAG 索引

本目录是 Agent 本地 RAG 的高权重索引源。RAG 主要用于 Agent 检索上下文,不替代人工阅读入口或正式文档地图。索引脚本位于 scripts/rag/,本地生成的 .rag/ 数据不提交 Git。