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.
- package/README.md +35 -35
- package/dist/server/ai.js +177 -0
- package/dist/server/preview.js +73 -73
- package/dist/ui/index.html +11 -11
- package/package.json +1 -1
- package/skill/dreative/DESIGN.md +25 -1
- package/skill/dreative/PLAN.md +201 -143
- package/skill/dreative/SKILL.md +2 -2
- package/skill/dreative/skills/cinematic.md +232 -232
- package/skill/dreative/skills/immersive.md +223 -223
- package/skill/dreative/skills/media.md +216 -216
- package/skill/dreative/skills/mobile.md +117 -117
- package/skill/dreative/skills/refined.md +102 -102
- package/skill/dreative/skills/ux.md +144 -144
package/skill/dreative/PLAN.md
CHANGED
|
@@ -1,143 +1,201 @@
|
|
|
1
|
-
# Dreative Plan Mode — decide everything before the first line of code
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
the
|
|
124
|
-
|
|
125
|
-
**
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
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 work — recommended 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 reference — a 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.
|
package/skill/dreative/SKILL.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: dreative
|
|
3
|
-
description: Frontend design skill + optional visual round-trip editor. Use 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.
|
|
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
|