Agent-System-Dev/PROJECT.md

Agent-System-Dev 项目事实

• 用途：开发集成父仓（gitlink 权威）；非分发单元。
• 组合（与 .gitmodules 一致）：modules/{core,backend,frontend,ui,documents} + deps/{development-guidelines,development-manager,agent-native,agent-squad,agent-intent,agent-command,error-code-system,logging-system}。
• 部署：非容器；Releases 仓从本仓固定提交导出版本。

验证

make test 先核对子模块工作树与固定指针，再运行治理脚本、公开边界、跨仓指针、库及各模块 测试。实际目标以根 Makefile 为准。make test-governance 可独立检查开发门禁，使用临时 真实仓库，不访问生产数据；操作与证据要求见 开发门禁。

scripts/agent-exec validate --repo . 核验 AGENT-EXECUTION.md，scripts/dm governance check --repo . 核验治理 kit 入口与采纳状态（只读）；二者均在 CI 中运行。

make build 在 backend 模块内编译，replace 指向该模块自己的 deps/； scripts/check-pins.sh 核对这些 gitlink 与 Dev 顶层指针，make test-worktree 另核对 真正被测的组件工作树。两者分别验证固定组合与实际检出，不能相互替代。

未加 go.work：工作区最小版本选择会抬高 backend 单独构建使用的部分 golang.org/x 版本。 发布消费方须从固定 Dev 提交递归物化后运行 make build，再核验制品与实际运行状态。

多个分支向 Dev main 交付时按 合入调度 执行；实际采纳范围见 采纳记录。

方向与规划入口

长期方向、目标及跨任务规划从过程仓的 项目方向与规划索引 查找主记录、里程碑和关联任务；原始正文沿用 方案与规划目录。 确立或调整具体方向时，在本入口维护其主记录链接；记录、任务关联及收尾建议按 交付规范的长期方向与任务衔接 执行。

下列条目只是主题索引：批准、进展、验收与部署状态一律以所链主记录、任务卡与 PR 为准， 本入口不复制；收录不构成批准。

• 分层分支交付与规范精简：两级分支、任务卡合入前闭合、分级门禁、任务分类通道与规范精简。
• 文档职责矩阵整改：项目设置的文档职责三视图分配。
• svc 插件组合部署（--with）：部署时把登记插件与 Dev 基座编成一个二进制并校验激活。
• 用户、职位角色与分层权限统一： I1 权限合同、 I1 实施候选与评审记录。
• 系统项目、成员工作入口与私域协作闭环：全局项目身份与名称、成员个人会话、每项目两树一网与私域权限。
• 快慢通道展示与动态工作摘要：对话即时答复、后台动态发现与来源、四层阅读、真实状态、并发/恢复； U1 实施计划。
• 渐进工作台界面重设计： 计划 覆盖任务摘要、对话/输入、窄屏和真实状态投影。
• 服务重启与全量数据恢复：svc 启停、异常退出后的依赖、配置/数据身份、任务/HITL/副作用、文件与组合备份恢复。
• svc 统一部署与一次性登录 Key： 二进制/源码统一部署、环境准备、无初始密码开户与账户恢复；规格见 docs/svc-deploy/， 账户与恢复续审见 续审记录。
• Generative UI 调研与插件：对话内生成界面与可信编译插件交付。
• 多人协作存储与分布式演进：多项目、多会话并行；PostgreSQL 团队档、迁移恢复与多实例执行。
• RDM 两树一网集成、完善与追溯审计展示：每项目笔记树、文档树与追溯网，项目绑定与读取授权、原子事件历史、统一审计读服务与四入口工作区。
• DHF 模板接入 RDM 文档生成管线：DHF 模板资产合同与文档生成转换。
• RDM 模板与两树一网对话文档生成：历史资产盘点、模板版本与章节实例化、持久提案、文档级审签及 DOCX。
• RDM 最终目标核对与完整交付：系统级项目、权限覆盖、私域协作、全部文档三权与完整业务链的需求映射。