dreative 0.5.2 → 0.5.3

package/skill/dreative/PLAN.md

@@ -34,17 +34,16 @@ Enumerate what your environment can actually produce, and write the result down
 Rules:
 - Probe by LOOKING (list your tools, `which ffmpeg`, check MCP config), never by
   assuming. A capability you didn't verify doesn't exist.
-- If a capability is missing but the design clearly wants it (e.g. a cinematic
-  brief with no video-gen), you MUST ask a real question with a real choice —
-  **stating the gap and moving on is not an offer, it's a disclosure.** The
-  bug this catches: saying "video generation isn't available, so I'll use
-  stills" and continuing is a FAILURE even though it's honest. The fix is a
-  question with at least two live options: "install <concrete MCP/tool name>
-  now and use it" vs "skip it, use <the specific fallback>". Ask it in the
-  decision phase (§3), phrased as a genuine fork, not a heads-up. Never
-  install tools silently; never silently degrade either.
-- The probe result changes the blueprint: no video-gen → hero loops become
-  generated stills + ken-burns or a shader surface; **no image-gen → media
+- Missing video, 3D, or separated source layers is not automatically a blocker.
+  First plan the strongest honest treatment available from generated/sourced
+  stills, local image processing, transparent cutouts, SVG, CSS, Canvas,
+  generated keyframes, or existing project assets. Ask for a tool or source
+  asset only when the requested result cannot be approximated convincingly;
+  present the concrete best-effort fallback in that question. Never install a
+  tool silently and never leave an "advanced animation later" placeholder.
+- The probe result changes the blueprint: no video-gen → stills become layered
+  scenes, masks, related keyframes, frame sequences, tiles/fragments, Canvas
+  samples, or shader textures as the concept warrants; **no image-gen → media
   cells become `source-image` (DESIGN.md §7's priority: verified stock/CDN
   photography), every planned cutout prop becomes a sourced-and-matted photo
   or is cut, and any 3D of an organic real-world subject is re-planned as a
@@ -59,7 +58,7 @@ Rules:
 Draft the page as a compact table BEFORE asking anything — the decision phase
 presents choices about a concrete plan, not abstractions. Per section:
 
-| section | layout family | media plan | motion treatment | interaction | intensity | fallback |
+| section | layout family | media + preparation | motion class/treatment | interaction | intensity | fallback |
 
 - **media plan** — one of: `generate-image` (subject + exact aspect + palette/
   light-temperature prompt notes), `generate-video` (loop subject, 5-10s,
@@ -72,8 +71,7 @@ presents choices about a concrete plan, not abstractions. Per section:
   where media itself becomes the visitor-controlled spectacle, not a specific
   catalog effect. A different solution uses a registered planning-time
   substitution with observable success criteria and evidence IDs.
-  When the set-piece uses a depth dive (the default for image-led `award`
-  concepts with depth-capable assets), its
+  When a concept-led set-piece uses a depth dive, its
   `generate-image` cell must plan a DEPTH-CAPABLE composition (a corridor,
   room, landscape, machinery receding — something a camera can enter) and
   the companion assets in the same cell: the depth map and/or the separated
@@ -102,17 +100,18 @@ presents choices about a concrete plan, not abstractions. Per section:
   Every 3D prop cell also names its BERTH (3d.md §3): which lane/stage of
   the section it occupies and what the layout does to make room — a prop
   planned "over the hero image" or with no berth is an invalid cell.
-  At the `award` tier the outcome gate is one unmistakable dimensional or
-  spatial signature. The proven default is a recognizable real GLB or photoreal
-  cutout prop with a berth and asset source. A typography, photographic, data,
-  scene-instrument, or other alternative must use `award.spatialSignature` and
-  prove equivalent depth, recurrence, interaction, and dominance on desktop
-  and mobile. Generic orbs/blobs/toruses remain invalid.
-  At dial ≥ 8 the media column marks each hero/key image quiet-class or
-  PIXEL-class. The proven default is at least half pixel-class (minimum three,
-  set-piece included), each a different mechanism. A coherent alternative may
-  substitute `media.award.pixelCoverage` only when it visibly develops through
-  at least three materially different roles or states and carries runtime proof.
+  At the `award` tier the outcome gate is one unmistakable spatial, media,
+  typographic, or material signature that shapes the journey. If the concept
+  calls for a recognizable physical subject, use a real GLB or photoreal cutout
+  with a berth and source. Typography, layered photography, data, SVG/Canvas,
+  or a scene instrument may be the stronger direct choice; no substitution is
+  needed merely because 3D is absent. Generic orbs/blobs/toruses remain invalid.
+  At expressive/award, the media column records whether each hero/key image
+  stays flat or becomes motion-ready through cutouts, depth layers, masks,
+  fragments, maps, alternate states, a frame sequence, or a Canvas/WebGL
+  texture. Transform only where it strengthens the concept; a still may remain
+  flat as an intentional rest. The default in `media.keyAssetTreatment` is a
+  coherent asset-preparation decision, not a pixel-effect quota.
 - **Travel map (mandatory when any element persists across sections).** If
   the blueprint contains a fixed canvas object, a recurring signature, or any
   scroll-morphing prop that lives through more than one section, add a travel
@@ -121,35 +120,67 @@ presents choices about a concrete plan, not abstractions. Per section:
   it never sits over text or controls (DESIGN.md §15). No berth fits ⇒ the
   object is scripted HIDDEN for that section. A persistent object without a
   travel map is an unplanned collision that verify will find later — plan it
-  now. The set-piece at dial ≥ 8 must also be pixel-transforming per
-  media.md §3 (placement choreography like orbit/collapse doesn't qualify).
+  now. When the set-piece claims transformation, its pixels, layers, form, or
+  role must visibly change; placement choreography alone does not qualify.
 - **Diversity or development (dial ≥ 7 / expressive+).** Choose and record one
-  path in `creativeStrategy`. Diversity uses at least four distinct mechanisms
-  across three distinct drivers. Development uses one coherent signature
-  mechanism that changes through at least three materially different roles or
-  states, supported by two quieter secondary mechanisms and two drivers. The
-  same reveal repeated with different values is neither path. This keeps the
-  proven anti-repetition safeguard without forcing unrelated effects into a
-  coherent concept.
-- **motion treatment** — from motion.md/immersive.md/cinematic.md vocabulary,
-  with the dial-appropriate ambition. **motion.md §5's verification inventory is a hard
-  plan gate, not a target:** at `expressive`/`award` ambition the blueprint
-  must enumerate every §9 item for its dial — which element carries it, what
-  triggers it — or explicitly name the item as cut with a reason. A plan that
-  neither covers nor justifies a §9 item is incomplete; rework it before
-  presenting, don't ship the gap to the build.
+  path in `creativeStrategy`. Diversity uses only the mechanisms and drivers the
+  concept needs, tied together by a shared language. Development evolves one
+  coherent signature through materially different roles with quieter support.
+  The same reveal repeated with different values is neither path. Do not add
+  unrelated mechanisms to satisfy a count.
+- **motion treatment** — from motion.md/immersive.md/cinematic.md vocabulary,
+  with dial-appropriate ambition. At `expressive`/`award`, complete every
+  `motionTreatment` field below and name the element/driver for each planned
+  moment. A generic or incomplete treatment is reworked before presentation.
 - **intensity (the pacing map)** — 1–10 per section: how loud this section is
   (motion + media + visual weight combined). The page must read as a CURVE, not
   a flat line: uniform intensity fails in both directions (all loud = exhausting,
-  all quiet = the set-piece feels bolted on). Place deliberate rests (≤ 3)
-  immediately before and after the set-piece so it lands; the hero and the
-  set-piece section are the peaks, nothing else matches them. A blueprint whose
+  all quiet = the set-piece feels bolted on). Place deliberate rests around
+  hero moments where the content permits so they land; supporting sections
+  should not compete with them. A blueprint whose
   intensity column is all the same number is incomplete — rework the pacing
   before presenting.
-- **fallback** — for every ambitious cell (WebGL, sim, scrubbed sequence,
-  generated video), the concrete boring version that ships if the fancy one
-  fails runtime verification. A plan cell without a fallback is not ambitious,
-  it's fragile.
+- **fallback** — for every ambitious cell (WebGL, sim, scrubbed sequence,
+  generated video), the concrete boring version that ships if the fancy one
+  fails runtime verification. A plan cell without a fallback is not ambitious,
+  it's fragile.
+
+### Motion treatment and complexity budget
+
+At expressive/award, write a coherent scene sequence before implementation. For
+every major section record in `motionTreatment`:
+
+- static composition and motion class (`none`, `decorative`, `structural`, or
+  `transformational`);
+- starting and ending visual states;
+- what changes, persists, pins, enters, transforms, combines, fragments, or exits;
+- the handoff into the next composition;
+- narrative/emotional purpose;
+- rendering mechanism;
+- mobile translation and reduced-motion state.
+
+Decorative motion introduces or responds. Structural motion controls hierarchy,
+pacing, pinning, and composition. Transformational motion changes form or turns
+one composition into the next. Opacity, translate, scale, and light parallax are
+not sufficient evidence of structural or transformational motion.
+
+Record `motionComplexityBudget`: normally two or three hero moments (one is valid
+for a short page), calm sections around them, shared motion language, target-
+device limits, and progressive enhancement. Spend complexity where the story
+changes state; do not distribute medium-complexity effects evenly.
+
+Choose the simplest mechanism capable of producing the intended transformation
+convincingly. Simplicity means implementation suitability, not visual blandness.
+Choose deliberately among CSS, Motion, GSAP/ScrollTrigger, SVG masks/filters,
+`clip-path`, DOM fragments, Canvas 2D, WebGL/shaders, image sequences, video,
+Lottie/vector animation, and 3D. Neither basic transforms nor WebGL/3D/pixels are
+an unexamined default.
+
+Before approving the plan, record `antiDefaultReview` answers: are images mostly
+fading/scaling/sliding; are sections independent reveals; where is the major
+composition handoff; how does motion change visual state; could this system fit
+an unrelated site; what is memorable; and how does movement express the concept?
+If the result is generic at expressive/award, revise the scene plan now.
 
 Plus four page-level lines: register + design read (DESIGN.md §2), signature
 element, animation stack (ONE system: GSAP+Lenis or motion/react — motion.md §2),
@@ -160,10 +191,11 @@ discovered at build time: if the signature is a visual OBJECT, it must be a
 subject a stranger names correctly (3d.md §1–2's subject test). An abstract
 crude coded organic form is a hard-gate failure. Generic spheres/orbs/rings/
 blobs/toruses with no brand-native function remain invalid signatures. The
-proven `award` default is a real GLB or rung-2 transparent photoreal cutout;
-an alternative spatial typography, layered photography, data structure, or
-interactive instrument uses a registered substitution and must outperform the
-default on depth, recurrence, input response, and visual dominance. **Coded custom 3D is
+award work chooses the medium that makes the signature most legible and
+concept-specific. A real GLB or rung-2 transparent photoreal cutout is preferred
+when the signature is a recognizable physical subject; spatial typography,
+layered photography, data structure, or an interactive instrument can be the
+direct plan when the concept supports it. **Coded custom 3D is
 capability-gated at the probe (§1):** offer/plan it only when the probe
 verified an actual quality path — a real GLB in reach, image-gen for
 albedo/label textures, an HDRI/environment source. No verified texture path

package/skill/dreative/SKILL.md

@@ -72,17 +72,23 @@ Detailed doctrine belongs in those references, not in this orchestration file.
   work, show a page × skill matrix: the user can assign treatments to specific
   pages, and approve routing for selected skills left unassigned. Every section
   names its layout family, skills, assets, interactions, mobile translation,
-  fallback, and verification criteria.
+  fallback, and verification criteria. Expressive/award plans also include a
+  motion treatment for every major section: static composition, start/end
+  states, changes, pins, handoff, purpose, mechanism, mobile translation, and
+  reduced-motion state.
 - Render a concise `.dreative/plan.md` for the user and for session re-entry.
 
 The approved plan is a delivery contract. A section ends as `shipped`,
 `fallback`, or `cut` with a reason—never silently omitted.
 
 At `expressive` and `award`, choose one coherent quality path: `diversity`
-(several mechanisms across several drivers) or `development` (one signature
-mechanism evolving through at least three materially different roles, supported
-by two quieter mechanisms). Experimental work explores one non-obvious candidate
-per major section, then selects only the strongest two or three to ship.
+(several concept-related mechanisms/drivers) or `development` (one signature
+mechanism evolving through materially different roles with quiet support).
+Allocate a contextual motion-complexity budget: concentrate effort into a small
+number of hero moments, name calm sections, and run the anti-default review.
+Do not satisfy ambition through mechanism quotas. Experimental work explores one
+non-obvious candidate per major section, then selects only the strongest two or
+three to ship.
 
 ### 3.3 Select skills
 
@@ -117,8 +123,10 @@ must appear somewhere in the overall plan, but not on every page.
 
 ### 3.4 Build
 
-- Prepare planned media before section implementation. Record each asset and its
-  delivery status in the plan.
+- Prepare planned media before section implementation. Treat generated stills as
+  raw material: decide whether each asset stays flat or needs cutouts, depth
+  layers, masks, fragments, variants, maps, or a frame sequence. Record the
+  decision, derivatives, rationale, and delivery status in the plan.
 - Follow the chosen framework adapter and the repository's established patterns.
 - Preserve the manifest unless the user explicitly approved a change; record
   approved divergence with a reason.
@@ -151,9 +159,13 @@ Verification is evidence, not prose asserting that something was checked.
 4. Check the console, links, forms, keyboard path, states, reduced motion,
    responsive overflow, and pointer hit areas.
 5. For motion/WebGL/video, record runtime evidence and performance numbers.
+   Capture initial, early, mid-transition, final, handoff, mobile, and
+   reduced-motion states; add pinned midpoint/exit states when pinning exists.
 6. Reconcile every plan section and asset against what visibly shipped.
-7. Write `.dreative/verify.json` and run `dreative audit`.
-8. Fix every error. Warnings require either a fix or a recorded justification.
+7. At expressive/award, visually inspect the captured states, make at least one
+   refinement to timing, composition, readability, or continuity, and record it.
+8. Write `.dreative/verify.json` and run `dreative audit`.
+9. Fix every error. Warnings require either a fix or a recorded justification.
 
 Every evidence-backed substitution references passing evidence IDs whose proof
 meets its declared success criteria. Vague reasons such as "it did not fit",

package/skill/dreative/recipes/motion-recipes.md

@@ -21,6 +21,30 @@ in `recipeAccess`.
 - Sticky CSS for simple pinning; cap pin length and remove/shorten on mobile.
 - Velocity treatments use damped/clamped derivatives, never raw scroll deltas.
 
+## Optional transformation patterns
+
+Choose only patterns that express the concept:
+
+- **Image fragmentation:** split a source into aligned DOM/SVG/Canvas tiles or
+  sampled pixels; disperse, filter, and reconstruct the actual image.
+- **Composition handoff:** carry an object, mask, grid, or type structure from
+  one section into the next instead of resetting the page.
+- **Layered image dive:** separate depth planes or use a depth map and move the
+  camera through the composition.
+- **Mask migration:** evolve one mask window across images or sections.
+- **Object persistence:** keep a key subject staged while its environment,
+  scale, supporting content, and berth change.
+- **Generated-keyframe morph:** blend related still states through masking,
+  displacement, or a bounded frame sequence.
+- **Pixel-to-object reconstruction:** assemble sampled text/image particles into
+  a recognizable subject.
+- **Typography-to-image:** use readable type as mask, grid, path, or fragment
+  source that becomes imagery.
+- **Environmental system:** drive texture, light, particles, type, and objects
+  from the same scroll/interaction state.
+- **Editorial sequence:** treat a long section as one pinned timeline with
+  deliberate internal states rather than independent blocks.
+
 ## Type
 
 - Split lines/words/characters only for selected display moments; keep accessible

package/skill/dreative/references/ARTIFACTS.md

@@ -24,6 +24,8 @@ Required top-level fields:
   declared during planning
 - `ruleExceptions`: bounded substitutions of evidence-backed defaults
 - `creativeStrategy`: `diversity` or `development` at expressive/award tiers
+- `motionComplexityBudget`: hero moments, calm sections, shared language,
+  device limits, progressive enhancement, and anti-default review
 - `fontDecision`: candidates, reflex markers, ledger history, and justification
 - `experimentalPlan`: per-section candidates and the selected two or three peaks
 - `conceptExploration` and `recipeAccess`: proof recipes were loaded only after
@@ -34,11 +36,14 @@ and `mobile`, but optional treatments are assigned only where they serve that
 page. A section may use only skills assigned to its parent page.
 
 Each section requires `id`, `name`, `layoutFamily`, `skills`, `interactions`,
-`mobile`, `fallback`, `verification`, `assets`, and `status`. Status is
+`mobile`, `fallback`, `verification`, `assets`, and `status`. At expressive/
+award it also requires `motionTreatment`: class, static composition, start/end
+states, changes, pins, handoff, purpose, mechanism, mobile, and reduced motion. Status is
 `planned | shipped | fallback | cut`; fallback/cut requires `reason`.
 
-Each asset requires `id`, `path`, `purpose`, and `status`. A shipped asset must
-exist when `dreative audit` runs.
+Each asset requires `id`, `path`, `purpose`, `importance`, `preparation`, and
+`status`. Preparation records flat/decompose/variants/sequence, named
+derivatives, and rationale. A shipped asset must exist when `dreative audit` runs.
 
 ### Routing authority
 
@@ -59,16 +64,16 @@ evidence IDs. The exception must predate `implementationStartedAt`.
 
 ```json
 {
-  "ruleId": "award.spatialSignature",
+  "ruleId": "media.keyAssetTreatment",
   "decision": "substituted",
   "declaredAt": "2026-01-01T00:30:00.000Z",
-  "reason": "The archival concept has no physical subject, so a product prop would misrepresent the material.",
+  "reason": "The archive contains no raster key imagery, so inventing photography would misrepresent the supplied material.",
   "alternative": "A persistent variable-type specimen becomes index, spatial architecture, and interactive control.",
   "successCriteria": [
-    "The specimen appears in at least three materially different roles",
-    "Pointer and scroll input visibly reshape its depth"
+    "The specimen appears in materially different structural roles",
+    "Pointer and scroll input visibly reshape the specimen"
   ],
-  "evidenceIds": ["spatial-type-desktop", "spatial-type-mobile"]
+  "evidenceIds": ["type-system-desktop", "type-system-mobile"]
 }
 ```
 
@@ -76,9 +81,15 @@ evidence IDs. The exception must predate `implementationStartedAt`.
 
 At `expressive` and `award`, `creativeStrategy.path` is either:
 
-- `diversity`: at least four distinct mechanisms and three drivers; or
-- `development`: one named mechanism with three materially different states,
-  two quieter secondary mechanisms, and two drivers.
+- `diversity`: the concept-related mechanisms and drivers the experience needs;
+  or
+- `development`: one named mechanism with materially different states and
+  quieter support.
+
+`motionComplexityBudget` concentrates complexity into one to three hero moments
+(normally two or three; one for a short page), names calm sections and the
+shared language, and records the anti-default review. It is contextual, not a
+mechanism quota.
 
 When `experimental` is selected, `experimentalPlan` records one candidate for
 every major section and marks only two or three as selected. Other sections
@@ -149,6 +160,11 @@ and rejects passing commands with nonzero exits or passing runs with console
 errors. `fail` blocks completion. Use `not-applicable` only with a concrete
 explanation and proof of why the criterion does not apply.
 
+For expressive/award motion, tag evidence with `timelineState`: initial, early,
+mid-transition, final, handoff, mobile, and reduced-motion; add pinned midpoint
+and exit states when relevant. Record the post-inspection refinement in
+`refinement` with findings, changes, and passing evidence IDs.
+
 ## `.dreative/ledger.json`
 
 The ledger is append-only design memory:

package/skill/dreative/references/RULES.json

@@ -105,9 +105,9 @@
       "id": "award.spatialSignature",
       "category": "evidence-backed-default",
       "observedFailure": "Award builds used a generic orb or had no recurring dimensional system beyond the hero.",
-      "defaultRemedy": "Use a recognizable real GLB or photoreal cutout prop staged in a designed berth.",
+      "defaultRemedy": "Plan one concept-specific spatial, media, typographic, or material signature that recurs and changes state.",
       "exceptionAllowed": true,
-      "exceptionTest": "A named alternative creates equivalent depth, recurrence, interaction, and visual dominance on desktop and mobile.",
+      "exceptionTest": "A named alternative creates equivalent recurrence, interaction, visual dominance, and journey continuity on desktop and mobile.",
       "reviewAfterRuns": 5
     },
     {
@@ -123,27 +123,27 @@
       "id": "media.award.participatoryMoment",
       "category": "evidence-backed-default",
       "observedFailure": "Award media remained something visitors only watched while the page claimed immersion.",
-      "defaultRemedy": "Use an image or video depth dive when the concept and assets support depth.",
+      "defaultRemedy": "Create one concept-specific point where the visitor affects, enters, transforms, or controls the media's visual logic.",
       "exceptionAllowed": true,
       "exceptionTest": "The visitor affects, enters, transforms, scrubs, drags, refracts, or controls the media's visual logic with equal perceptual impact.",
       "reviewAfterRuns": 5
     },
     {
-      "id": "media.award.pixelCoverage",
+      "id": "media.keyAssetTreatment",
       "category": "evidence-backed-default",
       "observedFailure": "Award builds shipped one set-piece while all other key images remained static or used basic fade-and-zoom.",
-      "defaultRemedy": "At least half of key images, minimum three, use distinct pixel-class treatments.",
+      "defaultRemedy": "Give every key image an explicit flat-or-decompose decision and concentrate meaningful transformation where the narrative changes state.",
       "exceptionAllowed": true,
-      "exceptionTest": "One coherent alternative media system visibly develops through at least three materially different roles or states.",
+      "exceptionTest": "A coherent alternative media system makes key imagery intentional while preserving calm sections and asset feasibility.",
       "reviewAfterRuns": 5
     },
     {
-      "id": "motion.expressive.diversityOrDevelopment",
+      "id": "motion.expressive.architecture",
       "category": "evidence-backed-default",
       "observedFailure": "Multiple sections repeated the same simple reveal or used unrelated effects only to satisfy a catalog.",
-      "defaultRemedy": "Use four distinct mechanisms across three input drivers.",
+      "defaultRemedy": "Plan the page as connected visual states with a small number of hero moments, calm sections, and a concept-specific handoff language.",
       "exceptionAllowed": true,
-      "exceptionTest": "One coherent signature mechanism develops through at least three materially different states with two quieter secondary mechanisms and two drivers.",
+      "exceptionTest": "A coherent signature mechanism develops through materially different states without requiring unrelated mechanisms or gimmick quotas.",
       "reviewAfterRuns": 5
     },
     {

package/skill/dreative/references/TIERS.md

@@ -22,8 +22,10 @@ all lower-tier requirements.
 ## Expressive (`expressive`)
 
 - Everything in Premium.
-- A recorded diversity-or-development path: several distinct mechanisms/drivers,
-  or one signature mechanism developing through three states with quiet support.
+- A recorded diversity-or-development path: concept-related mechanisms/drivers,
+  or one signature mechanism developing through materially different states.
+- A section-by-section motion treatment and contextual complexity budget
+  concentrate structural/transformational motion into a few hero moments.
 - At least one input-driven treatment; entrances alone do not satisfy the tier.
 - Mobile translations and reduced-motion fallbacks are implemented, not noted.
 - Frame behavior and heavy asset cost are measured.
@@ -32,11 +34,11 @@ all lower-tier requirements.
 
 - Everything in Expressive.
 - A distinctive persistent spatial, media, or material system shapes the journey.
-- One unmistakable dimensional or spatial signature is subject-honest, staged,
-  and resilient. A real GLB/cutout is the proven default, not the only medium.
+- One unmistakable spatial, media, typographic, or material signature is
+  subject-honest, staged, and resilient. WebGL/3D is used only when justified.
 - Runtime evidence covers effects, transferred weight, frame time, occlusion,
   context loss/loading, and fallbacks.
-- The page has three memorable moments without sacrificing function.
+- The page has a small number of memorable moments without sacrificing function.
 
 Do not force Award requirements on product dashboards, checkout, forms, or users
 who asked for calm professional work. Ambition is a product decision, not a score.

package/skill/dreative/schemas/plan.schema.json

@@ -48,6 +48,7 @@
     "implementationStartedAt": { "type": "string", "format": "date-time" },
     "ruleExceptions": { "type": "array", "items": { "$ref": "#/$defs/ruleException" } },
     "creativeStrategy": { "$ref": "#/$defs/creativeStrategy" },
+    "motionComplexityBudget": { "$ref": "#/$defs/motionComplexityBudget" },
     "fontDecision": { "$ref": "#/$defs/fontDecision" },
     "experimentalPlan": { "$ref": "#/$defs/experimentalPlan" },
     "conceptExploration": { "$ref": "#/$defs/conceptExploration" },
@@ -92,8 +93,8 @@
           "required": ["path", "mechanisms", "drivers"],
           "properties": {
             "path": { "const": "diversity" },
-            "mechanisms": { "type": "array", "minItems": 4, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
-            "drivers": { "type": "array", "minItems": 3, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+            "mechanisms": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+            "drivers": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
           }
         },
         {
@@ -103,13 +104,50 @@
           "properties": {
             "path": { "const": "development" },
             "signatureMechanism": { "type": "string", "minLength": 1 },
-            "states": { "type": "array", "minItems": 3, "uniqueItems": true, "items": { "type": "string", "minLength": 12 } },
-            "secondaryMechanisms": { "type": "array", "minItems": 2, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
-            "drivers": { "type": "array", "minItems": 2, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+            "states": { "type": "array", "minItems": 2, "uniqueItems": true, "items": { "type": "string", "minLength": 12 } },
+            "secondaryMechanisms": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+            "drivers": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
           }
         }
       ]
     },
+    "motionComplexityBudget": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["heroMoments", "calmSectionIds", "sharedLanguage", "deviceLimits", "progressiveEnhancement", "antiDefaultReview"],
+      "properties": {
+        "heroMoments": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 3,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["sectionId", "reason"],
+            "properties": {
+              "sectionId": { "type": "string", "minLength": 1 },
+              "reason": { "type": "string", "minLength": 20 }
+            }
+          }
+        },
+        "calmSectionIds": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+        "sharedLanguage": { "type": "string", "minLength": 20 },
+        "deviceLimits": { "type": "string", "minLength": 20 },
+        "progressiveEnhancement": { "type": "string", "minLength": 20 },
+        "antiDefaultReview": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["basicMotionAssessment", "compositionHandoff", "visualStateChange", "conceptSpecificity", "memorableMoment"],
+          "properties": {
+            "basicMotionAssessment": { "type": "string", "minLength": 20 },
+            "compositionHandoff": { "type": "string", "minLength": 20 },
+            "visualStateChange": { "type": "string", "minLength": 20 },
+            "conceptSpecificity": { "type": "string", "minLength": 20 },
+            "memorableMoment": { "type": "string", "minLength": 20 }
+          }
+        }
+      }
+    },
     "fontDecision": {
       "type": "object",
       "additionalProperties": false,
@@ -199,11 +237,22 @@
     "asset": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["id", "path", "purpose", "status"],
+      "required": ["id", "path", "purpose", "importance", "preparation", "status"],
       "properties": {
         "id": { "type": "string", "minLength": 1 },
         "path": { "type": "string", "minLength": 1 },
         "purpose": { "type": "string", "minLength": 1 },
+        "importance": { "enum": ["supporting", "key"] },
+        "preparation": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["decision", "derivatives", "rationale"],
+          "properties": {
+            "decision": { "enum": ["flat", "decompose", "variants", "sequence"] },
+            "derivatives": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+            "rationale": { "type": "string", "minLength": 12 }
+          }
+        },
         "status": { "$ref": "#/$defs/status" },
         "reason": { "type": "string", "minLength": 1 }
       }
@@ -218,6 +267,7 @@
         "layoutFamily": { "type": "string", "minLength": 1 },
         "skills": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/skill" } },
         "interactions": { "type": "array", "items": { "type": "string" } },
+        "motionTreatment": { "$ref": "#/$defs/motionTreatment" },
         "mobile": { "type": "string", "minLength": 1 },
         "fallback": { "type": "string", "minLength": 1 },
         "verification": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
@@ -226,6 +276,24 @@
         "reason": { "type": "string", "minLength": 1 }
       }
     },
+    "motionTreatment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["class", "staticComposition", "startState", "endState", "changes", "pinnedElements", "handoff", "purpose", "mechanism", "mobile", "reducedMotion"],
+      "properties": {
+        "class": { "enum": ["none", "decorative", "structural", "transformational"] },
+        "staticComposition": { "type": "string", "minLength": 12 },
+        "startState": { "type": "string", "minLength": 12 },
+        "endState": { "type": "string", "minLength": 12 },
+        "changes": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "pinnedElements": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "handoff": { "type": "string", "minLength": 12 },
+        "purpose": { "type": "string", "minLength": 12 },
+        "mechanism": { "type": "string", "minLength": 12 },
+        "mobile": { "type": "string", "minLength": 12 },
+        "reducedMotion": { "type": "string", "minLength": 12 }
+      }
+    },
     "page": {
       "type": "object",
       "additionalProperties": false,

package/skill/dreative/schemas/verify.schema.json

@@ -19,6 +19,9 @@
           "criterion": { "type": "string", "minLength": 1 },
           "status": { "enum": ["pass", "fail", "not-applicable"] },
           "evidence": { "type": "string", "minLength": 1 },
+          "timelineState": {
+            "enum": ["initial", "early", "mid-transition", "final", "handoff", "pinned-midpoint", "pinned-exit", "mobile", "reduced-motion"]
+          },
           "proof": {
             "type": "object",
             "additionalProperties": false,
@@ -56,6 +59,17 @@
           }
         }
       }
+    },
+    "refinement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["inspectedAt", "findings", "changes", "evidenceIds"],
+      "properties": {
+        "inspectedAt": { "type": "string", "format": "date-time" },
+        "findings": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "changes": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } },
+        "evidenceIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
+      }
     }
   }
 }