@xenonbyte/da-vinci-workflow 0.1.11 → 0.1.13

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 
 - No unreleased changes yet.
 
+## v0.1.13 - 2026-03-27
+
+### Changed
+- visual-adapter execution now requires explicit runtime declaration of the resolved primary adapter, available and unavailable requested adapters, and pre-anchor thesis writing instead of relying on artifact metadata alone
+- redesign guidance now requires anchor-surface structural-delta notes, shared primitives before broad page expansion, and screenshot review that cannot auto-pass when analysis reports hierarchy, spacing, clarity, or inconsistency issues
+- `.da-vinci/designs/` is now documented more strictly as a `.pen`-only directory, and design-source guidance now expects shell-visible `.pen` persistence immediately after the first successful Pencil write
+- Pencil workflow guidance now explicitly rejects web-only properties such as `flex` and `margin`, and platform-adapter docs now warn against assuming cross-platform equivalence between near-name visual adapters
+
+## v0.1.12 - 2026-03-27
+
+### Changed
+- visual-adapter resolution now documents that the resolved primary adapter must actively lead the first design pass instead of being recorded only for traceability
+- complex redesign guidance now requires anchor-first Pencil generation: design 1-3 anchor surfaces, review screenshots, then expand the rest of the product
+- design-checkpoint guidance now explicitly blocks placeholder-heavy repeated scaffolds and broad multi-screen generation that starts before anchor surfaces are compositionally stable
+- prompt presets for mobile, desktop, web, and tablet surfaces now include `Simple redesign`, `Complex redesign`, `Design-only`, and `Continue` variants in both English and Chinese
+
 ## v0.1.11 - 2026-03-27
 
 ### Changed

package/README.md

@@ -27,10 +27,21 @@ This workflow is intended for:
 
 Latest published npm package:
 
-- `@xenonbyte/da-vinci-workflow@0.1.10`
+- `@xenonbyte/da-vinci-workflow@0.1.13`
 
 Release highlights:
 
+- visual-adapter execution now requires explicit runtime declaration of the resolved primary adapter and any unavailable requested adapters
+- cross-platform near-name adapters such as `frontend-skill` and `frontend-design` are now treated as distinct unless the current environment explicitly resolves them
+- complex `redesign-from-code` runs now require a visual thesis, content plan, interaction thesis, and anchor-surface structural-delta notes before broad Pencil generation
+- screenshot review is now documented as a binding gate; analysis that reports hierarchy, spacing, clarity, or inconsistency issues cannot be treated as an automatic pass
+- `.da-vinci/designs/` is now documented more strictly as a `.pen`-only directory, and project-local `.pen` persistence must be verified as shell-visible immediately after the first Pencil write
+- multi-surface redesign guidance now requires a shared primitive family to be defined from approved anchor surfaces before broad page expansion
+- Pencil generation guidance now explicitly rejects web-only properties such as `flex` and `margin`
+- visual-adapter resolution now requires the resolved primary adapter to actively lead the first design pass
+- complex redesigns now default to anchor-first Pencil generation: design 1-3 anchor surfaces, review screenshots, then expand
+- design checkpoint now explicitly blocks placeholder-heavy repeated scaffolds and premature broad multi-screen generation
+- prompt presets for mobile, desktop, web, and tablet now include `Simple redesign`, `Complex redesign`, `Design-only`, and `Continue` variants
 - `redesign-from-code` now states explicitly that existing code is behavior truth, not layout truth
 - complex pages are now expected to decompose into subpages, overlays, materially different states, and implementation surfaces before broad Pencil redesign
 - design-checkpoint guidance now explicitly blocks skin-swap redesigns, generic card mosaics, weak visual anchors, and decorative clutter
@@ -147,6 +158,17 @@ Selection rules:
 
 - keep `ui-ux-pro-max` first for dense app and dashboard surfaces when the visual bar is moderate
 - move `frontend-skill` to the first slot when art direction, composition quality, and premium visual hierarchy matter more
+- when `Preferred adapters` are configured, the resolved primary adapter should actively lead the first design pass instead of being recorded only for traceability
+- state the resolved primary adapter explicitly at runtime and name any requested adapters that are unavailable
+- do not assume cross-platform equivalence between near-name adapters
+- write a visual thesis, content plan, and interaction thesis before the first anchor surface
+- use Pencil guides as platform/buildability constraints, not as the main art-direction source
+- on complex redesigns, design 1-3 anchor surfaces first and review screenshots before broad multi-screen generation
+- for each anchor surface, explain how the new composition differs structurally from the current layout
+- do not auto-pass screenshot review when analysis reports hierarchy, spacing, clarity, inconsistency, or unresolved-placeholder issues
+- define shared primitives from the approved anchor surfaces before broad page expansion
+- keep `.da-vinci/designs/` reserved for `.pen` files only and verify the registered `.pen` path is shell-visible after the first Pencil write
+- use only Pencil-supported properties; do not rely on web-only props such as `flex` or `margin`
 - keep `Fallback: native-da-vinci` unless you explicitly want missing adapters to block the workflow
 - keep `Require Adapter: false` by default and raise it to `true` only for design-critical work
 - keep `Scope` limited to presentation quality; do not use it to delegate behavior, routes, or state truth
@@ -515,6 +537,7 @@ See:
 
 - `docs/prompt-entrypoints.md`
 - `docs/prompt-presets/`
+  - includes `Simple redesign`, `Complex redesign`, `Design-only`, and `Continue` variants in each surface file
 - `docs/codex-natural-language-usage.md`
 - `docs/visual-adapters.md`
 - `docs/visual-assist-presets/`
@@ -527,6 +550,7 @@ Chinese companion documents are included in this repository:
 
 - `README.zh-CN.md`
 - `docs/zh-CN/prompt-presets/`
+  - each surface file also includes `Simple redesign`, `Complex redesign`, `Design-only`, and `Continue`
 - `docs/zh-CN/visual-adapters.md`
 - `docs/zh-CN/visual-assist-presets/`
 - `docs/zh-CN/`

package/README.zh-CN.md

@@ -29,10 +29,21 @@ Da Vinci 是一个把产品需求一路推进到结构化规格、Pencil 设计
 
 最新已发布 npm 包：
 
-- `@xenonbyte/da-vinci-workflow@0.1.10`
+- `@xenonbyte/da-vinci-workflow@0.1.13`
 
 已发布版本重点：
 
+- visual adapter 的执行现在要求在运行时明确声明解析出来的主 adapter，以及哪些请求的 adapter 当前不可用
+- `frontend-skill`、`frontend-design` 这类跨平台近名 adapter 现在明确视为不同能力源，除非当前环境真的解析到了它们
+- 复杂 `redesign-from-code` 现在要求在大规模 Pencil 设计前先写 visual thesis、content plan、interaction thesis 和 anchor surface 的 structural-delta 说明
+- screenshot review 现在被明确强调为硬闸门；只要分析指出 hierarchy、spacing、clarity 或 inconsistency 问题，就不能自动判通过
+- `.da-vinci/designs/` 现在更明确只用于放 `.pen` 文件，而且第一次 Pencil 写入后就要验证对应 `.pen` 已经成为 shell 可见文件
+- 多 surface 重设计现在要求先从已通过的 anchor surface 中抽出 shared primitive family，再扩展更多页面
+- Pencil 生成规则现在明确拒绝 `flex`、`margin` 这类 Web 属性
+- visual adapter 解析现在要求“解析出来的主 adapter 必须真正主导首轮设计”，而不是只登记在工件里
+- 复杂重设计现在默认采用 anchor-first 的 Pencil 生成策略：先做 1 到 3 个 anchor surface，截图审查后再扩展
+- design checkpoint 现在会明确拦截大量空占位、重复模板和过早的大批量多页面脚手架
+- 移动端、桌面端、Web、平板的提示词模板现在都包含 `Simple redesign`、`Complex redesign`、`Design-only`、`Continue`
 - `redesign-from-code` 现在明确写清：现有代码只是真相行为，不是真相布局
 - 复杂页面现在明确要求在大规模 Pencil 重设计前拆成 subpage、overlay、明显不同 state 和 implementation surface
 - design checkpoint 现在明确会拦截旧 UI 换皮、通用卡片拼贴、弱视觉锚点和装饰性噪音
@@ -152,6 +163,17 @@ Da Vinci V2 支持四种模式：
 
 - 高密度 app、dashboard、工具型界面，且视觉要求中等时，优先把 `ui-ux-pro-max` 放第一位
 - 如果更重视 art direction、构图和高级感，就把 `frontend-skill` 放第一位
+- 一旦配置了 `Preferred adapters`，解析出来的主 adapter 应该真正主导首轮设计，而不是只登记在工件里
+- 运行时必须明确写出解析出来的主 adapter，以及哪些请求的 adapter 当前不可用
+- 不要默认把跨平台的近名 adapter 当成同一个能力源
+- 在第一个 anchor surface 之前，先写 visual thesis、content plan 和 interaction thesis
+- Pencil 的 guide 只应该约束平台布局和可实现性，不应该替代主 adapter 成为设计方向来源
+- 面对复杂重设计时，先做 1 到 3 个 anchor surface，并完成截图审查，再扩展到更多页面
+- 对每个 anchor surface，都要说明“新的构图和当前布局结构相比，具体改了什么”
+- 如果截图分析指出 hierarchy、spacing、clarity、inconsistency 或 unresolved placeholder 问题，就不能自动判通过
+- 在扩展更多页面前，先从已通过的 anchor surface 中抽出 shared primitives
+- `.da-vinci/designs/` 只应该放 `.pen` 文件，并且第一次 Pencil 写入后就要验证登记路径已经成为 shell 可见文件
+- 只使用 Pencil 支持的属性，不要继续使用 `flex`、`margin` 这类 Web 属性
 - 默认保留 `Fallback: native-da-vinci`
 - `Require Adapter` 默认保持 `false`，只有设计要求很高时再改成 `true`
 - `Scope` 只管 presentation 质量，不要拿它去定义 behavior、route 或 state truth
@@ -428,6 +450,7 @@ Continue into full-delivery.
 - `docs/codex-natural-language-usage.md`
 - `docs/prompt-entrypoints.md`
 - `docs/prompt-presets/`
+  - 每个场景文件都包含 `Simple redesign`、`Complex redesign`、`Design-only`、`Continue`
 - `docs/visual-adapters.md`
 - `docs/visual-assist-presets/`
 - `docs/workflow-examples.md`
@@ -438,6 +461,7 @@ Continue into full-delivery.
 
 - `README.zh-CN.md`
 - `docs/zh-CN/prompt-presets/`
+  - 每个场景文件也都包含 `Simple redesign`、`Complex redesign`、`Design-only`、`Continue`
 - `docs/zh-CN/visual-adapters.md`
 - `docs/zh-CN/visual-assist-presets/`
 - `docs/zh-CN/`

package/SKILL.md

@@ -185,7 +185,12 @@ Do not repeatedly ask for inputs that are already stable in the artifacts.
 Treat visual adapters as optional design-assist layers.
 
 - resolve them from the user request first, then `DA-VINCI.md`, then locally available skills
+- do not assume cross-platform equivalence between near-name adapters such as `frontend-skill` and `frontend-design`; only resolve adapters that are explicitly named and actually installed in the current environment
+- record which requested adapters were available, which were unavailable, and which adapter became the resolved primary adapter
+- when `DA-VINCI.md` or the request declares `Preferred adapters`, the resolved primary adapter must actively lead first-pass design reasoning instead of being recorded only for traceability
+- when a resolved primary adapter is available, state that runtime resolution explicitly before the first anchor-screen design pass and let it drive the visual thesis, content plan, and interaction thesis
 - use them to improve visual contract quality, composition, hierarchy, spacing, and motion guidance
+- use Pencil guides and platform constraints as buildability aids only; they must not replace the resolved primary adapter as the art-direction source
 - do not let them redefine behavior, page truth, route truth, or acceptance rules
 - if a requested adapter is unavailable locally, continue with native Da Vinci design rules and record the fallback
 
@@ -211,6 +216,17 @@ Default completion rule:
 - if the request is `design-only`, stop after design artifacts and bindings
 - otherwise assume `full-delivery` and continue through implementation and verification
 
+## Pencil Generation Rules
+
+During active Pencil work:
+
+- keep `.da-vinci/designs/` reserved for project-local `.pen` files; do not write workflow markdown such as inventories, proposals, or checkpoints into that directory
+- on `redesign-from-code`, write a short structural-delta note for each anchor surface explaining how the new composition differs from the current XML or layout grouping
+- after the first successful Pencil write, verify that the registered project-local `.pen` path exists as a shell-visible file before treating the design source as persistent
+- use only Pencil-supported properties; do not emit web- or CSS-only layout properties such as `flex` or `margin`
+- on complex redesigns, turn approved anchor surfaces into a small shared primitive family before broad page expansion
+- screenshot review is binding: if the review calls out hierarchy, spacing, clarity, inconsistency, or unresolved-placeholder issues, revise the screen before treating the checkpoint as `PASS`
+
 ## Load References On Demand
 
 Load only the reference that matches the current step:
@@ -474,6 +490,8 @@ When visual adapters are requested:
 - resolve them from local availability when possible
 - choose one primary adapter when multiple helpers are available
 - record the requested adapters, resolved primary adapter, any secondary helpers, and fallback status in `design-registry.md`
+- treat the resolved primary adapter as the design lead for the first Pencil pass, especially on anchor screens and quality-critical surfaces
+- if `Require Adapter: true` and the requested adapter is unavailable, treat that as a blocker instead of silently downgrading the visual bar
 - continue with native Da Vinci design rules when no adapter is available unless the user explicitly requires a specific adapter
 
 If the request is too vague to design or implement safely, ask a short clarification question before generating artifacts.
@@ -517,16 +535,21 @@ When creating or editing Pencil designs:
 - use the workflow-owned `.pen` path from `design-registry.md` as the active design target
 - do not keep designing in whichever Pencil document happens to be open unless it already matches the registered project-local path
 - use the resolved visual adapter, when available, for composition, hierarchy, restraint, and motion guidance
+- on complex redesigns, design only 1-3 anchor surfaces first before broad multi-screen generation
+- make each anchor surface fully composed with real hierarchy and content structure before expanding the rest of the product
 - before broad page generation, write a visual thesis, a content plan, and an interaction thesis for the current surface
+- use screenshot review after each anchor surface and revise before cloning or expanding variants
 - Keep page names, section names, and labels aligned with the specs
 - Make important states explicit when they change implementation: empty, loading, success, error, restricted, unavailable
 - Prefer layout clarity and information hierarchy over decorative complexity
 - Reject generic UI patterns such as dashboard-card mosaics, weak visual anchors, decorative clutter, or motion with no hierarchy value
+- reject placeholder-heavy scaffolds; unresolved placeholder rectangles are not acceptable substitutes for real screen composition
 - For `redesign-from-code`, redesign from page responsibilities and state decomposition, not by recoloring or slightly rearranging the old UI
 - After changes, inspect the result visually before treating it as implementation-ready
 
 When multiple pages exist:
 
+- derive the remaining pages from approved anchor surfaces and shared primitives rather than from an empty repeated template
 - keep one canonical Pencil page or screen per implementation page
 - record the `.pen` file in `design-registry.md`
 - record the mapping in `pencil-bindings.md`

package/commands/claude/da-vinci.md

@@ -22,6 +22,9 @@ Notes:
 - Requirements decide behavior.
 - Pencil decides presentation.
 - Code must follow both.
+- If `Visual Assist` is configured, resolve and state the actual primary visual adapter for this environment instead of assuming cross-platform skill equivalence.
+- Keep `.da-vinci/designs/` reserved for `.pen` files only.
+- On complex redesigns, design 1-3 anchor surfaces first and treat screenshot review as a binding gate before broad expansion.
 - Use `intake` when the user needs help phrasing the first workflow request.
 - Use `continue` when `.da-vinci/` artifacts already exist and the workflow must resume.
 - Keep workflow semantics shared across Codex, Claude, and Gemini.

package/commands/codex/prompts/da-vinci.md

@@ -21,6 +21,9 @@ Available routes:
 
 Important:
 - Treat `/prompts:*` as action selectors in Codex.
+- If `Visual Assist` is configured, resolve and state the actual primary visual adapter for this environment instead of assuming cross-platform skill equivalence.
+- Keep `.da-vinci/designs/` reserved for `.pen` files only.
+- On complex redesigns, design 1-3 anchor surfaces first and treat screenshot review as a binding gate before broad expansion.
 - Use `intake` when the user does not know how to phrase the first request.
 - Use `continue` when `.da-vinci/` artifacts already exist and the workflow must resume.
 - If details are still needed after route selection, provide them in the next message.

package/commands/gemini/da-vinci.toml

@@ -24,6 +24,9 @@ Notes:
 - Requirements decide behavior.
 - Pencil decides presentation.
 - Code must follow both.
+- If `Visual Assist` is configured, resolve and state the actual primary visual adapter for this environment instead of assuming cross-platform skill equivalence.
+- Keep `.da-vinci/designs/` reserved for `.pen` files only.
+- On complex redesigns, design 1-3 anchor surfaces first and treat screenshot review as a binding gate before broad expansion.
 - Use `intake` when the user needs help phrasing the first workflow request.
 - Use `continue` when `.da-vinci/` artifacts already exist and the workflow must resume.
 - Keep workflow semantics shared across Claude, Codex, and Gemini.

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

@@ -73,6 +73,13 @@ For surface-specific prompt starting points, also see:
 
 - `docs/prompt-presets/`
 
+Each surface file includes:
+
+- `Simple redesign`
+- `Complex redesign`
+- `Design-only`
+- `Continue`
+
 ### 1. New project with clear requirements
 
 ```text

package/docs/mode-use-cases.md

@@ -42,6 +42,7 @@ Rule:
 - only `DA-VINCI.md` belongs at the project root
 - all other workflow outputs should stay under `.da-vinci/`
 - persisted project-local Pencil files should stay under `.da-vinci/designs/`
+- `.da-vinci/designs/` should contain `.pen` files only, not workflow markdown
 
 ## Quick mode selection
 
@@ -324,7 +325,11 @@ Register the design sources, extract DA-VINCI.md from them, bind covered pages,
 
 6. create or update `pencil-design.md`
    - build the new redesign baseline in Pencil
+   - write the visual thesis, content plan, interaction thesis, and structural-delta notes before broad anchor generation
+   - design 1-3 anchor surfaces first before broad multi-screen expansion
+   - let the resolved primary visual adapter lead that first pass
    - persist that baseline into the registered `.da-vinci/designs/` file
+   - verify that registered `.pen` path is shell-visible immediately after the first successful Pencil write
 
 7. create or update `pencil-bindings.md`
    - bind pages to redesign screens
@@ -339,6 +344,18 @@ Register the design sources, extract DA-VINCI.md from them, bind covered pages,
 
 ### Critical rule in this mode
 
+- treat the resolved primary visual adapter as the first-pass design lead when `Preferred adapters` are configured
+- state the resolved primary adapter explicitly at runtime, including which requested adapters were unavailable
+- do not assume cross-platform equivalence between near-name adapters; resolve the installed adapter names for the current environment
+- when a primary adapter is active, write the visual thesis, content plan, and interaction thesis before the first anchor screen
+- do not let Pencil guides or generic style packs replace that adapter as the art-direction source
+- do not start broad redesign work by scaffolding many empty screens
+- for complex products, get 1-3 anchor surfaces through screenshot review before expanding the rest of the redesign
+- for each anchor surface, explain briefly how the new composition differs from the current layout grouping
+- do not auto-pass screenshot review if the analysis reports hierarchy, spacing, clarity, inconsistency, or unresolved-placeholder issues
+- define a small shared primitive family from the approved anchor surfaces before broad page expansion
+- use only Pencil-supported properties; do not rely on web-only props such as `flex` or `margin`
+
 For redesign work:
 
 - current code decides behavior
@@ -355,6 +372,7 @@ Fresh-layout rule:
 Project-local `.pen` rule:
 
 - the preferred `.pen` path in `design-registry.md` is owned by the workflow, not by user hand-editing
+- keep `.da-vinci/designs/` reserved for `.pen` files rather than workflow markdown
 - do not keep redesign work inside an unrelated active Pencil editor just because it is currently open
 - if Pencil MCP does not materialize the registered shell-visible file automatically, reconstruct and write that `.pen` file before mapping or implementation is treated as complete
 

package/docs/prompt-presets/README.md

@@ -10,8 +10,9 @@ Recommended flow:
 
 1. choose the prompt preset closest to the product surface
 2. choose the matching `Visual Assist` preset
-3. copy both into your workflow setup
-4. tighten the prompt further only when the project has unusual truth sources or platform constraints
+3. choose the prompt variant that matches project complexity and delivery intent
+4. copy both into your workflow setup
+5. tighten the prompt further only when the project has unusual truth sources or platform constraints
 
 Available presets:
 
@@ -25,3 +26,10 @@ Design rule:
 - prompt presets define workflow intent, decomposition rules, and truth-source handling
 - visual-assist presets define UI-design helper preferences
 - use both together for the strongest result
+
+Each scene preset should now include:
+
+- `Simple redesign`
+- `Complex redesign`
+- `Design-only`
+- `Continue`

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

@@ -9,38 +9,76 @@ Pair with:
 Use this when the workflow needs:
 
 - dense workspace hierarchy
-- clear tool panels and primary working surfaces
-- disciplined modal and secondary-panel treatment
-- decomposition of complex screens into meaningful surfaces
+- clear primary and secondary working regions
+- disciplined panel, dialog, and inspector treatment
 
-Recommended prompt:
+## How To Choose
+
+- Use `Simple redesign` when the desktop surface is narrow, mostly single-workspace, or has limited state branching.
+- Use `Complex redesign` when the product has multiple workspaces, side panels, overlays, inspectors, or materially different states.
+- Use `Design-only` when you want the design chain and task readiness without code changes yet.
+- Use `Continue` when the workflow already created artifacts and needs to resume.
+
+## Simple Redesign
 
 ```text
 $da-vinci use redesign-from-code to redesign this existing desktop product.
 
 Existing code is the behavior source of truth, not the layout truth.
-Preserve behavior, flows, integrations, and validation rules unless explicitly required otherwise.
-Inventory primary workspaces, side panels, secondary panels, dialogs, settings flows, overlays, and important states before broad Pencil work.
-Decompose complex screens into primary surfaces, secondary surfaces, overlays, and materially different states.
+Preserve current behavior, flows, integrations, and validation rules unless explicitly required otherwise.
+Inventory the current workspaces, dialogs, overlays, and important states before Pencil work.
 Use the Visual Assist preferences declared in DA-VINCI.md.
-Do not pass design checkpoint if the result is just a boxed-up recolor of the old UI or if panel hierarchy remains unclear.
+Do not pass design checkpoint if the result is just a boxed-up recolor of the old UI or if workspace hierarchy remains unclear.
 Persist project-local Pencil files under .da-vinci/designs/.
 ```
 
-When to switch to `intake` first:
+## Complex Redesign
+
+```text
+$da-vinci use redesign-from-code to redesign this existing desktop product.
 
-- the desktop architecture is large
-- modules and workspace boundaries are unclear
-- there are multiple existing design references or mixed product surfaces
+Existing code is the behavior source of truth, not the layout truth.
+Preserve current behavior, flows, integrations, and validation rules unless explicitly required otherwise.
+Inventory primary workspaces, side panels, inspectors, dialogs, settings flows, overlays, and materially different states before broad Pencil work.
+Decompose complex screens into primary surfaces, secondary surfaces, overlays, and implementation surfaces.
+Use the Visual Assist preferences declared in DA-VINCI.md.
+Treat the resolved primary visual adapter as the first-pass design lead.
+Use Pencil guides only as workspace constraints, not as the design direction.
+Do not start with broad multi-screen scaffolding.
+Design 1-3 anchor surfaces first, review screenshots, then expand.
+Do not pass design checkpoint if the result is a repeated placeholder scaffold, flat panel soup, or a recolor of the old desktop shell.
+Persist project-local Pencil files under .da-vinci/designs/.
+```
 
-`intake` variant:
+## Design-Only
 
 ```text
-$da-vinci use intake for this existing desktop product.
+$da-vinci use redesign-from-code to redesign this existing desktop product.
 
-I need to redesign the UI while preserving current behavior.
 Existing code is the behavior source of truth, not the layout truth.
-Inventory workspaces, panels, dialogs, overlays, settings flows, and important states.
-Decompose complex screens before Pencil work.
-Generate the best executable Da Vinci workflow prompt for the next step.
+Preserve current behavior, flows, and integrations.
+Inventory workspaces, side panels, dialogs, overlays, and important states.
+Decompose complex screens into real design surfaces before Pencil work.
+Use the Visual Assist preferences declared in DA-VINCI.md.
+If the product is complex, design 1-3 anchor surfaces first, review screenshots, then expand.
+Stop after DA-VINCI.md, design-registry.md, page-map.md, proposal.md, specs, design.md, pencil-design.md, pencil-bindings.md, and tasks.md.
+Do not start code changes yet.
 ```
+
+## Continue
+
+```text
+$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.
+Keep the registered project-local Pencil source under .da-vinci/designs/ as the design source of truth.
+If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
+Continue into the next unfinished stage and do not stop at tasks.md when the active intent is full-delivery.
+```
+
+## When To Switch To Intake First
+
+- workspace boundaries are unclear
+- there are multiple truth sources or mixed product surfaces
+- the first workflow prompt is still hard to phrase cleanly

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

@@ -1,6 +1,6 @@
 # Mobile App Prompt Preset
 
-Recommended when the project is a phone-first product surface.
+Recommended when the product surface is a phone-first app.
 
 Pair with:
 
@@ -8,39 +8,85 @@ Pair with:
 
 Use this when the workflow needs:
 
-- app-first hierarchy
-- touch-first interaction surfaces
-- strong state decomposition
-- clear treatment of sheets, dialogs, tabs, and nested navigation
+- touch-first hierarchy
+- clear handling of tabs, sheets, dialogs, and nested flows
+- state decomposition that matches real app behavior
 
-Recommended prompt:
+## How To Choose
+
+- Use `Simple redesign` when the app surface is small, mostly contained, or has only a few canonical screens.
+- Use `Complex redesign` when the app has multiple activities, fragments, tabs, overlays, or materially different states.
+- Use `Design-only` when you want the full design chain but do not want code changes yet.
+- Use `Continue` when `.da-vinci/` artifacts already exist and the workflow needs to resume.
+
+## Simple Redesign
 
 ```text
 $da-vinci use redesign-from-code to redesign this existing mobile app.
 
 Existing code is the behavior source of truth, not the layout truth.
 Preserve business logic, navigation, permissions, integrations, validations, and state transitions unless explicitly required otherwise.
-Inventory routes, screens, tabs, dialogs, bottom sheets, nested flows, and important states before broad Pencil work.
-Decompose complex screens into subpages, overlays, materially different states, and implementation surfaces.
+Inventory the current screens and important states before Pencil work.
 Use the Visual Assist preferences declared in DA-VINCI.md.
 Do not pass design checkpoint if the result is a skin-swap of the old UI, a generic card grid, or a weak mobile hierarchy.
 Persist project-local Pencil files under .da-vinci/designs/.
 ```
 
-When to switch to `intake` first:
+## Complex Redesign
 
-- the project has multiple truth sources
-- the UI stack is unclear
-- the redesign spans many modules and the first workflow prompt is hard to phrase
+```text
+$da-vinci use redesign-from-code to redesign this existing mobile app.
 
-`intake` variant:
+Existing code is the behavior source of truth, not the layout truth.
+Preserve business logic, navigation, permissions, integrations, validations, and state transitions unless explicitly required otherwise.
+Inventory activities, fragments, tabs, dialogs, bottom sheets, nested flows, overlays, and materially different states before broad Pencil work.
+Decompose complex screens into subpages, overlays, materially different states, and implementation surfaces.
+Use the Visual Assist preferences declared in DA-VINCI.md.
+Treat the resolved primary visual adapter as the first-pass design lead.
+State the resolved primary visual adapter explicitly in the log and name any requested adapters that are unavailable.
+Before the first anchor surface, write a visual thesis, content plan, and interaction thesis.
+Use Pencil guides only as layout constraints, not as the design direction.
+Do not start with broad multi-screen scaffolding.
+Design 1-3 anchor surfaces first, review screenshots, then expand.
+For each anchor surface, explain how the new composition differs structurally from the current layout.
+Do not treat screenshot analysis as an automatic pass if it reports hierarchy, spacing, clarity, or inconsistency issues.
+Use only Pencil-supported properties; do not use web-only props like flex or margin.
+Verify the registered project-local `.pen` file exists as a shell-visible file after the first Pencil write.
+Keep non-`.pen` workflow artifacts out of `.da-vinci/designs/`.
+Define shared primitives from the approved anchor surfaces before broad page expansion.
+Do not pass design checkpoint if the result is a skin-swap of the old UI, a generic card grid, repeated placeholder templates, or weak visual anchors.
+Persist project-local Pencil files under .da-vinci/designs/.
+```
+
+## Design-Only
 
 ```text
-$da-vinci use intake for this existing mobile app.
+$da-vinci use redesign-from-code to redesign this existing mobile app.
 
-I need to redesign the UI while preserving current behavior.
 Existing code is the behavior source of truth, not the layout truth.
-Inventory screens, tabs, dialogs, bottom sheets, nested flows, and important states.
-Decompose complex screens before Pencil work.
-Generate the best executable Da Vinci workflow prompt for the next step.
+Preserve current behavior and navigation.
+Inventory screens, tabs, dialogs, bottom sheets, nested flows, overlays, and important states.
+Decompose complex screens into real design surfaces before Pencil work.
+Use the Visual Assist preferences declared in DA-VINCI.md.
+If the app is complex, design 1-3 anchor surfaces first, review screenshots, then expand.
+Stop after DA-VINCI.md, design-registry.md, page-map.md, proposal.md, specs, design.md, pencil-design.md, pencil-bindings.md, and tasks.md.
+Do not start code changes yet.
+```
+
+## Continue
+
+```text
+$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.
+Keep the registered project-local Pencil source under .da-vinci/designs/ as the design source of truth.
+If the redesign is complex, keep the anchor-first flow until the design checkpoint passes.
+Continue into the next unfinished stage and do not stop at tasks.md when the active intent is full-delivery.
 ```
+
+## When To Switch To Intake First
+
+- the project has multiple truth sources
+- the UI stack is unclear
+- the first workflow prompt is still hard to phrase cleanly

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

@@ -10,37 +10,75 @@ Use this when the workflow needs:
 
 - split-pane or multi-column composition
 - orientation-aware design thinking
-- decomposition of tool surfaces, side regions, and overlays
-- treatment of both touch-first and canvas-first interaction patterns
+- clear decomposition of tool regions, side regions, and overlays
 
-Recommended prompt:
+## How To Choose
+
+- Use `Simple redesign` when the tablet surface is limited, mostly single-flow, or only lightly adapted from a phone layout.
+- Use `Complex redesign` when the product has split panes, orientation changes, expanded canvases, overlays, or many materially different surfaces.
+- Use `Design-only` when you want the design chain and bindings but no code changes yet.
+- Use `Continue` when the workflow already created artifacts and needs to resume.
+
+## Simple Redesign
 
 ```text
 $da-vinci use redesign-from-code to redesign this existing tablet product.
 
 Existing code is the behavior source of truth, not the layout truth.
-Preserve behavior, permissions, integrations, validations, and state transitions unless explicitly required otherwise.
-Inventory split-pane regions, sidebars, expanded canvases, dialogs, sheets, orientation-driven changes, and important states before broad Pencil work.
-Decompose complex pages into multi-region surfaces, overlays, materially different states, and implementation surfaces.
+Preserve current behavior, permissions, integrations, validations, and state transitions unless explicitly required otherwise.
+Inventory the current tablet surfaces and important states before Pencil work.
 Use the Visual Assist preferences declared in DA-VINCI.md.
 Do not pass design checkpoint if the result ignores tablet-scale composition or collapses into a stretched phone layout.
 Persist project-local Pencil files under .da-vinci/designs/.
 ```
 
-When to switch to `intake` first:
+## Complex Redesign
+
+```text
+$da-vinci use redesign-from-code to redesign this existing tablet product.
 
-- the product has both phone and tablet surfaces
-- orientation or multi-pane logic is complicated
-- the design references do not map cleanly to the real implementation surfaces
+Existing code is the behavior source of truth, not the layout truth.
+Preserve current behavior, permissions, integrations, validations, and state transitions unless explicitly required otherwise.
+Inventory split-pane regions, sidebars, expanded canvases, dialogs, sheets, orientation-driven changes, and materially different states before broad Pencil work.
+Decompose complex pages into multi-region surfaces, overlays, materially different states, and implementation surfaces.
+Use the Visual Assist preferences declared in DA-VINCI.md.
+Treat the resolved primary visual adapter as the first-pass design lead.
+Use Pencil guides only as tablet-layout constraints, not as the design direction.
+Do not start with broad multi-screen scaffolding.
+Design 1-3 anchor surfaces first, review screenshots, then expand.
+Do not pass design checkpoint if the result collapses into a stretched phone layout, repeated placeholders, or weak multi-region hierarchy.
+Persist project-local Pencil files under .da-vinci/designs/.
+```
 
-`intake` variant:
+## Design-Only
 
 ```text
-$da-vinci use intake for this existing tablet product.
+$da-vinci use redesign-from-code to redesign this existing tablet product.
 
-I need to redesign the UI while preserving current behavior.
 Existing code is the behavior source of truth, not the layout truth.
+Preserve current behavior, permissions, integrations, and state transitions.
 Inventory split-pane regions, sidebars, dialogs, sheets, orientation changes, and important states.
-Decompose complex pages before Pencil work.
-Generate the best executable Da Vinci workflow prompt for the next step.
+Decompose complex pages into real design surfaces before Pencil work.
+Use the Visual Assist preferences declared in DA-VINCI.md.
+If the product is complex, design 1-3 anchor surfaces first, review screenshots, then expand.
+Stop after DA-VINCI.md, design-registry.md, page-map.md, proposal.md, specs, design.md, pencil-design.md, pencil-bindings.md, and tasks.md.
+Do not start code changes yet.
+```
+
+## Continue
+
+```text
+$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.
+Keep the registered project-local Pencil source under .da-vinci/designs/ as the design source of truth.
+If the redesign is complex, continue from the approved anchor surfaces instead of restarting broad scaffolding.
+Continue into the next unfinished stage and do not stop at tasks.md when the active intent is full-delivery.
 ```
+
+## When To Switch To Intake First
+
+- the product mixes phone and tablet surfaces
+- orientation or multi-pane behavior complicates the first workflow request
+- the first prompt is still hard to phrase cleanly