Architecture

Architecture

总体结构

┌─────────────────────────── DSH / Cordis Runtime ───────────────────────────┐
│  Host Plane：tools/skills/subagents/workflow/storageDomain/approval/…      │
│  Agent Plane：software-factory preset（persona + tools + skills + prompt） │
└───────────────────────────────────┬────────────────────────────────────────┘
                                    │  Factory Manager（一个 Agent）
        ┌───────────────────────────┼───────────────────────────────────────────┐
        ↓                           ↓                                           ↓
  Requirement & Planning      Dispatch（子代理 = 角色 Agent）              Monitor & Recover
  （artifacts + 状态机）        （PM/架构/前端/后端/QA/安全/DevOps）         （events + gates + retry）
        └───────────────────────────┼───────────────────────────────────────────┘
                                    ↓
                         Software Production（每个项目）
                                    ↓
                        Delivery：可运行项目 + 全套产物

两个平面（Cordis 规则）

平面	拥有	工厂对应物
Host（Harness 自带，不改）	注册表、沙箱/审批栈、持久化、模型路由、子代理后端	storageDomain、workspaceRegistry、approval、jobs、subagents
Agent（工厂新建）	每个预设的 persona、工具、prompt、技能	software-factory 预设 + 角色技能

铁律：不修改 Harness Core 与官方 shipped preset；所有能力走用户预设 + 文件/脚本。

项目模型

• 每个项目 = 独立目录：projects/<id>/（project.json 状态机 + artifacts/ + tasks/ + contracts/ + workspace/ + reports/ + memory/）
• Artifact-first：阶段产物（requirements.md → … → release-notes.md）是交接媒介
• 状态机：16 个阶段状态 × 8 个运行状态，全部迁移记录事件（见 Project State Machine）

关键设计决策（ADR 摘要）

#	决策	理由
A1	角色 = continuable 子代理，不静态起 Agent	动态创建 + 持久会话 + 可打断/续跑
A2	项目状态权威在文件，storageDomain 为镜像	workflow 无恢复 + 单进程限制
A3	长流程 = 多次 run + 状态文件恢复	进程重启不丢进度
A4	子代理不自证成功，Manager 独立验证	Evidence over claims
A5	危险/审批操作只在 Manager 层	子代理 approval policy = never
A6	正式能力落 preset，实验用动态插件	动态插件不跨重启