Skip to content

全旅途与时序链路

Archon 的运行时地图:一次会话可能走的每一条路径,按序排列,标注每一步由哪个文件定义、以及该步是机械闸门(run-state 行 / 契约条款 / 测试)还是纯散文。这是回答「业务可控、没偏差吗?」的参考——配合 架构参考(结构)与 五大支柱(为什么)一起读。

用户旅程(把 16 个陷阱映射到捕捉它们的机制)不同,本页映射的是控制流本身。

每条旅途都配了图;用于业务追踪与维护的横切视图——安装、更新/同步、drift 状态机、记录数据流、演进双动作——汇总在下方 §7 业务追踪与维护图表包。

下文所有路径都是同一个认知循环——Perceive → Model → Act → Verify(可回溯)——戴着三顶不同的帽子。帽子是唤醒模式;循环不变。

唤醒模式命令目的加载的 soul 扩展
Plan/archon-plan做什么 /多大 /多大风险soul/review.md
Demand/archon-demand端到端执行一次有边界的交付soul/delivery.md
Review/archon-reviewdrift 压力越阈时的独立全量复查soul/review.md

0. 唤醒与路由

来源:archon-wake.mdc · archon.md

#步骤定义于闸门
0.1加载框架 primer(仅本会话首次唤醒)archon-framework/SKILL.md机械(一次)
0.2热路径读 soul(仅身份/路由节)soul.md §Core Axioms · §Ownership · §Cognitive Loop · §Autonomy机械
0.3热路径读 manifest(当前状态、词表、ULI、validation 命令)manifest.md(分节作用域)机械
0.4Drift 预检(硬闸门)archon.md §Step 0硬闸门
0.5路由到 plan / demand / review(显式前缀或推断)archon.md §Routing机械

Drift 预检是主安全联锁(阈值取自 governance-contract.yaml drift_gate):

  • drift ≥ 20(emergency)→ 停止一切 demand 接入,强制 review。
  • drift ≥ 12(full)→ 阻断 demand,仅允许 review。
  • drift ≥ 6(light)→ 建议:在下一个 medium/large demand 前插入一次 light review。

为什么是硬闸门而非散文:历史上 drift 曾达到 full 阈值的 108% 而 demand 仍在执行。ADR-9 把预检从 L3 散文提升为 L1 测试。见 漂移机制

1. Plan 旅途

来源:archon-plan.md(加载 soul/review.md)。

  1. 状态感知——读 manifest、debt.mddrift.md(扩展点:plan.perception)
  2. 节奏推断——从状态信号推导 build / harden / repair 偏向,而非 mode flag(soul §Evolution Tempo):里程碑早期 → build;闸门失败 → harden;债务临期 → repair;最近 5 条 drift 有 ≥3 条同类 → 停滞。
  3. 领域透镜 + 工具选择——在 load budget 内选 ≤5(建议 3)个推理工具(domain-lenses/registry.yaml)。
  4. 优先级排序 → 输出。 (扩展点:plan.output)

Plan 只谈判,不写产品代码——那是 demand 旅途的活。

2. Demand 旅途(核心生命周期)

来源:archon-demand.md(加载 soul/delivery.md)。run-state 行取自 run.template.md

Run-State 懒激活archon-demand.md §Run-State Lazy Activation):Pre-Scan 与 Decision Gate 在内存里跑,让被拒或极小的 demand 快速回答;Run-State 仅在 Verdict 之后、且交付将执行 / 需拒绝证据 / 将提交时才写盘。

有序步骤 + 其 run-state 检查点

阶段步骤run-state key闸门
Bootsoul / mode-ext / manifest 已加载boot.soul_loaded · boot.mode_extension_loaded · boot.manifest_loaded机械
Pre-Scanmemos 扫描prescan.memos_scannedsoul 强制
Pre-Scanarchive 召回(关键词匹配)prescan.archive_scanned可 smart-skip
Pre-Scanmanifest 切片扫描(ADR-32,存在 slices/ 时)折入 manifest 加载条件
Pre-Scan用户语言别名扫描 · signs sweep机械 sweep
Pre-ScanADR 索引扫描 · 扩展 demand.pre-scan hookprescan.adrs_scanned · prescan.extensions_hooked机械
Decisionfast-path 评估decision.fastpath_assessed机械
Decisionconvergence 分类(manifest 声明 scope 时)decision.convergence_classified闸门(ADR-12)
Decisionradius_probe: · soul_headroom: · modularity_probe:(slice-aware)机械探针
Decisionplan-mode 绑定 · Verdict(+ Borrowed concepts (if any): · Override (if any):decision.plan_mode_declared · decision.verdict_output硬闸门(ADR-11)
Execute自主执行内部(boundary-hard, process-soft)execute.changes_applied有改动则 soul 强制
Validatelint + typecheck + test 绿validate.validation_green硬闸门(代码改动时绝不可用户跳过)
Close-Outmanifest + 切片同步closeout.manifest_syncedsoul 强制
Close-OutBlink Dispatch → 子 agentcloseout.subagent_dispatched闸门(高风险禁跳)
Close-Outcapture-auditor 运行/处理closeout.auditor_ran · closeout.auditor_processed可 smart-skip
Close-Outdrift 更新closeout.drift_updatedsoul 强制
Close-Out里程碑闸门 · memos 追加 · 扩展closeout.milestone_gate · closeout.memos_appended · closeout.extensions_hooked可 smart-skip
Close-Outpreservation pass · acceptance-delta · numeric 交叉核 · governance-docs mirror · architecture forecast · Final Imperative(折入)机械自检
Close-Outstatement 输出closeout.statement_outputsoul 强制
Gitpermit_commit: 1resolve-for-commitpermit_commitcommit 闸门

Verdict 是枢轴:它在任何 write-side 工具调用之前产出(ADR-11,契约 pin)。Validation GateClose-Out 是其后的两个硬检查点——在 validate.validation_green1permit_commit 置位前,没有任何东西能到达 commit;这由 archon-run-state.mjs resolve-for-commit 校验。

3. Review 旅途

来源:archon-review.md(加载 soul/review.md)。三级(阈值在 drift_gate):

级别触发运行内容重置
Lightdrift ≥ 6仅机械健康审计(≤full 成本的 10%)释放 2–4 分
Fulldrift ≥ 12独立 reviewer 子 agent + 四阶段审计重置到 0–3
Emergencydrift ≥ 20停止 demand 接入 + 盲点根因 + 强制整改重置

护栏:「Light cannot satisfy a Full-threshold crossing」(同时 pin 在 soul/review.mdarchon-review.md)——light pass 不能用来清除一个本该 full review 的 drift 等级。

drift 计数器就是驱动评审节奏的状态机(阈值按项目阶段动态变化——见 漂移机制):

4. run-state 账本(脊柱)

run.template.md + run-state.schema.json 是一次交付的机器可读轨迹。22 个状态 key,各为 0(待办)/ 1(完成)/ skip:<reason> / 2(用户意图 smart-skip,ADR-15)。仅六行可 smart-skip(prescan.archive_scanned、两个 auditor 行、memos_appendedmilestone_gateextensions_hooked);其余 soul 强制。permit_commit: 1 是最终闸门,被 pre-commit hook 与 archon-git-commit 技能检查。

追踪者盯的阶段推进——每次转移翻动 run-state 行;闸门未过则 commit 不可达:

这正是生命周期可审计的原因:一次交付无法悄悄跳过承重步骤——被跳过的行可见,且 resolve-for-commit 会阻断提交。

5. 子 agent 调度(独立性层)

来源:blink-dispatch/SKILL.md + archon-reviewer / archon-capture-auditor

Close-Out 时 Blink Dispatch 对完成的 diff 做薄切片,输出 subagent_dispatch: skip:<reason> | use:<subagent>:<reason>。高风险路径(scripts、contracts、soul、commands、agents——blink_dispatch.high_risk_path_patterns禁止跳过。两个子 agent 都应跑在与主 agent 不同的模型家族上(soul §Sub-Agent Independence)以对抗沉没成本偏见:

  • reviewer——周期级,在 full-review 阈值触发。
  • capture-auditor——每交付级,当 Blink 检测到实现 / 治理 / 边界 / 修复 / 状态闭合 / 不确定性风险时触发。

6. v0.2.0 机制落在哪

ADR-31 / ADR-32 的记忆升级接入既有槽位——无新 run-state key、无新 Verdict token:

  • 接管期自扫描(ADR-31)是安装期步骤(install.md §7b),在任何唤醒之前——它自举出 manifest,供唤醒步骤读取。
  • manifest 切片扫描(ADR-32)是pre-scan步骤(见上表):命中的切片按需加载,折入同样的 manifest_loaded / manifest_synced 检查点。缺 .archon/manifest/slices/ = 单作用域,所以不用此特性的项目链路不变。

7. 业务追踪与维护图表包

维护者或审计者需要的横切视图——它们跨会话,而非活在单次唤醒里。

7.1 安装 / 接管(一次性)

来源:install.md · skill.md。v0.2.0 的新增(模板播种 + 自扫描)是 Step 7 与 7b。

7.2 Update vs Sync——以及什么不动

维护不变量:框架文件可替换,runtime 账本归 adopter 所有、绝不覆盖manifest.runtime_ledger_paths)。

7.3 状态文件数据流(记录 → 热摘要 → 归档)

按 ADR-22——每个 drift / memos / debt 数字背后的事件溯源链,也是业务追踪的审计链。

7.4 知识演进——Close-Out 的双动作

来源:soul.md §Evolution。每次交付都回答两个问题;preservation 答案被机械校验(archon-claim-verifier --mode=preservation)。

7.5 manifest 切片加载(ADR-32,仅大型 / monorepo)

8. 为什么它保持可控

上面每个承重步骤都被锚定在最低可强制层(约束金字塔):硬闸门(drift 预检、Verdict 先于写、validation 绿、permit_commit)失败即阻断;run-state 账本让每次跳过可见;契约的 critical_rule_substrings 钉住锚点,使后续编辑无法静默抽干它们。偏差不是靠信任来防止的——是靠那道阻断提交的闸门防止的。

依据 Apache-2.0 许可证发布。