dreative 0.4.0 → 0.5.0

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.
@@ -1,143 +1,201 @@
1
- # Dreative Plan Mode — decide everything before the first line of code
2
-
3
- Run this protocol at the start of ANY non-trivial Mode A request (new page/site,
4
- redesign at rung 2+, any request implying motion/3d/immersive/cinematic/media, or
5
- "make it amazing/like <reference>"). Skip it only for trivial single-element
6
- restyles and rung-1 token refreshes — and even then run §1's capability probe
7
- once per session. The failure this file prevents: jumping into code with half a
8
- brief, discovering mid-build that media/tools/structure are missing, and shipping
9
- a page that is 60% of what the user actually wanted.
10
-
11
- Plan Mode is ONE planning pass ONE structured question round a written plan
12
- execution in the plan's order. Never turn it into a long interview; the user
13
- answers once and you build.
14
-
15
- ## 1. Capability probe (before proposing anything)
16
-
17
- Enumerate what your environment can actually produce, and write the result down
18
- (one line per capability in the plan file, §4). Check for:
19
-
20
- - **Image generation** — an image-gen tool/MCP, or a CLI that produces images.
21
- - **Video generation** a video-gen tool/MCP (seamless loops, image-to-video).
22
- - **Browser tools** screenshot + console + interaction (needed for the
23
- verification protocol; note it if absent).
24
- - **Asset tooling** — anything for compression/conversion (ffmpeg on PATH,
25
- sharp/squoosh in the project) for posters, loops, and frame sequences.
26
-
27
- Rules:
28
- - Probe by LOOKING (list your tools, `which ffmpeg`, check MCP config), never by
29
- assuming. A capability you didn't verify doesn't exist.
30
- - If a capability is missing but the design clearly wants it (e.g. a cinematic
31
- brief with no video-gen), include an **offer to install** in the question round
32
- (§3): name the concrete option (an MCP server the user can add, or
33
- falling back to generated stills / pre-rendered loops from image sequences)
34
- and let the user decide. Never install tools silently; never silently degrade
35
- either the user must know the fancy version was available.
36
- - The probe result changes the blueprint: no video-gen → hero loops become
37
- generated stills + ken-burns or a shader surface; no browser tools → the
38
- verification protocol's manual fallback (SKILL.md) must be declared up front.
39
-
40
- ## 2. The blueprint (section-by-section, media-first)
41
-
42
- Draft the page as a compact table BEFORE asking anything the question round
43
- presents choices about a concrete plan, not abstractions. Per section:
44
-
45
- | section | layout family | media plan | motion treatment | interaction | fallback |
46
-
47
- - **media plan** one of: `generate-image` (subject + exact aspect + palette/
48
- light-temperature prompt notes), `generate-video` (loop subject, 5-10s,
49
- seamless), `generate-sequence` (N frames for scroll scrub), `real-asset`
50
- (exists in repo / user must supply — name it), `none`. Media enters through
51
- the motion system per `skills/media.md` — name the treatment (curtain reveal,
52
- mask-shaped, hover-woken, media-plane distortion…), never "add an image".
53
- - **motion treatment** from motion.md/immersive.md/cinematic.md vocabulary,
54
- with the dial-appropriate ambition (motion.md §9 inventory is the target).
55
- - **fallback** for every ambitious cell (WebGL, sim, scrubbed sequence,
56
- generated video), the concrete boring version that ships if the fancy one
57
- fails runtime verification. A plan cell without a fallback is not ambitious,
58
- it's fragile.
59
-
60
- Plus four page-level lines: register + design read (DESIGN.md §2), signature
61
- element, animation stack (ONE system: GSAP+Lenis or motion/reactmotion.md §0),
62
- and the mobile strategy per ambitious effect (DESIGN.md §13).
63
-
64
- ## 3. The question round (one AskUserQuestion call, ≤4 questions)
65
-
66
- Bundle EVERYTHING the user must decide into one structured round (multi-select
67
- where choices stack). The pool below holds more than 4 questions — pick the
68
- ones the request leaves genuinely open, most-decision-changing first; skip any
69
- the request already answers. Structured tools always offer an "Other" free-text
70
- option, so every question doubles as a remarks channel and the round's last
71
- question should explicitly invite extra direction.
72
-
73
- 1. **Depth** (redesigns of existing code only) — the §11 transformation-depth
74
- ladder: restyle / re-layout / restructure / reimagine.
75
- 2. **Treatments** (multi-select) — the specialist skills with one-line plain
76
- descriptions, obvious ones marked "(Recommended)":
77
- motion · interaction · 3d · immersive · cinematic · refined · media
78
- (generated images/video woven into the motion system) · ux (make every
79
- control, form, and state actually work recommended by default) · mobile
80
- (first-class phone experience, calmer but equally crafted) · none.
81
- 3. **Generated media** the concrete offer from your probe: e.g. "Generate a
82
- hero video loop + 4 section images (Recommended)" / "Images only" /
83
- "Placeholders, I'll supply assets". If a needed tool is missing, this is
84
- where the install offer goes ("I can add <X> MCP for video generation — ok?").
85
- 4. **Ambition tier** — safe (clean + light motion) / expressive (full motion.md
86
- dial 7-8 inventory) / award-site (dial 9-10, immersive/cinematic
87
- architecture). State the cost honestly: higher tiers mean heavier builds and
88
- a mandatory runtime verification pass.
89
- 5. **References** "Do you have a reference a website you love, a
90
- screenshot, a brand whose feel to chase?" Options like: paste a URL /
91
- attach screenshots / "surprise meinvent it from the brand" / match the
92
- existing brand. When a URL or image arrives, actually study it before
93
- designing (SKILL.md's references rule: fetch the site / read the image,
94
- distill what specifically to borrow palette, type feel, layout family,
95
- motion cues never guess a named site from memory).
96
- 6. **Vibe & audience** (when the brief is thin) — 3-4 contrasting directions
97
- as options, each a one-line register + palette + energy sketch ("quiet
98
- luxury: bone, near-black serif, almost no motion" vs "electric launch:
99
- drenched color, kinetic type"), plus who the page must convince (buyers /
100
- investors / recruiters / fans). This seeds DESIGN.md §2's design read.
101
- 7. **Scope & priorities** (multi-page or vague requests)which pages/flows
102
- matter most, what's in this pass vs later, and any hard constraints
103
- (existing brand tokens to keep, CMS/content that must survive, deadline
104
- implying the safe tier).
105
- 8. **Final remarks** close the round with an open catch-all: "Anything else
106
- I should know or you'd love to seespecific effects, colors you hate,
107
- sections to add or kill?" Options: "no, go build" / "yes (write it in
108
- Other)". Everything written here lands verbatim in the plan file and is
109
- honored like the brief.
110
-
111
- Cap at 4 per round: depth/treatments/media/references usually win; fold
112
- ambition into treatments' recommendations when crowded, and vibe/scope into
113
- the blueprint you present for approval. Never re-ask in later rounds;
114
- ambiguity discovered mid-build resolves by the plan's spirit + doctrine
115
- defaults.
116
-
117
- ## 4. Write the plan, then execute it
118
-
119
- Persist the approved plan to `.dreative/plan.md` (or the scratchpad if
120
- `.dreative/` doesn't exist): capability manifest, every answer verbatim
121
- (including references studied — with the distilled borrow-list — and all
122
- free-text remarks), blueprint table, stack, mobile strategy, fallbacks. Long sessions lose context; the plan file is
123
- the re-entry point re-read it instead of re-deciding.
124
-
125
- **Execution order (always):**
126
-
127
- 1. **Assets first.** Generate every planned image/video/sequence NOW, at the
128
- blueprint's aspect ratios, graded to the palette (media.md §1). Sections get
129
- designed around real assets, not around placeholders that "will be swapped".
130
- 2. **Foundation.** Install and WIRE the animation stack (motion.md §8), fonts,
131
- tokens, providers before any section code.
132
- 3. **Sections** in blueprint order, each honoring its row (skills tagged per
133
- section apply to that section).
134
- 4. **Effects + choreography** across sections (page-level timelines, transitions,
135
- the signature element).
136
- 5. **Verification** — the full runtime protocol (SKILL.md self-critique +
137
- runtime gates). Any effect that fails gets its planned fallback, and the
138
- final report says so: "shipped the §2 fallback for X because Y".
139
-
140
- Report against the plan when done: each blueprint row shipped / fallback /
141
- cut (with reason), plus the motion inventory (motion.md §9) and the preservation
142
- ledger when §11 applies. A build that silently diverges from its approved plan
143
- is a bug even when it looks good.
1
+ # Dreative Plan Mode — decide everything before the first line of code
2
+
3
+ This skill is for **drastic change** a section, a page, or the whole site being
4
+ meaningfully redesigned or built. It is not for button tweaks or single-token
5
+ nudges unless the user explicitly invokes it for one.
6
+
7
+ **The plan gate (ask EVERY time).** At the start of ANY Mode A request in scope,
8
+ your FIRST action is one structured question: **"Plan it first, or build
9
+ directly?"** with "Plan first (Recommended)" as the leading option. Say plainly
10
+ why plan wins: you'll probe capabilities, agree on treatments/media/mockups up
11
+ front, and the result lands far closer to what they wanted on the first build.
12
+ "Build directly" skips to DESIGN.md + doctrine defaults. Never silently skip the
13
+ gate even a request that looks simple gets asked; only skip when the user
14
+ already said "no plan / just do it" this session. When plan is accepted, run the
15
+ protocol below.
16
+
17
+ The failure this file prevents: jumping into code with half a brief, discovering
18
+ mid-build that media/tools/structure are missing, and shipping a page that is
19
+ 60% of what the user actually wanted.
20
+
21
+ Plan Mode is ONE planning pass ONE structured question round → a written plan
22
+ (optional) mockups for approval execution in the plan's order. Never turn it
23
+ into a long interview; the user answers once and you build.
24
+
25
+ ## 1. Capability probe (before proposing anything)
26
+
27
+ Enumerate what your environment can actually produce, and write the result down
28
+ (one line per capability in the plan file, §4). Check for:
29
+
30
+ - **Image generation** an image-gen tool/MCP, or a CLI that produces images.
31
+ - **Video generation** — a video-gen tool/MCP (seamless loops, image-to-video).
32
+ - **Browser tools** screenshot + console + interaction (needed for the
33
+ verification protocol; note it if absent).
34
+ - **Asset tooling** anything for compression/conversion (ffmpeg on PATH,
35
+ sharp/squoosh in the project) for posters, loops, and frame sequences.
36
+
37
+ Rules:
38
+ - Probe by LOOKING (list your tools, `which ffmpeg`, check MCP config), never by
39
+ assuming. A capability you didn't verify doesn't exist.
40
+ - If a capability is missing but the design clearly wants it (e.g. a cinematic
41
+ brief with no video-gen), include an **offer to install** in the question round
42
+ (§3): name the concrete option (an MCP server the user can add, or
43
+ falling back to generated stills / pre-rendered loops from image sequences)
44
+ and let the user decide. Never install tools silently; never silently degrade
45
+ either the user must know the fancy version was available.
46
+ - The probe result changes the blueprint: no video-gen → hero loops become
47
+ generated stills + ken-burns or a shader surface; no browser tools the
48
+ verification protocol's manual fallback (SKILL.md) must be declared up front.
49
+
50
+ ## 2. The blueprint (section-by-section, media-first)
51
+
52
+ Draft the page as a compact table BEFORE asking anything — the question round
53
+ presents choices about a concrete plan, not abstractions. Per section:
54
+
55
+ | section | layout family | media plan | motion treatment | interaction | fallback |
56
+
57
+ - **media plan** one of: `generate-image` (subject + exact aspect + palette/
58
+ light-temperature prompt notes), `generate-video` (loop subject, 5-10s,
59
+ seamless), `generate-sequence` (N frames for scroll scrub), `real-asset`
60
+ (exists in repo / user must supply name it), `none`. Media enters through
61
+ the motion system per `skills/media.md`name the treatment (curtain reveal,
62
+ mask-shaped, hover-woken, media-plane distortion…), never "add an image".
63
+ - **motion treatment** — from motion.md/immersive.md/cinematic.md vocabulary,
64
+ with the dial-appropriate ambition (motion.md §9 inventory is the target).
65
+ - **fallback** — for every ambitious cell (WebGL, sim, scrubbed sequence,
66
+ generated video), the concrete boring version that ships if the fancy one
67
+ fails runtime verification. A plan cell without a fallback is not ambitious,
68
+ it's fragile.
69
+
70
+ Plus four page-level lines: register + design read (DESIGN.md §2), signature
71
+ element, animation stack (ONE system: GSAP+Lenis or motion/react — motion.md §0),
72
+ and the mobile strategy per ambitious effect (DESIGN.md §13).
73
+
74
+ ## 3. The question round (one AskUserQuestion call, ≤4 questions)
75
+
76
+ Bundle EVERYTHING the user must decide into one structured round (multi-select
77
+ where choices stack). The pool below holds more than 4 questions pick the
78
+ ones the request leaves genuinely open, most-decision-changing first; skip any
79
+ the request already answers. Structured tools always offer an "Other" free-text
80
+ option, so every question doubles as a remarks channel — and the round's last
81
+ question should explicitly invite extra direction.
82
+
83
+ 1. **Depth** (redesigns of existing code only) the §11 transformation-depth
84
+ ladder: restyle / re-layout / restructure / reimagine.
85
+ 2. **Treatments** (multi-select) the specialist skills with one-line plain
86
+ descriptions, obvious ones marked "(Recommended)":
87
+ motion · interaction · 3d · immersive · cinematic · refined · media
88
+ (generated images/video woven into the motion system) · ux (make every
89
+ control, form, and state actually workrecommended by default) · mobile
90
+ (first-class phone experience, calmer but equally crafted) · none.
91
+ 3. **Media & asset types** (multi-select) offer every asset class the probe
92
+ found tools for, and let choices stack: `generated images` · `generated
93
+ video loops` · `custom 3D` (real models/geometry, textures, and shaders
94
+ built in code top-tier 3D sites are made of custom 3D assets, not
95
+ wallpaper images behind a canvas) · `real assets` (in repo / user supplies)
96
+ · `placeholders only`. Mark the probe-backed recommendation "(Recommended)".
97
+ **State the cost honestly: image/video generation is token-intensive** say
98
+ roughly how many assets the blueprint wants and that each costs real
99
+ tokens/time, so "images only" or "placeholders" is a legitimate budget
100
+ choice, not a downgrade. If a needed tool is missing, this is where the
101
+ install offer goes ("I can add <X> MCP for video generation ok?").
102
+ 4. **Ambition tier** safe (clean + light motion) / expressive (full motion.md
103
+ dial 7-8 inventory) / award-site (dial 9-10, immersive/cinematic
104
+ architecture). State the cost honestly: higher tiers mean heavier builds and
105
+ a mandatory runtime verification pass.
106
+ 5. **References** "Do you have a referencea website you love, a
107
+ screenshot, a brand whose feel to chase?" Options like: paste a URL /
108
+ attach screenshots / "surprise me invent it from the brand" / match the
109
+ existing brand. When a URL or image arrives, actually study it before
110
+ designing (SKILL.md's references rule: fetch the site / read the image,
111
+ distill what specifically to borrow palette, type feel, layout family,
112
+ motion cues never guess a named site from memory).
113
+ 6. **Vibe & audience** (when the brief is thin) — 3-4 contrasting directions
114
+ as options, each a one-line register + palette + energy sketch ("quiet
115
+ luxury: bone, near-black serif, almost no motion" vs "electric launch:
116
+ drenched color, kinetic type"), plus who the page must convince (buyers /
117
+ investors / recruiters / fans). This seeds DESIGN.md §2's design read.
118
+ 7. **Scope & priorities** (multi-page or vague requests) — which pages/flows
119
+ matter most, what's in this pass vs later, and any hard constraints
120
+ (existing brand tokens to keep, CMS/content that must survive, deadline
121
+ implying the safe tier).
122
+ 8. **Mockups first?** offer to build 1:1 mockups BEFORE the full build:
123
+ "Mockup the key pages first (Recommended for big changes)" / "Straight to
124
+ build". If yes, execute §4b before touching real code.
125
+ 9. **Final remarks** — close the round with an open catch-all: "Anything else
126
+ I should know or you'd love to see — specific effects, colors you hate,
127
+ sections to add or kill?" Options: "no, go build" / "yes (write it in
128
+ Other)". Everything written here lands verbatim in the plan file and is
129
+ honored like the brief.
130
+
131
+ Cap at 4 per round: depth/treatments/media/mockups usually win; fold
132
+ ambition into treatments' recommendations when crowded, and vibe/scope into
133
+ the blueprint you present for approval. Never re-ask in later rounds;
134
+ ambiguity discovered mid-build resolves by the plan's spirit + doctrine
135
+ defaults.
136
+
137
+ ### Calibration references (what the top tiers actually look like)
138
+
139
+ When the user picks award-site ambition or 3d/immersive/cinematic treatments,
140
+ these are the bar (fetch and study whichever is closest before designing):
141
+
142
+ - https://www.experiencethebestyou.com/en-GB/ coordinated scroll choreography
143
+ + heavy custom 3D/motion throughout.
144
+ - https://unseen.co/projects/contra/ and https://unseen.co/projects/letter/ —
145
+ WebGL media planes, shader transitions, kinetic type.
146
+ - https://25residences.com/ — luxury real-estate register, cinematic pacing.
147
+
148
+ Common thread: their 3D is **custom models, textures, and shaders**, not
149
+ generated wallpapers behind text. If the environment has 3D-capable tooling and
150
+ the user opted in, build real 3D material (geometry, materials, lighting,
151
+ shader surfaces per `skills/3d.md`); reserve generated images/video for what
152
+ 3D can't do. This tier only happens when the user explicitly chose it in the
153
+ question round — never impose it.
154
+
155
+ ## 4. Write the plan, then execute it
156
+
157
+ Persist the approved plan to `.dreative/plan.md` (or the scratchpad if
158
+ `.dreative/` doesn't exist): capability manifest, every answer verbatim
159
+ (including references studied — with the distilled borrow-list — and all
160
+ free-text remarks), blueprint table, stack, mobile strategy, fallbacks. Long sessions lose context; the plan file is
161
+ the re-entry point — re-read it instead of re-deciding.
162
+
163
+ ## 4b. Mockups (when the user opted in)
164
+
165
+ Pick the page(s) with the **biggest/most important planned change** (usually
166
+ 1–2; the blueprint tells you which). For each, build a mockup that is a **1:1
167
+ replica of exactly what the full build would produce** — same stack, same
168
+ markup structure, same type/color/spacing, same motion and effects actually
169
+ running (real GSAP/Lenis/three.js code, not a note saying "animation here").
170
+ It is built for VISUAL judgment, not function: strip data fetching, handlers,
171
+ and routing to representative literals — like SKILL.md's replica/design-page
172
+ files (single file, default export, self-contained). The rule is: what the
173
+ user sees in the mockup is what they'd see in the shipped page; nothing in the
174
+ mockup that the build wouldn't do, nothing in the build's look that the mockup
175
+ hides.
176
+
177
+ Write mockups to `.dreative/mockups/<page>.tsx` (or the scratchpad), serve or
178
+ screenshot them for the user, and ask one approval question: approve / tweak
179
+ (what) / rethink. Approved mockups become the source of truth — the full build
180
+ replicates them exactly and extends the system to the remaining pages. Fold
181
+ tweak feedback into the plan file before building.
182
+
183
+ **Execution order (always):**
184
+
185
+ 1. **Assets first.** Generate every planned image/video/sequence NOW, at the
186
+ blueprint's aspect ratios, graded to the palette (media.md §1). Sections get
187
+ designed around real assets, not around placeholders that "will be swapped".
188
+ 2. **Foundation.** Install and WIRE the animation stack (motion.md §8), fonts,
189
+ tokens, providers — before any section code.
190
+ 3. **Sections** in blueprint order, each honoring its row (skills tagged per
191
+ section apply to that section).
192
+ 4. **Effects + choreography** across sections (page-level timelines, transitions,
193
+ the signature element).
194
+ 5. **Verification** — the full runtime protocol (SKILL.md self-critique +
195
+ runtime gates). Any effect that fails gets its planned fallback, and the
196
+ final report says so: "shipped the §2 fallback for X because Y".
197
+
198
+ Report against the plan when done: each blueprint row → shipped / fallback /
199
+ cut (with reason), plus the motion inventory (motion.md §9) and the preservation
200
+ ledger when §11 applies. A build that silently diverges from its approved plan
201
+ is a bug even when it looks good.
@@ -1,13 +1,13 @@
1
1
  ---
2
2
  name: dreative
3
- description: Frontend design skill + optional visual round-trip editor. Use for ANY frontend design work — redesign/restyle/build pages, landing pages, animations, motion, 3D, micro-interactions, "make my UI look good" — and for visual editing when the user says "open dreative" or "let me edit the layout visually". Default is direct design: apply the design doctrine straight to the codebase. The browser editor (extract → wireframes → edit → apply diff) is an optional mode the user can ask for.
3
+ description: Frontend design skill + optional visual round-trip editor. Use for DRASTIC frontend change — redesign/restructure/build a section, a page, or the whole site; landing pages; animations, motion, 3D, micro-interactions; "make my UI look good" — and for visual editing when the user says "open dreative" or "let me edit the layout visually". NOT for micro-tweaks (a button color, one label) unless the user explicitly invokes it. Default is direct design: apply the design doctrine straight to the codebase, after offering Plan Mode. The browser editor (extract → wireframes → edit → apply diff) is an optional mode the user can ask for.
4
4
  ---
5
5
 
6
6
  # Dreative — frontend design skill (+ optional visual editor)
7
7
 
8
8
  You (the coding agent) are the intelligence. Dreative has **two modes**:
9
9
 
10
- - **Mode A — Direct design (default).** The user asks you to design, redesign, restyle, animate, or build UI. For any non-trivial request, FIRST run Plan Mode per `PLAN.md` (same folder): probe your environment's capabilities (image-gen, video-gen, browser tools), draft a section-by-section blueprint with a media plan and fallbacks, bundle every user decision into one structured question round, persist the approved plan, then execute assets-first. Read `DESIGN.md` (and any specialist `skills/<name>.md` the plan calls for), then design/edit the real code directly. No server, no extraction, no wireframes. When you finish, add one closing note: *"Tip: run `dreative start` / say 'open dreative' if you want to tweak this visually — I'll extract the pages into an editable canvas."* That's the only place the editor should come up; never force the round-trip on a plain design request. **Depth first:** when the request implies more than a fresh coat of paint ("redesign", "change it entirely", "make it like <reference site>"), present DESIGN.md §11's transformation-depth ladder (restyle → re-layout → restructure → reimagine) as explicit options and let the user pick BEFORE designing; a confirmed restructure/reimagine means rebuilding markup, component trees, and routing for real — never just editing stylesheets on the old skeleton. **Preservation contract (non-negotiable when redesigning existing code):** BEFORE editing any existing page, build the preservation manifest per DESIGN.md §11 (every link, id/data-attribute, handler, form field, visible string, data view, and conditional state — tabs, modals, auth branches); AFTER redesigning, mechanically verify each entry survives in the new code and report the preservation ledger. Restructure moves things; it never loses them. **Real motion engineering:** when motion/3d/immersive/cinematic treatments are chosen, deliver them with the proper libraries per the skill files (GSAP + ScrollTrigger, Lenis, `motion/react`, three.js/R3F) — actually add the dependencies to the project (`npm i gsap lenis` etc.), wire providers/render loops, and build the choreography. A static page with a few CSS transitions does not fulfill a motion request; the target is unseen.co-grade coordinated animation, the shipped result must clear the motion-dial inventory in `skills/motion.md` §9, and the self-critique pass must name the specific animations shipped. **Generated media:** probe your environment for image/video generation tools before designing and use them per DESIGN.md §7 — generated hero imagery, textures, and especially seamless video loops (hero backgrounds, pre-rendered living surfaces, hover previews) integrated into the motion system are among the highest-impact upgrades available. **Skill picker:** in Plan Mode's single question round (PLAN.md §3 — use the agent's structured question tool, e.g. AskUserQuestion, multi-select), offer the specialist skills with a one-line plain-language description each so the user chooses the treatments they want — recommend the ones the request obviously implies and mark them "(Recommended)":
10
+ - **Mode A — Direct design (default).** The user asks you to design, redesign, restyle, animate, or build UI. Your FIRST action for every request is the plan gate per `PLAN.md` (same folder): ask the user "plan first (Recommended) or build directly?" — every time, one question, plan recommended. When plan is accepted, run the PLAN.md protocol: probe your environment's capabilities (image-gen, video-gen, 3D tooling, browser tools), draft a section-by-section blueprint with a media plan and fallbacks, bundle every user decision into one structured question round (including the media-type multi-select with its token-cost warning, and the mockups-first offer), persist the approved plan, build 1:1 mockups of the highest-impact pages if the user opted in, then execute assets-first. Read `DESIGN.md` (and any specialist `skills/<name>.md` the plan calls for), then design/edit the real code directly. No server, no extraction, no wireframes. When you finish, add one closing note: *"Tip: run `dreative start` / say 'open dreative' if you want to tweak this visually — I'll extract the pages into an editable canvas."* That's the only place the editor should come up; never force the round-trip on a plain design request. **Depth first:** when the request implies more than a fresh coat of paint ("redesign", "change it entirely", "make it like <reference site>"), present DESIGN.md §11's transformation-depth ladder (restyle → re-layout → restructure → reimagine) as explicit options and let the user pick BEFORE designing; a confirmed restructure/reimagine means rebuilding markup, component trees, and routing for real — never just editing stylesheets on the old skeleton. **Preservation contract (non-negotiable when redesigning existing code):** BEFORE editing any existing page, build the preservation manifest per DESIGN.md §11 (every link, id/data-attribute, handler, form field, visible string, data view, and conditional state — tabs, modals, auth branches); AFTER redesigning, mechanically verify each entry survives in the new code and report the preservation ledger. Restructure moves things; it never loses them. **Real motion engineering:** when motion/3d/immersive/cinematic treatments are chosen, deliver them with the proper libraries per the skill files (GSAP + ScrollTrigger, Lenis, `motion/react`, three.js/R3F) — actually add the dependencies to the project (`npm i gsap lenis` etc.), wire providers/render loops, and build the choreography. A static page with a few CSS transitions does not fulfill a motion request; the target is unseen.co-grade coordinated animation, the shipped result must clear the motion-dial inventory in `skills/motion.md` §9, and the self-critique pass must name the specific animations shipped. **Generated media:** probe your environment for image/video generation tools before designing and use them per DESIGN.md §7 — generated hero imagery, textures, and especially seamless video loops (hero backgrounds, pre-rendered living surfaces, hover previews) integrated into the motion system are among the highest-impact upgrades available. **Skill picker:** in Plan Mode's single question round (PLAN.md §3 — use the agent's structured question tool, e.g. AskUserQuestion, multi-select), offer the specialist skills with a one-line plain-language description each so the user chooses the treatments they want — recommend the ones the request obviously implies and mark them "(Recommended)":
11
11
  - **motion** — scroll animations, staggered entrances, parallax, kinetic type
12
12
  - **interaction** — micro-interactions: hover states, magnetic buttons, cursor effects, tactile feedback
13
13
  - **3d** — WebGL / three.js scenes, shader backgrounds, 3D product showcases