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