@bastani/atomic 0.9.11-alpha.6 → 0.9.11-alpha.7
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 +14 -0
- package/dist/builtin/intercom/package.json +1 -1
- package/dist/builtin/mcp/package.json +1 -1
- package/dist/builtin/subagents/package.json +1 -1
- package/dist/builtin/web-access/package.json +1 -1
- package/dist/builtin/workflows/package.json +1 -1
- package/dist/builtin/workflows/skills/impeccable/SKILL.md +33 -129
- package/dist/builtin/workflows/skills/impeccable/agents/impeccable_asset_producer.toml +11 -3
- package/dist/builtin/workflows/skills/impeccable/agents/impeccable_documenter.toml +26 -0
- package/dist/builtin/workflows/skills/impeccable/agents/impeccable_finish_reviewer.toml +35 -0
- package/dist/builtin/workflows/skills/impeccable/reference/android.md +1 -1
- package/dist/builtin/workflows/skills/impeccable/reference/animate.md +72 -189
- package/dist/builtin/workflows/skills/impeccable/reference/audit.md +10 -9
- package/dist/builtin/workflows/skills/impeccable/reference/audit.native.md +2 -2
- package/dist/builtin/workflows/skills/impeccable/reference/bolder.md +19 -108
- package/dist/builtin/workflows/skills/impeccable/reference/clarify.md +59 -253
- package/dist/builtin/workflows/skills/impeccable/reference/colorize.md +51 -222
- package/dist/builtin/workflows/skills/impeccable/reference/craft-floor.md +45 -0
- package/dist/builtin/workflows/skills/impeccable/reference/craft.md +3 -121
- package/dist/builtin/workflows/skills/impeccable/reference/critique.md +28 -20
- package/dist/builtin/workflows/skills/impeccable/reference/degraded/asset-producer.md +97 -0
- package/dist/builtin/workflows/skills/impeccable/reference/degraded/documenter.md +23 -0
- package/dist/builtin/workflows/skills/impeccable/reference/degraded/finish-reviewer.md +32 -0
- package/dist/builtin/workflows/skills/impeccable/reference/degraded/manual-edit-applier.md +92 -0
- package/dist/builtin/workflows/skills/impeccable/reference/delight.md +47 -279
- package/dist/builtin/workflows/skills/impeccable/reference/distill.md +2 -2
- package/dist/builtin/workflows/skills/impeccable/reference/doctor.md +53 -0
- package/dist/builtin/workflows/skills/impeccable/reference/document.md +60 -73
- package/dist/builtin/workflows/skills/impeccable/reference/harden.md +1 -12
- package/dist/builtin/workflows/skills/impeccable/reference/hooks.md +17 -4
- package/dist/builtin/workflows/skills/impeccable/reference/init.md +64 -163
- package/dist/builtin/workflows/skills/impeccable/reference/ios.md +1 -1
- package/dist/builtin/workflows/skills/impeccable/reference/layout.md +52 -153
- package/dist/builtin/workflows/skills/impeccable/reference/live.md +44 -32
- package/dist/builtin/workflows/skills/impeccable/reference/new-work.md +105 -0
- package/dist/builtin/workflows/skills/impeccable/reference/{product.md → operate.md} +6 -5
- package/dist/builtin/workflows/skills/impeccable/reference/optimize.md +4 -4
- package/dist/builtin/workflows/skills/impeccable/reference/overdrive.md +1 -4
- package/dist/builtin/workflows/skills/impeccable/reference/polish.md +68 -212
- package/dist/builtin/workflows/skills/impeccable/reference/quieter.md +3 -3
- package/dist/builtin/workflows/skills/impeccable/reference/routing.md +18 -0
- package/dist/builtin/workflows/skills/impeccable/reference/shape.md +38 -144
- package/dist/builtin/workflows/skills/impeccable/reference/typeset.md +48 -269
- package/dist/builtin/workflows/skills/impeccable/reference/visualize.md +38 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/command-metadata.json +1 -1
- package/dist/builtin/workflows/skills/impeccable/scripts/concept-seed.mjs +584 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/context-signals.mjs +117 -9
- package/dist/builtin/workflows/skills/impeccable/scripts/context.mjs +486 -59
- package/dist/builtin/workflows/skills/impeccable/scripts/critique-storage.mjs +16 -45
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/browser/injected/index.mjs +96 -10
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/cli/main.mjs +143 -26
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/design-system.mjs +181 -12
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/detect-antipatterns-browser.js +3187 -182
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/engines/browser/detect-url.mjs +102 -7
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/engines/regex/detect-text.mjs +282 -70
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/engines/static-html/css-cascade.mjs +183 -15
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/engines/static-html/detect-html.mjs +22 -7
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/findings.mjs +7 -1
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/node/file-system.mjs +16 -2
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/registry/antipatterns.mjs +155 -42
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/rules/checks.mjs +2988 -155
- package/dist/builtin/workflows/skills/impeccable/scripts/detector/shared/constants.mjs +11 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/doctor.mjs +336 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/generate-image.mjs +232 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/hook-admin.mjs +90 -10
- package/dist/builtin/workflows/skills/impeccable/scripts/hook-lib.mjs +410 -78
- package/dist/builtin/workflows/skills/impeccable/scripts/hook.mjs +25 -8
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/artifact-schema.mjs +93 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/composition-catalog.mjs +165 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/concept-catalog.mjs +329 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/impeccable-config.mjs +20 -5
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/impeccable-paths.mjs +16 -8
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/provider.mjs +1 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/staleness-deep.mjs +455 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/staleness-notice.mjs +169 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/staleness.mjs +457 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/surface-briefs.mjs +151 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/target-slug.mjs +33 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/lib/template-extensions.mjs +146 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live/completion.mjs +10 -1
- package/dist/builtin/workflows/skills/impeccable/scripts/live/event-validation.mjs +15 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live/generation-preflight.mjs +149 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live/poll-lanes.mjs +14 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live/session-store.mjs +109 -32
- package/dist/builtin/workflows/skills/impeccable/scripts/live/source-lock.mjs +105 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live/source-search.mjs +105 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live/sveltekit-adapter.mjs +8 -6
- package/dist/builtin/workflows/skills/impeccable/scripts/live/tanstack-adapter.mjs +280 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live-accept.mjs +208 -68
- package/dist/builtin/workflows/skills/impeccable/scripts/live-browser.js +563 -112
- package/dist/builtin/workflows/skills/impeccable/scripts/live-commit-manual-edits.mjs +3 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/live-inject.mjs +198 -13
- package/dist/builtin/workflows/skills/impeccable/scripts/live-insert.mjs +24 -6
- package/dist/builtin/workflows/skills/impeccable/scripts/live-manual-edit-evidence.mjs +6 -1
- package/dist/builtin/workflows/skills/impeccable/scripts/live-poll.mjs +44 -14
- package/dist/builtin/workflows/skills/impeccable/scripts/live-server.mjs +398 -33
- package/dist/builtin/workflows/skills/impeccable/scripts/live-status.mjs +9 -5
- package/dist/builtin/workflows/skills/impeccable/scripts/live-wrap.mjs +81 -67
- package/dist/builtin/workflows/skills/impeccable/scripts/live.mjs +7 -2
- package/dist/builtin/workflows/skills/impeccable/scripts/palette.mjs +76 -81
- package/dist/builtin/workflows/skills/impeccable/scripts/pin.mjs +2 -2
- package/dist/builtin/workflows/skills/impeccable/scripts/serve-question.mjs +890 -0
- package/dist/builtin/workflows/skills/impeccable/scripts/surface-brief.mjs +74 -0
- package/dist/builtin/workflows/src/extension/index.bundle.mjs +201 -22
- package/dist/builtin/workflows/src/runs/foreground/executor-stage-control.ts +23 -9
- package/dist/builtin/workflows/src/runs/foreground/executor-stage-replay.ts +1 -0
- package/dist/builtin/workflows/src/runs/foreground/postmortem-stage-chat.ts +20 -5
- package/dist/builtin/workflows/src/runs/foreground/stage-control-registry.ts +10 -0
- package/dist/builtin/workflows/src/runs/foreground/stage-delivery-activity.ts +86 -0
- package/dist/builtin/workflows/src/runs/foreground/stage-runner-context.ts +6 -2
- package/dist/builtin/workflows/src/runs/foreground/stage-runner-controller.ts +19 -13
- package/dist/builtin/workflows/src/runs/foreground/stage-runner-send-user-message.ts +8 -0
- package/dist/builtin/workflows/src/runs/foreground/stage-runner-types.ts +16 -0
- package/dist/builtin/workflows/src/tui/stage-chat-view-delivery-activity.ts +121 -0
- package/dist/builtin/workflows/src/tui/stage-chat-view-live-events.ts +42 -0
- package/dist/builtin/workflows/src/tui/stage-chat-view-state.ts +16 -0
- package/dist/builtin/workflows/src/tui/stage-chat-view-types.ts +4 -0
- package/dist/modes/interactive/components/chat-session-host-actions.d.ts.map +1 -1
- package/dist/modes/interactive/components/chat-session-host-actions.js +2 -14
- package/dist/modes/interactive/components/chat-session-host-actions.js.map +1 -1
- package/dist/modes/interactive/components/chat-session-host-events.d.ts.map +1 -1
- package/dist/modes/interactive/components/chat-session-host-events.js +9 -0
- package/dist/modes/interactive/components/chat-session-host-events.js.map +1 -1
- package/dist/modes/interactive/components/chat-session-host-runtime.d.ts +25 -0
- package/dist/modes/interactive/components/chat-session-host-runtime.d.ts.map +1 -1
- package/dist/modes/interactive/components/chat-session-host-runtime.js +53 -0
- package/dist/modes/interactive/components/chat-session-host-runtime.js.map +1 -1
- package/dist/modes/interactive/components/chat-session-host.d.ts +13 -0
- package/dist/modes/interactive/components/chat-session-host.d.ts.map +1 -1
- package/dist/modes/interactive/components/chat-session-host.js +22 -1
- package/dist/modes/interactive/components/chat-session-host.js.map +1 -1
- package/dist/modes/interactive/interactive-agent-events.js +9 -3
- package/dist/modes/interactive/interactive-agent-events.js.map +1 -1
- package/docs/tui.md +7 -2
- package/docs/workflows.md +1 -1
- package/npm-shrinkwrap.json +23 -23
- package/package.json +2 -2
- package/dist/builtin/workflows/skills/impeccable/reference/brand.md +0 -108
- package/dist/builtin/workflows/skills/impeccable/reference/codex.md +0 -105
- package/dist/builtin/workflows/skills/impeccable/reference/interaction-design.md +0 -189
|
@@ -1,203 +1,86 @@
|
|
|
1
1
|
> **Additional context needed**: performance constraints.
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Use motion to explain state, relationship, and hierarchy, or to create one authored moment the surface has earned. Decoration without purpose is animation debt.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Visitor mode
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
- **Persuade + Experience:** motion may carry the voice. Prefer one rehearsed focal sequence to repeated section reveals.
|
|
10
|
+
- **Operate + Read:** motion serves feedback, state, and continuity. Keep routine transitions fast and do not make users wait through page-load choreography.
|
|
11
|
+
- **Native (`ios` / `android` / `adaptive`):** follow the Motion section of [ios.md](ios.md) or [android.md](android.md), including the platform's Reduce Motion behavior. Do not apply the web tooling below.
|
|
10
12
|
|
|
11
|
-
|
|
13
|
+
## Find the job
|
|
12
14
|
|
|
13
|
-
|
|
15
|
+
Inspect the existing motion language, interaction states, target devices, and performance budget. Find only the places where motion would:
|
|
14
16
|
|
|
15
|
-
|
|
17
|
+
- acknowledge an action;
|
|
18
|
+
- make a state change or spatial relationship legible;
|
|
19
|
+
- preserve continuity through navigation or layout change;
|
|
20
|
+
- direct attention at a meaningful moment;
|
|
21
|
+
- embody the selected visual world.
|
|
22
|
+
|
|
23
|
+
Ask only when a material constraint cannot be inferred. Do not animate a static area merely because it exists.
|
|
24
|
+
|
|
25
|
+
## Set the motion thesis
|
|
26
|
+
|
|
27
|
+
Write a short plan before implementation:
|
|
28
|
+
|
|
29
|
+
- **Focal moment:** the one sequence or interaction that deserves authorship, if any.
|
|
30
|
+
- **Continuity:** the state, layout, or navigation changes that need explanation.
|
|
31
|
+
- **Feedback:** the controls and outcomes that need acknowledgment.
|
|
32
|
+
- **Budget:** which effects may be expensive and how often they run.
|
|
33
|
+
|
|
34
|
+
The focal moment must come from this product and surface concept. A generic fade-and-rise, hover lift, parallax layer, or scroll reveal is not a thesis.
|
|
35
|
+
|
|
36
|
+
## Choose material by meaning
|
|
37
|
+
|
|
38
|
+
Transform and opacity are reliable foundations, not the entire palette. Choose properties for what the transition communicates:
|
|
39
|
+
|
|
40
|
+
- **Continuity and relationship:** shared-element motion, FLIP-style transforms, view transitions, or deliberate spatial movement.
|
|
41
|
+
- **Focus and depth:** bounded blur, filter, backdrop, light, or shadow changes.
|
|
42
|
+
- **Reveal and composition:** masks, clip paths, cropping, or controlled occlusion.
|
|
43
|
+
- **Material and energy:** color, gradient position, texture, distortion, or shader effects when the world and runtime support them.
|
|
44
|
+
- **State and feedback:** the smallest change that makes cause and result unmistakable.
|
|
45
|
+
|
|
46
|
+
Do not stack techniques for spectacle. One strong material idea, carried through the focal sequence and quiet supporting states, is usually enough.
|
|
47
|
+
|
|
48
|
+
Sibling stagger is appropriate when a list appears as a list. Cap the total delay, and never reinterpret every scrolled section as a staggered list.
|
|
49
|
+
|
|
50
|
+
## Timing and easing
|
|
51
|
+
|
|
52
|
+
Timing should express distance and consequence:
|
|
53
|
+
|
|
54
|
+
| Duration | Typical use |
|
|
55
|
+
|---|---|
|
|
56
|
+
| 100–150 ms | immediate feedback |
|
|
57
|
+
| 150–300 ms | routine state change |
|
|
58
|
+
| 300–500 ms | layout, overlay, or view transition |
|
|
59
|
+
| 500–800 ms | a deliberately authored focal entrance |
|
|
60
|
+
|
|
61
|
+
Exit faster than entrance. Use natural deceleration such as `cubic-bezier(0.16, 1, 0.3, 1)` for confident arrivals; do not use bounce or elastic curves by reflex. Long feedback feels like latency.
|
|
62
|
+
|
|
63
|
+
## Implement to the runtime
|
|
64
|
+
|
|
65
|
+
- Use CSS transitions and keyframes for declarative state and bounded sequences.
|
|
66
|
+
- Use Web Animations API or the project's existing motion library for interruption, sequencing, and dynamic values.
|
|
67
|
+
- Use View Transitions or shared-element techniques when continuity across states is the point.
|
|
68
|
+
- Use scroll-driven motion only when the scroll relationship itself carries meaning, with a robust fallback.
|
|
69
|
+
- Do not add a dependency for an effect the existing stack can express cleanly.
|
|
70
|
+
|
|
71
|
+
Keep content visible in the default state so failed scripts do not hide the page. Avoid casually animating layout-driving properties such as `width`, `height`, `top`, `left`, and margins; use FLIP, transforms, or grid techniques when appropriate. Bound blur, filter, shadow, canvas, and shader work to isolated regions. Apply `will-change` only during known animation. Measure on target viewports and devices rather than assuming transform means fast.
|
|
16
72
|
|
|
17
|
-
##
|
|
73
|
+
## Accessibility and control
|
|
18
74
|
|
|
19
|
-
|
|
75
|
+
Respect autoplay and sound preferences. Any nonessential loop must stop when offscreen or hidden.
|
|
20
76
|
|
|
21
|
-
|
|
22
|
-
- **Missing feedback**: Actions without visual acknowledgment (button clicks, form submission, etc.)
|
|
23
|
-
- **Jarring transitions**: Instant state changes that feel abrupt (show/hide, page loads, route changes)
|
|
24
|
-
- **Unclear relationships**: Spatial or hierarchical relationships that aren't obvious
|
|
25
|
-
- **Lack of delight**: Functional but joyless interactions
|
|
26
|
-
- **Missed guidance**: Opportunities to direct attention or explain behavior
|
|
77
|
+
## Verify
|
|
27
78
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
If any of these are unclear from the codebase, STOP and use Codex's structured user-input/question tool when available; if unavailable, ask directly in chat to clarify what you cannot infer.
|
|
35
|
-
|
|
36
|
-
**CRITICAL**: Respect `prefers-reduced-motion`. Always provide non-animated alternatives for users who need them.
|
|
37
|
-
|
|
38
|
-
## Plan Animation Strategy
|
|
39
|
-
|
|
40
|
-
Create a purposeful animation plan:
|
|
41
|
-
|
|
42
|
-
- **Hero moment**: What's the ONE signature animation? (Page load? Hero section? Key interaction?)
|
|
43
|
-
- **Feedback layer**: Which interactions need acknowledgment?
|
|
44
|
-
- **Transition layer**: Which state changes need smoothing?
|
|
45
|
-
- **Delight layer**: Where can we surprise and delight?
|
|
79
|
+
- The focal motion is specific to the selected world and surface.
|
|
80
|
+
- Every supporting animation explains feedback, state, or relationship.
|
|
81
|
+
- Interruption and repeated use behave correctly.
|
|
82
|
+
- Desktop, mobile, and keyboard paths remain usable.
|
|
83
|
+
- Expensive effects stay smooth on the target device.
|
|
84
|
+
- Removing an animation would lose meaning or authored character, not merely decoration.
|
|
46
85
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
## Implement Animations
|
|
50
|
-
|
|
51
|
-
Add motion systematically across these categories:
|
|
52
|
-
|
|
53
|
-
### Entrance Animations
|
|
54
|
-
- **Hero section**: Dramatic entrance for primary content (scale, parallax, or creative effects)
|
|
55
|
-
- **Modal/drawer entry**: Smooth slide + fade, backdrop fade, focus management
|
|
56
|
-
- **List rhythm**: Sibling stagger is legitimate for cards-in-a-grid or list-items-appearing. Whole-section fade-on-scroll is not a list and is not legitimate. Cap total stagger time: 10 items at 50ms each = 500ms total. For more items, reduce per-item delay or cap the staggered count.
|
|
57
|
-
|
|
58
|
-
Use CSS custom properties for clean stagger: `animation-delay: calc(var(--i, 0) * 50ms)` with `style="--i: 0"`, `style="--i: 1"`, etc. on each item.
|
|
59
|
-
|
|
60
|
-
### Micro-interactions
|
|
61
|
-
- **Button feedback**:
|
|
62
|
-
- Hover: Subtle scale (1.02-1.05), color shift, shadow increase
|
|
63
|
-
- Click: Quick scale down then up (0.95 → 1), ripple effect
|
|
64
|
-
- Loading: Spinner or pulse state
|
|
65
|
-
- **Form interactions**:
|
|
66
|
-
- Input focus: Border color transition, slight scale or glow
|
|
67
|
-
- Validation: Shake on error, check mark on success, smooth color transitions
|
|
68
|
-
- **Toggle switches**: Smooth slide + color transition (200-300ms)
|
|
69
|
-
- **Checkboxes/radio**: Check mark animation, ripple effect
|
|
70
|
-
- **Like/favorite**: Scale + rotation, particle effects, color transition
|
|
71
|
-
|
|
72
|
-
### State Transitions
|
|
73
|
-
- **Show/hide**: Fade + slide (not instant), appropriate timing (200-300ms)
|
|
74
|
-
- **Expand/collapse**: Height transition with overflow handling, icon rotation
|
|
75
|
-
- **Loading states**: Skeleton screen fades, spinner animations, progress bars
|
|
76
|
-
- **Success/error**: Color transitions, icon animations, gentle scale pulse
|
|
77
|
-
- **Enable/disable**: Opacity transitions, cursor changes
|
|
78
|
-
|
|
79
|
-
### Navigation & Flow
|
|
80
|
-
- **Page transitions**: Crossfade between routes, shared element transitions
|
|
81
|
-
- **Tab switching**: Slide indicator, content fade/slide
|
|
82
|
-
- **Carousel/slider**: Smooth transforms, snap points, momentum
|
|
83
|
-
- **Scroll effects**: Parallax layers, sticky headers with state changes, scroll progress indicators
|
|
84
|
-
|
|
85
|
-
### Feedback & Guidance
|
|
86
|
-
- **Hover hints**: Tooltip fade-ins, cursor changes, element highlights
|
|
87
|
-
- **Drag & drop**: Lift effect (shadow + scale), drop zone highlights, smooth repositioning
|
|
88
|
-
- **Copy/paste**: Brief highlight flash on paste, "copied" confirmation
|
|
89
|
-
- **Focus flow**: Highlight path through form or workflow
|
|
90
|
-
|
|
91
|
-
### Delight Moments
|
|
92
|
-
- **Empty states**: Subtle floating animations on illustrations
|
|
93
|
-
- **Completed actions**: Confetti, check mark flourish, success celebrations
|
|
94
|
-
- **Easter eggs**: Hidden interactions for discovery
|
|
95
|
-
- **Contextual animation**: Weather effects, time-of-day themes, seasonal touches
|
|
96
|
-
|
|
97
|
-
## Technical Implementation
|
|
98
|
-
|
|
99
|
-
Use appropriate techniques for each animation:
|
|
100
|
-
|
|
101
|
-
### Timing & Easing
|
|
102
|
-
|
|
103
|
-
**Duration: the 100/300/500 rule.** Timing matters more than easing for "feels right":
|
|
104
|
-
|
|
105
|
-
| Duration | Use Case | Examples |
|
|
106
|
-
|----------|----------|----------|
|
|
107
|
-
| **100–150ms** | Instant feedback | Button press, toggle, color change |
|
|
108
|
-
| **200–300ms** | State changes | Menu open, tooltip, hover state |
|
|
109
|
-
| **300–500ms** | Layout changes | Accordion, modal, drawer |
|
|
110
|
-
| **500–800ms** | Entrance animations | Page load, hero reveal |
|
|
111
|
-
|
|
112
|
-
**Easing curves (use these, not CSS defaults):**
|
|
113
|
-
```css
|
|
114
|
-
/* Recommended: natural deceleration */
|
|
115
|
-
--ease-out-quart: cubic-bezier(0.25, 1, 0.5, 1); /* Smooth */
|
|
116
|
-
--ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1); /* Slightly snappier */
|
|
117
|
-
--ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1); /* Confident, decisive */
|
|
118
|
-
|
|
119
|
-
/* AVOID: feel dated and tacky */
|
|
120
|
-
/* bounce: cubic-bezier(0.34, 1.56, 0.64, 1); */
|
|
121
|
-
/* elastic: cubic-bezier(0.68, -0.6, 0.32, 1.6); */
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
**Exit animations are faster than entrances.** Use ~75% of enter duration.
|
|
125
|
-
|
|
126
|
-
### CSS Animations
|
|
127
|
-
```css
|
|
128
|
-
/* Prefer for simple, declarative animations */
|
|
129
|
-
- transitions for state changes
|
|
130
|
-
- @keyframes for complex sequences
|
|
131
|
-
- transform and opacity for reliable movement
|
|
132
|
-
- blur, filters, masks, clip paths, shadows, and color shifts for premium atmospheric effects when verified smooth
|
|
133
|
-
```
|
|
134
|
-
|
|
135
|
-
### JavaScript Animation
|
|
136
|
-
```javascript
|
|
137
|
-
/* Use for complex, interactive animations */
|
|
138
|
-
- Web Animations API for programmatic control
|
|
139
|
-
- Framer Motion for React
|
|
140
|
-
- GSAP for complex sequences
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
### Motion Materials
|
|
144
|
-
|
|
145
|
-
Transform and opacity are reliable defaults, not the whole palette. Premium interfaces often need atmospheric properties. Match material to effect:
|
|
146
|
-
|
|
147
|
-
- **Transform / opacity**: movement, press feedback, simple reveals, list choreography
|
|
148
|
-
- **Blur / filter / backdrop-filter**: focus pulls, depth, glass or lens effects, softened entrances
|
|
149
|
-
- **Clip-path / masks**: wipes, reveals, editorial cropping, product-like transitions
|
|
150
|
-
- **Shadow / glow / color filters**: energy, affordance, focus, warmth, active state
|
|
151
|
-
- **Grid-template-rows or FLIP-style transforms**: expanding and reflowing layout without animating `height` directly
|
|
152
|
-
|
|
153
|
-
The hard rule isn't "transform and opacity only." It's: avoid animating layout-driving properties casually (`width`, `height`, `top`, `left`, margins), keep expensive effects bounded to small or isolated areas, and verify smoothness in-browser on target viewports.
|
|
154
|
-
|
|
155
|
-
### Performance
|
|
156
|
-
- **Layout safety**: Avoid casual animation of layout-driving properties (`width`, `height`, `top`, `left`, margins)
|
|
157
|
-
- **will-change**: Add sparingly for known expensive animations only (e.g. on `:hover` or an `.animating` class), never preemptively across the whole page
|
|
158
|
-
- **Scroll triggers**: Use Intersection Observer instead of scroll event listeners; unobserve after the animation fires once
|
|
159
|
-
- **Bound expensive effects**: Keep blur/filter/shadow areas small or isolated, use `contain` where appropriate
|
|
160
|
-
- **Monitor FPS**: Ensure 60fps on target devices
|
|
161
|
-
|
|
162
|
-
### Perceived Performance
|
|
163
|
-
|
|
164
|
-
Nobody cares how fast your site *is*, only how fast it feels. The 80ms threshold: anything under ~80ms feels instant because our brains buffer sensory input for that long to synchronize perception. Target this for micro-interactions.
|
|
165
|
-
|
|
166
|
-
- **Preemptive start**: Begin transitions immediately while loading (iOS app zoom, skeleton UI). Users perceive work happening.
|
|
167
|
-
- **Early completion**: Show content progressively, don't wait for everything (progressive images, streaming HTML, skeleton fade-ins).
|
|
168
|
-
- **Optimistic UI**: Update the interface immediately, handle failures gracefully. Use for low-stakes actions (likes, follows). Avoid for payments or destructive operations.
|
|
169
|
-
- **Easing affects perceived duration**: Ease-in (accelerating toward completion) makes tasks feel shorter because the peak-end effect weights final moments heavily. Ease-out feels satisfying for entrances.
|
|
170
|
-
- **Caution**: Too-fast responses can decrease perceived value for complex operations (search, analysis). Sometimes a brief delay signals "real work" is happening.
|
|
171
|
-
|
|
172
|
-
### Accessibility
|
|
173
|
-
```css
|
|
174
|
-
@media (prefers-reduced-motion: reduce) {
|
|
175
|
-
* {
|
|
176
|
-
animation-duration: 0.01ms !important;
|
|
177
|
-
animation-iteration-count: 1 !important;
|
|
178
|
-
transition-duration: 0.01ms !important;
|
|
179
|
-
}
|
|
180
|
-
}
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
**NEVER**:
|
|
184
|
-
- Use bounce or elastic easing curves; they feel dated and draw attention to the animation itself
|
|
185
|
-
- Animate layout properties casually (`width`, `height`, `top`, `left`, margins) when transform, FLIP, or grid-based techniques would work
|
|
186
|
-
- Use durations over 500ms for feedback (it feels laggy)
|
|
187
|
-
- Animate without purpose (every animation needs a reason)
|
|
188
|
-
- Ignore `prefers-reduced-motion` (this is an accessibility violation)
|
|
189
|
-
- Animate everything (animation fatigue makes interfaces feel exhausting)
|
|
190
|
-
- Block interaction during animations unless intentional
|
|
191
|
-
|
|
192
|
-
## Verify Quality
|
|
193
|
-
|
|
194
|
-
Test animations thoroughly:
|
|
195
|
-
|
|
196
|
-
- **Smooth at 60fps**: No jank on target devices
|
|
197
|
-
- **Feels natural**: Easing curves feel organic, not robotic
|
|
198
|
-
- **Appropriate timing**: Not too fast (jarring) or too slow (laggy)
|
|
199
|
-
- **Reduced motion works**: Animations disabled or simplified appropriately
|
|
200
|
-
- **Doesn't block**: Users can interact during/after animations
|
|
201
|
-
- **Adds value**: Makes interface clearer or more delightful
|
|
202
|
-
|
|
203
|
-
When the motion clarifies state instead of decorating it, hand off to `$impeccable polish` for the final pass.
|
|
86
|
+
When motion earns its place, hand off to `$impeccable polish` for the final pass.
|
|
@@ -12,6 +12,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
|
|
|
12
12
|
|
|
13
13
|
**Check for**:
|
|
14
14
|
- **Contrast issues**: Text contrast ratios < 4.5:1 (or 7:1 for AAA)
|
|
15
|
+
- **Motion sensitivity**: `prefers-reduced-motion` needs an intentional alternative that preserves state change and hierarchy; flag a global `0.01ms` kill that destroys useful feedback, flashing above threshold, and motion that blocks focus, reading, or task completion
|
|
15
16
|
- **Missing ARIA**: Interactive elements without proper roles, labels, or states
|
|
16
17
|
- **Keyboard navigation**: Missing focus indicators, illogical tab order, keyboard traps
|
|
17
18
|
- **Semantic HTML**: Improper heading hierarchy, missing landmarks, divs instead of buttons
|
|
@@ -25,7 +26,8 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
|
|
|
25
26
|
**Check for**:
|
|
26
27
|
- **Layout thrashing**: Reading/writing layout properties in loops
|
|
27
28
|
- **Expensive animations**: Casual layout-property animation, unbounded blur/filter/shadow effects, or effects that visibly drop frames
|
|
28
|
-
- **Missing optimization**: Images without lazy loading, unoptimized assets
|
|
29
|
+
- **Missing optimization**: Images without lazy loading, unoptimized assets
|
|
30
|
+
- **will-change overuse**: `will-change` applied broadly or left on at rest (it is a targeted hint for known expensive animations, not a baseline requirement)
|
|
29
31
|
- **Bundle size**: Unnecessary imports, unused dependencies
|
|
30
32
|
- **Render performance**: Unnecessary re-renders, missing memoization
|
|
31
33
|
|
|
@@ -52,11 +54,11 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
|
|
|
52
54
|
|
|
53
55
|
**Score 0-4**: 0=Desktop-only (breaks on mobile), 1=Major issues (some breakpoints, many failures), 2=Partial (works on mobile, rough edges), 3=Good (responsive, minor touch target or overflow issues), 4=Excellent (fluid, all viewports, proper touch targets)
|
|
54
56
|
|
|
55
|
-
### 5.
|
|
57
|
+
### 5. Implementation Integrity (CRITICAL)
|
|
56
58
|
|
|
57
|
-
|
|
59
|
+
Run the bundled detector and verify each finding in context. Look for repeated implementation shortcuts, design-system drift, misleading or decorative content, and structure that is interchangeable with an unrelated product. Keep deterministic findings separate from visual judgment and call out false positives.
|
|
58
60
|
|
|
59
|
-
**Score 0-4**: 0=
|
|
61
|
+
**Score 0-4**: 0=systemic drift, 1=major repeated failures, 2=several verified issues, 3=minor isolated issues, 4=coherent and intentional
|
|
60
62
|
|
|
61
63
|
## Generate Report
|
|
62
64
|
|
|
@@ -68,13 +70,13 @@ Check against ALL the **DON'T** guidelines from the parent impeccable skill (alr
|
|
|
68
70
|
| 2 | Performance | ? | |
|
|
69
71
|
| 3 | Responsive Design | ? | |
|
|
70
72
|
| 4 | Theming | ? | |
|
|
71
|
-
| 5 |
|
|
73
|
+
| 5 | Implementation Integrity | ? | |
|
|
72
74
|
| **Total** | | **??/20** | **[Rating band]** |
|
|
73
75
|
|
|
74
76
|
**Rating bands**: 18-20 Excellent (minor polish), 14-17 Good (address weak dimensions), 10-13 Acceptable (significant work needed), 6-9 Poor (major overhaul), 0-5 Critical (fundamental issues)
|
|
75
77
|
|
|
76
|
-
###
|
|
77
|
-
**Start here.** Pass/fail:
|
|
78
|
+
### Implementation Integrity Verdict
|
|
79
|
+
**Start here.** Pass/fail: does the implementation express a coherent product-specific system? Cite verified evidence and detector findings.
|
|
78
80
|
|
|
79
81
|
### Executive Summary
|
|
80
82
|
- Audit Health Score: **??/20** ([rating band])
|
|
@@ -93,7 +95,7 @@ Tag every issue with **P0-P3 severity**:
|
|
|
93
95
|
For each issue, document:
|
|
94
96
|
- **[P?] Issue name**
|
|
95
97
|
- **Location**: Component, file, line
|
|
96
|
-
- **Category**: Accessibility / Performance / Theming / Responsive /
|
|
98
|
+
- **Category**: Accessibility / Performance / Theming / Responsive / Implementation Integrity
|
|
97
99
|
- **Impact**: How it affects users
|
|
98
100
|
- **WCAG/Standard**: Which standard it violates (if applicable)
|
|
99
101
|
- **Recommendation**: How to fix it
|
|
@@ -132,4 +134,3 @@ After presenting the summary, tell the user:
|
|
|
132
134
|
- Skip positive findings (celebrate what works)
|
|
133
135
|
- Forget to prioritize (everything can't be P0)
|
|
134
136
|
- Report false positives without verification
|
|
135
|
-
|
|
@@ -36,7 +36,7 @@ Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the
|
|
|
36
36
|
- **Hard-coded colors**: raw hex instead of semantic system colors (iOS) / Material color roles (Android) / design tokens
|
|
37
37
|
- **Broken dark appearance**: missing dark variants, poor contrast in dark, quick inverts
|
|
38
38
|
- **Dynamic Color** (Android 12+): no static fallback scheme, or ignored where it fits
|
|
39
|
-
- **Off-platform materials**: hand-rolled
|
|
39
|
+
- **Off-platform materials**: hand-rolled visual materials where system materials or tonal elevation are expected
|
|
40
40
|
|
|
41
41
|
**Score 0-4**: 0=Hard-coded everything, 1=Minimal tokens, 2=Partial (tokens exist, inconsistently used), 3=Good (minor hard-coded values), 4=Excellent (semantic throughout, both appearances first-class)
|
|
42
42
|
|
|
@@ -48,7 +48,7 @@ Score against the loaded platform reference(s), including their slop tests. **Ch
|
|
|
48
48
|
- **Off-platform navigation**: custom global nav, overloaded tab bars, iOS patterns on Android or vice versa
|
|
49
49
|
- **Web-shaped controls**: HTML-style buttons, custom toggles, hover-dependent affordances
|
|
50
50
|
- **Icon drift**: mixed icon sets instead of SF Symbols / Material Symbols
|
|
51
|
-
- **
|
|
51
|
+
- **System drift**: repeated shortcuts or decorative patterns that conflict with the product, platform, or established design system
|
|
52
52
|
|
|
53
53
|
**Score 0-4**: 0=Web port (nothing native), 1=Heavy violations (3-4 kinds), 2=Some (1-2 noticeable), 3=Mostly conformant (subtle issues), 4=Fully native (a fluent user trusts every screen)
|
|
54
54
|
|
|
@@ -1,120 +1,31 @@
|
|
|
1
|
-
|
|
1
|
+
> **Additional context needed**: which section is the target, and what must stay untouched.
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
"Bolder" is an amplification request, and almost always it is scoped to something that already exists. The surrounding page, its system, and its conventions are the given. Your job is to raise one part to the conviction the rest already implies, without rebuilding anything the brief did not name. The reflex answer, reaching for more effects, is the opposite of bold; reject it first.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Scope is sovereign
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
"Everything else stays" is a literal instruction. Touch only the named target. Do not restyle its neighbors, do not migrate the page to a new idea, do not add colors, fonts, radii, shadows, or system primitives the surface does not already own. If the existing system genuinely cannot express the direction, stop and STOP and use Codex's structured user-input/question tool when available; if unavailable, ask directly in chat to clarify what you cannot infer. before expanding it, naming the exact addition and the job it would do.
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
## Why it reads flat
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
A section usually reads flat for reasons its neighbors have already solved. Look at what the rest of the page does that this section does not: the display type at full strength, the structural devices that carry meaning, the signature motif, the density and pacing. A flat section is typically one that quietly opts out of the system's own strongest moves. The most reliable bolder pass brings the target up to the expressive level its neighbors already reach, in the system's own vocabulary rather than a new one.
|
|
12
12
|
|
|
13
|
-
##
|
|
13
|
+
## The amplification
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
- **Amplify what the system already owns.** Reuse its motif and its type scale at full strength, turned up for this section rather than invented for it. The bolder version should look more like the same brand, not less.
|
|
16
|
+
- **Keep content true.** Existing claims are part of the scope: preserve them unless the user supplies replacements. If real evidence is essential to the direction but absent, ask for it.
|
|
17
|
+
- **Commit, then clarify.** Half-measures read as noise. Make the one decisive move completely, then quiet everything around it so the move is legible. If every element got louder, the section got flatter.
|
|
18
|
+
- **Give it its own rhythm.** The target should read as a peak in the scroll, a shift in density or pace from what surrounds it, not simply more of the same.
|
|
16
19
|
|
|
17
|
-
|
|
18
|
-
- **Generic choices**: The page could belong to any product in the category.
|
|
19
|
-
- **Timid scale**: Everything is medium-sized with no clear lead.
|
|
20
|
-
- **Low contrast**: Important and supporting elements have similar visual weight.
|
|
21
|
-
- **Static**: The surface has no meaningful moment of emphasis.
|
|
22
|
-
- **Predictable**: The composition follows a default pattern without a point of view.
|
|
23
|
-
- **Flat hierarchy**: Nothing stands out or commands attention.
|
|
20
|
+
## The skeleton test
|
|
24
21
|
|
|
25
|
-
|
|
26
|
-
- What is the brand personality?
|
|
27
|
-
- What is the purpose of this surface?
|
|
28
|
-
- Who is the audience?
|
|
29
|
-
- What design system, tokens, components, and visual conventions already exist?
|
|
22
|
+
Strip the copy out of your planned section and study the bare structure. Does the skeleton still say what this section is and why it matters, through hierarchy and the system's devices alone? If it only works once the words return, the boldness is in the text size, not the design. A placeholder for an image or artifact names a job, an anchor and a piece of evidence, not a cue to drop in a decorative photo; fill that job with whatever the subject actually has.
|
|
30
23
|
|
|
31
|
-
|
|
24
|
+
## Before you finish
|
|
32
25
|
|
|
33
|
-
|
|
26
|
+
- Everything outside the named target is unchanged.
|
|
27
|
+
- No new color, font, or system primitive appeared without being asked for.
|
|
28
|
+
- The conventions the section carried, including anything that drives an action, still work the same way.
|
|
29
|
+
- The section is unmistakably the same brand, only more sure of itself.
|
|
34
30
|
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
## Design-System Lock
|
|
38
|
-
|
|
39
|
-
If the project has `DESIGN.md`, tokens, theme variables, or established component styles, treat that system as the boundary. Make the existing language stronger before adding new language.
|
|
40
|
-
|
|
41
|
-
Do not invent new colors, gradients, radii, shadows, fonts, decorative backgrounds, or effects just because the request says "bolder." A bolder pass should usually change emphasis, proportion, rhythm, density, contrast, copy, artifact specificity, and layout relationships while staying inside the documented system.
|
|
42
|
-
|
|
43
|
-
If the existing system is genuinely too limited to express the bolder direction, stop and ask the user before expanding it. Name the exact additions, the role each would play, and why the current system cannot do the job. If the user approves expansion, update the design system or tokens alongside the implementation.
|
|
44
|
-
|
|
45
|
-
## Plan Amplification
|
|
46
|
-
|
|
47
|
-
Create a strategy to increase impact while maintaining coherence:
|
|
48
|
-
|
|
49
|
-
- **Focal point**: Pick one thing the viewer should remember, then make the rest support it.
|
|
50
|
-
- **System levers**: Identify which existing tokens, components, layout patterns, and copy structures can carry more weight.
|
|
51
|
-
- **Risk budget**: Decide how far the surface can push while still feeling like the same product or brand.
|
|
52
|
-
- **Hierarchy amplification**: Increase contrast between primary, secondary, and tertiary content instead of making every element louder.
|
|
53
|
-
|
|
54
|
-
**IMPORTANT**: Bold design must still be usable. Impact without function is just decoration.
|
|
55
|
-
|
|
56
|
-
## Amplify the Design
|
|
57
|
-
|
|
58
|
-
Systematically increase impact through intention, not a menu of effects:
|
|
59
|
-
|
|
60
|
-
### Typography Amplification
|
|
61
|
-
- Strengthen the existing type hierarchy before changing typefaces.
|
|
62
|
-
- Make important text meaningfully more dominant, and make supporting text quieter.
|
|
63
|
-
- Use weight, measure, spacing, and line breaks to sharpen the point of view.
|
|
64
|
-
- Add or replace fonts only after user-approved design-system expansion.
|
|
65
|
-
|
|
66
|
-
### Color Amplification
|
|
67
|
-
- Use the existing palette more decisively before adding colors.
|
|
68
|
-
- Shift the proportion, placement, and contrast of documented colors to clarify meaning.
|
|
69
|
-
- Treat any new color, gradient, or tint ramp as a design-system expansion that requires user approval.
|
|
70
|
-
- Keep color tied to hierarchy, state, or brand meaning; do not use it as surface decoration.
|
|
71
|
-
|
|
72
|
-
### Spatial Amplification
|
|
73
|
-
- Change proportion, density, alignment, and sequencing so the composition has a stronger point of view.
|
|
74
|
-
- Create clearer contrast between dense evidence and open breathing room.
|
|
75
|
-
- Let layout express priority and narrative order before adding ornament.
|
|
76
|
-
- Preserve responsive behavior and avoid text overflow at every breakpoint.
|
|
77
|
-
|
|
78
|
-
### Surface Amplification
|
|
79
|
-
- Use existing surface, border, radius, and shadow rules more deliberately.
|
|
80
|
-
- Remove timid half-measures: either give an element a clear role or simplify it.
|
|
81
|
-
- Add texture, depth, illustration, or decorative treatments only when already established by the system or explicitly approved.
|
|
82
|
-
- Make real product artifacts, imagery, data, or copy carry attention before reaching for effects.
|
|
83
|
-
|
|
84
|
-
### Motion & Animation
|
|
85
|
-
- Design one meaningful moment of emphasis when motion genuinely supports the point.
|
|
86
|
-
- Make interaction feedback feel more decisive without becoming distracting.
|
|
87
|
-
- Keep transitions smooth and intentional.
|
|
88
|
-
- **Bolder != scroll-fade-rise on every section.** That's the saturated AI default, the opposite of bold.
|
|
89
|
-
|
|
90
|
-
### Composition Boldness
|
|
91
|
-
- Make the dominant idea unmistakable.
|
|
92
|
-
- Use layout tension, sequencing, contrast, and restraint to create a stronger read.
|
|
93
|
-
- Let the page's structure communicate priority before adding decorative layers.
|
|
94
|
-
- If every element is louder, the composition is not bolder; it is flatter.
|
|
95
|
-
|
|
96
|
-
**NEVER**:
|
|
97
|
-
- Add undocumented design-system primitives without user approval
|
|
98
|
-
- Add effects randomly without purpose
|
|
99
|
-
- Hide weak hierarchy behind decoration
|
|
100
|
-
- Sacrifice readability for aesthetics
|
|
101
|
-
- Make everything bold; contrast is the point
|
|
102
|
-
- Ignore accessibility
|
|
103
|
-
- Overwhelm with motion
|
|
104
|
-
- Copy trendy aesthetics blindly
|
|
105
|
-
|
|
106
|
-
## Verify Quality
|
|
107
|
-
|
|
108
|
-
Ensure amplification maintains usability and coherence:
|
|
109
|
-
|
|
110
|
-
- **System-faithful**: Did the pass make the existing design language stronger before adding anything new?
|
|
111
|
-
- **No undocumented drift**: Are new colors, gradients, shadows, radii, fonts, and effects either absent or explicitly approved and documented?
|
|
112
|
-
- **NOT AI slop**: Does this look like every other AI-generated "bold" design? If yes, start over.
|
|
113
|
-
- **Still functional**: Can users accomplish tasks without distraction?
|
|
114
|
-
- **Coherent**: Does everything feel intentional and unified?
|
|
115
|
-
- **Memorable**: Will users remember this experience for the intended reason?
|
|
116
|
-
- **Performant and accessible**: Does the result stay fast, readable, responsive, and WCAG-conscious?
|
|
117
|
-
|
|
118
|
-
**The test**: If you showed this to someone and said "AI made this bolder," would they believe you immediately? If yes, you've failed. Bold means distinctive, not "more AI effects."
|
|
119
|
-
|
|
120
|
-
When the result feels right, hand off to `$impeccable polish` for the final pass.
|
|
31
|
+
When the target holds its own without pulling the page apart, hand off to `$impeccable polish` for the final pass.
|