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 开启,冲突会话会被拒绝,而不只是被警告。