Archon Framework Changelog

记录 Archon framework（可移植治理套件 —— 由 scripts/export-archon-core.mjs 生成的全部文件与机制集合）的所有重要变更。

格式遵循 Keep a Changelog， 版本规则遵循 Semantic Versioning。

什么算作 Archon 的变更？ 由导出流水线交付的文件（soul、domain lenses、 命令、agents、rules、skills、templates、portable helpers、docs/archon/ 下 的文档）的任何修改。宿主项目应用代码的改动不属于本文件记录范围。

Versioning Scheme

Archon 使用单一的 MAJOR.MINOR.PATCH 版本号，记录在 .archon/VERSION 中， 并写入每一个独立导出包：

• MAJOR —— governance contract、文件布局或 wake 协议的破坏性变更， 适配方需要手动迁移。
• MINOR —— 以向后兼容方式新增的机制、ADR、skills 或 domain lenses。
• PATCH —— 文档修复、模板说明澄清、portable helpers 的 bug 修复， 或视觉素材更新。

Unreleased

Added

• （计划中） archon init / archon doctor / archon export CLI (ROI-2)， 支持一键接入，无需克隆 framework 源仓库。

Audited

• 模板纯净度：docs/archon/templates/{manifest,decisions,debt,drift,memos}.template.md 已确认不含宿主项目专属内容。所有概念示例要么是 HTML 注释形式的占位符， 要么是有意为之的通用教学词汇 （如 user-journeys 中的 Booking、Launch Prep、Capability Package）。

Changed

Fixed

0.1.0 — 2026-05-04

Archon framework 的首个打标发布版本。机制集合体现了大约三个月在宿主项目中 的迭代成果（ADR-01 至 ADR-26）。

Added

• Soul model —— 认知内核，包含 identity axioms、ownership contract、 cognitive loop、autonomy principles、evolution axis、guardrail system （soul.md + 路由级 soul/delivery.md · soul/review.md）。
• 三层目录布局 —— .archon/（core + project state）+ 平台目录 （.cursor/ / .claude/）+ docs/archon/（参考文档）。
• 认知状态文件 —— manifest / drift / debt / memos / decisions 六件套， 从不可变记录中再生 hot-summary（ADR-22 records-folder）。
• Delivery 生命周期 —— Decision Gate（Verdict）· Validation Gate · Close-Out，机械化产物由 Claim Verifier 校验（ADR-27）。
• Blink Dispatch —— close-out 子 agent 派遣的 thin-slice 分诊门 （ADR-17）。
• Constraint pyramid —— L0–L5 强制等级，配合 Lint-Rule Bridge 将 skills 晋升为 linter rules（ADR-20）。
• Preservation Axis —— 承重 rule 登记表，带 anchor + body-shape test
  • portable contract（ADR-28）。
• Source Modularity Probe —— Decision Gate 处的机械化架构债探针 （ADR-29）。
• Run-State v2 —— 单次 delivery 的临时状态，存放于 .archon/runs/<run_id>/ 并附带 JSON schema（ADR-14 扩展）。
• Domain Lenses —— 预 Verdict 的 lens 索引，首批交付五个 lens：dev、 design、platform、ecosystem、capability。
• Portable helpers —— archon-check.py（governance contract）、 archon-check.sh（bash 移植版）、archon-run-state.mjs、 archon-records.mjs、archon-claim-verifier.mjs。
• 双平台导出 —— scripts/export-archon-core.mjs 生成 Cursor 与 Claude Code 就绪套件。
• 完整文档集 —— docs/archon/ 下 18 个 markdown 文件，覆盖架构、 接入、decisions（10 篇公开 ADR）、user journeys（16 篇）、concepts， 以及 adoption quickstart。
• 漫画插图 —— 跨 README、architecture、setup、user-journeys、decisions、 adoption quickstart 共 26 张生成的漫画解说图。

Governance

• Apache-2.0 License。
• NOTICE 文件描述第三方致谢。
• Portable governance contract（.archon/contracts/governance-contract.yaml） 由 Node 与 Python 两套运行时校验。

---