业务架构
回答“做什么、为什么做”
- 处理对象
- 业务域、价值流、领域边界、跨域关系与核心业务不变量。
- 不处理
- 不复述鉴权、路由、部署等技术契约;技术机制归系统架构。
- 真相来源
.claude/arch/business/,以代码为锚:改了本域代码,当轮就要回看设计、升版并封版。- 交付给
- 把“真实业务问题与边界”交给系统能力承接。
五类架构是自上而下的五层:从业务真相,到系统契约、项目流水线、Agent 团队,再到框架控制面。HARNESS 让每个架构决定都有归属、有边界、有证据,也有演进路径。
五类架构是自上而下的五层,各答一个问题、维护各自的真相。从上往下读是落地:上一层要的,下一层接住;从下往上读是管控:框架管住 Agent 团队,团队办项目,项目改规范与业务,规范约束业务的写法。规范管写法,它的检测横着管各层,所以五层不是严格的上下级。
回答“做什么、为什么做”
.claude/arch/business/,以代码为锚:改了本域代码,当轮就要回看设计、升版并封版。回答“按什么规范写”
.claude/arch/system/,每个规范域以独立架构制品承载设计。回答“怎么一步步做成”
.claude/arch/project/,这条流水线的设计页与每条需求的履历都住在这里。回答“谁来做”
.claude/arch/agent/,执行体文件是这一类架构的内容,设计页描述它们,名册与文件由闸两边互核,机器守不到的逐条写明。回答“凭什么保证做对”
.claude/harness-engineering.md,定义 L0–L5 控制系统。从最高原则到底层代码,每一层都有明确职责。上层给下层边界,下层用真实证据反哺上层,形成可运行、可验证、可演进的控制闭环。
工作流是向导,L4 是传感器;
绕过流程,不等于绕过检测与测试。
定义最高原则、治理拓扑与边界禁区,只做定性和导航,不把下层机制塞回最高法。
CLAUDE.md治理规范、规则、架构制品与工作流自身的生命周期,让治理机制也被治理。
/x-meta-dev把开发、治理、发布与体检编排成可重复路径,明确谁在何时读取什么、产出什么。
/x-feature-dev把设计决定写成条款,把条款落实为判据,再由检测引擎判定“写得合不合规”;“行为对不对”归另一个裁判 —— 测试。
spec + rule + check在写前防手滑、写后记录事实、收尾时把检测与测试一起叫来、发布前当场真跑测试,让错误尽量在离开发动作最近的位置暴露。
guard.js承载 x-core 母本与各端真实运行材料。所有上层判断最终都必须在这里被兑现,而不是停在文档里。
x-core + 各端不让所有事都套一条大流程:按这件事落在哪里,分成五条流程。分析流程是所有流程的入口,Harness、规范、业务三条是主流程,运维流程是辅助;每条再按大小分三档,手续的轻重跟着档走。
入口
三档:快问、分析与体检、需求整理
主流程
三档:小事、成条的事、难事
三档:小事、成条的事、难事
三档:小事、成条的事、难事
辅助
三档:例行、常规、紧急
走哪条由落点定、不由人选;每条按大小分三档
不论业务如何变化,HARNESS 始终坚持四条底线。它们决定一份架构能否被理解、被执行、被证明,并在变化后仍值得信任。
每类关键事实只有一个权威来源,派生内容可以生成,但不能另起一份会漂移的账。
每项能力都有明确归属、责任边界与不处理事项,问题出现时能定位,决策落下时能追责。
所有关键判断都有可运行判据、测试床或人工守护说明,验证过程能回放,结论能复核。
每次架构变化都有理由、有影响面、有版本与历史,允许推翻旧结论,但不允许悄悄漂移。