@xenonbyte/da-vinci-workflow 0.1.19 → 0.1.20

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v0.1.20 - 2026-03-29
+
+### Added
+- `scripts/test-audit-context-delta.js` to cover context-delta expectation signals, status mismatch reporting, `supersedes` validation, and timestamp-normalized reference matching
+
+### Changed
+- continue prompt/docs behavior now consistently route from artifact and checkpoint truth first, with contextual deltas used only as auxiliary recovery context
+- context-delta audit expectation signals now trigger on `## Checkpoint Status` and `## MCP Runtime Gate` (or explicit `Context Delta Required` opt-in) instead of broad `## Outcome` matching
+- context-delta mismatch warnings now use neutral status-mismatch wording and include per-checkpoint status history
+- context-delta `supersedes` fields are now validated against earlier entries in the same artifact, including parseable timestamp normalization
+- README, Chinese README, workflow docs, prompt docs, and templates now document automatic context-delta checks plus optional explicit opt-in usage
+
 ## v0.1.19 - 2026-03-28
 
 ### Added

package/README.md

@@ -28,10 +28,13 @@ This workflow is intended for:
 
 Latest published npm package:
 
-- `@xenonbyte/da-vinci-workflow@0.1.19`
+- `@xenonbyte/da-vinci-workflow@0.1.20`
 
 Release highlights:
 
+- continue-routing and recovery guidance now consistently prioritize artifact/checkpoint truth first, with contextual deltas treated as auxiliary notes only
+- context-delta audit now uses tighter expectation signals, status-mismatch wording, and `supersedes` validation with timestamp normalization
+- context-delta expectation checks are now automatic for checkpoint-bearing artifacts and allow explicit opt-in (`Context Delta Required`) only for edge cases
 - `design-supervisor review` is now a first-class final style-quality gate with explicit advisory versus required behavior controlled by `Require Supervisor Review`
 - `Visual Assist` docs now explain gate order, gate judging criteria, and branching across screenshot review, layout hygiene, design checkpoint, and design-supervisor review
 - `visual-assist-presets` for mobile, desktop, web, and tablet now ship three explicit variants: adapter-only, advisory reviewer, and required reviewer signoff in both English and Chinese
@@ -118,6 +121,9 @@ Route discipline:
 - `intake` and `continue` should usually generate a main `$da-vinci ...` or `/da-vinci ...` prompt
 - they should not default the user into `build`
 - `build` remains a direct expert route for workflows that are already implementation-ready
+- `continue` should determine route selection from artifact and checkpoint truth first
+- contextual checkpoint deltas are auxiliary recovery notes only and must not override routing
+- if contextual deltas conflict with current artifacts, ignore them for routing and record the conflict
 
 ## Visual Assist Quick Start
 
@@ -340,6 +346,11 @@ Checkpoint outcomes:
 - `WARN`
 - `BLOCK`
 
+Context delta notes:
+
+- keep concise `Context Delta` entries inside existing change artifacts (`pencil-design.md`, `tasks.md`, `verification.md`)
+- treat contextual deltas as recovery aids, not as a second source of phase truth
+
 ## Execution Policy
 
 Da Vinci is `autonomous-by-default`.
@@ -355,6 +366,7 @@ Default behavior:
 - `PASS` -> continue
 - `WARN` -> record and continue
 - `BLOCK` -> stop only when the blocker cannot be resolved from existing artifacts or local context
+- missing or status-mismatched contextual deltas -> warn and continue
 
 Typical stop conditions:
 
@@ -476,6 +488,13 @@ da-vinci uninstall --platform codex,claude,gemini
 - `--mode integrity`: a mid-workflow filesystem-truth check for missing baseline artifacts, misplaced exports, polluted `.da-vinci/designs/`, and missing persisted `.pen` sources
 - `--mode completion`: a strict pre-completion gate for one change scope; use `--change <change-id>` and treat any failure as blocking
 
+Context-delta integration in audit:
+
+- missing, incomplete, or status-mismatched contextual delta entries are warning-level signals
+- these warnings improve resume quality but do not introduce new completion failure gates by themselves
+- expectation checks are automatic when an artifact includes `## Checkpoint Status` or `## MCP Runtime Gate`; no manual toggle is needed in normal workflows
+- only add `Context Delta Required: true` (also accepts `yes` / `on` / `1`) for artifacts that intentionally opt in without those headings
+
 Both modes check the most common workflow-integrity failures in a project:
 
 - missing standard Da Vinci artifacts

package/README.zh-CN.md

@@ -30,10 +30,13 @@ Da Vinci 是一个把产品需求一路推进到结构化规格、Pencil 设计
 
 最新已发布 npm 包：
 
-- `@xenonbyte/da-vinci-workflow@0.1.19`
+- `@xenonbyte/da-vinci-workflow@0.1.20`
 
 已发布版本重点：
 
+- `continue` 的选路与恢复规则现已统一：先看工件/checkpoint 真相，再把 Context Delta 当作辅助信息
+- Context Delta 审计规则已强化：触发信号更精确、告警改为状态不一致语义，并补充 `supersedes` 校验与时间归一化
+- checkpoint 相关工件默认自动启用 Context Delta 期望检查；只有少数无 checkpoint 标题的工件才需要显式 `Context Delta Required`
 - `design-supervisor review` 现在成为正式的最终风格质量 gate，并通过 `Require Supervisor Review` 明确区分“建议性”与“硬门槛”
 - `Visual Assist` 文档现在补全了 gate 顺序、每层 gate 怎么审，以及 screenshot review、layout hygiene、design checkpoint、design-supervisor review 之间的分叉规则
 - 移动端、桌面端、Web、平板四套 `visual-assist-presets` 现在都提供三种明确变体：只有 adapter、reviewer 建议性审查、reviewer 硬签字，中英文一致
@@ -123,6 +126,9 @@ Da Vinci 当前支持五种模式：
 - `intake` 和 `continue` 通常应该回到主工作流入口，即 `$da-vinci ...` 或 `/da-vinci ...`
 - 它们不应该默认把用户直接导向 `build`
 - `build` 仍然保留，但它是给已经实现就绪的高级直接入口
+- `continue` 的选路应先看工件和 checkpoint 真相，再看上下文补充信息
+- Context Delta 只用于恢复上下文，不是阶段判定真相源
+- 如果 Context Delta 与当前工件冲突，应该忽略冲突条目并按工件真相继续
 
 ## Visual Assist 快速上手
 
@@ -403,6 +409,13 @@ da-vinci uninstall --platform codex,claude,gemini
 - `--mode integrity`：适合在工作进行中检查文件系统真相，比如基础工件缺失、导出路径错误、`.da-vinci/designs/` 被污染、项目内 `.pen` 没落盘
 - `--mode completion`：适合在宣称完成前做严格检查；配合 `--change <change-id>` 使用，任何失败都应视为阻断
 
+Context Delta 与 audit 的关系：
+
+- Context Delta 缺失、字段不完整或与最新 checkpoint 不一致时，属于告警（`WARN`）
+- 这些告警用于提升续跑质量，不应单独变成新的 completion 失败门槛
+- 当工件包含 `## Checkpoint Status` 或 `## MCP Runtime Gate` 时，期望检查会自动启用，正常流程不需要手动开关
+- 只有在不包含这些标题但仍想启用检查时，才需要写 `Context Delta Required: true`（也支持 `yes` / `on` / `1`）
+
 两种模式都会检查项目里最常见的工作流完整性问题：
 
 - 标准 Da Vinci 工件缺失

package/SKILL.md

@@ -136,8 +136,11 @@ Use these helper actions when the user needs help entering or resuming the workf
      - detected workflow state
      - gaps or blockers
      - one executable continuation prompt
+     - contextual recovery notes from recent checkpoint deltas when consistent with current artifacts
    - do not restart discovery if the artifacts already provide enough truth
    - do not default to `build` unless the project is clearly implementation-ready
+   - determine route selection from artifact and checkpoint truth first; contextual deltas are auxiliary and must not override routing
+   - if contextual deltas conflict with current artifacts, ignore them for routing and record the conflict
 
 ## V2 Mode Selection
 
@@ -731,6 +734,7 @@ Checkpoint handling:
 - `PASS`: continue automatically
 - `WARN`: record the issue and continue automatically
 - `BLOCK`: stop, report the blocker, and ask only if the blocker cannot be resolved from existing artifacts
+- contextual-delta issues: warn and continue; do not treat missing/stale contextual notes as standalone blockers
 
 ## Drift Policy
 

package/commands/claude/dv/continue.md

@@ -15,11 +15,15 @@ Focus on:
 Output should include:
 - detected workflow state
 - missing or weak artifacts
+- contextual recovery notes from recent checkpoint deltas when they are consistent with current artifacts
 - one primary `/da-vinci continue ...` prompt
 - one more conservative continuation prompt when useful
 
 Route discipline:
 - do not restart discovery if the current artifacts already contain enough truth
+- determine route selection from artifact and checkpoint truth before reading contextual deltas
+- use contextual deltas as auxiliary recovery context only; they must not override route selection
+- if contextual deltas conflict with current artifacts, ignore them for routing and call out the conflict
 - do not default the user into `/dv:build` unless the project is clearly implementation-ready
 - if design artifacts exist but `tasks.md` does not, prefer a continuation prompt that moves into `/dv:tasks`
 - only prefer `/dv:build` once task generation and implementation readiness are already clear

package/commands/codex/prompts/dv-continue.md

@@ -15,11 +15,15 @@ Goal:
 Output should include:
 - detected workflow state
 - missing or weak artifacts
+- contextual recovery notes from recent checkpoint deltas when they are consistent with current artifacts
 - one primary `$da-vinci continue ...` prompt
 - one more conservative continuation prompt when useful
 
 Route discipline:
 - do not restart discovery if the current artifacts already contain enough truth
+- determine route selection from artifact and checkpoint truth before reading contextual deltas
+- use contextual deltas as auxiliary recovery context only; they must not override route selection
+- if contextual deltas conflict with current artifacts, ignore them for routing and call out the conflict
 - do not default the user into `/prompts:dv-build` unless the project is clearly implementation-ready
 - if design artifacts exist but `tasks.md` does not, prefer a continuation prompt that moves into `/prompts:dv-tasks`
 - only prefer `/prompts:dv-build` once task generation and implementation readiness are already clear

package/commands/gemini/dv/continue.toml

@@ -14,11 +14,15 @@ Focus on:
 Output should include:
 - detected workflow state
 - missing or weak artifacts
+- contextual recovery notes from recent checkpoint deltas when they are consistent with current artifacts
 - one primary `/da-vinci continue ...` prompt
 - one more conservative continuation prompt when useful
 
 Route discipline:
 - do not restart discovery if the current artifacts already contain enough truth
+- determine route selection from artifact and checkpoint truth before reading contextual deltas
+- use contextual deltas as auxiliary recovery context only; they must not override route selection
+- if contextual deltas conflict with current artifacts, ignore them for routing and call out the conflict
 - do not default the user into `/dv:build` unless the project is clearly implementation-ready
 - if design artifacts exist but `tasks.md` does not, prefer a continuation prompt that moves into `/dv:tasks`
 - only prefer `/dv:build` once task generation and implementation readiness are already clear

package/docs/codex-natural-language-usage.md

@@ -53,6 +53,7 @@ Use this when:
 - `DA-VINCI.md` already exists
 - `.da-vinci/` artifacts already exist
 - the workflow paused and needs to resume
+- route selection should come from artifact/checkpoint truth first, then contextual deltas
 
 ### Run a mode directly
 
@@ -151,6 +152,8 @@ $da-vinci use continue for this existing redesign-from-code workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Existing code remains the behavior source of truth.
+Determine route progression from current artifacts and checkpoints first.
+Use contextual checkpoint deltas only as auxiliary recovery notes.
 Do not restart discovery unless an artifact is missing or clearly wrong.
 Do not stop at tasks.md.
 Continue into implementation and verification.

package/docs/dv-command-reference.md

@@ -73,6 +73,7 @@ Outputs:
 
 - detected workflow state
 - missing or weak artifacts
+- contextual recovery notes from recent checkpoint deltas when consistent with current artifacts
 - one primary continuation prompt
 - one conservative continuation prompt when useful
 
@@ -80,6 +81,8 @@ Important continuation rule:
 
 - if design exists but `tasks.md` does not, continuation should usually point to `tasks`
 - it should not promote `build` as a co-equal next step yet
+- route selection should be derived from artifact and checkpoint truth before contextual deltas are consulted
+- if contextual deltas conflict with current artifacts, ignore those deltas for route selection and report the conflict
 
 ### `/dv:breakdown`
 

package/docs/mode-use-cases.md

@@ -82,6 +82,8 @@ Common rule:
 
 - `intake` and `continue` should normally lead back to the main workflow entry
 - they should not default the user into `build` unless the project is already implementation-ready
+- `continue` should determine route selection from artifact/checkpoint truth first, then use contextual deltas as auxiliary recovery notes
+- if contextual deltas conflict with current artifacts, ignore those deltas for routing and record the conflict
 
 ---
 

package/docs/pencil-rendering-workflow.md

@@ -63,6 +63,14 @@ When the project already has a registered `.pen`:
 
 Da Vinci does not assume live MCP edits were flushed automatically.
 
+## Continuation Recovery Rule
+
+When resuming from existing artifacts:
+
+- choose routing from current artifact and checkpoint truth first
+- use checkpoint-adjacent `Context Delta` notes only as auxiliary recovery context
+- if a contextual delta conflicts with current artifact/checkpoint truth, ignore that conflicting entry and record the conflict before continuing
+
 ## Persistence Rule
 
 Da Vinci does not treat headless interactive `save()` as authoritative persistence truth.
@@ -227,6 +235,14 @@ da-vinci audit --mode completion --change <change-id> <project-path>
 
 This audit now also expects `.da-vinci/state/pencil-session.json` to reflect the latest persisted `.pen` hash.
 
+Context-delta audit expectations are warning-only:
+
+- missing concrete context deltas for checkpoint-bearing artifacts -> `WARN`
+- incomplete context-delta entries -> `WARN`
+- context-delta status mismatch with current checkpoints -> `WARN`
+- a mismatch can indicate stale checkpoint status or stale context-delta notes
+- these warnings improve resume quality but do not create standalone completion blockers
+
 ## Preferred Command Chain
 
 Typical autonomous chain:

package/docs/prompt-entrypoints.md

@@ -58,9 +58,16 @@ What it should output:
 
 - detected workflow state
 - missing or weak artifacts
+- contextual recovery notes from recent checkpoint deltas when available
 - one primary continuation prompt
 - one more conservative continuation prompt when useful
 
+Continuation precedence:
+
+- determine routing from artifact and checkpoint truth first
+- use contextual checkpoint deltas only as auxiliary recovery context
+- if contextual deltas conflict with current artifacts, ignore them for routing and note the conflict
+
 ## Default Flow
 
 Use this default sequence:

package/docs/prompt-presets/README.md

@@ -116,5 +116,7 @@ $da-vinci use continue for this existing overhaul-from-code workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```

package/docs/prompt-presets/desktop-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code desktop workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -187,6 +189,8 @@ $da-vinci use continue for this existing desktop-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+Determine continuation routing from current artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Keep the registered project-local Pencil source under .da-vinci/designs/ as the design source of truth. If the resumed session will perform Pencil edits, require `da-vinci pencil-session begin --project <project-path> --pen <path>`, then use `da-vinci pencil-session persist --project <project-path> --pen <path> ...` after material live edits; fall back to the lower-level `write-pen + check-pen-sync` path only when the session wrapper cannot be used.
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 If Pencil MCP is active and this session performs new Pencil writes, rerun the MCP runtime gate and record the refreshed result in `pencil-design.md`.

package/docs/prompt-presets/mobile-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code mobile workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -195,6 +197,8 @@ $da-vinci use continue for this existing mobile-app redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+Determine continuation routing from current artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Keep the registered project-local Pencil source under .da-vinci/designs/ as the design source of truth. If the resumed session will perform Pencil edits, require `da-vinci pencil-session begin --project <project-path> --pen <path>`, then use `da-vinci pencil-session persist --project <project-path> --pen <path> ...` after material live edits; fall back to the lower-level `write-pen + check-pen-sync` path only when the session wrapper cannot be used.
 If the redesign is complex, keep the anchor-first flow until the design checkpoint passes.
 If Pencil MCP is active and this session performs new Pencil writes, rerun the MCP runtime gate and record the refreshed result in `pencil-design.md`.

package/docs/prompt-presets/tablet-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code tablet workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -187,6 +189,8 @@ $da-vinci use continue for this existing tablet-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+Determine continuation routing from current artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Keep the registered project-local Pencil source under .da-vinci/designs/ as the design source of truth. If the resumed session will perform Pencil edits, require `da-vinci pencil-session begin --project <project-path> --pen <path>`, then use `da-vinci pencil-session persist --project <project-path> --pen <path> ...` after material live edits; fall back to the lower-level `write-pen + check-pen-sync` path only when the session wrapper cannot be used.
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 If Pencil MCP is active and this session performs new Pencil writes, rerun the MCP runtime gate and record the refreshed result in `pencil-design.md`.

package/docs/prompt-presets/web-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code web workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -188,6 +190,8 @@ $da-vinci use continue for this existing web-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+Determine continuation routing from current artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Keep the registered project-local Pencil source under .da-vinci/designs/ as the design source of truth. If the resumed session will perform Pencil edits, require `da-vinci pencil-session begin --project <project-path> --pen <path>`, then use `da-vinci pencil-session persist --project <project-path> --pen <path> ...` after material live edits; fall back to the lower-level `write-pen + check-pen-sync` path only when the session wrapper cannot be used.
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 If Pencil MCP is active and this session performs new Pencil writes, rerun the MCP runtime gate and record the refreshed result in `pencil-design.md`.

package/docs/workflow-examples.md

@@ -14,6 +14,8 @@ Common rule:
 
 - `intake` and `continue` should usually generate a main `$da-vinci ...` or `/da-vinci ...` prompt
 - they should not default the user into `build` unless implementation readiness is already clear
+- `continue` should pick routes from artifact/checkpoint truth first, then use contextual deltas as auxiliary recovery notes
+- if contextual deltas conflict with current artifacts, ignore them for routing and record the conflict
 
 ## 1. `greenfield-spec`
 

package/docs/workflow-overview.md

@@ -128,6 +128,7 @@ Before mapping or implementation are treated as safe, Da Vinci runs:
 - `design-source checkpoint`
 - `MCP runtime gate` when Pencil MCP is active
 - `da-vinci audit --mode integrity <project-path>` during active work
+- checkpoint-adjacent `Context Delta` notes in existing change artifacts
 
 These checks verify that:
 
@@ -135,6 +136,7 @@ These checks verify that:
 - the active editor is the correct source
 - the shell-visible `.pen` exists
 - live snapshot and persisted snapshot are in sync
+- recent execution context is recoverable without replacing artifact truth as the routing authority
 
 ### 6. Mapping
 
@@ -163,6 +165,10 @@ The workflow must not report `design complete`, `workflow complete`, or any equi
 - MCP runtime gate is acceptable when Pencil MCP was used
 - `da-vinci audit --mode completion --change <change-id> <project-path>` passes
 
+Notes:
+
+- contextual delta warnings improve resume quality but do not create new completion blockers by themselves
+
 ## Gates And Audits
 
 ### Design Checkpoint
@@ -217,6 +223,11 @@ Run during active work, especially after the first successful Pencil write.
 
 Run before any terminal completion claim.
 
+Context-delta handling in audit:
+
+- missing, incomplete, or status-mismatched contextual deltas are warning-level quality signals
+- route and completion truth still come from artifacts, checkpoints, runtime gate, and filesystem audit
+
 ## Flow Diagram
 
 ```mermaid

package/docs/zh-CN/codex-natural-language-usage.md

@@ -54,6 +54,7 @@ $da-vinci use continue for <existing workflow state>
 - 已经存在 `DA-VINCI.md`
 - 已经存在 `.da-vinci/` 工件
 - 工作流中途暂停，需要恢复
+- 选路应先基于工件/checkpoint 真相，再参考 Context Delta
 
 ### 直接运行某个 mode
 
@@ -152,6 +153,8 @@ $da-vinci use continue for this existing redesign-from-code workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Existing code remains the behavior source of truth.
+Determine route progression from current artifacts and checkpoints first.
+Use contextual checkpoint deltas only as auxiliary recovery notes.
 Do not restart discovery unless an artifact is missing or clearly wrong.
 Do not stop at tasks.md.
 Continue into implementation and verification.

package/docs/zh-CN/dv-command-reference.md

@@ -75,6 +75,7 @@ Da Vinci 期望它们遵循工作流状态。
 
 - 当前 workflow state
 - 缺失或薄弱工件
+- 与当前工件一致时可引用最近 checkpoint 的 Context Delta 作为恢复补充
 - 一条主 continuation prompt
 - 必要时的保守 continuation prompt
 
@@ -82,6 +83,8 @@ Da Vinci 期望它们遵循工作流状态。
 
 - 如果设计已经有了，但 `tasks.md` 还没有，`continue` 通常应该把你送到 `tasks`
 - 这时候不应该把 `build` 当成同级主推荐
+- 选路必须先基于工件和 checkpoint 真相，再参考 Context Delta
+- 如果 Context Delta 与当前工件冲突，选路时应忽略冲突条目并记录冲突
 
 ### `/dv:breakdown`
 

package/docs/zh-CN/mode-use-cases.md

@@ -76,6 +76,8 @@ project/
 
 - `intake` 和 `continue` 一般应该回到主工作流入口
 - 不应默认导向 `build`，除非实现就绪已经非常明确
+- `continue` 选路应先看工件/checkpoint 真相，再把 Context Delta 当作辅助恢复信息
+- 如果 Context Delta 与当前工件冲突，选路时应忽略冲突条目并记录冲突
 
 ## 1. `greenfield-spec`
 

package/docs/zh-CN/pencil-rendering-workflow.md

@@ -65,6 +65,14 @@ Da Vinci 现在要求自治运行使用这组 session wrapper：
 
 Da Vinci 不会假设 live MCP 编辑已经被自动刷盘。
 
+## Continue 恢复规则
+
+从已有工件恢复时：
+
+- 选路先看当前工件和 checkpoint 真相
+- 只把 checkpoint 邻近的 `Context Delta` 当作辅助恢复信息
+- 如果 Context Delta 与当前工件或 checkpoint 真相冲突，忽略冲突条目并先记录冲突，再继续执行
+
 ## 持久化规则
 
 Da Vinci 不把 headless interactive `save()` 当作权威持久化真相。
@@ -229,6 +237,14 @@ da-vinci audit --mode completion --change <change-id> <project-path>
 
 这个审计现在还会检查 `.da-vinci/state/pencil-session.json`，要求它记录的 hash 与最新持久化 `.pen` 一致。
 
+Context Delta 相关审计期望都是告警级：
+
+- checkpoint 邻近工件缺少有效 Context Delta -> `WARN`
+- Context Delta 字段不完整 -> `WARN`
+- Context Delta 状态与当前 checkpoint 不一致 -> `WARN`
+- 这种不一致可能是 checkpoint 状态过期，也可能是 Context Delta 记录过期
+- 这些告警用于提升续跑质量，但不会单独形成 completion 阶段的硬阻断
+
 ## 推荐命令链
 
 典型自治流程：

package/docs/zh-CN/prompt-entrypoints.md

@@ -59,9 +59,16 @@
 
 - 当前工件状态判断
 - 缺失或薄弱工件
+- 可用时补充最近 checkpoint 的 Context Delta（仅在与当前工件一致时）
 - 一条主继续提示词
 - 必要时的保守继续版本
 
+继续规则优先级：
+
+- 先根据工件和 checkpoint 真相决定路由
+- Context Delta 只用于恢复和解释，不用于覆盖选路
+- 如果 Context Delta 与当前工件冲突，选路时忽略冲突内容并标记冲突
+
 ## 默认推荐流程
 
 推荐顺序：

package/docs/zh-CN/prompt-presets/README.md

@@ -116,5 +116,7 @@ $da-vinci use continue for this existing overhaul-from-code workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```

package/docs/zh-CN/prompt-presets/desktop-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code desktop workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -187,6 +189,7 @@ $da-vinci use continue for this existing desktop-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/prompt-presets/mobile-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code mobile workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -195,6 +197,7 @@ $da-vinci use continue for this existing mobile-app redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, keep the anchor-first flow until the design checkpoint passes.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/prompt-presets/tablet-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code tablet workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -187,6 +189,7 @@ $da-vinci use continue for this existing tablet-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/prompt-presets/web-app.md

@@ -75,6 +75,8 @@ $da-vinci use continue for this existing overhaul-from-code web workflow.
 
 Use the existing Da Vinci artifacts.
 Detect whether the workflow should return to breakdown, continue with design, generate tasks, continue implementation, or verify drift.
+Determine routing from artifact and checkpoint truth first, then use contextual checkpoint deltas only as auxiliary recovery notes.
+If a contextual delta conflicts with current artifacts, ignore that delta and record the conflict before continuing.
 Prefer the artifact-backed next safe stage instead of restarting the overhaul from scratch.
 ```
 
@@ -188,6 +190,7 @@ $da-vinci use continue for this existing web-product redesign workflow.
 
 Use the existing Da Vinci artifacts in this project.
 Do not restart discovery unless an artifact is missing or clearly wrong.
+选路先以当前工件和 checkpoint 真相为准，再把 Context Delta 作为辅助恢复信息；如果 Context Delta 与工件冲突，忽略冲突条目并记录冲突后继续。
 把登记的项目内 Pencil 源保持在 `.da-vinci/designs/` 下，作为设计真相源。如果继续这一轮会做 Pencil 编辑，必须先执行 `da-vinci pencil-session begin --project <project-path> --pen <path>`，发生实质性 live edit 后再执行 `da-vinci pencil-session persist --project <project-path> --pen <path> ...`；只有 session wrapper 不可用时，才退回 `write-pen + check-pen-sync` 这条底层链路。
 If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
 如果 Pencil MCP 可用，且这一轮继续做了新的 Pencil 写入，就重新运行 MCP runtime gate，并把最新结果记录到 `pencil-design.md`。

package/docs/zh-CN/workflow-examples.md

@@ -16,6 +16,8 @@
 
 - `intake` 和 `continue` 通常应该回到主工作流入口
 - 不应默认把用户导向 `build`
+- `continue` 选路先看工件/checkpoint 真相，再把 Context Delta 当作辅助恢复信息
+- 如果 Context Delta 与当前工件冲突，选路时应忽略冲突内容并记录冲突
 
 ## 1. `greenfield-spec`