@wnlen/agent-execution-template 0.8.19 → 0.8.21

package/template/en/ai/template/bootstrap.md

@@ -44,7 +44,7 @@ runtime files, result files, or metrics files during bootstrap.
 
 Read high-signal project evidence in this order:
 
-1. Root docs: `README*`, `AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING*`, `CHANGELOG*`
+1. Root docs: `README*`, `CONTRIBUTING*`, `CHANGELOG*`
 2. Manifests: `package.json`, `pyproject.toml`, `Cargo.toml`, `go.mod`,
    `pom.xml`, `build.gradle*`, `Makefile`
 3. Project docs: `docs/**`, preferring overview, architecture, setup, testing,
@@ -62,6 +62,9 @@ bounded read:
   project purpose, module boundaries, commands, and constraints;
 - do not read the whole codebase unless the human explicitly authorizes it.
 
+Do not treat `AGENTS.md` or `CLAUDE.md` as project business evidence; they are
+AI entrypoint routing files only.
+
 Do not read dependency folders, build outputs, coverage outputs, lockfiles
 except to infer package manager, secret files, environment files, or archives
 unless the human explicitly references them.

package/template/en/ai/template/execution-policy.md

@@ -121,6 +121,11 @@ verification was not possible. A purely subjective Green is not valid.
 
 ## User-Visible Output
 
+- Use the installed template language by default. When `ai/template/LANG` is
+  `en`, user-visible plans, L1 checklists, checkpoints, task draft handoffs,
+  blocked explanations, and final results should default to English. Use another
+  language only when the human explicitly asks, or when preserving code,
+  commands, file paths, or protocol field names.
 - Show the L1 checklist by default; do not show full L2/L3/L4 by default.
 - Show risk conclusions and necessary reasons; do not output long internal reasoning.
 - Show evidence; do not show internal protocol fields, full YAML,

package/template/en/ai/template/prompt.md

@@ -5,23 +5,25 @@ Execute the workflow below.
 
 You are operating inside an Agent Execution Template workspace.
 
-First read:
+This file only routes the workflow. First read minimal state:
 
-1. `ai/template/protocol.md`
-2. `ai/template/rules/core.md`
-3. `ai/template/execution-policy.md`
+1. `ai/project/project.md` if present
+2. `ai/project/task.md` if present
+3. Shallow listings of `ai/project/inbox/`, `ai/project/inbox/ideas/`, and `ai/project/proposals/final-shape-updates/`
 
 Then choose the mode:
 
 - If the user asks to update the North Star, final shape, product constitution,
   module map, roadmap, or project direction, or if
   `ai/project/inbox/ideas/` contains non-`.gitkeep` ideas waiting for
-  evaluation, draft a `strategy_update` task or produce the proposal directly,
-  then stop for human confirmation.
+  evaluation, read `ai/template/protocol.md`, `ai/template/rules/core.md`, and
+  relevant direction refs, then draft a `strategy_update` task or produce the
+  proposal directly, then stop for human confirmation.
 - If the user explicitly confirms that a proposal under
   `ai/project/proposals/final-shape-updates/*.md` may be merged, draft or
-  execute an `apply_strategy_update` task. If the proposal is still
-  `proposed`, update it to `accepted` based on that explicit confirmation.
+  execute an `apply_strategy_update` task after reading
+  `ai/template/protocol.md` and `ai/template/rules/core.md`. If the proposal is
+  still `proposed`, update it to `accepted` based on that explicit confirmation.
 - If the user says "Start initializing this project and absorb the material in ai/project/inbox/",
   or asks to initialize while also absorbing material from
   `ai/project/inbox/`, inspect `ai/project/project.md` first. If it already
@@ -54,7 +56,8 @@ Then choose the mode:
   the human hunt through files for gaps.
 - Use Execution Mode only after `ai/project/project.md` and
   `ai/project/task.md` are ready enough to define identity, goal, scope,
-  permission, and acceptance.
+  permission, and acceptance. Only then read `ai/template/protocol.md`,
+  `ai/template/rules/core.md`, and `ai/template/execution-policy.md`.
 
 ## Task Draft Handoff
 

package/template/en/ai/template/protocol.md

@@ -5,12 +5,18 @@ execution context.
 
 ```text
 ai/template/ = reusable execution protocol
-ai/project/  = current project execution workspace
+ai/project/  = current repo execution context
 ```
 
-Template is protocol. Project is the field workspace.
+Template is protocol. Project is repo-local context.
 
-The project workspace stores both execution state and direction. The direction
+Here, "repo execution context" means the repo-local `ai/project/**` context,
+not an external workspace / session / sandbox runtime. An external
+runtime may enter the repository and read this protocol, but should not replace
+`task.md`, file modification rules, acceptance criteria, or concrete coding
+context.
+
+The repo-local context stores both execution state and direction. The direction
 layer answers "why is this worth doing and where should the project grow"; the
 execution layer answers "what is this task and how will it be accepted."
 

package/template/en/ai/template/rules/output.md

@@ -25,7 +25,10 @@ verification, assumptions, issues, next steps, and runtime update proposals.
 
 ## Result Markdown
 
-`ai/project/result.md` is the human-readable summary. Keep it short:
+`ai/project/result.md` is the human-readable summary. Keep it short and use the
+installed language from `ai/template/LANG` by default. In the English template,
+headings and prose should default to English; preserve code, commands, file
+paths, and protocol field names as written.
 
 ```md
 ## Status

package/template/zh/ai/README.md

@@ -7,6 +7,8 @@ template 是协议
 project 是现场工作区
 ```
 
+这里的 `project` 是仓库内 `ai/project/**` 的项目现场，不是外部 workspace、session 或 sandbox 运行时。
+
 ## 文件
 
 - `template/prompt.md`：AI 启动提示。

package/template/zh/ai/project/runtime.md

@@ -3,15 +3,15 @@
 ## 当前状态
 
 - 阶段：方向层与执行层一致性收口
-- 重点：保持文件协议可安装、可升级、可审计，并让项目方向治理与任务执行约束一致。
+- 重点：保持协议可安装、可升级、可审计，并让方向治理与执行约束一致。
 - 阻塞：无
 - 已知风险：
   - 超出当前任务范围
-  - 询问人类那些 Agent 可以安全推断的细节
+  - 询问可安全推断的细节
   - 用历史过程笔记污染运行时上下文
   - 没有验证证据就标记成功
   - 在明确权限之外运行命令
-  - 只优化 token 节省，而忽略成本可接受前提下的输出质量
+  - 只省 token，忽略可接受成本下的质量
   - 方向层已升级但规则、runtime 或 doctor 仍停留在旧语义
 
 ## 硬规则
@@ -36,8 +36,8 @@
 
 ## 项目约束
 
-- 引导读取集从 `ai/template/bootstrap.md`、`ai/template/protocol.md`、`ai/template/rules/core.md`、根目录文档、清单、文档、引用开始；当文档不足时，进行有限源码结构检查。
-- 执行读取集是 `ai/template/prompt.md`、`ai/template/protocol.md`、`ai/template/rules/core.md`、`ai/project/project.md`、`ai/project/runtime.md` 和 `ai/project/task.md`。
+- 引导读取集：`bootstrap.md`、`protocol.md`、`rules/core.md`、根文档、清单、项目文档、引用；文档不足时有限检查源码结构。
+- 执行读取集：`prompt.md`、`protocol.md`、`rules/core.md`、`project.md`、`runtime.md`、`task.md`。
 - `ai/project/refs/` 文件只在任务要求或任务类型触发时加载。
 - `ai/project/refs/final-shape.md`、`module-map.md`、`roadmap.md` 属于方向层正式文档。
 - 方向层正式文档不能被普通 reconcile 或普通执行任务直接修改。
@@ -53,9 +53,9 @@
 ## 当前上下文
 
 这个项目是协议 / 模板，不是复杂 Agent 框架。
-当前产品定位是：面向 AI Coding Agent 的项目方向治理 + 可审计任务执行协议。
-当前产品目标是减少人类交互频率和输入量，同时让任务随时间变得更精确，并减少长期方向漂移。
-允许增加少量服务于协议采用和治理闭环的 CLI；不要引入 UI、云同步或多 Agent 编排。
+定位：面向 AI Coding Agent 的项目方向治理 + 可审计任务执行协议。
+目标：减少人类交互和输入量，让任务随时间更精确，并降低长期方向漂移。
+允许增加少量服务协议采用和治理闭环的 CLI；不要引入 UI、云同步或多 Agent 编排。
 
 ## 引用路由
 
@@ -69,6 +69,6 @@
 
 ## 运行时更新治理
 
-除非 `ai/project/task.md` 明确允许，AI 不得直接更新这个文件。
-如果任务产生长期有效上下文，将建议写入 `ai/project/result.json.runtime_update`。
-通过单独任务应用运行时更新，该任务唯一允许目标是 `ai/project/runtime.md`。
+除非 `task.md` 明确允许，AI 不得直接更新本文件。
+任务产生长期上下文时，写入 `result.json.runtime_update` 建议。
+运行时更新应由单独任务应用，唯一目标是 `ai/project/runtime.md`。

package/template/zh/ai/project/task.md

@@ -79,14 +79,12 @@ permission:
 
 # 任务
 
-这个文件是当前执行契约。优先在引导模式中，根据简短人类目标和仓库上下文生成，
-然后由人类在执行前检查。
+当前执行契约。优先由引导模式根据人类目标和仓库上下文生成，执行前由人类检查。
 
-优先使用安全假设，少问额外问题。AI 应基于用户目标、项目上下文和仓库事实推断
-范围、风险、权限和验收；如果推断会越过权限、安全边界或验收无法定义，将
-`readiness` 标为 `blocked` 或将相关任务节点标为 `Red`，等待人类确认。
-如果本轮新建或重写了任务契约，默认保持 `draft_for_confirmation` 并停下来交接；
-只有已有任务明确处于 `ready_to_execute` 时，才进入执行。
+优先安全假设，少问问题。AI 基于目标、上下文和仓库事实推断范围、风险、权限和验收；
+若会越权、触碰安全边界或验收不可定义，将 `readiness` 设为 `blocked` 或把相关节点设为
+`Red`，等待确认。本轮新建或重写任务契约时，默认保持 `draft_for_confirmation` 并停下交接；
+只有既有任务为 `ready_to_execute` 时才执行。
 
 ## 目标
 
@@ -125,34 +123,32 @@ permission:
 
 ## 执行策略
 
-默认使用 `auto`，由 AI 在执行前规划时判定是否启用连续执行，而不是等待用户口令。
-如果执行前拆出的 L1 任务少于 2 个，使用 `normal`；如果 L1 任务为 2 个或更多，
-自动使用 `bounded_continuous`。
+默认 `auto`：AI 执行前规划并决定是否连续执行，不等用户口令。L1 < 2 用 `normal`；
+L1 >= 2 自动用 `bounded_continuous`。
 
 `bounded_continuous` 表示边界内连续执行：
 
-- 目标、范围、验收、权限和风险评级由 AI 基于用户目标、项目上下文和仓库事实推断；
-  不要求用户预先逐项提供。
+- 目标、范围、验收、权限和风险由 AI 基于目标、上下文和仓库事实推断；不要求用户逐项提供。
 - `readiness = ready_to_execute` 表示没有 Red 预检项，可以执行。
 - `readiness = draft_for_confirmation` 表示需要人类确认后才能执行。
 - `readiness = blocked` 表示当前任务不可执行，必须写 blocked 结果。
-- 本轮如果新建或重写 `ai/project/task.md`，必须停在确认交接；不能在任务仍是草稿时执行。
-- 执行前必须把 L1 任务清单写入 `execution_policy.task_tree`。
-- 执行前必须列出 L1 任务清单；每个 L1 用待办列表表示，完成后打勾并划掉。
+- 本轮新建或重写 `task.md` 时必须停在确认交接；草稿不能执行。
+- 执行前必须把 L1 清单写入 `execution_policy.task_tree`。
+- 执行前必须列出 L1 清单；每个 L1 用待办表示，完成后打勾并划掉。
 - L1 必须是可独立验收的垂直切片；不要把单个机械步骤拆成 L1，也不要把多个
   可独立验收的用户可见结果合并成一个 L1。
-- 执行某个 L1 前，AI 先规划自然衍生出的 L2；如果 L2 仍需拆分，再规划 L3。
-- 默认最多 3 层；只有当不拆 L4 会导致 L3 过大或不可验证时，才允许动态增加 L4。
-- 每个任务节点都由 AI 自己生成 Green / Yellow / Red 风险评级。
+- 执行 L1 前规划 L2；L2 仍过大时规划 L3。
+- 默认最多 3 层；不拆 L4 会导致 L3 过大或不可验证时，才允许 L4。
+- 每个节点都由 AI 生成 Green / Yellow / Red 风险评级。
 - 只有 Red 停下来让人类确认；Green 自动继续，Yellow 只允许当前 L1/L2 内的局部
   低风险修正，不能改变公共接口、数据模型、权限、安全、架构方向或验收标准。
-- `progress_unit` 默认是 `vertical_slice`：每轮推进都应该产生可检查的工作增量。
-- `checkpoint_budget` 是最多可用检查点预算，不是必须用完的次数；不要为了消耗预算而汇报。
+- `progress_unit` 默认为 `vertical_slice`：每轮都应产生可检查增量。
+- `checkpoint_budget` 是上限，不是必须用完；不要为消耗预算而汇报。
 - 只有在风险从 Green 变 Yellow/Red、即将扩大范围或权限、完成 L1 垂直切片、
   验证失败后准备继续、准备最终收尾时才输出 Checkpoint。
 - 每个 Checkpoint 必须包含证据：已改文件、已运行命令、验证结果或无法验证的原因。
-- `task_tree` 写回频率：执行前写入 L1 清单；开始或完成 L1 时更新该 L1 状态；
-  出现 Red、blocked、范围变化或最终收尾时立即写回；不要为每个微小 L3 操作写回。
+- `task_tree` 写回：执行前写 L1 清单；L1 开始/完成、Red、blocked、范围变化或收尾时写回；
+  不为微小 L3 操作写回。
 - 完成后只做一次总复盘；只对 Yellow、Red、失败验证或高影响模块做二次抽检。
 - 连续执行不改变模型策略；涉及判断、架构、失败复盘或验收争议时仍按 `model_policy` 升级。
 
@@ -163,9 +159,8 @@ permission:
 
 ## 模型策略
 
-默认使用 `model_policy.default_tier` 声明的模型档位。
-不要用 `strong` 做常规执行。只为 `model_policy` 声明的角色和触发条件使用 `strong`，
-并在 `ai/project/metrics.json` 中记录原因。
+默认使用 `model_policy.default_tier`。不要用 `strong` 做常规执行；只在
+`model_policy` 声明的角色和触发条件下使用，并在 `metrics.json` 记录原因。
 
 ## 停止条件
 

package/template/zh/ai/template/VERSION

@@ -1 +1 @@
-0.8.19
+0.8.21

package/template/zh/ai/template/bootstrap.md

@@ -1,15 +1,12 @@
 # AI 执行引导
 
 不要总结这个文件。
-执行下面的引导流程。
+按下面流程整理项目上下文。
 
-你正在为 Agent Execution Template 整理项目上下文。
+目标：建立后续任务依赖的稳定项目理解。这是发现与确认，不是实现。
 
-目标：建立后续任务会依赖的稳定项目理解。
-这是发现与确认步骤，不是实现步骤。
-
-你的任务是检查项目，创建或更新 `ai/project/project.md`
-以及相关的 `ai/project/refs/*`，然后在“引导后交接”处停止。
+检查项目，创建或更新 `ai/project/project.md` 和相关 `ai/project/refs/*`，
+然后在“引导后交接”处停止。
 
 ## 先读
 
@@ -31,37 +28,37 @@
 - 能推断约束时，更新 `ai/project/refs/constraints.md`
 - 只有存在持久决策证据时，更新 `ai/project/refs/decisions.md`
 
-只有在人类同时提供当前任务时，才创建 `ai/project/task.md`。
-如果创建了 `ai/project/task.md`，只起草任务契约，不进入执行。
+只有人类同时提供当前任务时，才创建 `ai/project/task.md`。只起草任务契约，不执行。
 
-引导期间不要编辑源码、测试、应用配置、依赖文件、生成文件、
-运行时文件、结果文件或指标文件。
+引导期间不要编辑源码、测试、配置、依赖、生成文件、运行时、结果或指标文件。
 
 ## 阅读顺序
 
 按下面顺序读取高价值项目证据：
 
-1. 根目录文档：`README*`、`AGENTS.md`、`CLAUDE.md`、`CONTRIBUTING*`、`CHANGELOG*`
+1. 根目录文档：`README*`、`CONTRIBUTING*`、`CHANGELOG*`
 2. 清单文件：`package.json`、`pyproject.toml`、`Cargo.toml`、`go.mod`、
    `pom.xml`、`build.gradle*`、`Makefile`
 3. 项目文档：`docs/**`，优先阅读概览、架构、安装、测试、部署、API、ADR 和决策文件
 4. 现有 AI 引用：`ai/project/refs/*.md`
 5. 源码、测试、配置和文档目录的浅层仓库结构
 
-如果文档和清单缺失或不足，可以有限读取代码进行推断：
+文档和清单不足时，可有限读取代码推断：
 
 - 先检查顶层目录和文件名；
 - 检查可能的入口目录，例如 `src/`、`app/`、`lib/`、`packages/`、
   `services/`、`cmd/`、`internal/`、`server/`、`client/`、`test/`、`tests/`；
-- 只读取足够识别项目目的、模块边界、命令和约束的路由、模块、配置和测试文件；
+- 只读取足够识别目的、模块边界、命令和约束的路由、模块、配置和测试文件；
 - 除非人类明确授权，不要读取整个代码库。
 
+不要把 `AGENTS.md` 或 `CLAUDE.md` 当作项目业务证据；它们只是 AI 入口路由文件。
+
 除非人类明确引用或授权，不要读取依赖目录、构建产物、覆盖率输出、锁文件
 （推断包管理器除外）、密钥文件、环境文件或归档目录。
 
 ## 确认维度
 
-读取后，总结并请人类确认或修正这些点：
+读取后，请人类确认或修正：
 
 - 项目名称、目的和主要用户；
 - 一句话定位、最终形态和任务是否值得做的判断标准；
@@ -74,19 +71,18 @@
 - 持久约束、安全边界、兼容性要求和高风险区域；
 - 会影响后续任务精度的未知项。
 
-一次最多问 3 个问题。只问答案会改变项目身份、命令、边界、约束、风险、
-权限或验收的问题。
+最多问 3 个问题。只问会改变身份、命令、边界、约束、风险、权限或验收的问题。
 
 ## 输出规则
 
 - 未知事实标记为 `Unknown`；不要把猜测当成事实。
-- 如果本次引导吸收了 `ai/project/inbox/*.md` 或 `ai/project/inbox/raw/*.md`，
-  写入上下文后必须把已吸收资料移动到 `ai/project/inbox/processed/`。保留相对路径：
-  `ai/project/inbox/raw/file.md` 移动到 `ai/project/inbox/processed/raw/file.md`。
-  如果文件名冲突，保留原文件名并添加日期或序号。不要移动 `ai/project/inbox/ideas/**`。
+- 若本次吸收 `ai/project/inbox/*.md` 或 `ai/project/inbox/raw/*.md`，写入上下文后移到
+  `ai/project/inbox/processed/`，保留相对路径：`ai/project/inbox/raw/file.md` ->
+  `ai/project/inbox/processed/raw/file.md`。文件名冲突时加日期或序号。不要移动
+  `ai/project/inbox/ideas/**`。
 - 未吸收资料必须留在原位置，并在最终回复中说明原因。
-- 对 `final-shape.md`、`module-map.md`、`roadmap.md` 的初始化内容必须标明证据来源；
-  如果证据不足，保持占位或写 `Unknown`，不要编造愿景。
+- `final-shape.md`、`module-map.md`、`roadmap.md` 的初始化内容必须标明证据来源；
+  证据不足时保持占位或写 `Unknown`，不要编造愿景。
 - 有帮助时，在相关文件中记录证据来源。
 - 保持 `ai/project/project.md` 稳定、长期有效。
 - 保持 `ai/project/refs/*.md` 聚焦；不要把引用文件写成项目流水账。
@@ -95,11 +91,11 @@
 
 ## 引导后交接
 
-写完项目上下文草稿后，不要只要求人类打开文件检查。
-你必须在最终回复中给出可确认摘要，让人类可以直接在聊天里确认或修正。
+写完上下文草稿后，不要只要求人类打开文件检查。最终回复必须给出可确认摘要，
+让人类能直接在聊天里确认或修正。
 
-如果人类在引导请求中已经给出当前任务目标，你必须同时起草 `ai/project/task.md`，
-并把项目理解摘要和任务草稿摘要一起交给人类确认。
+如果引导请求已包含当前任务目标，必须同时起草 `ai/project/task.md`，
+并交付项目理解摘要和任务草稿摘要。
 
 如果人类没有给出当前任务目标，你必须根据项目现状推荐下一步最值得做的任务。
 
@@ -199,5 +195,5 @@
 - 修正：<你要改的地方>
 ```
 
-如果仍有重要未知项，只在“仍不确定”中列出最多 3 条。
+重要未知项只在“仍不确定”中列最多 3 条。
 不要让人类主动去文件管理器里寻找问题；文件路径只作为可追溯记录。

package/template/zh/ai/template/execution-policy.md

@@ -104,6 +104,9 @@ Checkpoint 只在以下情况输出：风险从 Green 变 Yellow/Red、即将扩
 
 ## 用户可见输出
 
+- 默认使用当前安装模板语言输出。`ai/template/LANG` 为 `zh` 时，用户可见的计划、
+  L1 清单、Checkpoint、任务草稿交接、阻塞说明和最终结果默认使用中文；只有用户
+  明确要求其他语言，或需要保留代码、命令、文件路径、协议字段原文时才使用其他语言。
 - 默认展示 L1 清单；不要默认展示完整 L2/L3/L4。
 - 展示风险结论和必要原因；不要输出长篇内部推理。
 - 展示证据；不要展示内部协议字段、完整 YAML、`checkpoint_budget` 或 `model_policy`。

package/template/zh/ai/template/prompt.md

@@ -1,64 +1,56 @@
 # AI 执行提示
 
 不要总结这个文件。
-执行下面的工作流。
+按下面流程执行。你正在 Agent Execution Template 工作区内操作。
 
-你正在 Agent Execution Template 工作区内操作。
+本文件只负责路由。先读取最小状态：
 
-先读取：
+1. `ai/project/project.md`（如果存在）
+2. `ai/project/task.md`（如果存在）
+3. `ai/project/inbox/`、`ai/project/inbox/ideas/` 和 `ai/project/proposals/final-shape-updates/` 的浅层列表
 
-1. `ai/template/protocol.md`
-2. `ai/template/rules/core.md`
-3. `ai/template/execution-policy.md`
+选择模式：
 
-然后选择模式：
-
-- 如果用户要求更新北极星、最终形态、产品宪法、模块地图、路线图、项目方向，
-  或 `ai/project/inbox/ideas/` 里存在 `.gitkeep` 之外的待评估灵感，按 `strategy_update`
-  起草方向修订任务或直接生成提案，然后停止等待人类确认。
-- 如果用户明确确认某个
-  `ai/project/proposals/final-shape-updates/*.md` 可以合并，按
-  `apply_strategy_update` 起草或执行应用任务；如果 proposal 仍为
-  `proposed`，先根据这次明确确认更新为 `accepted`。
+- 用户要求更新北极星、最终形态、产品宪法、模块地图、路线图或项目方向，
+  或 `ai/project/inbox/ideas/` 有待评估灵感：读取 `ai/template/protocol.md`、
+  `ai/template/rules/core.md` 和相关方向 refs，走 `strategy_update`，生成提案后停下确认。
+- 用户明确确认某个 `ai/project/proposals/final-shape-updates/*.md` 可合并：
+  读取 `ai/template/protocol.md` 和 `ai/template/rules/core.md`，走
+  `apply_strategy_update`。若 proposal 仍为 `proposed`，先改为 `accepted`。
 - 如果用户说“开始初始化这个项目，并吸收 ai/project/inbox/ 里的资料”，
-  或要求初始化时一并吸收 `ai/project/inbox/` 里的资料，先检查
-  `ai/project/project.md`。如果它已经存在且不是空文件、占位内容或明显不完整，
-  执行 `ai/template/reconcile.md`，不要重新 bootstrap；如果它为空、只有占位内容或
-  明显不完整，执行 `ai/template/bootstrap.md`，并把 `ai/project/inbox/*.md` 与
-  `ai/project/inbox/raw/*.md` 视为本次引导输入的一部分；在项目上下文确认后停止。
-- 如果用户说“整合 ai/project/inbox/ 里的新资料”，要求整合/合并/吸收/
-  更新上下文/处理新资料，提到 `reconcile` 或 `ai/project/inbox/`，
-  或 `ai/project/inbox/` 里存在 `.gitkeep` 之外的待吸收资料，执行 `ai/template/reconcile.md`，
-  并按它的两阶段流程停止或更新；但 `ai/project/inbox/processed/` 是已处理资料，
-  不应触发整合，`ai/project/inbox/ideas/` 应优先走 `strategy_update`。即使用户说
-  “整合整个 inbox”，默认也只处理 `ai/project/inbox/*.md` 和
-  `ai/project/inbox/raw/*.md`。
+  或要求初始化时吸收 inbox：先检查 `ai/project/project.md`。若已存在且有效，
+  执行 `ai/template/reconcile.md`，不要重新 bootstrap；若为空、占位或不完整，执行
+  `ai/template/bootstrap.md`，并把 `ai/project/inbox/*.md` 与
+  `ai/project/inbox/raw/*.md` 纳入引导输入；上下文确认后停止。
+- 用户说“整合 ai/project/inbox/ 里的新资料”，要求整合/合并/吸收/更新上下文/处理新资料，提到 `reconcile` 或
+  `ai/project/inbox/`，或 inbox 有待吸收资料：执行 `ai/template/reconcile.md`。
+  `processed/` 不触发整合，`ideas/` 优先走 `strategy_update`。即使用户说
+  “整合整个 inbox”，也默认只处理 `ai/project/inbox/*.md` 和 `ai/project/inbox/raw/*.md`。
 - 如果用户说“开始初始化这个项目”、要求初始化/整理/生成项目上下文，
-  或 `ai/project/project.md` 为空、只有占位内容、
-  或不完整，执行 `ai/template/bootstrap.md`，并在项目上下文确认后停止。
-- 如果 `ai/project/task.md` 为空、只有占位内容、或不完整，根据用户当前目标和
-  已确认的项目上下文起草它，然后停止等待人类确认。
-- 如果用户说“继续推进这个项目”，且没有更具体目标，先全局判断当前最值得做的
-  下一步：优先处理待确认上下文、待确认任务、失败结果、未完成任务或明显风险；
-  然后给出建议或起草 `ai/project/task.md`，不要让人类自己去文件管理器里找问题。
-- 只有当 `ai/project/project.md` 和 `ai/project/task.md` 已经足够定义身份、
-  目标、范围、权限和验收时，才进入执行模式。
+  或 `ai/project/project.md` 为空、占位或不完整：执行 `ai/template/bootstrap.md`，
+  上下文确认后停止。
+- `ai/project/task.md` 为空、占位或不完整：按当前目标和已确认上下文起草任务，
+  然后停下确认。
+- 用户说“继续推进这个项目”且无更具体目标：先判断最值得做的下一步，优先处理
+  待确认上下文、待确认任务、失败结果、未完成任务或明显风险；给出建议或起草
+  `ai/project/task.md`，不要让人类自己找问题。
+- 只有当 `project.md` 和 `task.md` 足以定义身份、目标、范围、权限和验收时，
+  才读取 `ai/template/protocol.md`、`ai/template/rules/core.md`、
+  `ai/template/execution-policy.md` 并进入执行模式。
 
 ## 任务草稿交接
 
 在任务草稿模式中：
 
 1. 读取已确认的 `ai/project/project.md` 和相关 `ai/project/refs/*.md`。
-2. 根据用户当前目标、项目上下文和仓库事实，推断目标、范围、验收、权限、
-   验证方式和初始风险；不要要求用户逐项提供。
+2. 根据用户目标、项目上下文和仓库事实推断目标、范围、验收、权限、验证方式和初始风险；
+   不要求用户逐项提供。
 3. 起草 `ai/project/task.md`，并将 `execution_policy.mode` 设为 `auto`。
-4. 执行前列出 L1 任务清单并标注 Green / Yellow / Red，同时写入
-   `execution_policy.task_tree`。L1 少于 2 个时使用 `normal`；L1 为 2 个或更多时
-   自动使用 `bounded_continuous`。
-5. 本轮如果新建或重写了 `ai/project/task.md`，将 `readiness` 设为
-   `draft_for_confirmation` 并停止交接；不要在任务仍是草稿时直接执行。
-6. 只有已有任务明确处于 `ready_to_execute`，且没有 Red 预检项时，才能进入执行模式；
-   如果不可执行，设为 `blocked`。
+4. 执行前列出 L1 清单并标注 Green / Yellow / Red，写入 `execution_policy.task_tree`。
+   L1 < 2 用 `normal`；L1 >= 2 自动用 `bounded_continuous`。
+5. 本轮新建或重写 `task.md` 时，将 `readiness` 设为 `draft_for_confirmation` 并停止；
+   草稿不能直接执行。
+6. 只有既有任务为 `ready_to_execute` 且无 Red 预检项，才进入执行；否则设为 `blocked`。
 7. 不要在任务草稿模式中修改源码或业务文件。
 
 任务草稿模式必须以下面结构结束：
@@ -108,15 +100,14 @@
 2. `ai/project/runtime.md`
 3. `ai/project/task.md`
 
-然后按 `ai/template/execution-policy.md` 做执行前规划：列出 L1 清单，给每个 L1
-标注 Green / Yellow / Red，并写入 `execution_policy.task_tree`。根据 L1 数量自动选择
-`normal` 或 `bounded_continuous`。只有 `readiness = ready_to_execute` 才能执行；
-如果本轮新建或重写任务契约，先停在确认交接。L1 必须是可独立验收的垂直切片。
-执行 L1 前规划 L2，执行 L2 前按需规划 L3；默认最多 3 层，必要时允许 L4。
-每完成一个 L1，在清单中打勾并划掉；开始或完成 L1、出现 Red/blocked、范围变化
-或最终收尾时写回 `task_tree`。只有 Red 停止等待人类确认；Green 自动继续，Yellow
-只做当前 L1/L2 内的局部低风险修正。用户可见输出遵守
-`ai/template/execution-policy.md` 的“用户可见输出”规则。最后把结果写入：
+然后按 `ai/template/execution-policy.md` 规划：列 L1，标注 Green / Yellow / Red，
+写入 `execution_policy.task_tree`，并按 L1 数量选择 `normal` 或 `bounded_continuous`。
+只有 `readiness = ready_to_execute` 才能执行；本轮新建或重写任务契约时先停下确认。
+L1 必须是可独立验收的垂直切片。执行 L1 前规划 L2，执行 L2 前按需规划 L3；
+默认最多 3 层，必要时允许 L4。每完成一个 L1，在清单中打勾并划掉；仅在 L1
+开始/完成、Red/blocked、范围变化或最终收尾时写回 `task_tree`。Red 停止确认；
+Green 自动继续；Yellow 只做当前 L1/L2 内的局部低风险修正。用户可见输出遵守
+“用户可见输出”规则。最后写入：
 
 - `ai/project/result.json`
 - `ai/project/result.md`