Notes on the shift from code-centric agentic engineering to intent-oriented execution. ｜ 从代码中心的 Agentic 工程到意图导向执行的认知笔记。
本仓库不是正式标准或成熟框架，而是一组按形成时间保留的工程判断。它记录了 AI 进入软件领域后两次不同层次的结构变化判断：第一代改变软件的生产、维护和操作方式，但代码与已声明能力仍是中心产物；第二代进一步讨论实现、能力和接口绑定时机的变化，并在独立派生场景中引入操作规格的延迟形成，使部分过程可以直到运行时才被发现或生成。既有软件也可能成为能力基底、组合组件或独立派生的可执行参照。两代之外，共同基础还讨论责任寿命，以及真实使用如何继续产生下一可用检查点或软件谱系。
这两代不是互斥路线，也不是从低到高的成熟度等级。第二代不会取消第一代，二者可以在同一个系统中长期共存。
仓库初稿形成于 2026 年 2-3 月，第一轮系统整理完成于 2026 年 6 月；Milestone II 的表述形成于 2026 年 7 月。具体形成背景见 MILESTONES.md。
两代共享两项前置判断：
| 共同基础 | 回答的问题 |
|---|---|
| Software Lifecycle Tiers | 软件、实现、权限、证据和责任分别值得保留多久，应当支付多高的工程成本？ |
| In-Use Evolution | 真实使用产生的反馈，需要经过多远才能形成下一可用检查点或新的软件谱系？ |
不要为短寿命实现支付长寿命成本，也不要让长期责任继承次抛写法。
短寿命不意味着一次性交付；反馈距离缩短也不意味着可以省略验证和责任边界。
第一代通过代码修改和再次发布响应反馈；第二代还可以修改意图模块、绑定策略或运行时系统，也可能把运行时产物或基于既有软件的新结构路由为单独治理的新软件身份。两者都把交付视为经过验证的可用检查点，而不是产品演进的天然终点。
| 里程碑 | AI 进入的位置 | 主要稳定对象 | 核心变化 |
|---|---|---|---|
| Milestone I: Agentic Software Engineering | 软件生产、维护与应用操作 | 代码库、应用、构建产物和部署版本 | AI 成为作者、维护者和操作者，软件仍主要在编写期形成 |
| Milestone II: Intent-Oriented Execution | 程序运行时与执行语义 | 确定性内核、意图契约、权限包络、验证器、证据与谱系策略 | 部分实现、能力和接口延迟到运行时发现或生成；独立派生时还可形成候选操作规格 |
两代的详细边界、关系和仓库映射见 MILESTONES.md。
foundations/ 跨代共同基础
milestone-1-agentic-engineering/ 代码中心的 Agentic 软件工程
milestone-2-intent-oriented-execution/ 意图中心的运行与执行模型
每个目录都有独立 README.md，说明范围、文档地图和继承边界。根目录只保留仓库总览、两代关系、术语和 License。
第一代路线讨论 AI 如何参与代码中心的软件生命周期：理解与修改代码、任务分解、测试和审查、Agent 可委托性、Prompt 资产、知识固化以及运行安全。
- Milestone I Index — 范围、继承基础和文档地图。
- Agent-operable Software — 软件如何提供可委托、可约束、可审计的能力面。
- Codebase Principles — 人与 AI 共同维护代码库时的组织原则。
- Development Workflow — 从需求到代码、集成和交付的研发流程草案。
- Testing and Evals — Agentic 应用的边界测试、轨迹审计和结果评估。
- Security Model — 数据与指令、外部权限、持久化污染和寿命错配风险。
第二代路线不再只讨论谁来编写代码，而是重新划分编写期、部署期、运行期和运行后的责任。需要长期维护的逻辑继续作为确定性程序存在；一次性、强上下文相关、可约束且可验证的实现和接口，可以只在编写期保留意图契约、权限包络与准入规则，由运行时发现、生成、验证、执行、缓存或丢弃。
- Milestone II Index — 第二代范围、文档地图和对第一代的继承矩阵。
- System Model — 多重绑定时机、Intent IR、不确定类型和混合执行语义。
- Capability Discovery, Recomposition, and Derivation — Agent 介导的绕行与修复、能力发现、软件重组、可执行参照和独立派生。
- Execution Lifecycle — 从契约批准和能力准入，到运行、认证、缓存、晋升与新软件形成的闭环。
- Testing and Certification — 分阶段能力/实现准入、动作授权、结果认证、晋升和新软件资格验证。
- Security Model — 契约、能力发现、接口适配、运行时生成、新软件和谱系风险。
第二代目前是一项研究假设，不是现行行业标准，也不假设所有软件最终都会采用这一形态。
- GLOSSARY.md — 统一共同基础和两代路线的术语。
- MILESTONES.md — 理解两代路线为何需要分开书写。
- Shared Foundations — 建立跨代的寿命、反馈与产品演进边界。
- 按当前问题进入 Milestone I 或 Milestone II。
- 人或 AI 都可以产生代码、契约与计划；作者身份属于来源信息，不自动构成正确性或授权。
- 目的提供优化方向，但执行必须同时受不可变量、验收条件、能力边界、预算和证据要求约束。
- AI 输出默认是候选，不是事实；动作建议默认是提案，不是授权。
- 短寿命实现可以少抽象，但不能省略权限、损害上界和必要审计。
- 运行时缓存不是长期源码；复用范围和责任增长必须触发重新分级与产物晋升。
- 被观察到的接口不是已授权能力；技术可达性、逆向或修改能力都不能扩大权限包络。
- 原软件行为是候选规格的证据，不是完整规格；派生软件需要自己的契约、owner、验证和生命周期。
- 每次交付都是经过验证、具有明确恢复或回退边界的可用检查点；使用反馈要形成产品变更或新软件提案，不能借速度绕过授权。