让架构成为一套
可运行的控制系统

五类架构是自上而下的五层:从业务真相,到系统契约、项目流水线、Agent 团队,再到框架控制面。HARNESS 让每个架构决定都有归属、有边界、有证据,也有演进路径。

HARNESS 五类架构关系图 业务架构、系统架构、项目架构、Agent 架构与Harness架构是自上而下的五层,各答一个问题:业务架构答做什么、为什么做;系统架构答按什么规范写;项目架构答怎么一步步做成;Agent 架构答谁来做;Harness架构答凭什么保证做对。五层叠成一座金字塔:塔尖是业务架构,底座最宽是Harness架构。从上往下读是落地,上一层要的,下一层接住;从下往上读是支撑与管控,框架管住 Agent 团队,团队办项目,项目改规范与业务,规范约束业务的写法。
  1. 01业务架构做什么、为什么做
  2. 02系统架构按什么规范写
  3. 03项目架构怎么一步步做成
  4. 04Agent 架构谁来做
  5. 05Harness架构凭什么保证做对
五类架构不是五个目录,而是自上而下的五层,每层旁边那一句是它答的问题:从上往下读是落地,从下往上读是支撑与管控。
01

五类架构,五种不同的真相

五类架构是自上而下的五层,各答一个问题、维护各自的真相。从上往下读是落地:上一层要的,下一层接住;从下往上读是管控:框架管住 Agent 团队,团队办项目,项目改规范与业务,规范约束业务的写法。规范管写法,它的检测横着管各层,所以五层不是严格的上下级。

01

业务架构

回答“做什么、为什么做”

处理对象
业务域、价值流、领域边界、跨域关系与核心业务不变量。
不处理
不复述鉴权、路由、部署等技术契约;技术机制归系统架构。
真相来源
.claude/arch/business/,以代码为锚:改了本域代码,当轮就要回看设计、升版并封版。
交付给
把“真实业务问题与边界”交给系统能力承接。
02

系统架构

回答“按什么规范写”

处理对象
系统责任、组件关系、技术契约、质量属性、验证边界与诚实边界。
不处理
不复制业务领域真相,也不把框架控制机制重新发明一遍。
真相来源
.claude/arch/system/,每个规范域以独立架构制品承载设计。
交付给
把“设计决定”翻译成工程可执行、机器可判断的契约。
03

项目架构

回答“怎么一步步做成”

处理对象
一条需求只有这几个状态:未立项、已立项、在办实施、已封版、复盘过、待验收、已完结、已发布、已归档、环收尾;状态之间有关口守着,守卫与引擎在拦,证据记在账本、履历与锁清单里。
串起各层
它不是归档栏:签字门核落点单元,封版把「这一版为了哪条签过字的需求」写进锁清单,发布门核基线之后封的每一版都绑着需求 —— 各层由此串成一条线。
真相来源
.claude/arch/project/,这条流水线的设计页与每条需求的履历都住在这里。
入口
进入项目架构:流水线、沿线的关口与历史项目
04

Agent 架构

回答“谁来做”

处理对象
干活的分三层、不嵌套:顶端是 X大脑(首席产品官),只有它和 BOSS 说话;它统管各专项的产品经理,常驻的项目经理、运维经理、产品架构师、Harness架构师各管一摊,会话再按队形派执行体,执行体各有自己的写域、必读、经谁核与禁区。
挂在各层
它不另起一套规矩:每位执行体的归属、必读、写域、经谁核,分别挂在另外四类(业务、系统、项目、框架)的具体文件上。
真相来源
.claude/arch/agent/,执行体文件是这一类架构的内容,设计页描述它们,名册与文件由闸两边互核,机器守不到的逐条写明。
入口
进入 Agent 架构:X大脑、会话、执行体与队形
05

Harness架构

回答“凭什么保证做对”

处理对象
最高原则、元治理、工作流、规范能力、强制机制与真实代码材料。
不处理
不代替具体业务设计,也不成为各系统规范的第二本账。
真相来源
.claude/harness-engineering.md,定义 L0–L5 控制系统。
交付给
让架构跨会话、跨角色、跨端仍然保持一致并持续演进。
从上往下读是落地 从下往上读是管控 规范的检测横着管各层 五层不是严格的上下级
02

Harness架构的
六层控制系统

从最高原则到底层代码,每一层都有明确职责。上层给下层边界,下层用真实证据反哺上层,形成可运行、可验证、可演进的控制闭环。

自上而下 原则 → 路径 → 判据 → 强制 → 代码
自下而上 事实 → 证据 → 复盘 → 演进
工作流是向导,L4 是传感器;
绕过流程,不等于绕过检测与测试。
  1. L0

    宪法层

    定义最高原则、治理拓扑与边界禁区,只做定性和导航,不把下层机制塞回最高法。

    它处理
    不可被下层改写的原则
    主要载体
    CLAUDE.md
  2. L1

    元治理层

    治理规范、规则、架构制品与工作流自身的生命周期,让治理机制也被治理。

    它处理
    一致性、版本锁步与安全演进
    核心入口
    /x-meta-dev
  3. L2

    工作流层

    把开发、治理、发布与体检编排成可重复路径,明确谁在何时读取什么、产出什么。

    它处理
    PLAN → IMPLEMENT → VERIFY → ARCH-SYNC → DEPLOY
    核心入口
    /x-feature-dev
  4. L3

    规范能力层

    把设计决定写成条款,把条款落实为判据,再由检测引擎判定“写得合不合规”;“行为对不对”归另一个裁判 —— 测试。

    它处理
    规则语义、机器判定与验证射程
    核心载体
    spec + rule + check
  5. L4

    强制层

    在写前防手滑、写后记录事实、收尾时把检测与测试一起叫来、发布前当场真跑测试,让错误尽量在离开发动作最近的位置暴露。

    它处理
    PreToolUse / PostToolUse / Stop
    核心载体
    guard.js
  6. L5

    代码层

    承载 x-core 母本与各端真实运行材料。所有上层判断最终都必须在这里被兑现,而不是停在文档里。

    它处理
    真实结构、运行行为与发布材料
    主要载体
    x-core + 各端
03

一件事进来,走哪条流程

不让所有事都套一条大流程:按这件事落在哪里,分成五条流程。分析流程是所有流程的入口,Harness、规范、业务三条是主流程,运维流程是辅助;每条再按大小分三档,手续的轻重跟着档走。

入口

  1. 01

    分析流程

    只分析、不改任何东西

    三档:快问、分析与体检、需求整理

主流程

  1. 02

    Harness 流程

    宪法、框架的机制、项目架构、Agent 架构、五层怎么写怎么管

    三档:小事、成条的事、难事

  2. 03

    规范流程

    一份系统规范

    三档:小事、成条的事、难事

  3. 04

    业务流程

    业务需求

    三档:小事、成条的事、难事

辅助

  1. 05

    运维流程

    不改仓、只动线上的部署与版本

    三档:例行、常规、紧急

走哪条由落点定、不由人选;每条按大小分三档

04

专业架构的四条底线

不论业务如何变化,HARNESS 始终坚持四条底线。它们决定一份架构能否被理解、被执行、被证明,并在变化后仍值得信任。

  1. 01单一真相源

    每类关键事实只有一个权威来源,派生内容可以生成,但不能另起一份会漂移的账。

  2. 02边界可定位

    每项能力都有明确归属、责任边界与不处理事项,问题出现时能定位,决策落下时能追责。

  3. 03证据可复现

    所有关键判断都有可运行判据、测试床或人工守护说明,验证过程能回放,结论能复核。

  4. 04变更可追溯

    每次架构变化都有理由、有影响面、有版本与历史,允许推翻旧结论,但不允许悄悄漂移。

架构不是一次性交付,
而是一套持续运行的控制系统。

进入系统架构 查看框架与模板 看项目架构:每条需求走到哪一步 看 Agent 架构:谁来干、怎么组队