设计
WHY为什么这样定,哪里守不到。
架构页 · 框架自身写在架构详图HARNESS ARCHITECTURE · ARCHITECTURE OPERATING SYSTEM
Harness架构不是业务架构,也不是某个系统的设计。它是承载业务意图、约束系统实现、生产架构制品并执行治理规则的架构操作系统。
| HARNESS 版本 | — 大版本 — |
|---|---|
| 最近一次 | — |
| 版本住在 | .claude/harness-engineering.md 文首一行 |
| 全部版本 | 在「版本」页签看 → |
代码、制品、环境与真实运行行为
写前拦截 · 收尾逼修 · 部署门 · 按内容记账
两个裁判
定义方向 · 组织生产 · 验证执行 · 反馈演进
明确为什么做、做什么、建立原则、约束与边界。
把方向转化为可落地、可复用的系统与架构制品。
通过自动化与门禁确保设计承诺进入真实工程。
基于事实持续改进,让架构在真实世界中成长。
每个规范域由设计、条款、判据、执法四件组成;判断对错的只有两个裁判 —— 检测读代码,测试跑代码。执法不是第三个裁判,它在四个关口把两个裁判一起叫来。本页后面各节,都是这个模型的展开。
为什么这样定,哪里守不到。
架构页 · 框架自身写在架构详图必须什么、禁止什么、为什么;每一条都点名守护它的闸。
规则书(条款书)怎么判:唯一标准写法加禁止项,检测器就写在判据里。
规范 · 内嵌检测器在哪一刻把裁判叫来,裁判说不过时怎么办。
守卫 · 工作流 · 定版脚本 · 发布出口条款与判据双向对齐派生部分按内容指纹锁步,判据一变,条款与设计必须跟上框架三件套同构:治理别人,也治理自己
判「写得合不合规」。
判「行为对不对」。
一条命令同时叫两个裁判,没过就回去改。
L2 · 工作流核对每轮一次,检测与测试两栏分开报;说不清就拦。
L4 · 收尾逼修三层同一个封版命令:检测与测试都过才钉;本单元的代码没有测试覆盖,如实写 none。
L1 · L2经本体系的发布出口当场真跑,不认旧记录;传上去的必须就是测过的那一份。小程序包由开发者工具上传,不经这里。
L2 · L4 · L5写入那一刻另有写前拦截(L4):挡越权写入与改坏规矩本身的写法;云端发布的部署门也挂在它上面,读检测结论、叫测试当场跑。写前拦截被摘下(开闸)时,这些一并不在岗,六层体检会把这一项报红。
证明不了的两个裁判都过,只证明「对当前内容查过、跑过、咬得住」,证明不了判据写得全、测试测得全 —— 测试守不到的地方,必须写进设计。
还没到的地方后台、端上的业务模块、官网和数据表文档目前没有测试,那里只有检测一个裁判,发布时也只有检测把关;宪法、元规则、架构详图这类文字同样只有检测看着。
L0–L4 不是具体的技术实现,而是从原则到强制的架构控制层,共同作用于 L5,确保架构能够被生产、执行、验证与持续演进。
定义为什么做,划定边界与治理主体
定义如何落地,从意图走向可交付
通过强制确保验证,用事实驱动持续演进
方向决定生产,生产接受强制,事实驱动演进。
框架负责定义“如何治理”,各层只拥有自己的事实;其他呈现必须引用或生成,不能复制成第二份可编辑真相。
回答为什么存在、哪些边界不可突破。
宪法 · 价值主张 · 基本约束回答规矩怎么立、怎么改,事情按什么路径做完。
元规范 · 元规则 · 工作流 · 决策记录回答正确的结构、行为与质量标准是什么。
模板 · 条款 · 判据 · 能力清单回答实际执行了什么、结果是否满足承诺。
检查结果 · 运行事实 · 版本证据原创区由该层直接维护,是唯一可编辑入口。
派生区由工具从真相源生成,只读展示,不承载新事实。
锁步封版版本、指纹与验证结论一起推进,避免半更新状态。
框架负责操作架构制品,但不能依赖任何一个被治理系统才能成立。
框架通过自身的控制面与裁判能力操作各类被治理架构制品;其成立不依赖任何一个具体业务系统,因此保持可迁移、可复用、可持续。
模板只解决“如何描述”,执行链解决“如何兑现”。HARNESS 用生成、裁判、门禁和证据四类能力,把设计约束带入每一次工程变更。
将模板、参数和规范能力编排为结构一致的架构制品。
检测(x-spec-checker)读代码判写法,测试(x-harness-dev)跑代码判行为;开发与治理两个闭环共用。
开发中由工作流叫、收尾由守卫叫、定版由统一封版命令叫、发布由发布出口与部署门叫;写入那一刻另有守卫的写前拦截。
将版本、指纹、两个裁判的结论与处置记录归集为可追溯证据。
整个 HARNESS 有一个总版本,就是框架设计的版本,在顶部「版本」页签按大版本、小版本展开。业务架构、系统架构里每个域各有自己的版本与变更历史。每个版本号只写在一个地方,页面和别的文件都从那里读;两处对不上,就是错。三层用同一份版本契约:同一种写法、同一份判定代码、同一个封版命令。
.claude/harness-engineering.md.claude/harness/CHANGELOG.md,每版一节「v主.次.补 · 日期 · 一句标题」、新的在最上面,封版时写下设计、内容、测试三行指纹与改动清单;「版本」页签按大版本、小版本展开CHANGELOG.md,与整个 HARNESS 同一种写法:每版三行指纹与改动清单ARCH.md 的 version 一行CHANGELOG.md,与另外两层同一种写法:每版三行指纹与改动清单三者的关系各域的版本变,不带动整个 HARNESS 的版本;整个 HARNESS 只在框架本身变的时候升。否则每改一次业务,总版本就要升一次,真正改框架的那几版会被淹没。不是设计、但带版本号的东西(云函数内核、移动端母本包、微信基础库、后台组件库)各自只写一处,在「版本」页签里列着。
机器管不了的升第几位要看改动的性质,机器判不了;机器保证的是必须升、一次只升一步、两处一致、封过的一版与它下面的旧版一个字不能改。有人故意写脚本去改守卫保护的台账,拦不住,但会话记录与改动记录里都看得见。
模板不是另一类架构。它由框架拥有,被系统架构实例化,并由验证制品链持续校验。模板负责统一思考结构,而不替任何系统预写答案。
从关注点进入,经过模板、生成、实例化和机器验证,最终形成可复核的演进证据。
VIEWS → DECISIONS → EVIDENCE → EVOLUTION
模块覆盖从架构驱动力到验证演进的完整判断链;完整不等于全部展开。
先回答为什么存在,以及系统内外的责任分界。
把干系人关注点、外部关系和总体解法连接起来。
分别表达静态组成、动态协作、状态与真实运行环境。
记录跨构件机制,以及昂贵、难逆和有争议的取舍。
让承诺可验证,让风险、债务和下一步行动可追溯。
| Harness架构 | 系统架构 | 验证与证据链 | |
|---|---|---|---|
| 角色 | 方法与模板的拥有者 | 在领域中使用模板的设计者 | 验证与持续改进的执行者 |
| 负责 | 定义方法、维护 13 模块模板,提供生成能力与验证规则 | 基于模板完成领域化实例,形成系统的设计承诺 | 读取架构、条款、判据,在各关口叫检测与测试两个裁判并执法,生成证据与改进建议 |
| 产物 | 方法、模板、生成工具、验证规则 | 领域化的系统 ARCH.html | 验证结果、问题清单、证据与演进建议 |
| 不能做 | 不复制其他来源的真相 不直接手工编辑派生区域 | 不修改模板方法本身 不绕过生成与验证流程 | 不更改架构内容 不作为其他真相来源的编辑入口 |
模板在框架内定义方法,在系统中形成实例,在验证制品链中留下证据。