@cubis/foundry 0.3.71 → 0.3.72
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 +15 -0
- package/dist/cli/core.js +4 -18
- package/dist/cli/core.js.map +1 -1
- package/package.json +1 -1
- package/src/cli/core.ts +4 -18
- package/workflows/powers/accessibility/POWER.md +83 -94
- package/workflows/powers/accessibility/SKILL.md +82 -94
- package/workflows/powers/agent-design/POWER.md +201 -0
- package/workflows/powers/agent-design/SKILL.md +198 -0
- package/workflows/powers/agent-design/references/clarification-patterns.md +153 -0
- package/workflows/powers/agent-design/references/skill-testing.md +164 -0
- package/workflows/powers/agent-design/references/workflow-patterns.md +226 -0
- package/workflows/powers/agentic-eval/POWER.md +62 -0
- package/workflows/powers/agentic-eval/SKILL.md +59 -0
- package/workflows/powers/agentic-eval/references/rubric-and-regression-checklist.md +11 -0
- package/workflows/powers/api-designer/POWER.md +43 -71
- package/workflows/powers/api-designer/SKILL.md +43 -71
- package/workflows/powers/api-patterns/POWER.md +42 -56
- package/workflows/powers/api-patterns/SKILL.md +42 -57
- package/workflows/powers/architecture-designer/POWER.md +43 -60
- package/workflows/powers/architecture-designer/SKILL.md +43 -60
- package/workflows/powers/ask-questions-if-underspecified/POWER.md +51 -3
- package/workflows/powers/auth-architect/POWER.md +69 -0
- package/workflows/powers/auth-architect/SKILL.md +66 -0
- package/workflows/powers/auth-architect/references/session-token-policy-checklist.md +45 -0
- package/workflows/powers/behavioral-modes/POWER.md +100 -9
- package/workflows/powers/c-pro/POWER.md +105 -0
- package/workflows/powers/c-pro/SKILL.md +102 -0
- package/workflows/powers/c-pro/references/build-systems-and-toolchains.md +148 -0
- package/workflows/powers/c-pro/references/common-ub-and-portability.md +166 -0
- package/workflows/powers/c-pro/references/debugging-with-sanitizers.md +205 -0
- package/workflows/powers/c-pro/references/memory-safety-and-build-checklist.md +60 -0
- package/workflows/powers/c-pro/references/posix-and-platform-apis.md +244 -0
- package/workflows/powers/changelog-generator/POWER.md +127 -63
- package/workflows/powers/changelog-generator/SKILL.md +126 -63
- package/workflows/powers/ci-cd-pipelines/POWER.md +156 -0
- package/workflows/powers/ci-cd-pipelines/SKILL.md +153 -0
- package/workflows/powers/ci-cd-pipelines/references/github-actions-patterns.md +160 -0
- package/workflows/powers/ci-cd-pipelines/references/pipeline-security-checklist.md +57 -0
- package/workflows/powers/cli-developer/POWER.md +152 -95
- package/workflows/powers/cli-developer/SKILL.md +152 -95
- package/workflows/powers/cpp-pro/POWER.md +111 -0
- package/workflows/powers/cpp-pro/SKILL.md +108 -0
- package/workflows/powers/cpp-pro/references/concurrency-primitives.md +266 -0
- package/workflows/powers/cpp-pro/references/move-semantics-and-value-types.md +149 -0
- package/workflows/powers/cpp-pro/references/performance-and-profiling.md +191 -0
- package/workflows/powers/cpp-pro/references/raii-and-modern-cpp-checklist.md +87 -0
- package/workflows/powers/cpp-pro/references/template-and-concepts-patterns.md +205 -0
- package/workflows/powers/csharp-pro/POWER.md +47 -22
- package/workflows/powers/csharp-pro/SKILL.md +47 -22
- package/workflows/powers/dart-pro/POWER.md +68 -0
- package/workflows/powers/dart-pro/SKILL.md +65 -0
- package/workflows/powers/dart-pro/references/isolate-and-concurrency.md +180 -0
- package/workflows/powers/dart-pro/references/null-safety-and-async-patterns.md +133 -0
- package/workflows/powers/dart-pro/references/package-structure-and-linting.md +193 -0
- package/workflows/powers/dart-pro/references/sealed-records-patterns.md +173 -0
- package/workflows/powers/dart-pro/references/testing-and-mocking.md +235 -0
- package/workflows/powers/database-design/POWER.md +47 -33
- package/workflows/powers/database-design/SKILL.md +47 -33
- package/workflows/powers/database-optimizer/POWER.md +43 -64
- package/workflows/powers/database-optimizer/SKILL.md +43 -64
- package/workflows/powers/database-skills/POWER.md +59 -93
- package/workflows/powers/database-skills/SKILL.md +59 -93
- package/workflows/powers/debugging-strategies/POWER.md +69 -0
- package/workflows/powers/debugging-strategies/SKILL.md +66 -0
- package/workflows/powers/debugging-strategies/references/reproduce-isolate-verify-checklist.md +42 -0
- package/workflows/powers/deep-research/POWER.md +67 -0
- package/workflows/powers/deep-research/SKILL.md +64 -0
- package/workflows/powers/deep-research/references/multi-round-research-loop.md +80 -0
- package/workflows/powers/design-system-builder/POWER.md +130 -116
- package/workflows/powers/design-system-builder/SKILL.md +130 -116
- package/workflows/powers/devops-engineer/POWER.md +120 -57
- package/workflows/powers/devops-engineer/SKILL.md +120 -57
- package/workflows/powers/docker-kubernetes/POWER.md +94 -0
- package/workflows/powers/docker-kubernetes/SKILL.md +91 -0
- package/workflows/powers/docker-kubernetes/references/dockerfile-optimization-checklist.md +35 -0
- package/workflows/powers/docker-kubernetes/references/kubernetes-deployment-patterns.md +59 -0
- package/workflows/powers/documentation-templates/POWER.md +158 -127
- package/workflows/powers/documentation-templates/SKILL.md +158 -127
- package/workflows/powers/drizzle-expert/POWER.md +66 -0
- package/workflows/powers/drizzle-expert/SKILL.md +63 -0
- package/workflows/powers/drizzle-expert/references/runtime-pairing-matrix.md +16 -0
- package/workflows/powers/drizzle-expert/references/schema-and-migration-playbook.md +18 -0
- package/workflows/powers/error-ux-observability/POWER.md +144 -131
- package/workflows/powers/error-ux-observability/SKILL.md +143 -131
- package/workflows/powers/fastapi-expert/POWER.md +46 -60
- package/workflows/powers/fastapi-expert/SKILL.md +46 -60
- package/workflows/powers/firebase/POWER.md +65 -0
- package/workflows/powers/firebase/SKILL.md +62 -0
- package/workflows/powers/firebase/references/platform-routing.md +16 -0
- package/workflows/powers/firebase/references/rules-and-indexes-checklist.md +11 -0
- package/workflows/powers/flutter-design-system/POWER.md +63 -0
- package/workflows/powers/flutter-design-system/SKILL.md +60 -0
- package/workflows/powers/flutter-design-system/references/shared-widgets.md +29 -0
- package/workflows/powers/flutter-design-system/references/tokens-and-theme.md +34 -0
- package/workflows/powers/flutter-drift/POWER.md +65 -0
- package/workflows/powers/flutter-drift/SKILL.md +62 -0
- package/workflows/powers/flutter-drift/references/migrations.md +22 -0
- package/workflows/powers/flutter-drift/references/query-patterns.md +26 -0
- package/workflows/powers/flutter-feature/POWER.md +65 -0
- package/workflows/powers/flutter-feature/SKILL.md +62 -0
- package/workflows/powers/flutter-feature/references/architecture-rules.md +85 -0
- package/workflows/powers/flutter-feature/references/composite-provider.md +58 -0
- package/workflows/powers/flutter-feature/references/outbox-pattern.md +87 -0
- package/workflows/powers/flutter-feature/references/testing-patterns.md +218 -0
- package/workflows/powers/flutter-go-router/POWER.md +64 -0
- package/workflows/powers/flutter-go-router/SKILL.md +61 -0
- package/workflows/powers/flutter-go-router/references/guards-and-deeplinks.md +20 -0
- package/workflows/powers/flutter-go-router/references/typed-routes.md +27 -0
- package/workflows/powers/flutter-offline-sync/POWER.md +62 -0
- package/workflows/powers/flutter-offline-sync/SKILL.md +59 -0
- package/workflows/powers/flutter-offline-sync/references/outbox-full.md +44 -0
- package/workflows/powers/flutter-repository/POWER.md +64 -0
- package/workflows/powers/flutter-repository/SKILL.md +61 -0
- package/workflows/powers/flutter-repository/references/drift-patterns.md +21 -0
- package/workflows/powers/flutter-repository/references/retrofit-patterns.md +20 -0
- package/workflows/powers/flutter-riverpod/POWER.md +70 -0
- package/workflows/powers/flutter-riverpod/SKILL.md +67 -0
- package/workflows/powers/flutter-riverpod/references/async-and-mutations.md +19 -0
- package/workflows/powers/flutter-riverpod/references/async-lifecycle.md +19 -0
- package/workflows/powers/flutter-riverpod/references/provider-selection.md +20 -0
- package/workflows/powers/flutter-riverpod/references/testing.md +21 -0
- package/workflows/powers/flutter-riverpod/references/version-matrix.md +24 -0
- package/workflows/powers/flutter-state-machine/POWER.md +62 -0
- package/workflows/powers/flutter-state-machine/SKILL.md +59 -0
- package/workflows/powers/flutter-state-machine/references/app-state-contract.md +23 -0
- package/workflows/powers/flutter-state-machine/references/ui-rendering.md +14 -0
- package/workflows/powers/flutter-testing/POWER.md +64 -0
- package/workflows/powers/flutter-testing/SKILL.md +61 -0
- package/workflows/powers/flutter-testing/references/offline-sync-tests.md +16 -0
- package/workflows/powers/flutter-testing/references/test-layers.md +33 -0
- package/workflows/powers/frontend-code-review/POWER.md +137 -0
- package/workflows/powers/frontend-code-review/SKILL.md +134 -0
- package/workflows/powers/frontend-code-review/references/common-antipatterns.md +86 -0
- package/workflows/powers/frontend-code-review/references/performance-budgets.md +56 -0
- package/workflows/powers/frontend-code-review/references/review-checklists.md +47 -0
- package/workflows/powers/frontend-design/POWER.md +163 -362
- package/workflows/powers/frontend-design/SKILL.md +163 -362
- package/workflows/powers/game-development/POWER.md +57 -140
- package/workflows/powers/game-development/SKILL.md +57 -140
- package/workflows/powers/geo-fundamentals/POWER.md +64 -126
- package/workflows/powers/geo-fundamentals/SKILL.md +64 -127
- package/workflows/powers/git-workflow/POWER.md +135 -0
- package/workflows/powers/git-workflow/SKILL.md +132 -0
- package/workflows/powers/git-workflow/references/pr-review-checklist.md +63 -0
- package/workflows/powers/golang-pro/POWER.md +46 -35
- package/workflows/powers/golang-pro/SKILL.md +46 -35
- package/workflows/powers/graphql-architect/POWER.md +44 -62
- package/workflows/powers/graphql-architect/SKILL.md +44 -62
- package/workflows/powers/i18n-localization/POWER.md +118 -103
- package/workflows/powers/i18n-localization/SKILL.md +118 -103
- package/workflows/powers/java-pro/POWER.md +47 -22
- package/workflows/powers/java-pro/SKILL.md +47 -22
- package/workflows/powers/javascript-pro/POWER.md +47 -34
- package/workflows/powers/javascript-pro/SKILL.md +47 -34
- package/workflows/powers/kotlin-pro/POWER.md +46 -23
- package/workflows/powers/kotlin-pro/SKILL.md +46 -23
- package/workflows/powers/legacy-modernizer/POWER.md +43 -60
- package/workflows/powers/legacy-modernizer/SKILL.md +43 -60
- package/workflows/powers/mcp-builder/POWER.md +65 -0
- package/workflows/powers/mcp-builder/SKILL.md +62 -0
- package/workflows/powers/mcp-builder/references/testing-and-evals.md +17 -0
- package/workflows/powers/mcp-builder/references/transport-and-tool-design.md +17 -0
- package/workflows/powers/microservices-architect/POWER.md +43 -70
- package/workflows/powers/microservices-architect/SKILL.md +43 -70
- package/workflows/powers/mobile-design/POWER.md +110 -345
- package/workflows/powers/mobile-design/SKILL.md +110 -345
- package/workflows/powers/mongodb/POWER.md +67 -0
- package/workflows/powers/mongodb/SKILL.md +64 -0
- package/workflows/powers/mongodb/references/mongodb-checklist.md +20 -0
- package/workflows/powers/mysql/POWER.md +67 -0
- package/workflows/powers/mysql/SKILL.md +64 -0
- package/workflows/powers/mysql/references/mysql-checklist.md +20 -0
- package/workflows/powers/neki/POWER.md +67 -0
- package/workflows/powers/neki/SKILL.md +64 -0
- package/workflows/powers/neki/references/neki-checklist.md +18 -0
- package/workflows/powers/nestjs-expert/POWER.md +45 -91
- package/workflows/powers/nestjs-expert/SKILL.md +45 -91
- package/workflows/powers/nextjs-developer/POWER.md +51 -44
- package/workflows/powers/nextjs-developer/SKILL.md +51 -44
- package/workflows/powers/nodejs-best-practices/POWER.md +48 -29
- package/workflows/powers/nodejs-best-practices/SKILL.md +48 -29
- package/workflows/powers/observability/POWER.md +109 -0
- package/workflows/powers/observability/SKILL.md +106 -0
- package/workflows/powers/observability/references/alerting-and-slo-checklist.md +87 -0
- package/workflows/powers/observability/references/opentelemetry-setup-guide.md +121 -0
- package/workflows/powers/openai-docs/POWER.md +61 -0
- package/workflows/powers/openai-docs/SKILL.md +58 -0
- package/workflows/powers/openai-docs/references/official-source-playbook.md +10 -0
- package/workflows/powers/performance-profiling/POWER.md +61 -114
- package/workflows/powers/performance-profiling/SKILL.md +61 -114
- package/workflows/powers/php-pro/POWER.md +116 -0
- package/workflows/powers/php-pro/SKILL.md +113 -0
- package/workflows/powers/php-pro/references/architecture-and-di.md +239 -0
- package/workflows/powers/php-pro/references/modern-php-features.md +189 -0
- package/workflows/powers/php-pro/references/performance-and-deployment.md +197 -0
- package/workflows/powers/php-pro/references/php84-strict-typing-checklist.md +161 -0
- package/workflows/powers/php-pro/references/testing-and-static-analysis.md +235 -0
- package/workflows/powers/playwright-e2e/POWER.md +85 -0
- package/workflows/powers/playwright-e2e/SKILL.md +82 -0
- package/workflows/powers/playwright-e2e/references/locator-trace-flake-checklist.md +80 -0
- package/workflows/powers/postgres/POWER.md +67 -0
- package/workflows/powers/postgres/SKILL.md +64 -0
- package/workflows/powers/postgres/references/postgres-checklist.md +20 -0
- package/workflows/powers/prompt-engineer/POWER.md +47 -30
- package/workflows/powers/prompt-engineer/SKILL.md +47 -30
- package/workflows/powers/python-pro/POWER.md +47 -36
- package/workflows/powers/python-pro/SKILL.md +47 -36
- package/workflows/powers/react-best-practices/POWER.md +56 -33
- package/workflows/powers/react-best-practices/SKILL.md +56 -33
- package/workflows/powers/react-expert/POWER.md +47 -37
- package/workflows/powers/react-expert/SKILL.md +47 -37
- package/workflows/powers/redis/POWER.md +67 -0
- package/workflows/powers/redis/SKILL.md +64 -0
- package/workflows/powers/redis/references/redis-checklist.md +19 -0
- package/workflows/powers/ruby-pro/POWER.md +118 -0
- package/workflows/powers/ruby-pro/SKILL.md +115 -0
- package/workflows/powers/ruby-pro/references/modern-ruby-features.md +189 -0
- package/workflows/powers/ruby-pro/references/object-design-patterns.md +220 -0
- package/workflows/powers/ruby-pro/references/performance-and-profiling.md +224 -0
- package/workflows/powers/ruby-pro/references/ruby-concurrency-and-testing.md +190 -0
- package/workflows/powers/ruby-pro/references/testing-and-rspec.md +236 -0
- package/workflows/powers/rust-pro/POWER.md +45 -31
- package/workflows/powers/rust-pro/SKILL.md +45 -31
- package/workflows/powers/security-engineer/POWER.md +129 -0
- package/workflows/powers/security-engineer/SKILL.md +126 -0
- package/workflows/powers/seo-fundamentals/POWER.md +59 -102
- package/workflows/powers/seo-fundamentals/SKILL.md +59 -102
- package/workflows/powers/serverless-patterns/POWER.md +171 -0
- package/workflows/powers/serverless-patterns/SKILL.md +168 -0
- package/workflows/powers/skill-creator/POWER.md +90 -0
- package/workflows/powers/skill-creator/SKILL.md +87 -0
- package/workflows/powers/skill-creator/references/platform-formats.md +181 -0
- package/workflows/powers/skill-creator/references/schemas.md +430 -0
- package/workflows/powers/spec-miner/POWER.md +49 -57
- package/workflows/powers/spec-miner/SKILL.md +49 -57
- package/workflows/powers/sqlite/POWER.md +67 -0
- package/workflows/powers/sqlite/SKILL.md +64 -0
- package/workflows/powers/sqlite/references/sqlite-checklist.md +19 -0
- package/workflows/powers/sre-engineer/POWER.md +123 -64
- package/workflows/powers/sre-engineer/SKILL.md +123 -64
- package/workflows/powers/static-analysis/POWER.md +121 -77
- package/workflows/powers/static-analysis/SKILL.md +121 -77
- package/workflows/powers/stripe-best-practices/POWER.md +140 -17
- package/workflows/powers/stripe-best-practices/SKILL.md +139 -17
- package/workflows/powers/supabase/POWER.md +67 -0
- package/workflows/powers/supabase/SKILL.md +64 -0
- package/workflows/powers/supabase/references/supabase-checklist.md +19 -0
- package/workflows/powers/swift-pro/POWER.md +118 -0
- package/workflows/powers/swift-pro/SKILL.md +115 -0
- package/workflows/powers/swift-pro/references/concurrency-patterns.md +165 -0
- package/workflows/powers/swift-pro/references/protocol-and-generics.md +172 -0
- package/workflows/powers/swift-pro/references/sendable-and-isolation.md +116 -0
- package/workflows/powers/swift-pro/references/swift-concurrency-and-protocols.md +260 -0
- package/workflows/powers/swift-pro/references/testing-and-packages.md +192 -0
- package/workflows/powers/tailwind-patterns/POWER.md +71 -240
- package/workflows/powers/tailwind-patterns/SKILL.md +71 -240
- package/workflows/powers/testing-patterns/POWER.md +155 -10
- package/workflows/powers/testing-patterns/SKILL.md +155 -10
- package/workflows/powers/typescript-pro/POWER.md +47 -38
- package/workflows/powers/typescript-pro/SKILL.md +47 -38
- package/workflows/powers/vitess/POWER.md +67 -0
- package/workflows/powers/vitess/SKILL.md +64 -0
- package/workflows/powers/vitess/references/vitess-checklist.md +19 -0
- package/workflows/powers/vulnerability-scanner/POWER.md +146 -10
- package/workflows/powers/vulnerability-scanner/SKILL.md +146 -10
- package/workflows/powers/web-perf/POWER.md +43 -170
- package/workflows/powers/web-perf/SKILL.md +43 -170
- package/workflows/powers/webapp-testing/POWER.md +43 -164
- package/workflows/powers/webapp-testing/SKILL.md +43 -164
|
@@ -1,418 +1,219 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: frontend-design
|
|
3
|
-
description:
|
|
4
|
-
|
|
3
|
+
description: Create distinctive, production-grade frontend interfaces with high design quality. Use when building pages, dashboards, or applications. Generates polished code that avoids generic AI aesthetics.
|
|
4
|
+
license: Apache-2.0
|
|
5
|
+
metadata:
|
|
6
|
+
author: cubis-foundry
|
|
7
|
+
version: "3.0"
|
|
8
|
+
compatibility: Claude Code, Codex, GitHub Copilot, Gemini CLI
|
|
5
9
|
---
|
|
6
10
|
|
|
7
|
-
# Frontend Design
|
|
11
|
+
# Frontend Design
|
|
8
12
|
|
|
9
|
-
|
|
10
|
-
> **Core Principle:** THINK, don't memorize. ASK, don't assume.
|
|
13
|
+
## Purpose
|
|
11
14
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
## 🎯 Selective Reading Rule (MANDATORY)
|
|
15
|
-
|
|
16
|
-
**Read REQUIRED files always, OPTIONAL only when needed:**
|
|
17
|
-
|
|
18
|
-
| File | Status | When to Read |
|
|
19
|
-
|------|--------|--------------|
|
|
20
|
-
| [ux-psychology.md](ux-psychology.md) | 🔴 **REQUIRED** | Always read first! |
|
|
21
|
-
| [color-system.md](color-system.md) | ⚪ Optional | Color/palette decisions |
|
|
22
|
-
| [typography-system.md](typography-system.md) | ⚪ Optional | Font selection/pairing |
|
|
23
|
-
| [visual-effects.md](visual-effects.md) | ⚪ Optional | Glassmorphism, shadows, gradients |
|
|
24
|
-
| [animation-guide.md](animation-guide.md) | ⚪ Optional | Animation needed |
|
|
25
|
-
| [motion-graphics.md](motion-graphics.md) | ⚪ Optional | Lottie, GSAP, 3D |
|
|
26
|
-
| [decision-trees.md](decision-trees.md) | ⚪ Optional | Context templates |
|
|
27
|
-
|
|
28
|
-
> 🔴 **ux-psychology.md = ALWAYS READ. Others = only if relevant.**
|
|
29
|
-
|
|
30
|
-
---
|
|
31
|
-
|
|
32
|
-
## 🔧 Runtime Scripts
|
|
33
|
-
|
|
34
|
-
**Execute these for audits (don't read, just run):**
|
|
35
|
-
|
|
36
|
-
| Script | Purpose | Usage |
|
|
37
|
-
|--------|---------|-------|
|
|
38
|
-
| `scripts/ux_audit.py` | UX Psychology & Accessibility Audit | `python scripts/ux_audit.py <project_path>` |
|
|
39
|
-
|
|
40
|
-
---
|
|
41
|
-
|
|
42
|
-
## ⚠️ CRITICAL: ASK BEFORE ASSUMING (MANDATORY)
|
|
43
|
-
|
|
44
|
-
> **STOP! If the user's request is open-ended, DO NOT default to your favorites.**
|
|
45
|
-
|
|
46
|
-
### When User Prompt is Vague, ASK:
|
|
47
|
-
|
|
48
|
-
**Color not specified?** Ask:
|
|
49
|
-
> "What color palette do you prefer? (blue/green/orange/neutral/other?)"
|
|
50
|
-
|
|
51
|
-
**Style not specified?** Ask:
|
|
52
|
-
> "What style are you going for? (minimal/bold/retro/futuristic/organic?)"
|
|
53
|
-
|
|
54
|
-
**Layout not specified?** Ask:
|
|
55
|
-
> "Do you have a layout preference? (single column/grid/asymmetric/full-width?)"
|
|
56
|
-
|
|
57
|
-
### ⛔ DEFAULT TENDENCIES TO AVOID (ANTI-SAFE HARBOR):
|
|
58
|
-
|
|
59
|
-
| AI Default Tendency | Why It's Bad | Think Instead |
|
|
60
|
-
|---------------------|--------------|---------------|
|
|
61
|
-
| **Bento Grids (Modern Cliché)** | Used in every AI design | Why does this content NEED a grid? |
|
|
62
|
-
| **Hero Split (Left/Right)** | Predictable & Boring | How about Massive Typography or Vertical Narrative? |
|
|
63
|
-
| **Mesh/Aurora Gradients** | The "new" lazy background | What's a radical color pairing? |
|
|
64
|
-
| **Glassmorphism** | AI's idea of "premium" | How about solid, high-contrast flat? |
|
|
65
|
-
| **Deep Cyan / Fintech Blue** | Safe harbor from purple ban | Why not Red, Black, or Neon Green? |
|
|
66
|
-
| **"Orchestrate / Empower"** | AI-generated copywriting | How would a human say this? |
|
|
67
|
-
| Dark background + neon glow | Overused, "AI look" | What does the BRAND actually need? |
|
|
68
|
-
| **Rounded everything** | Generic/Safe | Where can I use sharp, brutalist edges? |
|
|
15
|
+
Guide creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Synthesize design thinking, visual direction, and implementation into working code with exceptional attention to aesthetic details, accessibility, and creative choices. Serve both technical and non-technical users with clear communication about design decisions.
|
|
69
16
|
|
|
70
|
-
|
|
17
|
+
## When to Use
|
|
71
18
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
| **Timeline** | How much time? | Determines complexity |
|
|
81
|
-
| **Content** | Ready or placeholder? | Affects layout flexibility |
|
|
82
|
-
| **Brand** | Existing guidelines? | May dictate colors/fonts |
|
|
83
|
-
| **Tech** | What stack? | Affects capabilities |
|
|
84
|
-
| **Audience** | Who exactly? | Drives all visual decisions |
|
|
85
|
-
|
|
86
|
-
### Audience → Design Approach
|
|
87
|
-
|
|
88
|
-
| Audience | Think About |
|
|
89
|
-
|----------|-------------|
|
|
90
|
-
| **Gen Z** | Bold, fast, mobile-first, authentic |
|
|
91
|
-
| **Millennials** | Clean, minimal, value-driven |
|
|
92
|
-
| **Gen X** | Familiar, trustworthy, clear |
|
|
93
|
-
| **Boomers** | Readable, high contrast, simple |
|
|
94
|
-
| **B2B** | Professional, data-focused, trust |
|
|
95
|
-
| **Luxury** | Restrained elegance, whitespace |
|
|
96
|
-
|
|
97
|
-
---
|
|
98
|
-
|
|
99
|
-
## 2. UX Psychology Principles
|
|
100
|
-
|
|
101
|
-
### Core Laws (Internalize These)
|
|
19
|
+
- Building web components, pages, artifacts, posters, or applications
|
|
20
|
+
- Designing layouts, choosing visual direction, or selecting typography
|
|
21
|
+
- Creating dashboards, landing pages, marketing sites, or SaaS interfaces
|
|
22
|
+
- Reviewing interface clarity, visual hierarchy, or interaction patterns
|
|
23
|
+
- Styling or beautifying existing web UI that looks generic or templated
|
|
24
|
+
- Making color system decisions (palettes, dark mode, contrast)
|
|
25
|
+
- Adding motion, animation, or micro-interactions to an interface
|
|
26
|
+
- Designing component states (hover, active, disabled, loading, error, empty)
|
|
102
27
|
|
|
103
|
-
|
|
104
|
-
|-----|-----------|-------------|
|
|
105
|
-
| **Hick's Law** | More choices = slower decisions | Limit options, use progressive disclosure |
|
|
106
|
-
| **Fitts' Law** | Bigger + closer = easier to click | Size CTAs appropriately |
|
|
107
|
-
| **Miller's Law** | ~7 items in working memory | Chunk content into groups |
|
|
108
|
-
| **Von Restorff** | Different = memorable | Make CTAs visually distinct |
|
|
109
|
-
| **Serial Position** | First/last remembered most | Key info at start/end |
|
|
28
|
+
## Instructions
|
|
110
29
|
|
|
111
|
-
###
|
|
30
|
+
### Step 1 — Understand the Context
|
|
112
31
|
|
|
113
|
-
|
|
114
|
-
VISCERAL (instant) → First impression: colors, imagery, overall feel
|
|
115
|
-
BEHAVIORAL (use) → Using it: speed, feedback, efficiency
|
|
116
|
-
REFLECTIVE (memory) → After: "I like what this says about me"
|
|
117
|
-
```
|
|
32
|
+
Before writing code, ask or infer:
|
|
118
33
|
|
|
119
|
-
|
|
34
|
+
1. **Purpose** — What problem does this interface solve? Who uses it?
|
|
35
|
+
2. **Brand** — Is there an existing brand system, style guide, or named brand (e.g. "Anthropic", client guidelines, hex palette) to follow? If yes, load `references/brand-presets.md` and use `/brand` to apply it before choosing aesthetic direction.
|
|
36
|
+
3. **Tone** — If no brand system exists, pick a bold aesthetic direction: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian. There are many flavors. Pick one and commit.
|
|
37
|
+
4. **Constraints** — Technical requirements (framework, performance, a11y level, browser support).
|
|
38
|
+
5. **Differentiation** — What makes this UNFORGETTABLE? What's the one thing someone will remember?
|
|
120
39
|
|
|
121
|
-
|
|
122
|
-
- Social proof where relevant
|
|
123
|
-
- Clear contact/support access
|
|
124
|
-
- Consistent, professional design
|
|
125
|
-
- Transparent policies
|
|
40
|
+
Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work — the key is intentionality, not intensity.
|
|
126
41
|
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
## 3. Layout Principles
|
|
130
|
-
|
|
131
|
-
### Golden Ratio (φ = 1.618)
|
|
132
|
-
|
|
133
|
-
```
|
|
134
|
-
Use for proportional harmony:
|
|
135
|
-
├── Content : Sidebar = roughly 62% : 38%
|
|
136
|
-
├── Each heading size = previous × 1.618 (for dramatic scale)
|
|
137
|
-
├── Spacing can follow: sm → md → lg (each × 1.618)
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
### 8-Point Grid Concept
|
|
42
|
+
When communicating with non-technical users: explain design decisions in plain language. Say "this font pairing creates a sense of professionalism" rather than "I used a sans-serif display font with a serif body font." Show the reasoning, not the jargon.
|
|
141
43
|
|
|
142
|
-
|
|
143
|
-
All spacing and sizing in multiples of 8:
|
|
144
|
-
├── Tight: 4px (half-step for micro)
|
|
145
|
-
├── Small: 8px
|
|
146
|
-
├── Medium: 16px
|
|
147
|
-
├── Large: 24px, 32px
|
|
148
|
-
├── XL: 48px, 64px, 80px
|
|
149
|
-
└── Adjust based on content density
|
|
150
|
-
```
|
|
44
|
+
### Step 2 — Commit to a Design Direction
|
|
151
45
|
|
|
152
|
-
|
|
46
|
+
Implement working code that is:
|
|
153
47
|
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
| **Inputs** | Match button height for alignment |
|
|
159
|
-
| **Cards** | Consistent padding, breathable |
|
|
160
|
-
| **Reading width** | 45-75 characters optimal |
|
|
48
|
+
- Production-grade and functional
|
|
49
|
+
- Visually striking and memorable
|
|
50
|
+
- Cohesive with a clear aesthetic point-of-view
|
|
51
|
+
- Meticulously refined in every detail
|
|
161
52
|
|
|
162
|
-
|
|
53
|
+
Match implementation complexity to the aesthetic vision. Maximalist designs need elaborate code with extensive animations and effects. Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details.
|
|
163
54
|
|
|
164
|
-
|
|
55
|
+
### Step 3 — Apply Aesthetics Guidelines
|
|
165
56
|
|
|
166
|
-
|
|
57
|
+
For each domain, follow the DO/DON'T guidance below. Load the corresponding reference file when deeper expertise is needed.
|
|
167
58
|
|
|
168
|
-
|
|
169
|
-
60% → Primary/Background (calm, neutral base)
|
|
170
|
-
30% → Secondary (supporting areas)
|
|
171
|
-
10% → Accent (CTAs, highlights, attention)
|
|
172
|
-
```
|
|
59
|
+
**Typography** → see `references/typography.md`
|
|
173
60
|
|
|
174
|
-
|
|
61
|
+
- DO: Use a modular type scale with fluid sizing (clamp)
|
|
62
|
+
- DO: Vary font weights and sizes to create clear visual hierarchy
|
|
63
|
+
- DO: Choose fonts that are beautiful, unique, and interesting — pair a distinctive display font with a refined body font
|
|
64
|
+
- DON'T: Use overused fonts — Inter, Roboto, Arial, Open Sans, system defaults
|
|
65
|
+
- DON'T: Use monospace typography as lazy shorthand for "technical/developer" vibes
|
|
66
|
+
- DON'T: Put large icons with rounded corners above every heading
|
|
175
67
|
|
|
176
|
-
|
|
177
|
-
|----------------|---------------|-------|
|
|
178
|
-
| Trust, calm | Blue family | Aggressive reds |
|
|
179
|
-
| Growth, nature | Green family | Industrial grays |
|
|
180
|
-
| Energy, urgency | Orange, red | Passive blues |
|
|
181
|
-
| Luxury, creativity | Deep Teal, Gold, Emerald | Cheap-feeling brights |
|
|
182
|
-
| Clean, minimal | Neutrals | Overwhelming color |
|
|
68
|
+
**Color & Theme** → see `references/color-and-contrast.md`
|
|
183
69
|
|
|
184
|
-
|
|
70
|
+
- DO: Use modern CSS color functions (oklch, color-mix, light-dark) for perceptually uniform, maintainable palettes
|
|
71
|
+
- DO: Tint neutrals toward the brand hue for subconscious cohesion
|
|
72
|
+
- DON'T: Use gray text on colored backgrounds — use a shade of the background color instead
|
|
73
|
+
- DON'T: Use pure black (#000) or pure white (#fff) — always tint; pure values never appear in nature
|
|
74
|
+
- DON'T: Use the AI color palette: cyan-on-dark, purple-to-blue gradients, neon accents on dark backgrounds
|
|
75
|
+
- DON'T: Default to dark mode with glowing accents — it looks "cool" without requiring actual design decisions
|
|
185
76
|
|
|
186
|
-
|
|
187
|
-
2. **What's the emotion?** (picks primary)
|
|
188
|
-
3. **Light or dark mode?** (sets foundation)
|
|
189
|
-
4. **ASK USER** if not specified
|
|
77
|
+
**Layout & Space** → see `references/spatial-design.md`
|
|
190
78
|
|
|
191
|
-
|
|
79
|
+
- DO: Create visual rhythm through varied spacing — tight groupings, generous separations
|
|
80
|
+
- DO: Use fluid spacing with clamp() that breathes on larger screens
|
|
81
|
+
- DO: Use asymmetry and unexpected compositions; break the grid intentionally for emphasis
|
|
82
|
+
- DON'T: Wrap everything in cards — not everything needs a container
|
|
83
|
+
- DON'T: Nest cards inside cards — visual noise, flatten the hierarchy
|
|
84
|
+
- DON'T: Use identical card grids — same-sized cards with icon + heading + text, repeated endlessly
|
|
85
|
+
- DON'T: Center everything — left-aligned text with asymmetric layouts feels more designed
|
|
86
|
+
- DON'T: Use the same spacing everywhere — without rhythm, layouts feel monotonous
|
|
192
87
|
|
|
193
|
-
|
|
88
|
+
**Visual Details**
|
|
194
89
|
|
|
195
|
-
|
|
90
|
+
- DO: Use intentional, purposeful decorative elements that reinforce brand
|
|
91
|
+
- DON'T: Use glassmorphism everywhere — blur effects and glass cards used decoratively rather than purposefully
|
|
92
|
+
- DON'T: Use rounded rectangles with generic drop shadows — safe, forgettable
|
|
93
|
+
- DON'T: Use sparklines as decoration — tiny charts that convey nothing meaningful
|
|
94
|
+
- DON'T: Use modals unless there's truly no better alternative
|
|
196
95
|
|
|
197
|
-
|
|
96
|
+
**Motion** → see `references/motion-design.md`
|
|
198
97
|
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
| Hero/display | 1.5-1.618 | Dramatic impact |
|
|
98
|
+
- DO: Use motion to convey state changes — entrances, exits, feedback
|
|
99
|
+
- DO: Use exponential easing (ease-out-quart/quint/expo) for natural deceleration
|
|
100
|
+
- DO: For height animations, use grid-template-rows transitions instead of animating height directly
|
|
101
|
+
- DON'T: Animate layout properties (width, height, padding, margin) — use transform and opacity only
|
|
102
|
+
- DON'T: Use bounce or elastic easing — they feel dated and tacky
|
|
205
103
|
|
|
206
|
-
|
|
104
|
+
**Interaction** → see `references/interaction-design.md`
|
|
207
105
|
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
```
|
|
106
|
+
- DO: Use progressive disclosure — start simple, reveal sophistication through interaction
|
|
107
|
+
- DO: Design empty states that teach the interface, not just say "nothing here"
|
|
108
|
+
- DO: Make every interactive surface feel intentional and responsive
|
|
109
|
+
- DON'T: Repeat the same information — redundant headers, intros that restate the heading
|
|
110
|
+
- DON'T: Make every button primary — use ghost buttons, text links, secondary styles; hierarchy matters
|
|
214
111
|
|
|
215
|
-
|
|
112
|
+
**Responsive** → see `references/responsive-design.md`
|
|
216
113
|
|
|
217
|
-
-
|
|
218
|
-
-
|
|
219
|
-
-
|
|
220
|
-
- **Size**: 16px+ for body on web
|
|
114
|
+
- DO: Use container queries (@container) for component-level responsiveness
|
|
115
|
+
- DO: Adapt the interface for different contexts — don't just shrink it
|
|
116
|
+
- DON'T: Hide critical functionality on mobile — adapt the interface, don't amputate it
|
|
221
117
|
|
|
222
|
-
|
|
118
|
+
**UX Writing** → see `references/ux-writing.md`
|
|
223
119
|
|
|
224
|
-
|
|
120
|
+
- DO: Make every word earn its place
|
|
121
|
+
- DON'T: Repeat information users can already see
|
|
225
122
|
|
|
226
|
-
|
|
123
|
+
### Step 4 — Run the AI Slop Test
|
|
227
124
|
|
|
228
|
-
|
|
125
|
+
Before delivering, review: if you showed this interface to someone and said "AI made this," would they believe you immediately? If yes, that's the problem.
|
|
229
126
|
|
|
230
|
-
|
|
231
|
-
Key properties:
|
|
232
|
-
├── Semi-transparent background
|
|
233
|
-
├── Backdrop blur
|
|
234
|
-
├── Subtle border for definition
|
|
235
|
-
└── ⚠️ **WARNING:** Standard blue/white glassmorphism is a modern cliché. Use it radically or not at all.
|
|
236
|
-
```
|
|
127
|
+
A distinctive interface should make someone ask "how was this made?" not "which AI made this?"
|
|
237
128
|
|
|
238
|
-
|
|
129
|
+
Review the DON'T guidelines above — they are the fingerprints of AI-generated work. Also check for these anti-patterns:
|
|
239
130
|
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
└── Dark mode: may need glow instead
|
|
246
|
-
```
|
|
131
|
+
- Bento grids (modern cliché)
|
|
132
|
+
- Hero splits with image/text 50-50 (predictable)
|
|
133
|
+
- Mesh/Aurora gradients (lazy atmosphere)
|
|
134
|
+
- Deep cyan / fintech blue (safe harbor color)
|
|
135
|
+
- Gradient text for "impact" — especially on metrics or headings
|
|
247
136
|
|
|
248
|
-
###
|
|
137
|
+
### Step 5 — Verify Accessibility
|
|
249
138
|
|
|
250
|
-
|
|
251
|
-
Harmonious gradients:
|
|
252
|
-
├── Adjacent colors on wheel (analogous)
|
|
253
|
-
├── OR same hue, different lightness
|
|
254
|
-
├── Avoid harsh complementary pairs
|
|
255
|
-
├── 🚫 **NO Mesh/Aurora Gradients** (floating blobs)
|
|
256
|
-
└── VARY from project to project radically
|
|
257
|
-
```
|
|
139
|
+
Do not treat visual polish as a substitute for accessibility:
|
|
258
140
|
|
|
259
|
-
|
|
141
|
+
1. Confirm color contrast ratios meet WCAG 2.1 AA (4.5:1 for normal text, 3:1 for large text)
|
|
142
|
+
2. Verify all interactive elements are keyboard-navigable
|
|
143
|
+
3. Add appropriate ARIA attributes where semantic HTML is insufficient
|
|
144
|
+
4. Ensure motion respects `prefers-reduced-motion`
|
|
145
|
+
5. Test focus states are visible and intentional
|
|
260
146
|
|
|
261
|
-
|
|
147
|
+
### Step 6 — Explain Decisions to the User
|
|
262
148
|
|
|
263
|
-
|
|
149
|
+
When delivering, explain:
|
|
264
150
|
|
|
265
|
-
|
|
151
|
+
- What aesthetic direction was chosen and why
|
|
152
|
+
- Key design decisions the user should understand
|
|
153
|
+
- What trade-offs were made (performance, browser support, complexity)
|
|
154
|
+
- What to change if the user wants to adjust the direction
|
|
266
155
|
|
|
267
|
-
|
|
268
|
-
Duration based on:
|
|
269
|
-
├── Distance (further = longer)
|
|
270
|
-
├── Size (larger = slower)
|
|
271
|
-
├── Importance (critical = clear)
|
|
272
|
-
└── Context (urgent = fast, luxury = slow)
|
|
273
|
-
```
|
|
156
|
+
Use plain language. Avoid unexplained jargon. If the user is non-technical, lead with the visual impact and emotional tone, not the implementation details.
|
|
274
157
|
|
|
275
|
-
|
|
158
|
+
## Output Format
|
|
159
|
+
|
|
160
|
+
Deliver:
|
|
161
|
+
|
|
162
|
+
1. **Working code** — Production-grade HTML/CSS/JS, React, Vue, Svelte, or framework-specific code
|
|
163
|
+
2. **Design rationale** — Brief explanation of aesthetic direction, key choices, and trade-offs
|
|
164
|
+
3. **Accessibility notes** — Contrast ratios checked, keyboard navigation verified, ARIA attributes applied
|
|
165
|
+
4. **Next steps** — What to iterate on, what commands to run for refinement (see Commands section)
|
|
276
166
|
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
|
282
|
-
|
|
|
167
|
+
## References
|
|
168
|
+
|
|
169
|
+
Load only what the current step needs.
|
|
170
|
+
|
|
171
|
+
| File | Load when |
|
|
172
|
+
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
|
|
173
|
+
| `references/typography.md` | Task involves font selection, type scale, font loading, or text hierarchy decisions. |
|
|
174
|
+
| `references/color-and-contrast.md` | Task involves palette selection, dark mode, OKLCH color, contrast ratios, or tinted neutrals. |
|
|
175
|
+
| `references/spatial-design.md` | Task involves grid systems, spacing rhythm, container queries, or layout composition. |
|
|
176
|
+
| `references/motion-design.md` | Task involves animation timing, easing curves, staggered reveals, or reduced motion support. |
|
|
177
|
+
| `references/interaction-design.md` | Task involves form design, focus management, loading states, or progressive disclosure patterns. |
|
|
178
|
+
| `references/responsive-design.md` | Task involves mobile-first design, fluid layouts, container queries, or adaptive interfaces. |
|
|
179
|
+
| `references/ux-writing.md` | Task involves button labels, error messages, empty states, or microcopy decisions. |
|
|
180
|
+
| `references/ux-psychology.md` | Task involves cognitive load, decision architecture, trust building, or emotional design principles. |
|
|
181
|
+
| `references/brand-presets.md` | Task involves applying existing brand guidelines, a named brand system (e.g. Anthropic), or converting a hex palette into CSS tokens. |
|
|
283
182
|
|
|
284
|
-
|
|
183
|
+
## Commands
|
|
285
184
|
|
|
286
|
-
|
|
287
|
-
- Respect reduced-motion preference
|
|
288
|
-
- Test on low-end devices
|
|
185
|
+
17 specialized commands for targeted design operations. Each command focuses on a specific design concern and can be applied to a whole page or a specific element.
|
|
289
186
|
|
|
290
|
-
|
|
187
|
+
| Command | Purpose |
|
|
188
|
+
| ------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
189
|
+
| `/audit` | Run technical quality checks: accessibility, performance, responsive behavior |
|
|
190
|
+
| `/critique` | UX design review: hierarchy, clarity, emotional resonance, user flow |
|
|
191
|
+
| `/normalize` | Align with design system standards: tokens, spacing, typography consistency |
|
|
192
|
+
| `/polish` | Final pass before shipping: micro-details, alignment, visual refinement |
|
|
193
|
+
| `/distill` | Strip to essence: remove unnecessary complexity, simplify without losing character |
|
|
194
|
+
| `/clarify` | Improve unclear UX copy: labels, instructions, error messages, empty states |
|
|
195
|
+
| `/optimize` | Performance improvements: image sizes, render-blocking, bundle impact |
|
|
196
|
+
| `/harden` | Error handling, i18n readiness, edge cases, defensive UI patterns |
|
|
197
|
+
| `/animate` | Add purposeful motion: transitions, micro-interactions, state changes |
|
|
198
|
+
| `/colorize` | Introduce strategic color: palette refinement, accent placement, contrast fixes |
|
|
199
|
+
| `/bolder` | Amplify timid designs: stronger hierarchy, more contrast, bigger gestures |
|
|
200
|
+
| `/quieter` | Tone down overwhelming designs: reduce noise, increase whitespace, simplify |
|
|
201
|
+
| `/delight` | Add moments of joy: easter eggs, satisfying interactions, personality |
|
|
202
|
+
| `/extract` | Pull into reusable components: identify patterns, create component API |
|
|
203
|
+
| `/adapt` | Adapt for different devices: responsive breakpoints, touch targets, viewport optimization |
|
|
204
|
+
| `/onboard` | Design onboarding flows: first-run experience, empty states, progressive disclosure |
|
|
205
|
+
| `/teach-impeccable` | One-time setup: gather project design context, save preferences for future sessions |
|
|
206
|
+
| `/brand` | Apply or enforce a specific brand identity: convert guideline colors to CSS tokens, set typography, verify contrast |
|
|
291
207
|
|
|
292
|
-
|
|
208
|
+
Usage: Most commands accept an optional argument to focus on a specific area (e.g., `/audit header`, `/polish checkout-form`).
|
|
293
209
|
|
|
294
|
-
##
|
|
295
|
-
|
|
296
|
-
### Premium Indicators
|
|
297
|
-
|
|
298
|
-
- [ ] Generous whitespace (luxury = breathing room)
|
|
299
|
-
- [ ] Subtle depth and dimension
|
|
300
|
-
- [ ] Smooth, purposeful animations
|
|
301
|
-
- [ ] Attention to detail (alignment, consistency)
|
|
302
|
-
- [ ] Cohesive visual rhythm
|
|
303
|
-
- [ ] Custom elements (not all defaults)
|
|
304
|
-
|
|
305
|
-
### Trust Builders
|
|
306
|
-
|
|
307
|
-
- [ ] Security cues where appropriate
|
|
308
|
-
- [ ] Social proof / testimonials
|
|
309
|
-
- [ ] Clear value proposition
|
|
310
|
-
- [ ] Professional imagery
|
|
311
|
-
- [ ] Consistent design language
|
|
312
|
-
|
|
313
|
-
### Emotional Triggers
|
|
314
|
-
|
|
315
|
-
- [ ] Hero that evokes intended emotion
|
|
316
|
-
- [ ] Human elements (faces, stories)
|
|
317
|
-
- [ ] Progress/achievement indicators
|
|
318
|
-
- [ ] Moments of delight
|
|
319
|
-
|
|
320
|
-
---
|
|
321
|
-
|
|
322
|
-
## 9. Anti-Patterns (What NOT to Do)
|
|
323
|
-
|
|
324
|
-
### ❌ Lazy Design Indicators
|
|
325
|
-
|
|
326
|
-
- Default system fonts without consideration
|
|
327
|
-
- Stock imagery that doesn't match
|
|
328
|
-
- Inconsistent spacing
|
|
329
|
-
- Too many competing colors
|
|
330
|
-
- Walls of text without hierarchy
|
|
331
|
-
- Inaccessible contrast
|
|
332
|
-
|
|
333
|
-
### ❌ AI Tendency Patterns (AVOID!)
|
|
334
|
-
|
|
335
|
-
- **Same colors every project**
|
|
336
|
-
- **Dark + neon as default**
|
|
337
|
-
- **Purple/violet everything (PURPLE BAN ✅)**
|
|
338
|
-
- **Bento grids for simple landing pages**
|
|
339
|
-
- **Mesh Gradients & Glow Effects**
|
|
340
|
-
- **Same layout structure / Vercel clone**
|
|
341
|
-
- **Not asking user preferences**
|
|
342
|
-
|
|
343
|
-
### ❌ Dark Patterns (Unethical)
|
|
344
|
-
|
|
345
|
-
- Hidden costs
|
|
346
|
-
- Fake urgency
|
|
347
|
-
- Forced actions
|
|
348
|
-
- Deceptive UI
|
|
349
|
-
- Confirmshaming
|
|
350
|
-
|
|
351
|
-
---
|
|
352
|
-
|
|
353
|
-
## 10. Decision Process Summary
|
|
354
|
-
|
|
355
|
-
```
|
|
356
|
-
For EVERY design task:
|
|
357
|
-
|
|
358
|
-
1. CONSTRAINTS
|
|
359
|
-
└── What's the timeline, brand, tech, audience?
|
|
360
|
-
└── If unclear → ASK
|
|
361
|
-
|
|
362
|
-
2. CONTENT
|
|
363
|
-
└── What content exists?
|
|
364
|
-
└── What's the hierarchy?
|
|
365
|
-
|
|
366
|
-
3. STYLE DIRECTION
|
|
367
|
-
└── What's appropriate for context?
|
|
368
|
-
└── If unclear → ASK (don't default!)
|
|
369
|
-
|
|
370
|
-
4. EXECUTION
|
|
371
|
-
└── Apply principles above
|
|
372
|
-
└── Check against anti-patterns
|
|
373
|
-
|
|
374
|
-
5. REVIEW
|
|
375
|
-
└── "Does this serve the user?"
|
|
376
|
-
└── "Is this different from my defaults?"
|
|
377
|
-
└── "Would I be proud of this?"
|
|
378
|
-
```
|
|
379
|
-
|
|
380
|
-
---
|
|
381
|
-
|
|
382
|
-
## Reference Files
|
|
383
|
-
|
|
384
|
-
For deeper guidance on specific areas:
|
|
385
|
-
|
|
386
|
-
- [color-system.md](color-system.md) - Color theory and selection process
|
|
387
|
-
- [typography-system.md](typography-system.md) - Font pairing and scale decisions
|
|
388
|
-
- [visual-effects.md](visual-effects.md) - Effects principles and techniques
|
|
389
|
-
- [animation-guide.md](animation-guide.md) - Motion design principles
|
|
390
|
-
- [motion-graphics.md](motion-graphics.md) - Advanced: Lottie, GSAP, SVG, 3D, Particles
|
|
391
|
-
- [decision-trees.md](decision-trees.md) - Context-specific templates
|
|
392
|
-
- [ux-psychology.md](ux-psychology.md) - User psychology deep dive
|
|
393
|
-
|
|
394
|
-
---
|
|
395
|
-
|
|
396
|
-
## Related Skills
|
|
397
|
-
|
|
398
|
-
| Skill | When to Use |
|
|
399
|
-
|-------|-------------|
|
|
400
|
-
| **frontend-design** (this) | Before coding - Learn design principles (color, typography, UX psychology) |
|
|
401
|
-
| **[web-design-guidelines](../web-design-guidelines/SKILL.md)** | After coding - Audit for accessibility, performance, and best practices |
|
|
402
|
-
|
|
403
|
-
## Post-Design Workflow
|
|
404
|
-
|
|
405
|
-
After implementing your design, run the audit:
|
|
406
|
-
|
|
407
|
-
```
|
|
408
|
-
1. DESIGN → Read frontend-design principles ← YOU ARE HERE
|
|
409
|
-
2. CODE → Implement the design
|
|
410
|
-
3. AUDIT → Run web-design-guidelines review
|
|
411
|
-
4. FIX → Address findings from audit
|
|
412
|
-
```
|
|
413
|
-
|
|
414
|
-
> **Next Step:** After coding, use `web-design-guidelines` skill to audit your implementation for accessibility, focus states, animations, and performance issues.
|
|
415
|
-
|
|
416
|
-
---
|
|
210
|
+
## Examples
|
|
417
211
|
|
|
418
|
-
|
|
212
|
+
- "Build a landing page for a developer tool — make it feel premium and editorial, not like every other SaaS template."
|
|
213
|
+
- "Redesign this dashboard. It looks like AI made it. Make it distinctive."
|
|
214
|
+
- "/audit this page — check accessibility, responsive behavior, and performance."
|
|
215
|
+
- "/critique the checkout flow — is the hierarchy clear? Does it build trust?"
|
|
216
|
+
- "/polish the hero section before we ship."
|
|
217
|
+
- "I need a color system for a health tech app. No fintech blue, no AI purple."
|
|
218
|
+
- "/brand anthropic — apply Anthropic's brand colors and typography to this interface."
|
|
219
|
+
- "Here's our brand guide with hex values. Apply it to this dashboard — /brand"
|