AI 编码代理治理 - work session 与 preflight gate

让每个 AI 编码代理先声明工作:对 C4 元素的 advisory lease、给出 allow/warn/deny 的 preflight gate,以及架构变动时开启的 Architecture Change Request。

harness

Harness

让每个 AI 编码代理先声明工作,再动代码

Archyl 不是又一个编码代理。它位于你已经在用的代理之上 -- Claude Code、Cursor、Copilot、Codex -- 并在第一行代码之前,用你已记录的架构对每个会话把关。

AI 编码代理治理 | work session 与 preflight gate | Archyl

用 work session 治理 AI 编码代理:对 C4 元素的 advisory lease、给出 allow/warn/deny 的 preflight gate,以及架构变动时开启的 Architecture Change Request。

AI 代理治理, 多代理架构, work session, AI 代理冲突, 架构护栏

并行代理在沉默中相撞

三个代理开出三个 pull request。每一个单独看都对,合在一起却让系统变成三种不同的样子。

没人知道代理在做什么

代理读仓库、写代码、开 pull request。在那之前,它的意图对团队不可见。

RefreshCw

辛苦得来的上下文随会话消失

让一个代理损失一个下午的陷阱,在会话结束后就没了,下一个代理照样踩进去。

start_work_session 将任务对应到你的 C4 模型,取得 advisory lease,并以 briefing 开场:相关 ADR、guardrails 和过往会话留下的陷阱。

Terminal

preflight gate 给出裁决

allow、带具名理由的 warn,或在 schema 迁移这类独占冲突下的 deny。写下任何代码之前,先有一个裁决。

编码期间护栏生效

在 Claude Code 上,Guard hook 会在违反规则的修改写入前将其拦下;其他代理通过 MCP 执行同样的检查。

会话把上下文交还

finish_work_session 记录结果,把决策和陷阱固定到涉及的元素上,并在架构发生变动时开启 Architecture Change Request。

GitPullRequestArrow

Advisory lease

每个会话声明它将要修改的 C4 元素,下一个代理能看到谁已经在里面。

Preflight gate

依据实时 lease 与你的一致性规则给出 allow、warn 或 deny;用 exclusive 可直接拦停会话。

跨会话存续的记忆

笔记、约定与陷阱附着在架构元素上,下一个会话会自动取回。

Activity

Fleet console

组织内所有会话实时可见:谁在做什么、持有哪些元素、处于哪个 gate。

Architecture Change Requests

重构服务的代理提交提案,而不是偷偷改模型。代理提出建议,人来合并。

任何支持 MCP 的代理

work session 工具就是标准 MCP,并提供 16 个工具的 coding 配置。

多个代理共用一个代码库

同一小时编辑同一 container 的两个代理,在会话开始时就知道,而不是等到评审。

不能并行的工作

schema 迁移以 exclusive 开启,冲突会话会被拒绝,而不只是被警告。