Agent-Native/AGENTS.md

项目工作入口

本项目采纳的通用规则：核心规则。 采纳范围、生效状态及项目差异：采纳记录。 项目事实、测试和环境入口：PROJECT.md。

• 启动：阅读以上短入口；只加载本次任务触发的专题。
• 普通交付：交付流程。
• 并行开发/正式测试/审核/合入：共同基线与同步节点，必须确认并实际同步最新权威目标。
• Bug/异常：系统性排障。
• 会话结束/换机器/换客户端/换执行者：会话、执行者与机器交接，状态写入任务主记录，不依赖本地会话历史。
• 测试与验收：验证标准。
• 模块/接口：模块契约。
• 功能设计/跨模块变更：设计与验证，按增量明确验收、独立测试及故障范围。
• 错误与过程事件：可观测性。
• 拆仓与 submodule：多仓库与固定版本组合。
• 其他专题：按 任务索引 选择。

项目补充硬边界：

• contract 不依赖内核、产品类型、数据库或本仓以外的运行时；错误码字符串与 Error-Code-System 的 agent.* 规范码对齐，旧字符串只作为别名由错误码库解析。
• 未知结果保持 Unknown，不降级为成功或失败；副作用为 possible/unknown 时禁止无条件重放。
• 缺能力即拒绝，不静默降级到 Stub。Workspace 路径授权不是 OS 沙箱。
• 意图闸门为可选依赖：唯 adapters/intentgate 与其测试可 import agent-intent；contract/exec/runtime 等核心不感知意图。未 Wrap 或意图快照为空时，后端行为与原实现一致；识别系统错误 fail-closed。
• 依赖仓版本以本仓 gitlink 为准，不执行 submodule update --remote。

任务权威：Gitea 仓库 weichen/Agent-Native 的 Issue 与 Pull Request。 规范性文档目录与过程记录位置：policy/ 放项目规则；docs/records/ 为过程记录豁免目录（方案、验证、交接）。项目规范与过程记录不进通用规范库。 默认集成基线和提交身份：main；提交身份沿用本机 git 作者，不在文档中写死密钥或个人 fork URL。 共享环境/发布入口及授权：无共享运行环境。权威远端 ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-Native.git。