@xenonbyte/da-vinci-workflow 0.1.20 → 0.1.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,17 @@
1
1
  # Changelog
2
2
 
3
+ ## v0.1.21 - 2026-03-29
4
+
5
+ ### Added
6
+ - `scripts/test-mode-consistency.js` coverage for `build` completion-audit discipline and `continue` build-recommendation gate behavior
7
+ - `scripts/test-pencil-session.js` coverage requiring live snapshot input for `pencil-session end` unless `--force` is used
8
+
9
+ ### Changed
10
+ - `da-vinci pencil-session end` now requires `--nodes-file` (and optional variables/version payload) unless `--force` is explicitly provided
11
+ - `build` prompts across Codex, Claude, and Gemini now treat compile success as non-terminal and require completion-audit pass before terminal completion claims
12
+ - `continue` prompts across Codex, Claude, and Gemini now block build recommendation while unresolved design gates exist
13
+ - command reference docs (English and Chinese) now reflect the stricter build/continue routing discipline and completion gate expectations
14
+
3
15
  ## v0.1.20 - 2026-03-29
4
16
 
5
17
  ### Added
package/README.md CHANGED
@@ -28,10 +28,14 @@ This workflow is intended for:
28
28
 
29
29
  Latest published npm package:
30
30
 
31
- - `@xenonbyte/da-vinci-workflow@0.1.20`
31
+ - `@xenonbyte/da-vinci-workflow@0.1.21`
32
32
 
33
33
  Release highlights:
34
34
 
35
+ - `da-vinci pencil-session end` now requires live snapshot input (`--nodes-file`) unless `--force` is used, preventing silent session close while live MCP and disk are out of sync
36
+ - `build` route discipline now treats compile success as non-terminal and requires `da-vinci audit --mode completion --change <change-id> <project-path>` before reporting terminal completion
37
+ - `continue` route guidance now blocks `build` recommendation whenever core design gates remain unresolved (missing project-local `.pen`, active session, runtime/design-source BLOCK, or required design-supervisor BLOCK)
38
+ - added regression coverage for session-end sync guards and prompt-level build/continue gate discipline
35
39
  - continue-routing and recovery guidance now consistently prioritize artifact/checkpoint truth first, with contextual deltas treated as auxiliary notes only
36
40
  - context-delta audit now uses tighter expectation signals, status-mismatch wording, and `supersedes` validation with timestamp normalization
37
41
  - context-delta expectation checks are now automatic for checkpoint-bearing artifacts and allow explicit opt-in (`Context Delta Required`) only for edge cases
@@ -133,32 +137,14 @@ Recommended default:
133
137
 
134
138
  ```md
135
139
  ## Visual Assist
136
- - Preferred adapters:
137
- - ui-ux-pro-max
138
- - frontend-skill
139
- - Design-supervisor reviewers:
140
- - frontend-skill
141
- - ui-ux-pro-max
142
- - Design-supervisor review mode:
143
- - screenshot-and-theme
144
- - Design-supervisor review inputs:
145
- - screenshots
146
- - pencil variables
147
- - visual thesis
148
- - content plan
149
- - interaction thesis
150
- - Scope:
151
- - visual contract refinement
152
- - page composition
153
- - hierarchy and spacing
154
- - anchor-surface composition
155
- - Pencil design refinement
156
- - Fallback:
157
- - native-da-vinci
158
- - Require Adapter:
159
- - false
160
- - Require Supervisor Review:
161
- - false
140
+ - Preferred adapters: ui-ux-pro-max, frontend-skill
141
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
142
+ - Design-supervisor review mode: screenshot-and-theme
143
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
144
+ - Scope: visual contract refinement, page composition, hierarchy and spacing, anchor-surface composition, Pencil design refinement
145
+ - Fallback: native-da-vinci
146
+ - Require Adapter: false
147
+ - Require Supervisor Review: false
162
148
  ```
163
149
 
164
150
  Use this when:
@@ -171,33 +157,14 @@ Quality-first redesign configuration:
171
157
 
172
158
  ```md
173
159
  ## Visual Assist
174
- - Preferred adapters:
175
- - frontend-skill
176
- - ui-ux-pro-max
177
- - Design-supervisor reviewers:
178
- - frontend-skill
179
- - ui-ux-pro-max
180
- - Design-supervisor review mode:
181
- - screenshot-and-theme
182
- - Design-supervisor review inputs:
183
- - screenshots
184
- - pencil variables
185
- - visual thesis
186
- - content plan
187
- - interaction thesis
188
- - Scope:
189
- - visual contract refinement
190
- - page composition
191
- - hierarchy and spacing
192
- - motion guidance
193
- - anchor-surface composition
194
- - Pencil design refinement
195
- - Fallback:
196
- - native-da-vinci
197
- - Require Adapter:
198
- - true
199
- - Require Supervisor Review:
200
- - true
160
+ - Preferred adapters: frontend-skill, ui-ux-pro-max
161
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
162
+ - Design-supervisor review mode: screenshot-and-theme
163
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
164
+ - Scope: visual contract refinement, page composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
165
+ - Fallback: native-da-vinci
166
+ - Require Adapter: true
167
+ - Require Supervisor Review: true
201
168
  ```
202
169
 
203
170
  Use this when:
package/README.zh-CN.md CHANGED
@@ -30,10 +30,14 @@ Da Vinci 是一个把产品需求一路推进到结构化规格、Pencil 设计
30
30
 
31
31
  最新已发布 npm 包:
32
32
 
33
- - `@xenonbyte/da-vinci-workflow@0.1.20`
33
+ - `@xenonbyte/da-vinci-workflow@0.1.21`
34
34
 
35
35
  已发布版本重点:
36
36
 
37
+ - `da-vinci pencil-session end` 现在默认要求提供 live 快照输入(`--nodes-file`);只有显式 `--force` 才允许跳过,避免 live MCP 与磁盘未同步时被静默关闭
38
+ - `build` 路由现在明确:编译成功不等于流程完成;对外宣布终态前必须通过 `da-vinci audit --mode completion --change <change-id> <project-path>`
39
+ - `continue` 的推荐规则现在会拦截未过设计门禁时的 `build` 选路(缺少项目内 `.pen`、session 未关闭、runtime/design-source BLOCK、required design-supervisor BLOCK)
40
+ - 新增回归测试覆盖:session 结束同步防护,以及 build/continue 提示词级门禁约束
37
41
  - `continue` 的选路与恢复规则现已统一:先看工件/checkpoint 真相,再把 Context Delta 当作辅助信息
38
42
  - Context Delta 审计规则已强化:触发信号更精确、告警改为状态不一致语义,并补充 `supersedes` 校验与时间归一化
39
43
  - checkpoint 相关工件默认自动启用 Context Delta 期望检查;只有少数无 checkpoint 标题的工件才需要显式 `Context Delta Required`
@@ -138,32 +142,14 @@ Da Vinci 当前支持五种模式:
138
142
 
139
143
  ```md
140
144
  ## Visual Assist
141
- - Preferred adapters:
142
- - ui-ux-pro-max
143
- - frontend-skill
144
- - Design-supervisor reviewers:
145
- - frontend-skill
146
- - ui-ux-pro-max
147
- - Design-supervisor review mode:
148
- - screenshot-and-theme
149
- - Design-supervisor review inputs:
150
- - screenshots
151
- - pencil variables
152
- - visual thesis
153
- - content plan
154
- - interaction thesis
155
- - Scope:
156
- - visual contract refinement
157
- - page composition
158
- - hierarchy and spacing
159
- - anchor-surface composition
160
- - Pencil design refinement
161
- - Fallback:
162
- - native-da-vinci
163
- - Require Adapter:
164
- - false
165
- - Require Supervisor Review:
166
- - false
145
+ - Preferred adapters: ui-ux-pro-max, frontend-skill
146
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
147
+ - Design-supervisor review mode: screenshot-and-theme
148
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
149
+ - Scope: visual contract refinement, page composition, hierarchy and spacing, anchor-surface composition, Pencil design refinement
150
+ - Fallback: native-da-vinci
151
+ - Require Adapter: false
152
+ - Require Supervisor Review: false
167
153
  ```
168
154
 
169
155
  适用场景:
@@ -176,33 +162,14 @@ Da Vinci 当前支持五种模式:
176
162
 
177
163
  ```md
178
164
  ## Visual Assist
179
- - Preferred adapters:
180
- - frontend-skill
181
- - ui-ux-pro-max
182
- - Design-supervisor reviewers:
183
- - frontend-skill
184
- - ui-ux-pro-max
185
- - Design-supervisor review mode:
186
- - screenshot-and-theme
187
- - Design-supervisor review inputs:
188
- - screenshots
189
- - pencil variables
190
- - visual thesis
191
- - content plan
192
- - interaction thesis
193
- - Scope:
194
- - visual contract refinement
195
- - page composition
196
- - hierarchy and spacing
197
- - motion guidance
198
- - anchor-surface composition
199
- - Pencil design refinement
200
- - Fallback:
201
- - native-da-vinci
202
- - Require Adapter:
203
- - true
204
- - Require Supervisor Review:
205
- - true
165
+ - Preferred adapters: frontend-skill, ui-ux-pro-max
166
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
167
+ - Design-supervisor review mode: screenshot-and-theme
168
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
169
+ - Scope: visual contract refinement, page composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
170
+ - Fallback: native-da-vinci
171
+ - Require Adapter: true
172
+ - Require Supervisor Review: true
206
173
  ```
207
174
 
208
175
  适用场景:
@@ -15,3 +15,9 @@ Focus on:
15
15
  During implementation:
16
16
  - run `execution checkpoint` after each top-level task group
17
17
  - update source artifacts before continuing if drift is found
18
+
19
+ Completion discipline:
20
+ - treat `BUILD SUCCESSFUL` as compile-only evidence, not workflow completion
21
+ - do not report `design complete` or `workflow complete` while in-scope task groups remain unfinished
22
+ - before any terminal completion claim, require `da-vinci audit --mode completion --change <change-id> <project-path>` to pass
23
+ - if completion audit fails, continue from the minimal unfinished stage instead of exiting
@@ -27,4 +27,5 @@ Route discipline:
27
27
  - do not default the user into `/dv:build` unless the project is clearly implementation-ready
28
28
  - if design artifacts exist but `tasks.md` does not, prefer a continuation prompt that moves into `/dv:tasks`
29
29
  - only prefer `/dv:build` once task generation and implementation readiness are already clear
30
+ - do not route into `/dv:build` when any design gate is unresolved: missing shell-visible project-local `.pen`, active/unclosed Pencil session, runtime/design-source checkpoint still BLOCK, or required design-supervisor review still BLOCK/unaccepted
30
31
  - continuation prompts should usually target the main workflow entry so Da Vinci can resume the full state machine
@@ -11,3 +11,7 @@ Implementation rules:
11
11
  - requirements decide behavior
12
12
  - Pencil decides presentation
13
13
  - run `execution checkpoint` after each top-level task group
14
+ - treat `BUILD SUCCESSFUL` as compile-only evidence, not workflow completion
15
+ - do not report `design complete` or `workflow complete` while in-scope task groups remain unfinished
16
+ - before any terminal completion claim, require `da-vinci audit --mode completion --change <change-id> <project-path>` to pass
17
+ - if completion audit fails, continue from the minimal unfinished stage instead of exiting
@@ -27,4 +27,5 @@ Route discipline:
27
27
  - do not default the user into `/prompts:dv-build` unless the project is clearly implementation-ready
28
28
  - if design artifacts exist but `tasks.md` does not, prefer a continuation prompt that moves into `/prompts:dv-tasks`
29
29
  - only prefer `/prompts:dv-build` once task generation and implementation readiness are already clear
30
+ - do not route into `/prompts:dv-build` when any design gate is unresolved: missing shell-visible project-local `.pen`, active/unclosed Pencil session, runtime/design-source checkpoint still BLOCK, or required design-supervisor review still BLOCK/unaccepted
30
31
  - continuation prompts should usually target the main workflow entry so Da Vinci can resume the full state machine
@@ -10,4 +10,8 @@ Implementation rules:
10
10
  - requirements decide behavior
11
11
  - Pencil decides presentation
12
12
  - run `execution checkpoint` after each top-level task group
13
+ - treat `BUILD SUCCESSFUL` as compile-only evidence, not workflow completion
14
+ - do not report `design complete` or `workflow complete` while in-scope task groups remain unfinished
15
+ - before any terminal completion claim, require `da-vinci audit --mode completion --change <change-id> <project-path>` to pass
16
+ - if completion audit fails, continue from the minimal unfinished stage instead of exiting
13
17
  """
@@ -26,5 +26,6 @@ Route discipline:
26
26
  - do not default the user into `/dv:build` unless the project is clearly implementation-ready
27
27
  - if design artifacts exist but `tasks.md` does not, prefer a continuation prompt that moves into `/dv:tasks`
28
28
  - only prefer `/dv:build` once task generation and implementation readiness are already clear
29
+ - do not route into `/dv:build` when any design gate is unresolved: missing shell-visible project-local `.pen`, active/unclosed Pencil session, runtime/design-source checkpoint still BLOCK, or required design-supervisor review still BLOCK/unaccepted
29
30
  - continuation prompts should usually target the main workflow entry so Da Vinci can resume the full state machine
30
31
  """
@@ -83,6 +83,7 @@ Important continuation rule:
83
83
  - it should not promote `build` as a co-equal next step yet
84
84
  - route selection should be derived from artifact and checkpoint truth before contextual deltas are consulted
85
85
  - if contextual deltas conflict with current artifacts, ignore those deltas for route selection and report the conflict
86
+ - do not route into `build` while design gates are unresolved: missing shell-visible project-local `.pen`, active/unclosed Pencil session, runtime or design-source checkpoint still `BLOCK`, or required design-supervisor review still `BLOCK`/unaccepted
86
87
 
87
88
  ### `/dv:breakdown`
88
89
 
@@ -154,6 +155,12 @@ Creates or updates:
154
155
 
155
156
  This is the execution stage.
156
157
 
158
+ Completion discipline:
159
+
160
+ - treat `BUILD SUCCESSFUL` as compile-only evidence
161
+ - do not claim `design complete` or `workflow complete` while in-scope task groups remain
162
+ - run `da-vinci audit --mode completion --change <change-id> <project-path>` before any terminal completion claim
163
+
157
164
  ### `/dv:verify`
158
165
 
159
166
  Use when:
@@ -46,33 +46,14 @@ Recommended shape:
46
46
 
47
47
  ```md
48
48
  ## Visual Assist
49
- - Preferred adapters:
50
- - frontend-skill
51
- - ui-ux-pro-max
52
- - Design-supervisor reviewers:
53
- - frontend-skill
54
- - ui-ux-pro-max
55
- - Design-supervisor review mode:
56
- - screenshot-and-theme
57
- - Design-supervisor review inputs:
58
- - screenshots
59
- - pencil variables
60
- - visual thesis
61
- - content plan
62
- - interaction thesis
63
- - Scope:
64
- - visual contract refinement
65
- - page composition
66
- - hierarchy and spacing
67
- - motion guidance
68
- - anchor-surface composition
69
- - Pencil design refinement
70
- - Fallback:
71
- - native-da-vinci
72
- - Require Adapter:
73
- - false
74
- - Require Supervisor Review:
75
- - false
49
+ - Preferred adapters: frontend-skill, ui-ux-pro-max
50
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
51
+ - Design-supervisor review mode: screenshot-and-theme
52
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
53
+ - Scope: visual contract refinement, page composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
54
+ - Fallback: native-da-vinci
55
+ - Require Adapter: false
56
+ - Require Supervisor Review: false
76
57
  ```
77
58
 
78
59
  Use `Require Adapter: true` only when the workflow must stop if the preferred adapter is unavailable locally.
@@ -83,32 +64,14 @@ Balanced default:
83
64
 
84
65
  ```md
85
66
  ## Visual Assist
86
- - Preferred adapters:
87
- - ui-ux-pro-max
88
- - frontend-skill
89
- - Design-supervisor reviewers:
90
- - frontend-skill
91
- - ui-ux-pro-max
92
- - Design-supervisor review mode:
93
- - screenshot-and-theme
94
- - Design-supervisor review inputs:
95
- - screenshots
96
- - pencil variables
97
- - visual thesis
98
- - content plan
99
- - interaction thesis
100
- - Scope:
101
- - visual contract refinement
102
- - page composition
103
- - hierarchy and spacing
104
- - anchor-surface composition
105
- - Pencil design refinement
106
- - Fallback:
107
- - native-da-vinci
108
- - Require Adapter:
109
- - false
110
- - Require Supervisor Review:
111
- - false
67
+ - Preferred adapters: ui-ux-pro-max, frontend-skill
68
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
69
+ - Design-supervisor review mode: screenshot-and-theme
70
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
71
+ - Scope: visual contract refinement, page composition, hierarchy and spacing, anchor-surface composition, Pencil design refinement
72
+ - Fallback: native-da-vinci
73
+ - Require Adapter: false
74
+ - Require Supervisor Review: false
112
75
  ```
113
76
 
114
77
  Use this when:
@@ -120,33 +83,14 @@ Quality-first redesign:
120
83
 
121
84
  ```md
122
85
  ## Visual Assist
123
- - Preferred adapters:
124
- - frontend-skill
125
- - ui-ux-pro-max
126
- - Design-supervisor reviewers:
127
- - frontend-skill
128
- - ui-ux-pro-max
129
- - Design-supervisor review mode:
130
- - screenshot-and-theme
131
- - Design-supervisor review inputs:
132
- - screenshots
133
- - pencil variables
134
- - visual thesis
135
- - content plan
136
- - interaction thesis
137
- - Scope:
138
- - visual contract refinement
139
- - page composition
140
- - hierarchy and spacing
141
- - motion guidance
142
- - anchor-surface composition
143
- - Pencil design refinement
144
- - Fallback:
145
- - native-da-vinci
146
- - Require Adapter:
147
- - true
148
- - Require Supervisor Review:
149
- - false
86
+ - Preferred adapters: frontend-skill, ui-ux-pro-max
87
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
88
+ - Design-supervisor review mode: screenshot-and-theme
89
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
90
+ - Scope: visual contract refinement, page composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
91
+ - Fallback: native-da-vinci
92
+ - Require Adapter: true
93
+ - Require Supervisor Review: false
150
94
  ```
151
95
 
152
96
  Use this when:
@@ -21,20 +21,10 @@ Use when:
21
21
 
22
22
  ```md
23
23
  ## Visual Assist
24
- - Preferred adapters:
25
- - ui-ux-pro-max
26
- - frontend-skill
27
- - Scope:
28
- - visual contract refinement
29
- - workspace composition
30
- - hierarchy and spacing
31
- - motion guidance
32
- - anchor-surface composition
33
- - Pencil design refinement
34
- - Fallback:
35
- - native-da-vinci
36
- - Require Adapter:
37
- - false
24
+ - Preferred adapters: ui-ux-pro-max, frontend-skill
25
+ - Scope: visual contract refinement, workspace composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
26
+ - Fallback: native-da-vinci
27
+ - Require Adapter: false
38
28
  ```
39
29
 
40
30
  ### Variant 2: Advisory Supervisor Review
@@ -46,33 +36,14 @@ Use when:
46
36
 
47
37
  ```md
48
38
  ## Visual Assist
49
- - Preferred adapters:
50
- - ui-ux-pro-max
51
- - frontend-skill
52
- - Design-supervisor reviewers:
53
- - frontend-skill
54
- - ui-ux-pro-max
55
- - Design-supervisor review mode:
56
- - screenshot-and-theme
57
- - Design-supervisor review inputs:
58
- - screenshots
59
- - pencil variables
60
- - visual thesis
61
- - content plan
62
- - interaction thesis
63
- - Scope:
64
- - visual contract refinement
65
- - workspace composition
66
- - hierarchy and spacing
67
- - motion guidance
68
- - anchor-surface composition
69
- - Pencil design refinement
70
- - Fallback:
71
- - native-da-vinci
72
- - Require Adapter:
73
- - false
74
- - Require Supervisor Review:
75
- - false
39
+ - Preferred adapters: ui-ux-pro-max, frontend-skill
40
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
41
+ - Design-supervisor review mode: screenshot-and-theme
42
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
43
+ - Scope: visual contract refinement, workspace composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
44
+ - Fallback: native-da-vinci
45
+ - Require Adapter: false
46
+ - Require Supervisor Review: false
76
47
  ```
77
48
 
78
49
  ### Variant 3: Required Supervisor Signoff
@@ -85,33 +56,14 @@ Use when:
85
56
 
86
57
  ```md
87
58
  ## Visual Assist
88
- - Preferred adapters:
89
- - frontend-skill
90
- - ui-ux-pro-max
91
- - Design-supervisor reviewers:
92
- - frontend-skill
93
- - ui-ux-pro-max
94
- - Design-supervisor review mode:
95
- - screenshot-and-theme
96
- - Design-supervisor review inputs:
97
- - screenshots
98
- - pencil variables
99
- - visual thesis
100
- - content plan
101
- - interaction thesis
102
- - Scope:
103
- - visual contract refinement
104
- - workspace composition
105
- - hierarchy and spacing
106
- - motion guidance
107
- - anchor-surface composition
108
- - Pencil design refinement
109
- - Fallback:
110
- - native-da-vinci
111
- - Require Adapter:
112
- - true
113
- - Require Supervisor Review:
114
- - true
59
+ - Preferred adapters: frontend-skill, ui-ux-pro-max
60
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
61
+ - Design-supervisor review mode: screenshot-and-theme
62
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
63
+ - Scope: visual contract refinement, workspace composition, hierarchy and spacing, motion guidance, anchor-surface composition, Pencil design refinement
64
+ - Fallback: native-da-vinci
65
+ - Require Adapter: true
66
+ - Require Supervisor Review: true
115
67
  ```
116
68
 
117
69
  Notes for all variants:
@@ -21,20 +21,10 @@ Use when:
21
21
 
22
22
  ```md
23
23
  ## Visual Assist
24
- - Preferred adapters:
25
- - ui-ux-pro-max
26
- - frontend-skill
27
- - Scope:
28
- - visual contract refinement
29
- - mobile page composition
30
- - hierarchy and spacing
31
- - touch-first motion guidance
32
- - anchor-surface composition
33
- - Pencil design refinement
34
- - Fallback:
35
- - native-da-vinci
36
- - Require Adapter:
37
- - false
24
+ - Preferred adapters: ui-ux-pro-max, frontend-skill
25
+ - Scope: visual contract refinement, mobile page composition, hierarchy and spacing, touch-first motion guidance, anchor-surface composition, Pencil design refinement
26
+ - Fallback: native-da-vinci
27
+ - Require Adapter: false
38
28
  ```
39
29
 
40
30
  ### Variant 2: Advisory Supervisor Review
@@ -47,33 +37,14 @@ Use when:
47
37
 
48
38
  ```md
49
39
  ## Visual Assist
50
- - Preferred adapters:
51
- - ui-ux-pro-max
52
- - frontend-skill
53
- - Design-supervisor reviewers:
54
- - frontend-skill
55
- - ui-ux-pro-max
56
- - Design-supervisor review mode:
57
- - screenshot-and-theme
58
- - Design-supervisor review inputs:
59
- - screenshots
60
- - pencil variables
61
- - visual thesis
62
- - content plan
63
- - interaction thesis
64
- - Scope:
65
- - visual contract refinement
66
- - mobile page composition
67
- - hierarchy and spacing
68
- - touch-first motion guidance
69
- - anchor-surface composition
70
- - Pencil design refinement
71
- - Fallback:
72
- - native-da-vinci
73
- - Require Adapter:
74
- - false
75
- - Require Supervisor Review:
76
- - false
40
+ - Preferred adapters: ui-ux-pro-max, frontend-skill
41
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
42
+ - Design-supervisor review mode: screenshot-and-theme
43
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
44
+ - Scope: visual contract refinement, mobile page composition, hierarchy and spacing, touch-first motion guidance, anchor-surface composition, Pencil design refinement
45
+ - Fallback: native-da-vinci
46
+ - Require Adapter: false
47
+ - Require Supervisor Review: false
77
48
  ```
78
49
 
79
50
  ### Variant 3: Required Supervisor Signoff
@@ -86,33 +57,14 @@ Use when:
86
57
 
87
58
  ```md
88
59
  ## Visual Assist
89
- - Preferred adapters:
90
- - frontend-skill
91
- - ui-ux-pro-max
92
- - Design-supervisor reviewers:
93
- - frontend-skill
94
- - ui-ux-pro-max
95
- - Design-supervisor review mode:
96
- - screenshot-and-theme
97
- - Design-supervisor review inputs:
98
- - screenshots
99
- - pencil variables
100
- - visual thesis
101
- - content plan
102
- - interaction thesis
103
- - Scope:
104
- - visual contract refinement
105
- - mobile page composition
106
- - hierarchy and spacing
107
- - touch-first motion guidance
108
- - anchor-surface composition
109
- - Pencil design refinement
110
- - Fallback:
111
- - native-da-vinci
112
- - Require Adapter:
113
- - true
114
- - Require Supervisor Review:
115
- - true
60
+ - Preferred adapters: frontend-skill, ui-ux-pro-max
61
+ - Design-supervisor reviewers: frontend-skill, ui-ux-pro-max
62
+ - Design-supervisor review mode: screenshot-and-theme
63
+ - Design-supervisor review inputs: screenshots, pencil variables, visual thesis, content plan, interaction thesis
64
+ - Scope: visual contract refinement, mobile page composition, hierarchy and spacing, touch-first motion guidance, anchor-surface composition, Pencil design refinement
65
+ - Fallback: native-da-vinci
66
+ - Require Adapter: true
67
+ - Require Supervisor Review: true
116
68
  ```
117
69
 
118
70
  Notes for all variants: