agent-shared-memory 用于智能体协作场景下的持久事实协调，避免智能体静默改写项目记忆。使用前应阅读 references/coord_memory_schema.md 中的事件模式。权威顺序为：仓库状态、当前证据、已记录的人类决策高于记忆，召回系统仅是可选缓存。
主要能力分四种模式。读取：读取规范事件并返回当前决策（含 supersedes 引用）、未解决问题、相关产物/证据指针、近期执行结果、冲突或过期声明；不将原始智能体日志载入主会话。提出：在 .coord/memory-proposals/<proposal-id>.json 创建提案，含 schema_version、proposal_id、source_task、action（operation 为 add|supersede|archive|delete，含 target_ref、summary、evidence_refs）、state、created_at、decision；supersede/archive/delete 必须指定 target_ref，无 evidence_refs 的提案保持待定且不得应用，action 对象不可变，其规范 JSON 字节（非可变信封）才是审批载荷。决策：仅人类可批准、拒绝或修订，需记录 actor、decision、时间戳、理由、受影响的提案/动作哈希及可信主机的 HMAC 授权；拒绝和超时均为非成功，修订会新建或更新提案而非批准。应用：仅应用 state 为 approved 且不可变 action 字节仍匹配 decision.affected_action_hash 的提案，使用与检查点人工记录相同的 hmac-sha256 授权边界，不得向被委托执行者暴露签名密钥。
应用时向 .coord/memory.yml 追加一条不可变事件，绝不编辑已有事件：取代决策追加带 supersedes 的新决策事件，解决问题追加带 resolves 的解决事件，归档或删除追加引用 target_ref 的生命周期事件。规范移除、压缩或物理删除需单独的仓库特定保留决策。
该记忆仅用于协作决策、问题、产物指针和执行结果；研究真相属于研究证据库，论文主张属于论文的声明/证据契约。.coord/ 默认为草稿且被 gitignore，不应提交每个提案或智能体边界，仅将明确选定的检查点快照、交付产物或验收记录提升到仓库自有证据路径。输出时始终报告模式、提案/事件 id、状态、证据引用、规范记忆是否变更、是否仍需人类决策，且绝不把未批准提案报告为规范决策。