@heyai-rules/pilo-masterkit 2.1.0 β†’ 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (739) hide show
  1. package/.agent/agents/PILO_MASTER.md +77 -77
  2. package/.agent/agents/architect.md +211 -211
  3. package/.agent/agents/backend-specialist.md +263 -263
  4. package/.agent/agents/build-error-resolver.md +114 -114
  5. package/.agent/agents/chief-of-staff.md +151 -151
  6. package/.agent/agents/code-archaeologist.md +106 -106
  7. package/.agent/agents/code-reviewer.md +237 -237
  8. package/.agent/agents/cpp-build-resolver.md +90 -90
  9. package/.agent/agents/cpp-reviewer.md +72 -72
  10. package/.agent/agents/csharp-reviewer.md +101 -101
  11. package/.agent/agents/dart-build-resolver.md +201 -201
  12. package/.agent/agents/database-architect.md +226 -226
  13. package/.agent/agents/database-reviewer.md +91 -91
  14. package/.agent/agents/debugger.md +225 -225
  15. package/.agent/agents/devops-engineer.md +242 -242
  16. package/.agent/agents/doc-updater.md +107 -107
  17. package/.agent/agents/docs-lookup.md +68 -68
  18. package/.agent/agents/documentation-writer.md +104 -104
  19. package/.agent/agents/e2e-runner.md +107 -107
  20. package/.agent/agents/explorer-agent.md +73 -73
  21. package/.agent/agents/flutter-reviewer.md +243 -243
  22. package/.agent/agents/frontend-specialist.md +593 -593
  23. package/.agent/agents/game-developer.md +162 -162
  24. package/.agent/agents/gan-evaluator.md +209 -209
  25. package/.agent/agents/gan-generator.md +131 -131
  26. package/.agent/agents/gan-planner.md +99 -99
  27. package/.agent/agents/go-build-resolver.md +94 -94
  28. package/.agent/agents/go-reviewer.md +76 -76
  29. package/.agent/agents/harness-optimizer.md +35 -35
  30. package/.agent/agents/healthcare-reviewer.md +83 -83
  31. package/.agent/agents/java-build-resolver.md +153 -153
  32. package/.agent/agents/java-reviewer.md +92 -92
  33. package/.agent/agents/kotlin-build-resolver.md +118 -118
  34. package/.agent/agents/kotlin-reviewer.md +159 -159
  35. package/.agent/agents/loop-operator.md +36 -36
  36. package/.agent/agents/mobile-developer.md +377 -377
  37. package/.agent/agents/opensource-forker.md +198 -198
  38. package/.agent/agents/opensource-packager.md +249 -249
  39. package/.agent/agents/opensource-sanitizer.md +188 -188
  40. package/.agent/agents/orchestrator.md +416 -416
  41. package/.agent/agents/penetration-tester.md +188 -188
  42. package/.agent/agents/performance-optimizer.md +446 -446
  43. package/.agent/agents/personas/athena-agent/agent.json +10 -10
  44. package/.agent/agents/personas/athena-agent/athena-backend-logic-architecture-profile.md +3 -3
  45. package/.agent/agents/personas/athena-agent/context-files/agents.md +1 -1
  46. package/.agent/agents/personas/athena-agent/context-files/identity.md +1 -1
  47. package/.agent/agents/personas/athena-agent/context-files/soul.md +1 -1
  48. package/.agent/agents/personas/athena-agent/context-files/user-predefined.md +1 -1
  49. package/.agent/agents/personas/athena-agent/user-context-files/system/bootstrap.md +1 -1
  50. package/.agent/agents/personas/athena-agent/user-context-files/system/user.md +1 -1
  51. package/.agent/agents/personas/da-vinci-agent/agent.json +10 -10
  52. package/.agent/agents/personas/da-vinci-agent/context-files/agents.md +1 -1
  53. package/.agent/agents/personas/da-vinci-agent/context-files/identity.md +1 -1
  54. package/.agent/agents/personas/da-vinci-agent/context-files/soul.md +1 -1
  55. package/.agent/agents/personas/da-vinci-agent/context-files/user-predefined.md +1 -1
  56. package/.agent/agents/personas/da-vinci-agent/da-vinci-frontend-ui-ux-design-profile.md +3 -3
  57. package/.agent/agents/personas/da-vinci-agent/user-context-files/system/bootstrap.md +1 -1
  58. package/.agent/agents/personas/da-vinci-agent/user-context-files/system/user.md +1 -1
  59. package/.agent/agents/personas/duong-tang-agent/agent.json +10 -10
  60. package/.agent/agents/personas/duong-tang-agent/context-files/agents.md +1 -1
  61. package/.agent/agents/personas/duong-tang-agent/context-files/identity.md +1 -1
  62. package/.agent/agents/personas/duong-tang-agent/context-files/soul.md +1 -1
  63. package/.agent/agents/personas/duong-tang-agent/context-files/user-predefined.md +1 -1
  64. package/.agent/agents/personas/duong-tang-agent/tang-monk-quality-testing-documentation-profile.md +3 -3
  65. package/.agent/agents/personas/duong-tang-agent/user-context-files/system/bootstrap.md +1 -1
  66. package/.agent/agents/personas/duong-tang-agent/user-context-files/system/user.md +1 -1
  67. package/.agent/agents/personas/gia-cat-luong-agent/agent.json +10 -10
  68. package/.agent/agents/personas/gia-cat-luong-agent/context-files/agents.md +1 -1
  69. package/.agent/agents/personas/gia-cat-luong-agent/context-files/identity.md +1 -1
  70. package/.agent/agents/personas/gia-cat-luong-agent/context-files/soul.md +1 -1
  71. package/.agent/agents/personas/gia-cat-luong-agent/context-files/user-predefined.md +1 -1
  72. package/.agent/agents/personas/gia-cat-luong-agent/kongming-research-strategy-analysis-profile.md +3 -3
  73. package/.agent/agents/personas/gia-cat-luong-agent/user-context-files/system/bootstrap.md +1 -1
  74. package/.agent/agents/personas/gia-cat-luong-agent/user-context-files/system/user.md +1 -1
  75. package/.agent/agents/personas/mihata-agent/agent.json +10 -10
  76. package/.agent/agents/personas/mihata-agent/context-files/agents.md +1 -1
  77. package/.agent/agents/personas/mihata-agent/context-files/identity.md +1 -1
  78. package/.agent/agents/personas/mihata-agent/context-files/soul.md +1 -1
  79. package/.agent/agents/personas/mihata-agent/context-files/user-predefined.md +1 -1
  80. package/.agent/agents/personas/mihata-agent/mihata-multi-agent-orchestration-profile.md +3 -3
  81. package/.agent/agents/personas/mihata-agent/user-context-files/system/bootstrap.md +1 -1
  82. package/.agent/agents/personas/mihata-agent/user-context-files/system/user.md +1 -1
  83. package/.agent/agents/personas/tesla-agent/agent.json +10 -10
  84. package/.agent/agents/personas/tesla-agent/context-files/agents.md +1 -1
  85. package/.agent/agents/personas/tesla-agent/context-files/identity.md +1 -1
  86. package/.agent/agents/personas/tesla-agent/context-files/soul.md +1 -1
  87. package/.agent/agents/personas/tesla-agent/context-files/user-predefined.md +1 -1
  88. package/.agent/agents/personas/tesla-agent/tesla-fullstack-system-optimization-profile.md +3 -3
  89. package/.agent/agents/personas/tesla-agent/user-context-files/system/bootstrap.md +1 -1
  90. package/.agent/agents/personas/tesla-agent/user-context-files/system/user.md +1 -1
  91. package/.agent/agents/personas/tu-ma-y-agent/agent.json +10 -10
  92. package/.agent/agents/personas/tu-ma-y-agent/context-files/agents.md +1 -1
  93. package/.agent/agents/personas/tu-ma-y-agent/context-files/identity.md +1 -1
  94. package/.agent/agents/personas/tu-ma-y-agent/context-files/soul.md +1 -1
  95. package/.agent/agents/personas/tu-ma-y-agent/context-files/user-predefined.md +1 -1
  96. package/.agent/agents/personas/tu-ma-y-agent/simayi-feasibility-risk-control-profile.md +3 -3
  97. package/.agent/agents/personas/tu-ma-y-agent/user-context-files/system/bootstrap.md +1 -1
  98. package/.agent/agents/personas/tu-ma-y-agent/user-context-files/system/user.md +1 -1
  99. package/.agent/agents/personas/venti-agent/agent.json +10 -10
  100. package/.agent/agents/personas/venti-agent/context-files/agents.md +1 -1
  101. package/.agent/agents/personas/venti-agent/context-files/identity.md +1 -1
  102. package/.agent/agents/personas/venti-agent/context-files/soul.md +1 -1
  103. package/.agent/agents/personas/venti-agent/context-files/user-predefined.md +1 -1
  104. package/.agent/agents/personas/venti-agent/user-context-files/system/bootstrap.md +1 -1
  105. package/.agent/agents/personas/venti-agent/user-context-files/system/user.md +1 -1
  106. package/.agent/agents/personas/venti-agent/venti-learning-communication-mentoring-profile.md +3 -3
  107. package/.agent/agents/planner.md +212 -212
  108. package/.agent/agents/product-manager.md +112 -112
  109. package/.agent/agents/product-owner.md +95 -95
  110. package/.agent/agents/project-planner.md +406 -406
  111. package/.agent/agents/python-reviewer.md +98 -98
  112. package/.agent/agents/pytorch-build-resolver.md +120 -120
  113. package/.agent/agents/qa-automation-engineer.md +103 -103
  114. package/.agent/agents/refactor-cleaner.md +85 -85
  115. package/.agent/agents/rust-build-resolver.md +148 -148
  116. package/.agent/agents/rust-reviewer.md +94 -94
  117. package/.agent/agents/security-auditor.md +170 -170
  118. package/.agent/agents/security-reviewer.md +108 -108
  119. package/.agent/agents/seo-specialist.md +111 -111
  120. package/.agent/agents/tdd-guide.md +91 -91
  121. package/.agent/agents/test-engineer.md +158 -158
  122. package/.agent/agents/typescript-reviewer.md +112 -112
  123. package/.agent/contexts/dev.md +20 -20
  124. package/.agent/contexts/research.md +26 -26
  125. package/.agent/contexts/review.md +22 -22
  126. package/.agent/hooks/hooks.json +395 -395
  127. package/.agent/hooks/readme.md +222 -222
  128. package/.agent/mcp-configs/mcp-servers.json +181 -181
  129. package/.agent/rules/ARCHITECTURAL_BLUEPRINTS.md +62 -62
  130. package/.agent/rules/CODE_CRAFTSMANSHIP.md +69 -69
  131. package/.agent/rules/CORE_RULES.md +72 -72
  132. package/.agent/rules/PROJECT_MAP.md +58 -58
  133. package/.agent/rules/QUALITY_ASSURANCE.md +54 -54
  134. package/.agent/rules/SECURITY_ARMOR.md +44 -44
  135. package/.agent/rules/VERSION_ORCHESTRATION.md +64 -64
  136. package/.agent/rules/WORKFLOW_ORCHESTRATION.md +55 -55
  137. package/.agent/rules/common/agents.md +50 -50
  138. package/.agent/rules/common/code-review.md +124 -124
  139. package/.agent/rules/common/coding-style.md +48 -48
  140. package/.agent/rules/common/development-workflow.md +44 -44
  141. package/.agent/rules/common/git-workflow.md +24 -24
  142. package/.agent/rules/common/hooks.md +30 -30
  143. package/.agent/rules/common/patterns.md +31 -31
  144. package/.agent/rules/common/performance.md +55 -55
  145. package/.agent/rules/common/security.md +29 -29
  146. package/.agent/rules/common/testing.md +29 -29
  147. package/.agent/rules/cpp/coding-style.md +44 -44
  148. package/.agent/rules/cpp/hooks.md +39 -39
  149. package/.agent/rules/cpp/patterns.md +51 -51
  150. package/.agent/rules/cpp/security.md +51 -51
  151. package/.agent/rules/cpp/testing.md +44 -44
  152. package/.agent/rules/csharp/coding-style.md +72 -72
  153. package/.agent/rules/csharp/hooks.md +25 -25
  154. package/.agent/rules/csharp/patterns.md +50 -50
  155. package/.agent/rules/csharp/security.md +58 -58
  156. package/.agent/rules/csharp/testing.md +46 -46
  157. package/.agent/rules/dart/coding-style.md +159 -159
  158. package/.agent/rules/dart/hooks.md +66 -66
  159. package/.agent/rules/dart/patterns.md +261 -261
  160. package/.agent/rules/dart/security.md +135 -135
  161. package/.agent/rules/dart/testing.md +215 -215
  162. package/.agent/rules/golang/coding-style.md +32 -32
  163. package/.agent/rules/golang/hooks.md +17 -17
  164. package/.agent/rules/golang/patterns.md +45 -45
  165. package/.agent/rules/golang/security.md +34 -34
  166. package/.agent/rules/golang/testing.md +31 -31
  167. package/.agent/rules/java/coding-style.md +114 -114
  168. package/.agent/rules/java/hooks.md +18 -18
  169. package/.agent/rules/java/patterns.md +146 -146
  170. package/.agent/rules/java/security.md +100 -100
  171. package/.agent/rules/java/testing.md +131 -131
  172. package/.agent/rules/kotlin/coding-style.md +86 -86
  173. package/.agent/rules/kotlin/hooks.md +17 -17
  174. package/.agent/rules/kotlin/patterns.md +146 -146
  175. package/.agent/rules/kotlin/security.md +82 -82
  176. package/.agent/rules/kotlin/testing.md +128 -128
  177. package/.agent/rules/perl/coding-style.md +46 -46
  178. package/.agent/rules/perl/hooks.md +22 -22
  179. package/.agent/rules/perl/patterns.md +76 -76
  180. package/.agent/rules/perl/security.md +69 -69
  181. package/.agent/rules/perl/testing.md +54 -54
  182. package/.agent/rules/php/coding-style.md +40 -40
  183. package/.agent/rules/php/hooks.md +24 -24
  184. package/.agent/rules/php/patterns.md +33 -33
  185. package/.agent/rules/php/security.md +37 -37
  186. package/.agent/rules/php/testing.md +39 -39
  187. package/.agent/rules/python/coding-style.md +42 -42
  188. package/.agent/rules/python/hooks.md +19 -19
  189. package/.agent/rules/python/patterns.md +39 -39
  190. package/.agent/rules/python/security.md +30 -30
  191. package/.agent/rules/python/testing.md +38 -38
  192. package/.agent/rules/readme.md +111 -111
  193. package/.agent/rules/rust/coding-style.md +151 -151
  194. package/.agent/rules/rust/hooks.md +16 -16
  195. package/.agent/rules/rust/patterns.md +168 -168
  196. package/.agent/rules/rust/security.md +141 -141
  197. package/.agent/rules/rust/testing.md +154 -154
  198. package/.agent/rules/swift/coding-style.md +47 -47
  199. package/.agent/rules/swift/hooks.md +20 -20
  200. package/.agent/rules/swift/patterns.md +66 -66
  201. package/.agent/rules/swift/security.md +33 -33
  202. package/.agent/rules/swift/testing.md +45 -45
  203. package/.agent/rules/typescript/coding-style.md +199 -199
  204. package/.agent/rules/typescript/hooks.md +22 -22
  205. package/.agent/rules/typescript/patterns.md +52 -52
  206. package/.agent/rules/typescript/security.md +28 -28
  207. package/.agent/rules/typescript/testing.md +18 -18
  208. package/.agent/rules/web/coding-style.md +96 -96
  209. package/.agent/rules/web/design-quality.md +63 -63
  210. package/.agent/rules/web/hooks.md +120 -120
  211. package/.agent/rules/web/patterns.md +79 -79
  212. package/.agent/rules/web/performance.md +64 -64
  213. package/.agent/rules/web/security.md +57 -57
  214. package/.agent/rules/web/testing.md +55 -55
  215. package/.agent/rules/zh/agents.md +50 -50
  216. package/.agent/rules/zh/code-review.md +124 -124
  217. package/.agent/rules/zh/coding-style.md +48 -48
  218. package/.agent/rules/zh/development-workflow.md +44 -44
  219. package/.agent/rules/zh/git-workflow.md +24 -24
  220. package/.agent/rules/zh/hooks.md +30 -30
  221. package/.agent/rules/zh/patterns.md +31 -31
  222. package/.agent/rules/zh/performance.md +55 -55
  223. package/.agent/rules/zh/readme.md +108 -108
  224. package/.agent/rules/zh/security.md +29 -29
  225. package/.agent/rules/zh/testing.md +29 -29
  226. package/.agent/scripts/auto_preview.py +148 -148
  227. package/.agent/scripts/checklist.py +217 -217
  228. package/.agent/scripts/session_manager.py +120 -120
  229. package/.agent/scripts/verify_all.py +327 -327
  230. package/.agent/skills/agent-eval/SKILL.md +145 -145
  231. package/.agent/skills/agent-harness-construction/SKILL.md +73 -73
  232. package/.agent/skills/agent-payment-x402/SKILL.md +178 -178
  233. package/.agent/skills/agentic-engineering/SKILL.md +63 -63
  234. package/.agent/skills/ai-first-engineering/SKILL.md +51 -51
  235. package/.agent/skills/ai-regression-testing/SKILL.md +385 -385
  236. package/.agent/skills/android-clean-architecture/SKILL.md +339 -339
  237. package/.agent/skills/api-design/SKILL.md +523 -523
  238. package/.agent/skills/api-patterns/SKILL.md +81 -81
  239. package/.agent/skills/api-patterns/api-style.md +42 -42
  240. package/.agent/skills/api-patterns/auth.md +24 -24
  241. package/.agent/skills/api-patterns/documentation.md +26 -26
  242. package/.agent/skills/api-patterns/graphql.md +41 -41
  243. package/.agent/skills/api-patterns/rate-limiting.md +31 -31
  244. package/.agent/skills/api-patterns/response.md +37 -37
  245. package/.agent/skills/api-patterns/rest.md +40 -40
  246. package/.agent/skills/api-patterns/scripts/api_validator.py +211 -211
  247. package/.agent/skills/api-patterns/security-testing.md +122 -122
  248. package/.agent/skills/api-patterns/trpc.md +41 -41
  249. package/.agent/skills/api-patterns/versioning.md +22 -22
  250. package/.agent/skills/app-builder/SKILL.md +75 -75
  251. package/.agent/skills/app-builder/agent-coordination.md +71 -71
  252. package/.agent/skills/app-builder/feature-building.md +53 -53
  253. package/.agent/skills/app-builder/project-detection.md +34 -34
  254. package/.agent/skills/app-builder/scaffolding.md +118 -118
  255. package/.agent/skills/app-builder/tech-stack.md +41 -41
  256. package/.agent/skills/app-builder/templates/SKILL.md +39 -39
  257. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  258. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  259. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  260. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  261. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  262. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  263. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  264. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +122 -122
  265. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +122 -122
  266. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +169 -169
  267. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +134 -134
  268. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  269. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +119 -119
  270. package/.agent/skills/architecture/SKILL.md +55 -55
  271. package/.agent/skills/architecture/context-discovery.md +43 -43
  272. package/.agent/skills/architecture/examples.md +94 -94
  273. package/.agent/skills/architecture/pattern-selection.md +68 -68
  274. package/.agent/skills/architecture/patterns-reference.md +50 -50
  275. package/.agent/skills/architecture/trade-off-analysis.md +77 -77
  276. package/.agent/skills/architecture-decision-records/SKILL.md +179 -179
  277. package/.agent/skills/article-writing/SKILL.md +79 -79
  278. package/.agent/skills/autonomous-agent-harness/SKILL.md +267 -267
  279. package/.agent/skills/autonomous-loops/SKILL.md +610 -610
  280. package/.agent/skills/backend-patterns/SKILL.md +598 -598
  281. package/.agent/skills/bash-linux/SKILL.md +199 -199
  282. package/.agent/skills/behavioral-modes/SKILL.md +242 -242
  283. package/.agent/skills/benchmark/SKILL.md +93 -93
  284. package/.agent/skills/blueprint/SKILL.md +105 -105
  285. package/.agent/skills/brainstorming/SKILL.md +163 -163
  286. package/.agent/skills/brainstorming/dynamic-questioning.md +350 -350
  287. package/.agent/skills/brand-voice/SKILL.md +97 -97
  288. package/.agent/skills/brand-voice/references/voice-profile-schema.md +55 -55
  289. package/.agent/skills/browser-qa/SKILL.md +87 -87
  290. package/.agent/skills/bun-runtime/SKILL.md +84 -84
  291. package/.agent/skills/canary-watch/SKILL.md +99 -99
  292. package/.agent/skills/carrier-relationship-management/SKILL.md +212 -212
  293. package/.agent/skills/ck/SKILL.md +147 -147
  294. package/.agent/skills/ck/commands/forget.mjs +44 -44
  295. package/.agent/skills/ck/commands/info.mjs +24 -24
  296. package/.agent/skills/ck/commands/init.mjs +143 -143
  297. package/.agent/skills/ck/commands/list.mjs +40 -40
  298. package/.agent/skills/ck/commands/migrate.mjs +202 -202
  299. package/.agent/skills/ck/commands/resume.mjs +36 -36
  300. package/.agent/skills/ck/commands/save.mjs +210 -210
  301. package/.agent/skills/ck/commands/shared.mjs +387 -387
  302. package/.agent/skills/ck/hooks/session-start.mjs +224 -224
  303. package/.agent/skills/claude-api/SKILL.md +337 -337
  304. package/.agent/skills/claude-devfleet/SKILL.md +103 -103
  305. package/.agent/skills/clean-code/SKILL.md +201 -201
  306. package/.agent/skills/click-path-audit/SKILL.md +244 -244
  307. package/.agent/skills/clickhouse-io/SKILL.md +439 -439
  308. package/.agent/skills/code-review-checklist/SKILL.md +109 -109
  309. package/.agent/skills/codebase-onboarding/SKILL.md +233 -233
  310. package/.agent/skills/coding-standards/SKILL.md +530 -530
  311. package/.agent/skills/compose-multiplatform-patterns/SKILL.md +299 -299
  312. package/.agent/skills/configure-ecc/SKILL.md +367 -367
  313. package/.agent/skills/connections-optimizer/SKILL.md +189 -189
  314. package/.agent/skills/content-engine/SKILL.md +131 -131
  315. package/.agent/skills/content-hash-cache-pattern/SKILL.md +161 -161
  316. package/.agent/skills/context-budget/SKILL.md +135 -135
  317. package/.agent/skills/continuous-agent-loop/SKILL.md +45 -45
  318. package/.agent/skills/continuous-learning/SKILL.md +119 -119
  319. package/.agent/skills/continuous-learning/config.json +18 -18
  320. package/.agent/skills/continuous-learning/evaluate-session.sh +69 -69
  321. package/.agent/skills/continuous-learning-v2/SKILL.md +365 -365
  322. package/.agent/skills/continuous-learning-v2/agents/observer-loop.sh +271 -271
  323. package/.agent/skills/continuous-learning-v2/agents/observer.md +198 -198
  324. package/.agent/skills/continuous-learning-v2/agents/session-guardian.sh +150 -150
  325. package/.agent/skills/continuous-learning-v2/agents/start-observer.sh +244 -244
  326. package/.agent/skills/continuous-learning-v2/config.json +8 -8
  327. package/.agent/skills/continuous-learning-v2/hooks/observe.sh +428 -428
  328. package/.agent/skills/continuous-learning-v2/scripts/detect-project.sh +228 -228
  329. package/.agent/skills/continuous-learning-v2/scripts/instinct-cli.py +1426 -1426
  330. package/.agent/skills/continuous-learning-v2/scripts/test-parse-instinct.py +984 -984
  331. package/.agent/skills/cost-aware-llm-pipeline/SKILL.md +183 -183
  332. package/.agent/skills/cpp-coding-standards/SKILL.md +723 -723
  333. package/.agent/skills/cpp-testing/SKILL.md +324 -324
  334. package/.agent/skills/crosspost/SKILL.md +111 -111
  335. package/.agent/skills/csharp-testing/SKILL.md +321 -321
  336. package/.agent/skills/customer-billing-ops/SKILL.md +140 -140
  337. package/.agent/skills/customs-trade-compliance/SKILL.md +263 -263
  338. package/.agent/skills/dart-flutter-patterns/SKILL.md +563 -563
  339. package/.agent/skills/data-scraper-agent/SKILL.md +764 -764
  340. package/.agent/skills/database-design/SKILL.md +52 -52
  341. package/.agent/skills/database-design/database-selection.md +43 -43
  342. package/.agent/skills/database-design/indexing.md +39 -39
  343. package/.agent/skills/database-design/migrations.md +48 -48
  344. package/.agent/skills/database-design/optimization.md +36 -36
  345. package/.agent/skills/database-design/orm-selection.md +30 -30
  346. package/.agent/skills/database-design/schema-design.md +56 -56
  347. package/.agent/skills/database-design/scripts/schema_validator.py +172 -172
  348. package/.agent/skills/database-migrations/SKILL.md +429 -429
  349. package/.agent/skills/deep-research/SKILL.md +155 -155
  350. package/.agent/skills/deployment-patterns/SKILL.md +427 -427
  351. package/.agent/skills/deployment-procedures/SKILL.md +241 -241
  352. package/.agent/skills/design-system/SKILL.md +82 -82
  353. package/.agent/skills/django-patterns/SKILL.md +734 -734
  354. package/.agent/skills/django-security/SKILL.md +593 -593
  355. package/.agent/skills/django-tdd/SKILL.md +729 -729
  356. package/.agent/skills/django-verification/SKILL.md +469 -469
  357. package/.agent/skills/dmux-workflows/SKILL.md +191 -191
  358. package/.agent/skills/doc.md +177 -177
  359. package/.agent/skills/docker-patterns/SKILL.md +364 -364
  360. package/.agent/skills/documentation-lookup/SKILL.md +90 -90
  361. package/.agent/skills/documentation-templates/SKILL.md +194 -194
  362. package/.agent/skills/dotnet-patterns/SKILL.md +321 -321
  363. package/.agent/skills/e2e-testing/SKILL.md +326 -326
  364. package/.agent/skills/energy-procurement/SKILL.md +228 -228
  365. package/.agent/skills/enterprise-agent-ops/SKILL.md +50 -50
  366. package/.agent/skills/eval-harness/SKILL.md +270 -270
  367. package/.agent/skills/exa-search/SKILL.md +103 -103
  368. package/.agent/skills/fal-ai-media/SKILL.md +284 -284
  369. package/.agent/skills/flutter-dart-code-review/SKILL.md +435 -435
  370. package/.agent/skills/foundation-models-on-device/SKILL.md +243 -243
  371. package/.agent/skills/frontend-design/SKILL.md +452 -452
  372. package/.agent/skills/frontend-design/animation-guide.md +331 -331
  373. package/.agent/skills/frontend-design/color-system.md +311 -311
  374. package/.agent/skills/frontend-design/decision-trees.md +418 -418
  375. package/.agent/skills/frontend-design/motion-graphics.md +306 -306
  376. package/.agent/skills/frontend-design/scripts/accessibility_checker.py +183 -183
  377. package/.agent/skills/frontend-design/scripts/ux_audit.py +722 -722
  378. package/.agent/skills/frontend-design/typography-system.md +345 -345
  379. package/.agent/skills/frontend-design/ux-psychology.md +1116 -1116
  380. package/.agent/skills/frontend-design/visual-effects.md +383 -383
  381. package/.agent/skills/frontend-patterns/SKILL.md +642 -642
  382. package/.agent/skills/frontend-slides/SKILL.md +184 -184
  383. package/.agent/skills/frontend-slides/style-presets.md +330 -330
  384. package/.agent/skills/game-development/2d-games/SKILL.md +119 -119
  385. package/.agent/skills/game-development/3d-games/SKILL.md +135 -135
  386. package/.agent/skills/game-development/SKILL.md +167 -167
  387. package/.agent/skills/game-development/game-art/SKILL.md +185 -185
  388. package/.agent/skills/game-development/game-audio/SKILL.md +190 -190
  389. package/.agent/skills/game-development/game-design/SKILL.md +129 -129
  390. package/.agent/skills/game-development/mobile-games/SKILL.md +108 -108
  391. package/.agent/skills/game-development/multiplayer/SKILL.md +132 -132
  392. package/.agent/skills/game-development/pc-games/SKILL.md +144 -144
  393. package/.agent/skills/game-development/vr-ar/SKILL.md +123 -123
  394. package/.agent/skills/game-development/web-games/SKILL.md +150 -150
  395. package/.agent/skills/gan-style-harness/SKILL.md +278 -278
  396. package/.agent/skills/geo-fundamentals/SKILL.md +156 -156
  397. package/.agent/skills/geo-fundamentals/scripts/geo_checker.py +289 -289
  398. package/.agent/skills/git-workflow/SKILL.md +715 -715
  399. package/.agent/skills/golang-patterns/SKILL.md +674 -674
  400. package/.agent/skills/golang-testing/SKILL.md +720 -720
  401. package/.agent/skills/google-workspace-ops/SKILL.md +95 -95
  402. package/.agent/skills/healthcare-cdss-patterns/SKILL.md +245 -245
  403. package/.agent/skills/healthcare-emr-patterns/SKILL.md +159 -159
  404. package/.agent/skills/healthcare-eval-harness/SKILL.md +207 -207
  405. package/.agent/skills/healthcare-phi-compliance/SKILL.md +145 -145
  406. package/.agent/skills/hexagonal-architecture/SKILL.md +276 -276
  407. package/.agent/skills/i18n-localization/SKILL.md +154 -154
  408. package/.agent/skills/i18n-localization/scripts/i18n_checker.py +241 -241
  409. package/.agent/skills/intelligent-routing/SKILL.md +335 -335
  410. package/.agent/skills/inventory-demand-planning/SKILL.md +247 -247
  411. package/.agent/skills/investor-materials/SKILL.md +96 -96
  412. package/.agent/skills/investor-outreach/SKILL.md +91 -91
  413. package/.agent/skills/iterative-retrieval/SKILL.md +211 -211
  414. package/.agent/skills/java-coding-standards/SKILL.md +147 -147
  415. package/.agent/skills/jira-integration/SKILL.md +293 -293
  416. package/.agent/skills/jpa-patterns/SKILL.md +151 -151
  417. package/.agent/skills/kotlin-coroutines-flows/SKILL.md +284 -284
  418. package/.agent/skills/kotlin-exposed-patterns/SKILL.md +719 -719
  419. package/.agent/skills/kotlin-ktor-patterns/SKILL.md +689 -689
  420. package/.agent/skills/kotlin-patterns/SKILL.md +711 -711
  421. package/.agent/skills/kotlin-testing/SKILL.md +824 -824
  422. package/.agent/skills/laravel-patterns/SKILL.md +415 -415
  423. package/.agent/skills/laravel-plugin-discovery/SKILL.md +229 -229
  424. package/.agent/skills/laravel-security/SKILL.md +285 -285
  425. package/.agent/skills/laravel-tdd/SKILL.md +283 -283
  426. package/.agent/skills/laravel-verification/SKILL.md +179 -179
  427. package/.agent/skills/lead-intelligence/SKILL.md +321 -321
  428. package/.agent/skills/lead-intelligence/agents/enrichment-agent.md +85 -85
  429. package/.agent/skills/lead-intelligence/agents/mutual-mapper.md +75 -75
  430. package/.agent/skills/lead-intelligence/agents/outreach-drafter.md +98 -98
  431. package/.agent/skills/lead-intelligence/agents/signal-scorer.md +60 -60
  432. package/.agent/skills/lint-and-validate/SKILL.md +45 -45
  433. package/.agent/skills/lint-and-validate/scripts/lint_runner.py +184 -184
  434. package/.agent/skills/lint-and-validate/scripts/type_coverage.py +173 -173
  435. package/.agent/skills/liquid-glass-design/SKILL.md +279 -279
  436. package/.agent/skills/logistics-exception-management/SKILL.md +222 -222
  437. package/.agent/skills/manim-video/SKILL.md +89 -89
  438. package/.agent/skills/manim-video/assets/network-graph-scene.py +52 -52
  439. package/.agent/skills/market-research/SKILL.md +75 -75
  440. package/.agent/skills/mcp-server-patterns/SKILL.md +67 -67
  441. package/.agent/skills/mobile-design/SKILL.md +394 -394
  442. package/.agent/skills/mobile-design/decision-trees.md +516 -516
  443. package/.agent/skills/mobile-design/mobile-backend.md +491 -491
  444. package/.agent/skills/mobile-design/mobile-color-system.md +420 -420
  445. package/.agent/skills/mobile-design/mobile-debugging.md +122 -122
  446. package/.agent/skills/mobile-design/mobile-design-thinking.md +357 -357
  447. package/.agent/skills/mobile-design/mobile-navigation.md +458 -458
  448. package/.agent/skills/mobile-design/mobile-performance.md +767 -767
  449. package/.agent/skills/mobile-design/mobile-testing.md +356 -356
  450. package/.agent/skills/mobile-design/mobile-typography.md +433 -433
  451. package/.agent/skills/mobile-design/platform-android.md +666 -666
  452. package/.agent/skills/mobile-design/platform-ios.md +561 -561
  453. package/.agent/skills/mobile-design/scripts/mobile_audit.py +670 -670
  454. package/.agent/skills/mobile-design/touch-psychology.md +537 -537
  455. package/.agent/skills/nanoclaw-repl/SKILL.md +33 -33
  456. package/.agent/skills/nestjs-patterns/SKILL.md +230 -230
  457. package/.agent/skills/nextjs-react-expert/1-async-eliminating-waterfalls.md +351 -351
  458. package/.agent/skills/nextjs-react-expert/2-bundle-bundle-size-optimization.md +240 -240
  459. package/.agent/skills/nextjs-react-expert/3-server-server-side-performance.md +490 -490
  460. package/.agent/skills/nextjs-react-expert/4-client-client-side-data-fetching.md +264 -264
  461. package/.agent/skills/nextjs-react-expert/5-rerender-re-render-optimization.md +581 -581
  462. package/.agent/skills/nextjs-react-expert/6-rendering-rendering-performance.md +432 -432
  463. package/.agent/skills/nextjs-react-expert/7-js-javascript-performance.md +684 -684
  464. package/.agent/skills/nextjs-react-expert/8-advanced-advanced-patterns.md +150 -150
  465. package/.agent/skills/nextjs-react-expert/9-cache-components.md +103 -103
  466. package/.agent/skills/nextjs-react-expert/SKILL.md +293 -293
  467. package/.agent/skills/nextjs-react-expert/scripts/convert_rules.py +222 -222
  468. package/.agent/skills/nextjs-react-expert/scripts/react_performance_checker.py +252 -252
  469. package/.agent/skills/nextjs-turbopack/SKILL.md +44 -44
  470. package/.agent/skills/nodejs-best-practices/SKILL.md +333 -333
  471. package/.agent/skills/nutrient-document-processing/SKILL.md +167 -167
  472. package/.agent/skills/nuxt4-patterns/SKILL.md +100 -100
  473. package/.agent/skills/openclaw-persona-forge/SKILL.md +296 -296
  474. package/.agent/skills/openclaw-persona-forge/gacha.py +224 -224
  475. package/.agent/skills/openclaw-persona-forge/gacha.sh +5 -5
  476. package/.agent/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  477. package/.agent/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  478. package/.agent/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  479. package/.agent/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  480. package/.agent/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  481. package/.agent/skills/openclaw-persona-forge/references/output-template.md +166 -166
  482. package/.agent/skills/opensource-pipeline/SKILL.md +255 -255
  483. package/.agent/skills/parallel-agents/SKILL.md +175 -175
  484. package/.agent/skills/performance-profiling/SKILL.md +143 -143
  485. package/.agent/skills/performance-profiling/scripts/lighthouse_audit.py +76 -76
  486. package/.agent/skills/perl-patterns/SKILL.md +504 -504
  487. package/.agent/skills/perl-security/SKILL.md +503 -503
  488. package/.agent/skills/perl-testing/SKILL.md +475 -475
  489. package/.agent/skills/plan-writing/SKILL.md +152 -152
  490. package/.agent/skills/plankton-code-quality/SKILL.md +236 -236
  491. package/.agent/skills/postgres-patterns/SKILL.md +147 -147
  492. package/.agent/skills/powershell-windows/SKILL.md +167 -167
  493. package/.agent/skills/product-lens/SKILL.md +85 -85
  494. package/.agent/skills/production-scheduling/SKILL.md +238 -238
  495. package/.agent/skills/project-flow-ops/SKILL.md +111 -111
  496. package/.agent/skills/project-guidelines-example/SKILL.md +349 -349
  497. package/.agent/skills/prompt-optimizer/SKILL.md +397 -397
  498. package/.agent/skills/python-patterns/SKILL.md +750 -750
  499. package/.agent/skills/python-testing/SKILL.md +816 -816
  500. package/.agent/skills/pytorch-patterns/SKILL.md +396 -396
  501. package/.agent/skills/quality-nonconformance/SKILL.md +260 -260
  502. package/.agent/skills/ralphinho-rfc-pipeline/SKILL.md +67 -67
  503. package/.agent/skills/red-team-tactics/SKILL.md +199 -199
  504. package/.agent/skills/regex-vs-llm-structured-text/SKILL.md +220 -220
  505. package/.agent/skills/remotion-video-creation/SKILL.md +43 -43
  506. package/.agent/skills/remotion-video-creation/rules/3d.md +86 -86
  507. package/.agent/skills/remotion-video-creation/rules/animations.md +29 -29
  508. package/.agent/skills/remotion-video-creation/rules/assets/charts-bar-chart.tsx +173 -173
  509. package/.agent/skills/remotion-video-creation/rules/assets/text-animations-typewriter.tsx +100 -100
  510. package/.agent/skills/remotion-video-creation/rules/assets/text-animations-word-highlight.tsx +108 -108
  511. package/.agent/skills/remotion-video-creation/rules/assets.md +78 -78
  512. package/.agent/skills/remotion-video-creation/rules/audio.md +172 -172
  513. package/.agent/skills/remotion-video-creation/rules/calculate-metadata.md +104 -104
  514. package/.agent/skills/remotion-video-creation/rules/can-decode.md +75 -75
  515. package/.agent/skills/remotion-video-creation/rules/charts.md +58 -58
  516. package/.agent/skills/remotion-video-creation/rules/compositions.md +146 -146
  517. package/.agent/skills/remotion-video-creation/rules/display-captions.md +126 -126
  518. package/.agent/skills/remotion-video-creation/rules/extract-frames.md +229 -229
  519. package/.agent/skills/remotion-video-creation/rules/fonts.md +152 -152
  520. package/.agent/skills/remotion-video-creation/rules/get-audio-duration.md +58 -58
  521. package/.agent/skills/remotion-video-creation/rules/get-video-dimensions.md +68 -68
  522. package/.agent/skills/remotion-video-creation/rules/get-video-duration.md +58 -58
  523. package/.agent/skills/remotion-video-creation/rules/gifs.md +138 -138
  524. package/.agent/skills/remotion-video-creation/rules/images.md +130 -130
  525. package/.agent/skills/remotion-video-creation/rules/import-srt-captions.md +67 -67
  526. package/.agent/skills/remotion-video-creation/rules/lottie.md +67 -67
  527. package/.agent/skills/remotion-video-creation/rules/measuring-dom-nodes.md +34 -34
  528. package/.agent/skills/remotion-video-creation/rules/measuring-text.md +143 -143
  529. package/.agent/skills/remotion-video-creation/rules/sequencing.md +106 -106
  530. package/.agent/skills/remotion-video-creation/rules/tailwind.md +11 -11
  531. package/.agent/skills/remotion-video-creation/rules/text-animations.md +20 -20
  532. package/.agent/skills/remotion-video-creation/rules/timing.md +179 -179
  533. package/.agent/skills/remotion-video-creation/rules/transcribe-captions.md +19 -19
  534. package/.agent/skills/remotion-video-creation/rules/transitions.md +122 -122
  535. package/.agent/skills/remotion-video-creation/rules/trimming.md +52 -52
  536. package/.agent/skills/remotion-video-creation/rules/videos.md +171 -171
  537. package/.agent/skills/repo-scan/SKILL.md +63 -63
  538. package/.agent/skills/returns-reverse-logistics/SKILL.md +240 -240
  539. package/.agent/skills/rules-distill/SKILL.md +264 -264
  540. package/.agent/skills/rules-distill/scripts/scan-rules.sh +58 -58
  541. package/.agent/skills/rules-distill/scripts/scan-skills.sh +129 -129
  542. package/.agent/skills/rust-patterns/SKILL.md +499 -499
  543. package/.agent/skills/rust-pro/SKILL.md +175 -175
  544. package/.agent/skills/rust-testing/SKILL.md +500 -500
  545. package/.agent/skills/safety-guard/SKILL.md +75 -75
  546. package/.agent/skills/santa-method/SKILL.md +306 -306
  547. package/.agent/skills/search-first/SKILL.md +161 -161
  548. package/.agent/skills/security-review/SKILL.md +495 -495
  549. package/.agent/skills/security-review/cloud-infrastructure-security.md +361 -361
  550. package/.agent/skills/security-scan/SKILL.md +165 -165
  551. package/.agent/skills/seo-fundamentals/SKILL.md +129 -129
  552. package/.agent/skills/seo-fundamentals/scripts/seo_checker.py +219 -219
  553. package/.agent/skills/server-management/SKILL.md +161 -161
  554. package/.agent/skills/skill-comply/SKILL.md +58 -58
  555. package/.agent/skills/skill-comply/fixtures/compliant-trace.jsonl +5 -5
  556. package/.agent/skills/skill-comply/fixtures/noncompliant-trace.jsonl +3 -3
  557. package/.agent/skills/skill-comply/fixtures/tdd-spec.yaml +44 -44
  558. package/.agent/skills/skill-comply/prompts/classifier.md +24 -24
  559. package/.agent/skills/skill-comply/prompts/scenario-generator.md +62 -62
  560. package/.agent/skills/skill-comply/prompts/spec-generator.md +42 -42
  561. package/.agent/skills/skill-comply/pyproject.toml +15 -15
  562. package/.agent/skills/skill-comply/scripts/classifier.py +85 -85
  563. package/.agent/skills/skill-comply/scripts/grader.py +122 -122
  564. package/.agent/skills/skill-comply/scripts/parser.py +107 -107
  565. package/.agent/skills/skill-comply/scripts/report.py +170 -170
  566. package/.agent/skills/skill-comply/scripts/run.py +127 -127
  567. package/.agent/skills/skill-comply/scripts/runner.py +161 -161
  568. package/.agent/skills/skill-comply/scripts/scenario-generator.py +70 -70
  569. package/.agent/skills/skill-comply/scripts/spec-generator.py +72 -72
  570. package/.agent/skills/skill-comply/scripts/utils.py +13 -13
  571. package/.agent/skills/skill-comply/tests/test-grader.py +137 -137
  572. package/.agent/skills/skill-comply/tests/test-parser.py +90 -90
  573. package/.agent/skills/skill-stocktake/SKILL.md +193 -193
  574. package/.agent/skills/skill-stocktake/scripts/quick-diff.sh +87 -87
  575. package/.agent/skills/skill-stocktake/scripts/save-results.sh +56 -56
  576. package/.agent/skills/skill-stocktake/scripts/scan.sh +170 -170
  577. package/.agent/skills/social-graph-ranker/SKILL.md +154 -154
  578. package/.agent/skills/springboot-patterns/SKILL.md +314 -314
  579. package/.agent/skills/springboot-security/SKILL.md +272 -272
  580. package/.agent/skills/springboot-tdd/SKILL.md +158 -158
  581. package/.agent/skills/springboot-verification/SKILL.md +231 -231
  582. package/.agent/skills/strategic-compact/SKILL.md +131 -131
  583. package/.agent/skills/strategic-compact/suggest-compact.sh +54 -54
  584. package/.agent/skills/swift-actor-persistence/SKILL.md +143 -143
  585. package/.agent/skills/swift-concurrency-6-2/SKILL.md +216 -216
  586. package/.agent/skills/swift-protocol-di-testing/SKILL.md +190 -190
  587. package/.agent/skills/swiftui-patterns/SKILL.md +259 -259
  588. package/.agent/skills/systematic-debugging/SKILL.md +109 -109
  589. package/.agent/skills/tailwind-patterns/SKILL.md +269 -269
  590. package/.agent/skills/tdd-workflow/SKILL.md +463 -463
  591. package/.agent/skills/team-builder/SKILL.md +168 -168
  592. package/.agent/skills/testing-patterns/SKILL.md +178 -178
  593. package/.agent/skills/testing-patterns/scripts/test_runner.py +219 -219
  594. package/.agent/skills/token-budget-advisor/SKILL.md +133 -133
  595. package/.agent/skills/ui-demo/SKILL.md +465 -465
  596. package/.agent/skills/ui-ux-pro-max/SKILL.md +292 -292
  597. package/.agent/skills/ui-ux-pro-max/data/charts.csv +26 -26
  598. package/.agent/skills/ui-ux-pro-max/data/colors.csv +97 -97
  599. package/.agent/skills/ui-ux-pro-max/data/icons.csv +101 -101
  600. package/.agent/skills/ui-ux-pro-max/data/landing.csv +31 -31
  601. package/.agent/skills/ui-ux-pro-max/data/products.csv +96 -96
  602. package/.agent/skills/ui-ux-pro-max/data/react-performance.csv +45 -45
  603. package/.agent/skills/ui-ux-pro-max/data/stacks/astro.csv +54 -54
  604. package/.agent/skills/ui-ux-pro-max/data/stacks/flutter.csv +53 -53
  605. package/.agent/skills/ui-ux-pro-max/data/stacks/html-tailwind.csv +56 -56
  606. package/.agent/skills/ui-ux-pro-max/data/stacks/jetpack-compose.csv +53 -53
  607. package/.agent/skills/ui-ux-pro-max/data/stacks/nextjs.csv +53 -53
  608. package/.agent/skills/ui-ux-pro-max/data/stacks/nuxt-ui.csv +51 -51
  609. package/.agent/skills/ui-ux-pro-max/data/stacks/nuxtjs.csv +59 -59
  610. package/.agent/skills/ui-ux-pro-max/data/stacks/react-native.csv +52 -52
  611. package/.agent/skills/ui-ux-pro-max/data/stacks/react.csv +54 -54
  612. package/.agent/skills/ui-ux-pro-max/data/stacks/shadcn.csv +61 -61
  613. package/.agent/skills/ui-ux-pro-max/data/stacks/svelte.csv +54 -54
  614. package/.agent/skills/ui-ux-pro-max/data/stacks/swiftui.csv +51 -51
  615. package/.agent/skills/ui-ux-pro-max/data/stacks/vue.csv +50 -50
  616. package/.agent/skills/ui-ux-pro-max/data/styles.csv +68 -68
  617. package/.agent/skills/ui-ux-pro-max/data/typography.csv +57 -57
  618. package/.agent/skills/ui-ux-pro-max/data/ui-reasoning.csv +101 -101
  619. package/.agent/skills/ui-ux-pro-max/data/ux-guidelines.csv +99 -99
  620. package/.agent/skills/ui-ux-pro-max/data/web-interface.csv +31 -31
  621. package/.agent/skills/ui-ux-pro-max/scripts/core.py +253 -253
  622. package/.agent/skills/ui-ux-pro-max/scripts/design_system.py +1067 -1067
  623. package/.agent/skills/ui-ux-pro-max/scripts/search.py +114 -114
  624. package/.agent/skills/verification-loop/SKILL.md +126 -126
  625. package/.agent/skills/video-editing/SKILL.md +310 -310
  626. package/.agent/skills/videodb/SKILL.md +374 -374
  627. package/.agent/skills/videodb/reference/api-reference.md +550 -550
  628. package/.agent/skills/videodb/reference/capture-reference.md +407 -407
  629. package/.agent/skills/videodb/reference/capture.md +101 -101
  630. package/.agent/skills/videodb/reference/editor.md +443 -443
  631. package/.agent/skills/videodb/reference/generative.md +331 -331
  632. package/.agent/skills/videodb/reference/rtstream-reference.md +564 -564
  633. package/.agent/skills/videodb/reference/rtstream.md +65 -65
  634. package/.agent/skills/videodb/reference/search.md +230 -230
  635. package/.agent/skills/videodb/reference/streaming.md +406 -406
  636. package/.agent/skills/videodb/reference/use-cases.md +118 -118
  637. package/.agent/skills/videodb/scripts/ws-listener.py +282 -282
  638. package/.agent/skills/visa-doc-translate/SKILL.md +117 -117
  639. package/.agent/skills/visa-doc-translate/readme.md +86 -86
  640. package/.agent/skills/vulnerability-scanner/SKILL.md +276 -276
  641. package/.agent/skills/vulnerability-scanner/checklists.md +121 -121
  642. package/.agent/skills/vulnerability-scanner/scripts/security_scan.py +458 -458
  643. package/.agent/skills/web-design-guidelines/SKILL.md +57 -57
  644. package/.agent/skills/webapp-testing/SKILL.md +187 -187
  645. package/.agent/skills/webapp-testing/scripts/playwright_runner.py +173 -173
  646. package/.agent/skills/workspace-surface-audit/SKILL.md +125 -125
  647. package/.agent/skills/x-api/SKILL.md +230 -230
  648. package/.agent/tasks/lessons.md +40 -40
  649. package/.agent/tasks/todo.md +33 -33
  650. package/.agent/tasks/two-track-merge-contract.md +1 -1
  651. package/.agent/workflows/aside.md +164 -164
  652. package/.agent/workflows/brainstorm.md +113 -113
  653. package/.agent/workflows/build-fix.md +62 -62
  654. package/.agent/workflows/checkpoint.md +74 -74
  655. package/.agent/workflows/claw.md +23 -23
  656. package/.agent/workflows/clean-memory.md +34 -34
  657. package/.agent/workflows/code-review.md +289 -289
  658. package/.agent/workflows/context-budget.md +23 -23
  659. package/.agent/workflows/cpp-build.md +173 -173
  660. package/.agent/workflows/cpp-review.md +132 -132
  661. package/.agent/workflows/cpp-test.md +251 -251
  662. package/.agent/workflows/create.md +59 -59
  663. package/.agent/workflows/debug.md +103 -103
  664. package/.agent/workflows/deploy.md +176 -176
  665. package/.agent/workflows/devfleet.md +23 -23
  666. package/.agent/workflows/docs.md +23 -23
  667. package/.agent/workflows/e2e.md +268 -268
  668. package/.agent/workflows/enhance.md +63 -63
  669. package/.agent/workflows/eval.md +23 -23
  670. package/.agent/workflows/evolve.md +178 -178
  671. package/.agent/workflows/flutter-build.md +164 -164
  672. package/.agent/workflows/flutter-review.md +116 -116
  673. package/.agent/workflows/flutter-test.md +144 -144
  674. package/.agent/workflows/gan-build.md +99 -99
  675. package/.agent/workflows/gan-design.md +35 -35
  676. package/.agent/workflows/go-build.md +183 -183
  677. package/.agent/workflows/go-review.md +148 -148
  678. package/.agent/workflows/go-test.md +268 -268
  679. package/.agent/workflows/gradle-build.md +70 -70
  680. package/.agent/workflows/harness-audit.md +73 -73
  681. package/.agent/workflows/init-docs.md +46 -46
  682. package/.agent/workflows/instinct-export.md +66 -66
  683. package/.agent/workflows/instinct-import.md +114 -114
  684. package/.agent/workflows/instinct-status.md +59 -59
  685. package/.agent/workflows/jira.md +106 -106
  686. package/.agent/workflows/kotlin-build.md +174 -174
  687. package/.agent/workflows/kotlin-review.md +140 -140
  688. package/.agent/workflows/kotlin-test.md +312 -312
  689. package/.agent/workflows/learn-eval.md +116 -116
  690. package/.agent/workflows/learn.md +70 -70
  691. package/.agent/workflows/loop-start.md +32 -32
  692. package/.agent/workflows/loop-status.md +24 -24
  693. package/.agent/workflows/model-route.md +26 -26
  694. package/.agent/workflows/multi-backend.md +158 -158
  695. package/.agent/workflows/multi-execute.md +315 -315
  696. package/.agent/workflows/multi-frontend.md +158 -158
  697. package/.agent/workflows/multi-plan.md +268 -268
  698. package/.agent/workflows/multi-workflow.md +191 -191
  699. package/.agent/workflows/orchestrate.md +135 -135
  700. package/.agent/workflows/plan.md +117 -117
  701. package/.agent/workflows/pm2.md +272 -272
  702. package/.agent/workflows/preview.md +81 -81
  703. package/.agent/workflows/projects.md +39 -39
  704. package/.agent/workflows/promote.md +41 -41
  705. package/.agent/workflows/prompt-optimize.md +23 -23
  706. package/.agent/workflows/prp-commit.md +112 -112
  707. package/.agent/workflows/prp-implement.md +385 -385
  708. package/.agent/workflows/prp-plan.md +502 -502
  709. package/.agent/workflows/prp-pr.md +184 -184
  710. package/.agent/workflows/prp-prd.md +447 -447
  711. package/.agent/workflows/prune.md +31 -31
  712. package/.agent/workflows/python-review.md +297 -297
  713. package/.agent/workflows/quality-gate.md +29 -29
  714. package/.agent/workflows/refactor-clean.md +80 -80
  715. package/.agent/workflows/resume-session.md +156 -156
  716. package/.agent/workflows/rules-distill.md +20 -20
  717. package/.agent/workflows/rust-build.md +187 -187
  718. package/.agent/workflows/rust-review.md +142 -142
  719. package/.agent/workflows/rust-test.md +308 -308
  720. package/.agent/workflows/santa-loop.md +175 -175
  721. package/.agent/workflows/save-session.md +275 -275
  722. package/.agent/workflows/sessions.md +333 -333
  723. package/.agent/workflows/setup-pm.md +80 -80
  724. package/.agent/workflows/skill-create.md +174 -174
  725. package/.agent/workflows/skill-health.md +54 -54
  726. package/.agent/workflows/status.md +86 -86
  727. package/.agent/workflows/tdd.md +231 -231
  728. package/.agent/workflows/test-coverage.md +69 -69
  729. package/.agent/workflows/test.md +144 -144
  730. package/.agent/workflows/ui-ux-pro-max.md +295 -295
  731. package/.agent/workflows/update-codemaps.md +72 -72
  732. package/.agent/workflows/update-docs.md +84 -84
  733. package/.agent/workflows/verify.md +23 -23
  734. package/LICENSE +176 -176
  735. package/README.md +144 -144
  736. package/package.json +1 -1
  737. package/scripts/release-check.js +55 -55
  738. package/src/bin/cli.js +424 -354
  739. package/src/lib/installer.js +223 -11
@@ -1,1116 +1,1116 @@
1
- # UX Psychology Reference
2
-
3
- > Deep dive into UX laws, emotional design, trust building, and behavioral psychology.
4
-
5
- ---
6
-
7
- ## 1. Core UX Laws
8
-
9
- ### Hick's Law
10
-
11
- **Principle:** The time to make a decision increases logarithmically with the number of choices.
12
-
13
- ```
14
- Decision Time = a + b Γ— logβ‚‚(n + 1)
15
- Where n = number of choices
16
- ```
17
-
18
- **Application:**
19
- - Navigation: Max 5-7 top-level items
20
- - Forms: Break into steps (progressive disclosure)
21
- - Options: Default selections when possible
22
- - Filters: Prioritize most-used, hide advanced
23
-
24
- **Example:**
25
- ```
26
- ❌ Bad: 15 menu items in one nav
27
- βœ… Good: 5 main categories + "More"
28
-
29
- ❌ Bad: 20 form fields at once
30
- βœ… Good: 3-step wizard with 5-7 fields each
31
- ```
32
-
33
- ---
34
-
35
- ### Fitts' Law
36
-
37
- **Principle:** Time to reach a target = function of distance and size.
38
-
39
- ```
40
- MT = a + b Γ— logβ‚‚(1 + D/W)
41
- Where D = distance, W = width
42
- ```
43
-
44
- **Application:**
45
- - CTAs: Make primary buttons larger (min 44px height)
46
- - Touch targets: 44Γ—44px minimum on mobile
47
- - Placement: Important actions near natural cursor position
48
- - Corners: "Magic corners" (infinite edge = easy to hit)
49
-
50
- **Button Sizing:**
51
- ```css
52
- /* Size by importance */
53
- .btn-primary { height: 48px; padding: 0 24px; }
54
- .btn-secondary { height: 40px; padding: 0 16px; }
55
- .btn-tertiary { height: 36px; padding: 0 12px; }
56
-
57
- /* Mobile touch targets */
58
- @media (hover: none) {
59
- .btn { min-height: 44px; min-width: 44px; }
60
- }
61
- ```
62
-
63
- ---
64
-
65
- ### Miller's Law
66
-
67
- **Principle:** Average person can hold 7Β±2 chunks in working memory.
68
-
69
- **Application:**
70
- - Lists: Group into chunks of 5-7 items
71
- - Navigation: Max 7 menu items
72
- - Content: Break long content with headings
73
- - Phone numbers: 555-123-4567 (chunked)
74
-
75
- **Chunking Example:**
76
- ```
77
- ❌ 5551234567
78
- βœ… 555-123-4567
79
-
80
- ❌ Long paragraph of text without breaks
81
- βœ… Short paragraphs
82
- With bullet points
83
- And subheadings
84
- ```
85
-
86
- ---
87
-
88
- ### Von Restorff Effect (Isolation Effect)
89
-
90
- **Principle:** An item that stands out is more likely to be remembered.
91
-
92
- **Application:**
93
- - CTA buttons: Distinct color from other elements
94
- - Pricing: Highlight recommended plan
95
- - Important info: Visual differentiation
96
- - New features: Badge or callout
97
-
98
- **Example:**
99
- ```css
100
- /* All buttons gray, primary stands out */
101
- .btn { background: #E5E7EB; }
102
- .btn-primary { background: #3B82F6; }
103
-
104
- /* Recommended plan highlighted */
105
- .pricing-card { border: 1px solid #E5E7EB; }
106
- .pricing-card.popular {
107
- border: 2px solid #3B82F6;
108
- box-shadow: var(--shadow-lg);
109
- }
110
- ```
111
-
112
- ---
113
-
114
- ### Serial Position Effect
115
-
116
- **Principle:** Items at the beginning (primacy) and end (recency) of a list are remembered best.
117
-
118
- **Application:**
119
- - Navigation: Most important items first and last
120
- - Lists: Key info at top and bottom
121
- - Forms: Most critical fields at start
122
- - CTAs: Repeat at top and bottom of long pages
123
-
124
- **Example:**
125
- ```
126
- Navigation: Home | [key items] | Contact
127
-
128
- Long landing page:
129
- - CTA at hero (top)
130
- - Content sections
131
- - CTA repeated at bottom
132
- ```
133
-
134
- ### Jakob’s Law
135
-
136
- **Principle:** Users spend most of their time on other sites. They prefer your site to work the same way as all the other sites they already know.
137
-
138
- **Application:**
139
- - **Patterns:** Use standard placement for search bars and carts.
140
- - **Mental Models:** Leverage familiar icons (e.g., a magnifying glass).
141
- - **Vocabulary:** Use "Log In" instead of "Enter the Portal."
142
- - **Layout:** Keep the logo in the top-left for "Home" navigation.
143
- - **Interaction:** Swiping right to go back/next should feel native.
144
- - **Feedback:** Standard colors (Red = Error, Green = Success).
145
-
146
- **Example:**
147
- ```
148
- ❌ Bad: A website where clicking the logo takes you to an "About Us" page.
149
- βœ… Good: Clicking the logo always returns the user to the Homepage.
150
-
151
- ❌ Bad: Using a "Star" icon to represent "Delete."
152
- βœ… Good: Using a "Trash Can" icon to represent "Delete."
153
- ```
154
-
155
- ---
156
-
157
- ### Tesler’s Law (Conservation of Complexity)
158
-
159
- **Principle:** For any system, there is a certain amount of complexity which cannot be reduced, only shifted from user to software.
160
-
161
- **Application:**
162
- - **Backend:** Let the system handle formatting (e.g., currency).
163
- - **Detection:** Auto-detect card type or city via ZIP code.
164
- - **Automation:** Pre-fill returning user data.
165
- - **Personalization:** Show only relevant fields based on previous answers.
166
- - **Defaults:** Smart defaults for common settings.
167
- - **Integration:** Use SSO (Social Logins) to offload registration friction.
168
-
169
- **Example:**
170
- ```
171
- ❌ Bad: Making users type "USD $" before every price field in a form.
172
- βœ… Good: The app automatically prefixing the "$" based on the user's location.
173
-
174
- ❌ Bad: Forcing users to manually select their "Card Type" (Visa/Mastercard).
175
- βœ… Good: Detecting the card type automatically from the first four digits entered.
176
- ```
177
-
178
- ---
179
-
180
- ### Parkinson’s Law
181
-
182
- **Principle:** Any task will inflate until all available time is spent.
183
-
184
- **Application:**
185
- - **Efficiency:** Use "Auto-save" to reduce task completion time.
186
- - **Speed:** Limit the steps in a conversion funnel.
187
- - **Clarity:** Use clear labels to prevent "hover-poking" for meaning.
188
- - **Feedback:** Real-time validation to stop users from wasting time on errors.
189
- - **Onboarding:** Quick "Express" setup for power users.
190
- - **Constraints:** Set character limits on inputs to focus thoughts.
191
-
192
- **Example:**
193
- ```
194
- ❌ Bad: A 10-page registration form that allows users to browse away and lose data.
195
- βœ… Good: A "One-Tap Sign In" using Google or Apple ID.
196
-
197
- ❌ Bad: Giving a user an indefinite amount of time to fill out a bio.
198
- βœ… Good: Providing a "Suggested Bios" feature to help them finish in seconds.
199
- ```
200
-
201
- ---
202
-
203
- ### Doherty Threshold
204
-
205
- **Principle:** Productivity skyrockets when a computer and its users interact at a pace (<400ms) that ensures neither has to wait on the other.
206
-
207
- **Application:**
208
- - **Feedback:** Use immediate visual cues for clicks.
209
- - **Loading:** Use skeleton screens for perceivable performance.
210
- - **Optimism:** Update UI before the server responds (Optimistic UI).
211
- - **Motion:** Use micro-animations to mask slight delays.
212
- - **Caching:** Pre-load next pages or assets in the background.
213
- - **Prioritization:** Load text content before heavy high-res images.
214
-
215
- **Example:**
216
- ```
217
- ❌ Bad: A button that does nothing for 2 seconds after being clicked.
218
- βœ… Good: A button that immediately changes color and shows a "Loading" spinner.
219
-
220
- ❌ Bad: A blank white screen that appears while data is fetching.
221
- βœ… Good: A skeleton screen showing the gray outlines of where content will appear.
222
- ```
223
-
224
- ---
225
-
226
- ### Postel’s Law (Robustness Principle)
227
-
228
- **Principle:** Be conservative in what you do, be liberal in what you accept from others.
229
-
230
- **Application:**
231
- - **Error Handling:** Don't error out for a missing space or dash.
232
- - **Formatting:** Accept dates in DD/MM/YYYY or MM/DD/YYYY.
233
- - **Inputs:** Strip trailing/leading white space automatically.
234
- - **Fallbacks:** Use default avatars if a user hasn't uploaded a photo.
235
- - **Search:** Accept typos and provide "Did you mean...?" suggestions.
236
- - **Accessibility:** Ensure the site works across all browsers and devices.
237
-
238
- **Example:**
239
- ```
240
- ❌ Bad: Rejecting a phone number because the user put a space in it.
241
- βœ… Good: Accepting the input and stripping the spaces automatically.
242
-
243
- ❌ Bad: Forcing users to type "January" instead of "01" or "Jan."
244
- βœ… Good: A date field that understands all three formats.
245
- ```
246
-
247
- ---
248
-
249
- ### Occam’s Razor
250
-
251
- **Principle:** Among competing hypotheses that predict equally well, the one with the fewest assumptions should be selected. The simplest solution is usually the best.
252
-
253
- **Application:**
254
- - **Logic:** Remove unnecessary clicks.
255
- - **Visuals:** Use only as many fonts/colors as strictly necessary.
256
- - **Function:** If one field can do the work of two, combine them.
257
- - **Copy:** Use the shortest possible text to convey meaning.
258
- - **Layout:** Remove decorative elements that don't serve a goal.
259
- - **Flow:** Avoid branching paths unless absolutely required.
260
-
261
- **Example:**
262
- ```
263
- ❌ Bad: A "Login" button that opens a new page, then email, then password.
264
- βœ… Good: A single login modal that asks for both on one screen.
265
-
266
- ❌ Bad: Using 5 different font sizes and 4 colors on a single card.
267
- βœ… Good: Using 2 font sizes and 1 accent color.
268
- ```
269
-
270
- ---
271
-
272
- ## 2. Visual Perception (Gestalt Principles)
273
-
274
- ### Law of Proximity
275
-
276
- **Principle:** Objects that are near, or proximate to each other, tend to be grouped together.
277
-
278
- **Application:**
279
- - **Grouping:** Keep labels physically close to input fields.
280
- - **Spacing:** Larger margins between unrelated content blocks.
281
- - **Cards:** Text inside a card should be closer to its image than the border.
282
- - **Footers:** Cluster legal links together away from social links.
283
- - **Navigation:** Group "User" settings separate from "App" settings.
284
- - **Forms:** Group Address fields together, separate from Credit Card fields.
285
-
286
- **Example:**
287
- ```
288
- ❌ Bad: Large, equal gaps between every line of text in a form.
289
- βœ… Good: Tight spacing between a label and its input, with larger gaps between pairs.
290
-
291
- ❌ Bad: A "Submit" button floating in the middle of a page, far from the form.
292
- βœ… Good: The "Submit" button placed directly under the last input field.
293
- ```
294
-
295
- ---
296
-
297
- ### Law of Similarity
298
-
299
- **Principle:** The human eye tends to perceive similar elements in a design as a complete picture, shape, or group, even if those elements are separated.
300
-
301
- **Application:**
302
- - **Consistency:** Consistent colors for all clickable links.
303
- - **Iconography:** All icons in a set should have the same stroke weight.
304
- - **Buttons:** Same shape/size for buttons with the same importance.
305
- - **Typography:** Use the same H2 style for all section headers.
306
- - **Feedback:** All "Delete" actions should use the same color (e.g. Red).
307
- - **States:** Hover and Active states must be consistent across the app.
308
-
309
- **Example:**
310
- ```
311
- ❌ Bad: Some links are blue, some are green, and some are just bold black.
312
- βœ… Good: Every clickable text element in the app is the same shade of Blue.
313
-
314
- ❌ Bad: Using a "Blue Button" for "Submit" and the same "Blue Button" for "Cancel."
315
- βœ… Good: "Submit" is Solid Blue; "Cancel" is a Blue Outline (Ghost Button).
316
- ```
317
-
318
- ---
319
-
320
- ### Law of Common Region
321
-
322
- **Principle:** Elements tend to be perceived into groups if they are sharing an area with a clearly defined boundary.
323
-
324
- **Application:**
325
- - **Containerizing:** Use cards to group images and titles.
326
- - **Borders:** Use lines to separate the sidebar from the main feed.
327
- - **Backgrounds:** Use a different background color for the footer.
328
- - **Modals:** Use a distinct box to separate pop-ups from the page.
329
- - **Lists:** Alternating background colors (zebra striping) for rows.
330
- - **Header:** A solid bar across the top to group navigation items.
331
-
332
- **Example:**
333
- ```
334
- ❌ Bad: A list of news articles where the text and image of different stories overlap.
335
- βœ… Good: Each article is contained within its own white card on a light gray background.
336
-
337
- ❌ Bad: A footer that has the same background color as the main body.
338
- βœ… Good: A dark-themed footer that clearly separates legal links from page content.
339
- ```
340
-
341
- ---
342
-
343
- ### Law of Uniform Connectedness
344
-
345
- **Principle:** Elements that are visually connected (e.g., via lines, arrows) are perceived as more related than elements with no connection.
346
-
347
- **Application:**
348
- - **Flow:** Use lines to connect steps in a progress wizard.
349
- - **Menus:** Dropdowns that "touch" or connect to their parent button.
350
- - **Graphs:** Lines connecting data points in a chart.
351
- - **Relationship:** Connecting a toggle switch to the text it controls.
352
- - **Hierarchy:** Tree structures for file directories.
353
- - **Forms:** Connecting a "Credit Card" radio button to the fieldset below it.
354
-
355
- **Example:**
356
- ```
357
- ❌ Bad: A 3-step setup where the numbers "1", "2", and "3" are scattered.
358
- βœ… Good: A horizontal line connecting "1", "2", and "3" to show a sequence.
359
-
360
- ❌ Bad: Floating dropdown menus that don't touch the button that opened them.
361
- βœ… Good: A dropdown menu that visually "attaches" to the parent button.
362
- ```
363
-
364
- ---
365
-
366
- ### Law of PrΓ€gnanz (Simplicity)
367
-
368
- **Principle:** People will perceive and interpret ambiguous or complex images as the simplest form possible, because it is the interpretation that requires the least cognitive effort.
369
-
370
- **Application:**
371
- - **Clarity:** Use clear, geometric icons for navigation.
372
- - **Reduction:** Remove unnecessary 3D textures or shadows.
373
- - **Shapes:** Prefer standard rectangles/circles over complex polygons.
374
- - **Focus:** Use high-contrast silhouettes for primary actions.
375
- - **Logos:** Simple brand marks that are recognizable at small sizes.
376
- - **UX:** One main goal per page to keep the "mental shape" simple.
377
-
378
- **Example:**
379
- ```
380
- ❌ Bad: A hyper-realistic 3D illustration of a file folder for the "Files" icon.
381
- βœ… Good: A simple 2D outline of a folder.
382
-
383
- ❌ Bad: A multi-colored, complex logo used as a loading spinner.
384
- βœ… Good: A simple, single-color circular ring.
385
- ```
386
-
387
- ---
388
-
389
- ### Law of Figure/Ground
390
-
391
- **Principle:** The eye differentiates an object from its surrounding area. a form, silhouette, or shape is perceived as figure (object), while the surrounding area is perceived as ground (background).
392
-
393
- **Application:**
394
- - **Focus:** Use overlays (scrims) for modals to pop the content.
395
- - **Depth:** Drop shadows to imply the "figure" is sitting above the "ground."
396
- - **Contrast:** Light text on dark ground (or vice versa).
397
- - **Blur:** Use background blur to emphasize foreground text.
398
- - **Navigation:** Floating sticky headers that stay above the page content.
399
- - **Hover:** Elevate cards slightly on hover to define them as the figure.
400
-
401
- **Example:**
402
- ```
403
- ❌ Bad: A popup window that has no shadow or border, blending into the page.
404
- βœ… Good: A modal with a drop shadow and a dimmed background overlay.
405
-
406
- ❌ Bad: White text placed directly over a busy, multi-colored photograph.
407
- βœ… Good: White text placed over a dark semi-transparent "scrim."
408
- ```
409
-
410
- ---
411
-
412
- ### Law of Focal Point
413
-
414
- **Principle:** Whatever stands out visually will capture and hold the viewer’s attention first.
415
-
416
- **Application:**
417
- - **Entry:** Place the primary value proposition at the focal point.
418
- - **Color:** Use one high-vibrancy "Action Color" against a neutral UI.
419
- - **Movement:** Use subtle animation on the CTA to draw the eye.
420
- - **Size:** The most important statistic should be the largest font.
421
- - **Typography:** Use bold weights for headers and standard weights for body.
422
- - **Direction:** Use arrows or gaze (images of people looking at a button).
423
-
424
- **Example:**
425
- ```
426
- ❌ Bad: A homepage with 5 buttons of the same size and color.
427
- βœ… Good: One large "Get Started" button in a bright color.
428
-
429
- ❌ Bad: A dashboard where "Total Revenue" is the same size as "System Version."
430
- βœ… Good: "Total Revenue" displayed in huge, bold numbers at the top center.
431
- ```
432
-
433
- ---
434
-
435
- ## 3. Cognitive Biases & Behavior
436
-
437
- ### Zeigarnik Effect
438
-
439
- **Principle:** People remember uncompleted or interrupted tasks better than completed tasks.
440
-
441
- **Application:**
442
- - **Gamification:** Use "Profile 60% complete" bars.
443
- - **Engagement:** Tease the next module in a learning path.
444
- - **Retention:** Show a "To-Do" list of features yet to be explored.
445
- - **Feedback:** Persistent badges for unread messages.
446
- - **Momentum:** Show "Next" steps immediately after completing one.
447
- - **Shopping:** "Finish your order" reminders in the cart.
448
-
449
- **Example:**
450
- ```
451
- ❌ Bad: A silent onboarding process that gives no indication of what's left.
452
- βœ… Good: A checklist that shows "3 of 5 steps finished."
453
-
454
- ❌ Bad: An e-learning app that shows a checkmark even if a video was half-watched.
455
- βœ… Good: A progress ring that stays half-full until the video is finished.
456
- ```
457
-
458
- ### Goal Gradient Effect
459
-
460
- **Principle:** The tendency to approach a goal increases with proximity to the goal.
461
-
462
- **Application:**
463
- - **Momentum:** Give users "Artificial Advancement" (e.g. 2 free stamps).
464
- - **Progress:** Break a 10-field form into two 5-field steps.
465
- - **Feedback:** Celebrate milestones halfway through a task.
466
- - **Motivation:** Show the user how close they are to a reward/status.
467
- - **Navigation:** Use breadcrumbs to show how close they are to the end.
468
- - **Loading:** Speed up the loading animation as it nears 100%.
469
-
470
- **Example:**
471
- ```
472
- ❌ Bad: A progress bar that starts at 0% and feels like a long climb.
473
- βœ… Good: A bar that starts at 20% because the user "started" by opening the app.
474
-
475
- ❌ Bad: A checkout flow where the "Final Review" feels like a surprise 5th step.
476
- βœ… Good: Clearly labeling the steps: "Shipping > Payment > Almost Done!"
477
- ```
478
-
479
- ### Peak-End Rule
480
-
481
- **Principle:** People judge an experience largely based on how they felt at its peak (the most intense point) and at its end, rather than the total sum or average of every moment.
482
-
483
- **Application:**
484
- - **Success:** Make the "Order Confirmed" screen memorable.
485
- - **Delight:** Add confetti or a unique animation at the point of value.
486
- - **Support:** Ensure the final interaction with a chat bot is helpful.
487
- - **Unboarding:** Even when a user leaves, make the final exit clean.
488
- - **Onboarding:** End the first session with a clear "Win."
489
- - **Error Handling:** Turn a 404 page into a fun, helpful interaction.
490
-
491
- **Example:**
492
- ```
493
- ❌ Bad: After a 20-minute tax filing process, the app just says "Submitted."
494
- βœ… Good: A "Congratulations!" screen with a summary of the refund amount.
495
-
496
- ❌ Bad: A game that ends with a simple "Game Over" text in plain font.
497
- βœ… Good: A summary screen showing high scores with celebratory music.
498
- ```
499
-
500
- ### Aesthetic-Usability Effect
501
-
502
- **Principle:** Users often perceive aesthetically pleasing design as design that’s more usable.
503
-
504
- **Application:**
505
- - **Trust:** High-fidelity visuals buy "trust credit" for minor bugs.
506
- - **Branding:** Consistent high-quality imagery build professionalism.
507
- - **Engagement:** Beautiful interfaces keep users exploring longer.
508
- - **Patience:** Users are more forgiving of load times if the UI is pretty.
509
- - **Confidence:** Clean design makes complex tools feel more manageable.
510
- - **Loyalty:** People form emotional bonds with beautiful products.
511
-
512
- **Example:**
513
- ```
514
- ❌ Bad: A banking app with misaligned text and clashing 1990s colors.
515
- βœ… Good: A sleek, modern banking app with smooth animations.
516
-
517
- ❌ Bad: Using low-resolution, pixelated stock photos.
518
- βœ… Good: Using high-definition, custom brand illustrations.
519
- ```
520
-
521
- ### Anchoring Bias
522
-
523
- **Principle:** Users rely heavily on the first piece of information offered (the "anchor") when making decisions.
524
-
525
- **Application:**
526
- - **Pricing:** Show the original price crossed out.
527
- - **Tiers:** Put the most expensive "Enterprise" plan on the far left.
528
- - **Sorting:** Highlight "Most Popular" as the first recommendation.
529
- - **Discounts:** State the "Save 20%" before showing the final price.
530
- - **Limits:** "Limit 12 per customer" anchors the idea that it's high value.
531
- - **Defaults:** Start with a high "Suggested Donation" amount.
532
-
533
- **Example:**
534
- ```
535
- ❌ Bad: Only showing the price "$49."
536
- βœ… Good: Showing "~~$99~~ $49 (50% Off)."
537
-
538
- ❌ Bad: Sorting a list of laptops from cheapest to most expensive.
539
- βœ… Good: Showing a high-end "Pro" model first to make others seem cheap.
540
- ```
541
-
542
- ### Social Proof
543
-
544
- **Principle:** People copy the actions of others in an attempt to undertake behavior in a given situation.
545
-
546
- **Application:**
547
- - **Validation:** Display "Join 50,000+ others."
548
- - **Reviews:** Star ratings and verified customer testimonials.
549
- - **Logos:** "Trusted by" section showing partner brands.
550
- - **Live Feed:** "Sarah just bought this 5 mins ago" notifications.
551
- - **Activity:** "300 people are currently viewing this item."
552
- - **Certificates:** Industry awards and security badges.
553
-
554
- **Example:**
555
- ```
556
- ❌ Bad: A signup page with just a form.
557
- βœ… Good: A signup page that says "Join 2 million designers."
558
-
559
- ❌ Bad: Anonymous reviews with no names or photos.
560
- βœ… Good: Reviews that include a face, a name, and a "Verified Buyer" tag.
561
- ```
562
-
563
- ### Scarcity Principle
564
-
565
- **Principle:** Humans place a higher value on an object that is scarce, and a lower value on those that are in abundance.
566
-
567
- **Application:**
568
- - **Urgency:** "Only 2 items left in stock."
569
- - **Time:** Ticking countdown timers for sales.
570
- - **Access:** "Invite-only" betas or exclusive tiers.
571
- - **Seasonality:** "Summer Edition" products.
572
- - **Low Stock:** "Back in stock soon - pre-order now."
573
- - **Demand:** "In high demand - 10 people have this in their cart."
574
-
575
- **Example:**
576
- ```
577
- ❌ Bad: A sale that never ends and has no countdown.
578
- βœ… Good: A "Deal of the Day" with a ticking timer.
579
-
580
- ❌ Bad: Showing a product is available with no stock count.
581
- βœ… Good: "Only 3 left at this price!"
582
- ```
583
-
584
- ### Authority Bias
585
-
586
- **Principle:** The tendency to attribute greater accuracy to the opinion of an authority figure and be more influenced by that opinion.
587
-
588
- **Application:**
589
- - **Expertise:** Use "Expert-verified" or professional headshots.
590
- - **Certifications:** Trust seals (Norton, ISO, HIPAA).
591
- - **Media:** "As seen on TechCrunch/Forbes" logos.
592
- - **Endorsements:** Testimonials from industry leaders or influencers.
593
- - **Language:** Confident, professional, and accurate copy.
594
- - **History:** "Established in 1950" to imply longevity and trust.
595
-
596
- **Example:**
597
- ```
598
- ❌ Bad: A health blog written by "Admin."
599
- βœ… Good: A health article "Reviewed by Dr. Jane Smith, Cardiologist."
600
-
601
- ❌ Bad: A security app with no mentions of certifications.
602
- βœ… Good: Displaying "ISO 27001 Certified" and "Norton Secured" logos.
603
- ```
604
-
605
- ### Loss Aversion
606
-
607
- **Principle:** People generally prefer avoiding losses to acquiring equivalent gains. It is better to not lose $5 than to find $5.
608
-
609
- **Application:**
610
- - **Messaging:** "Don't lose your discount."
611
- - **Trials:** "Your free trial is ending - keep your data now."
612
- - **Scarcity:** "Once it's gone, it's gone for good."
613
- - **Carts:** "Don't miss out on the items in your cart."
614
- - **Loyalty:** "You've earned 500 points - don't let them expire."
615
- - **Risk:** "30-day money-back guarantee" (reduces the "loss" of money).
616
-
617
- **Example:**
618
- ```
619
- ❌ Bad: "Click here to get a $10 coupon."
620
- βœ… Good: "You have a $10 credit waiting. Use it before it expires tonight!"
621
-
622
- ❌ Bad: "Cancel your subscription."
623
- βœ… Good: "If you cancel, you will lose access to your 50 saved projects."
624
- ```
625
-
626
- ### False-Consensus Effect
627
-
628
- **Principle:** People tend to overestimate the extent to which their opinions, beliefs, preferences, values, and habits are normal and typical of those of others.
629
-
630
- **Application:**
631
- - **Testing:** You are not the user - test with real target audiences.
632
- - **Research:** Use qualitative data (interviews) and quantitative data (analytics).
633
- - **Bias:** Use "Blind Design Reviews" to avoid personal favoritism.
634
- - **Persona:** Stick to established User Personas over personal hunches.
635
- - **Variation:** Test with users from different demographics/abilities.
636
- - **Objectivity:** Use heatmaps to see actual user behavior.
637
-
638
- **Example:**
639
- ```
640
- ❌ Bad: A designer deciding a feature is "intuitive" without testing it.
641
- βœ… Good: Running an A/B test to see which version users prefer.
642
-
643
- ❌ Bad: Building an app entirely in English because "everyone knows English."
644
- βœ… Good: Adding localization based on actual user location data.
645
- ```
646
-
647
- ### Curse of Knowledge
648
-
649
- **Principle:** A cognitive bias that occurs when an individual, communicating with other individuals, unknowingly assumes that the others have the background to understand.
650
-
651
- **Application:**
652
- - **Copy:** Avoid jargon and use plain language.
653
- - **Onboarding:** Tutorials that assume the user knows nothing.
654
- - **Tooltips:** Explain complex terms on hover.
655
- - **Structure:** Progressive disclosure (hide advanced settings).
656
- - **Labels:** Use icons + text labels for navigation (don't rely on icons alone).
657
- - **Support:** Comprehensive FAQs for first-time users.
658
-
659
- **Example:**
660
- ```
661
- ❌ Bad: An error message saying "Exception: Null Pointer at 0x0045."
662
- βœ… Good: An error message saying "Something went wrong. Please try refreshing."
663
-
664
- ❌ Bad: Navigating a cloud app using terms like "S3 Bucket Instances."
665
- βœ… Good: Using simple terms like "File Storage."
666
- ```
667
-
668
- ### Stepping Stone Effect (Foot-in-the-Door)
669
-
670
- **Principle:** Users commit to large tasks if they start with small ones.
671
-
672
- **Application:**
673
- - **Funnel:** Ask for email before asking for credit card.
674
- - **Engagement:** Ask for one preference (e.g. "Dark Mode?") before registration.
675
- - **Onboarding:** Use a series of "Quick Yes/No" questions.
676
- - **Trust:** Offer a free PDF/tool before asking for a subscription.
677
- - **Profile:** Ask to upload a photo first, then fill out the bio later.
678
- - **Sales:** Offer a low-cost "tripwire" product before the main service.
679
-
680
- **Example:**
681
- ```
682
- ❌ Bad: A "Start Free Trial" button that immediately requires credit card info.
683
- βœ… Good: Asking for an email and password first, then offering the trial.
684
-
685
- ❌ Bad: A survey that shows all 50 questions on one page.
686
- βœ… Good: A survey that starts with one easy "Yes/No" question.
687
- ```
688
-
689
- ---
690
-
691
- ## 2. Emotional Design (Don Norman)
692
-
693
- ### Three Levels of Processing
694
-
695
- ```
696
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
697
- β”‚ VISCERAL (Lizard Brain) β”‚
698
- β”‚ ───────────────────── β”‚
699
- β”‚ β€’ Immediate, automatic reaction β”‚
700
- β”‚ β€’ First impressions (first 50ms) β”‚
701
- β”‚ β€’ Aesthetics: colors, shapes, imagery β”‚
702
- β”‚ β€’ "Wow, this looks beautiful!" β”‚
703
- β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
704
- β”‚ BEHAVIORAL (Functional Brain) β”‚
705
- β”‚ ───────────────────────────── β”‚
706
- β”‚ β€’ Usability and function β”‚
707
- β”‚ β€’ Pleasure from effective use β”‚
708
- β”‚ β€’ Performance, reliability, ease β”‚
709
- β”‚ β€’ "This works exactly how I expected!" β”‚
710
- β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
711
- β”‚ REFLECTIVE (Conscious Brain) β”‚
712
- β”‚ ───────────────────────────── β”‚
713
- β”‚ β€’ Conscious thought and meaning β”‚
714
- β”‚ β€’ Personal identity and values β”‚
715
- β”‚ β€’ Long-term memory and loyalty β”‚
716
- β”‚ β€’ "This brand represents who I am" β”‚
717
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
718
- ```
719
-
720
- ### Designing for Each Level
721
-
722
- **Visceral:**
723
- ```css
724
- /* Beautiful first impression */
725
- .hero {
726
- background: linear-gradient(135deg, #0ea5e9 0%, #14b8a6 100%);
727
- color: white;
728
- }
729
-
730
- /* Pleasing microinteractions */
731
- .button:hover {
732
- transform: translateY(-2px);
733
- box-shadow: var(--shadow-lg);
734
- }
735
- ```
736
-
737
- **Behavioral:**
738
- ```javascript
739
- // Instant feedback
740
- button.onclick = () => {
741
- button.disabled = true;
742
- button.textContent = 'Saving...';
743
-
744
- save().then(() => {
745
- showSuccess('Saved!'); // Immediate confirmation
746
- });
747
- };
748
- ```
749
-
750
- **Reflective:**
751
- ```html
752
- <!-- Brand story and values -->
753
- <section class="about">
754
- <h2>Why We Exist</h2>
755
- <p>We believe technology should empower, not complicate...</p>
756
- </section>
757
-
758
- <!-- Social proof connecting to identity -->
759
- <blockquote>
760
- "This tool helped me become the designer I wanted to be."
761
- </blockquote>
762
- ```
763
-
764
- ---
765
-
766
- ## 3. Trust Building System
767
-
768
- ### Trust Signal Categories
769
-
770
- | Category | Elements | Implementation |
771
- |----------|----------|----------------|
772
- | **Security** | SSL, badges, encryption | Visible padlock, security logos on forms |
773
- | **Social Proof** | Reviews, testimonials, logos | Star ratings, customer photos, brand logos |
774
- | **Transparency** | Policies, pricing, contact | Clear links, no hidden fees, real address |
775
- | **Professional** | Design quality, consistency | No broken elements, consistent branding |
776
- | **Authority** | Certifications, awards, media | "As seen in...", industry certifications |
777
-
778
- ### Trust Signal Placement
779
-
780
- ```
781
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
782
- β”‚ HEADER: Trust banner ("Free shipping | 30-day β”‚
783
- β”‚ returns | Secure checkout") β”‚
784
- β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
785
- β”‚ HERO: Social proof ("Trusted by 10,000+") β”‚
786
- β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
787
- β”‚ PRODUCT: Reviews visible, security badges β”‚
788
- β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
789
- β”‚ CHECKOUT: Payment icons, SSL badge, guarantee β”‚
790
- β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
791
- β”‚ FOOTER: Contact info, policies, certifications β”‚
792
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
793
- ```
794
-
795
- ### Trust-Building CSS Patterns
796
-
797
- ```css
798
- /* Trust badge styling */
799
- .trust-badge {
800
- display: flex;
801
- align-items: center;
802
- gap: 8px;
803
- padding: 12px 16px;
804
- background: #F0FDF4; /* Light green = security */
805
- border-radius: 2px; /* Sharp for trust = precision feel */
806
- font-size: 14px;
807
- color: #166534;
808
- }
809
-
810
- /* Secure form indicator */
811
- .secure-form::before {
812
- content: 'πŸ”’ Secure form';
813
- display: block;
814
- font-size: 12px;
815
- color: #166534;
816
- margin-bottom: 8px;
817
- }
818
-
819
- /* Testimonial card */
820
- .testimonial {
821
- display: flex;
822
- gap: 16px;
823
- padding: 24px;
824
- background: white;
825
- border-radius: 16px; /* Friendly = larger radius */
826
- box-shadow: var(--shadow-sm);
827
- }
828
-
829
- .testimonial-avatar {
830
- width: 48px;
831
- height: 48px;
832
- border-radius: 50%; /* Real photos > initials */
833
- }
834
- ```
835
-
836
- ---
837
-
838
- ## 4. Cognitive Load Management
839
-
840
- ### Three Types of Cognitive Load
841
-
842
- | Type | Definition | Designer's Role |
843
- |------|------------|-----------------|
844
- | **Intrinsic** | Inherent complexity of task | Break into smaller steps |
845
- | **Extraneous** | Load from poor design | Eliminate this! |
846
- | **Germane** | Effort for learning | Support and encourage |
847
-
848
- ### Reduction Strategies
849
-
850
- **1. Simplify (Reduce Extraneous)**
851
- ```css
852
- /* Visual noise β†’ Clean */
853
- .card-busy {
854
- border: 2px solid red;
855
- background: linear-gradient(...);
856
- box-shadow: 0 0 20px ...;
857
- /* Too much! */
858
- }
859
-
860
- .card-clean {
861
- background: white;
862
- border-radius: 16px;
863
- box-shadow: 0 10px 30px -10px rgba(0,0,0,0.1);
864
- /* Calm, focused */
865
- }
866
- ```
867
-
868
- **2. Chunk Information**
869
- ```html
870
- <!-- Overwhelming -->
871
- <form>
872
- <!-- 15 fields at once -->
873
- </form>
874
-
875
- <!-- Chunked -->
876
- <form>
877
- <fieldset>
878
- <legend>Step 1: Personal Info</legend>
879
- <!-- 3-4 fields -->
880
- </fieldset>
881
- <fieldset>
882
- <legend>Step 2: Shipping</legend>
883
- <!-- 3-4 fields -->
884
- </fieldset>
885
- </form>
886
- ```
887
-
888
- **3. Progressive Disclosure**
889
- ```html
890
- <!-- Hide complexity until needed -->
891
- <div class="filters">
892
- <div class="filters-basic">
893
- <!-- Common filters visible -->
894
- </div>
895
- <button onclick="toggleAdvanced()">
896
- Advanced Options β–Ό
897
- </button>
898
- <div class="filters-advanced" hidden>
899
- <!-- Complex filters hidden -->
900
- </div>
901
- </div>
902
- ```
903
-
904
- **4. Use Familiar Patterns**
905
- ```
906
- βœ… Standard navigation placement
907
- βœ… Expected icon meanings (πŸ” = search)
908
- βœ… Conventional form layouts
909
- βœ… Common gesture patterns (swipe, pinch)
910
- ```
911
-
912
- **5. Offload Information**
913
- ```html
914
- <!-- Don't make users remember -->
915
- <label>
916
- Card Number
917
- <input type="text" inputmode="numeric"
918
- autocomplete="cc-number"
919
- placeholder="1234 5678 9012 3456">
920
- </label>
921
-
922
- <!-- Show what they entered -->
923
- <div class="order-summary">
924
- <p>Shipping to: <strong>John Doe, 123 Main St...</strong></p>
925
- <a href="#">Edit</a>
926
- </div>
927
- ```
928
-
929
- ---
930
-
931
- ## 5. Persuasive Design (Ethical)
932
-
933
- ### Ethical Persuasion Techniques
934
-
935
- | Technique | Ethical Use | Dark Pattern (Avoid) |
936
- |-----------|-------------|----------------------|
937
- | **Scarcity** | Real stock levels | Fake countdown timers |
938
- | **Social Proof** | Genuine reviews | Fake testimonials |
939
- | **Authority** | Real credentials | Misleading badges |
940
- | **Urgency** | Real deadlines | Manufactured FOMO |
941
- | **Commitment** | Progress saving | Guilt-tripping |
942
-
943
- ### Nudge Patterns
944
-
945
- **Smart Defaults:**
946
- ```html
947
- <!-- Pre-select the recommended option -->
948
- <input type="radio" name="plan" value="monthly">
949
- <input type="radio" name="plan" value="annual" checked>
950
- Annual (Save 20%)
951
- ```
952
-
953
- **Anchoring:**
954
- ```html
955
- <!-- Show original price to frame discount -->
956
- <div class="price">
957
- <span class="original">$99</span>
958
- <span class="current">$79</span>
959
- <span class="savings">Save 20%</span>
960
- </div>
961
- ```
962
-
963
- **Social Proof:**
964
- ```html
965
- <!-- Real-time activity -->
966
- <div class="activity">
967
- <span class="avatar">πŸ‘€</span>
968
- <span>Sarah from NYC just purchased</span>
969
- </div>
970
-
971
- <!-- Aggregate proof -->
972
- <p>Join 50,000+ designers who use our tool</p>
973
- ```
974
-
975
- **Progress & Commitment:**
976
- ```html
977
- <!-- Show progress to encourage completion -->
978
- <div class="progress">
979
- <div class="progress-bar" style="width: 60%"></div>
980
- <span>60% complete - almost there!</span>
981
- </div>
982
- ```
983
-
984
- ---
985
-
986
- ## 6. User Persona Quick Reference
987
-
988
- ### Gen Z (Born 1997-2012)
989
-
990
- ```
991
- CHARACTERISTICS:
992
- - Digital natives, mobile-first
993
- - Value authenticity, diversity
994
- - Short attention spans
995
- - Visual learners
996
-
997
- DESIGN APPROACH:
998
- β”œβ”€β”€ Colors: Vibrant, hypercolor, bold gradients
999
- β”œβ”€β”€ Typography: Large, variable, experimental
1000
- β”œβ”€β”€ Layout: Vertical scroll, mobile-native
1001
- β”œβ”€β”€ Interactions: Fast, gamified, gesture-based
1002
- β”œβ”€β”€ Content: Short-form video, memes, stories
1003
- └── Trust: Peer reviews > authority
1004
- ```
1005
-
1006
- ### Millennials (Born 1981-1996)
1007
-
1008
- ```
1009
- CHARACTERISTICS:
1010
- - Value experiences over things
1011
- - Research before buying
1012
- - Socially conscious
1013
- - Price-sensitive but quality-aware
1014
-
1015
- DESIGN APPROACH:
1016
- β”œβ”€β”€ Colors: Muted pastels, earth tones
1017
- β”œβ”€β”€ Typography: Clean, readable sans-serif
1018
- β”œβ”€β”€ Layout: Responsive, card-based
1019
- β”œβ”€β”€ Interactions: Smooth, purposeful animations
1020
- β”œβ”€β”€ Content: Value-driven, transparent
1021
- └── Trust: Reviews, sustainability, values
1022
- ```
1023
-
1024
- ### Gen X (Born 1965-1980)
1025
-
1026
- ```
1027
- CHARACTERISTICS:
1028
- - Independent, self-reliant
1029
- - Value efficiency
1030
- - Skeptical of marketing
1031
- - Balanced tech comfort
1032
-
1033
- DESIGN APPROACH:
1034
- β”œβ”€β”€ Colors: Professional, trustworthy
1035
- β”œβ”€β”€ Typography: Familiar, conservative
1036
- β”œβ”€β”€ Layout: Clear hierarchy, traditional
1037
- β”œβ”€β”€ Interactions: Functional, not flashy
1038
- β”œβ”€β”€ Content: Direct, fact-based
1039
- └── Trust: Expertise, track record
1040
- ```
1041
-
1042
- ### Baby Boomers (Born 1946-1964)
1043
-
1044
- ```
1045
- CHARACTERISTICS:
1046
- - Detail-oriented
1047
- - Loyal when trusted
1048
- - Value personal service
1049
- - Less tech-confident
1050
-
1051
- DESIGN APPROACH:
1052
- β”œβ”€β”€ Colors: High contrast, simple palette
1053
- β”œβ”€β”€ Typography: Large (18px+), high contrast
1054
- β”œβ”€β”€ Layout: Simple, linear, spacious
1055
- β”œβ”€β”€ Interactions: Minimal, clear feedback
1056
- β”œβ”€β”€ Content: Comprehensive, detailed
1057
- └── Trust: Phone numbers, real people
1058
- ```
1059
-
1060
- ---
1061
-
1062
- ## 7. Emotion Color Mapping
1063
-
1064
- ```
1065
- β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
1066
- β”‚ EMOTION β”‚ COLORS β”‚ USE β”‚
1067
- β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
1068
- β”‚ Trust β”‚ Blue, Green β”‚ Finance β”‚
1069
- β”‚ Excitement β”‚ Red, Orange β”‚ Sales β”‚
1070
- β”‚ Calm β”‚ Blue, Soft green β”‚ Wellness β”‚
1071
- β”‚ Luxury β”‚ Black, Gold β”‚ Premium β”‚
1072
- β”‚ Creativity β”‚ Teal, Pink β”‚ Art β”‚
1073
- β”‚ Energy β”‚ Yellow, Orange β”‚ Sports β”‚
1074
- β”‚ Nature β”‚ Green, Brown β”‚ Eco β”‚
1075
- β”‚ Happiness β”‚ Yellow, Orange β”‚ Kids β”‚
1076
- β”‚ Sophistication β”‚ Gray, Navy β”‚ Corporate β”‚
1077
- β”‚ Urgency β”‚ Red β”‚ Errors β”‚
1078
- β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
1079
- ```
1080
-
1081
- ---
1082
-
1083
- ## 8. Psychology Checklist
1084
-
1085
- ### Before Launch
1086
-
1087
- - [ ] **Hick's Law:** No more than 7 choices in navigation. Have choices been narrowed to reduce decision fatigue?
1088
- - [ ] **Fitts' Law:** Primary CTAs are large and reachable. Are the most important buttons easy to hit on mobile?
1089
- - [ ] **Miller's Law:** Content is chunked appropriately. Is information grouped into digestible units of 5-7?
1090
- - [ ] **Jakob's Law:** Does the site follow standard web conventions that users already understand?
1091
- - [ ] **Doherty Threshold:** Does the system provide feedback within 400ms? Are skeleton screens in place?
1092
- - [ ] **Tesler's Law:** Has complexity been moved from the user to the system where possible?
1093
- - [ ] **Parkinson’s Law:** Are there features like "One-Click Checkout" to minimize task completion time?
1094
- - [ ] **Von Restorff:** Does the primary CTA visually stand out from all other elements?
1095
- - [ ] **Serial Position:** Is the most critical information at the very beginning or end of lists?
1096
- - [ ] **Gestalt Laws:** Are related items physically grouped together (Proximity) or within a Card (Common Region)?
1097
- - [ ] **Zeigarnik Effect:** Are there visual indicators (like progress bars) for incomplete tasks?
1098
- - [ ] **Goal Gradient:** Is the user given a "head start" (e.g., 20% progress) to encourage completion?
1099
- - [ ] **Peak-End Rule:** Does the final "Success" screen create a moment of delight?
1100
- - [ ] **Occam’s Razor:** Have unnecessary visual or functional elements been removed?
1101
- - [ ] **Aesthetic-Usability:** Is the UI high-fidelity enough to build initial user trust?
1102
- - [ ] **Trust & Authority:** Are security badges, reviews, and expert certifications visible?
1103
- - [ ] **Social Proof:** Are real user numbers or testimonials visible at decision points?
1104
- - [ ] **Scarcity & Urgency:** If used, is the scarcity real and ethical (e.g., actual low stock)?
1105
- - [ ] **Loss Aversion:** Does the copy emphasize what the user stands to keep rather than just gain?
1106
- - [ ] **Anchoring:** Is the pricing presented in a way that frames the desired choice as a great value?
1107
- - [ ] **Postel’s Law:** Is the system flexible enough to accept various input formats without errors?
1108
- - [ ] **False-Consensus:** Has the design been tested with real users rather than just the internal team?
1109
- - [ ] **Curse of Knowledge:** Is the copy free of technical jargon and easy for a beginner to understand?
1110
- - [ ] **Stepping Stone:** Does the funnel start with low-friction tasks (e.g., email only)?
1111
- - [ ] **Cognitive Load:** Is extraneous visual noise minimized to keep the interface clean?
1112
- - [ ] **Emotional Design:** Does the color palette and imagery evoke the intended visceral reaction?
1113
- - [ ] **Feedback:** Do all interactive elements have immediate hover, active, and success states?
1114
- - [ ] **Accessibility:** Is the contrast ratio sufficient, and is the site navigable via keyboard/screen reader?
1115
- - [ ] **PrΓ€gnanz:** Are icons and shapes simple enough to be recognized at a glance?
1116
- - [ ] **Figure/Ground:** Is it clear which element is in focus (e.g., using shadows or scrims for modals)?
1
+ # UX Psychology Reference
2
+
3
+ > Deep dive into UX laws, emotional design, trust building, and behavioral psychology.
4
+
5
+ ---
6
+
7
+ ## 1. Core UX Laws
8
+
9
+ ### Hick's Law
10
+
11
+ **Principle:** The time to make a decision increases logarithmically with the number of choices.
12
+
13
+ ```
14
+ Decision Time = a + b Γ— logβ‚‚(n + 1)
15
+ Where n = number of choices
16
+ ```
17
+
18
+ **Application:**
19
+ - Navigation: Max 5-7 top-level items
20
+ - Forms: Break into steps (progressive disclosure)
21
+ - Options: Default selections when possible
22
+ - Filters: Prioritize most-used, hide advanced
23
+
24
+ **Example:**
25
+ ```
26
+ ❌ Bad: 15 menu items in one nav
27
+ βœ… Good: 5 main categories + "More"
28
+
29
+ ❌ Bad: 20 form fields at once
30
+ βœ… Good: 3-step wizard with 5-7 fields each
31
+ ```
32
+
33
+ ---
34
+
35
+ ### Fitts' Law
36
+
37
+ **Principle:** Time to reach a target = function of distance and size.
38
+
39
+ ```
40
+ MT = a + b Γ— logβ‚‚(1 + D/W)
41
+ Where D = distance, W = width
42
+ ```
43
+
44
+ **Application:**
45
+ - CTAs: Make primary buttons larger (min 44px height)
46
+ - Touch targets: 44Γ—44px minimum on mobile
47
+ - Placement: Important actions near natural cursor position
48
+ - Corners: "Magic corners" (infinite edge = easy to hit)
49
+
50
+ **Button Sizing:**
51
+ ```css
52
+ /* Size by importance */
53
+ .btn-primary { height: 48px; padding: 0 24px; }
54
+ .btn-secondary { height: 40px; padding: 0 16px; }
55
+ .btn-tertiary { height: 36px; padding: 0 12px; }
56
+
57
+ /* Mobile touch targets */
58
+ @media (hover: none) {
59
+ .btn { min-height: 44px; min-width: 44px; }
60
+ }
61
+ ```
62
+
63
+ ---
64
+
65
+ ### Miller's Law
66
+
67
+ **Principle:** Average person can hold 7Β±2 chunks in working memory.
68
+
69
+ **Application:**
70
+ - Lists: Group into chunks of 5-7 items
71
+ - Navigation: Max 7 menu items
72
+ - Content: Break long content with headings
73
+ - Phone numbers: 555-123-4567 (chunked)
74
+
75
+ **Chunking Example:**
76
+ ```
77
+ ❌ 5551234567
78
+ βœ… 555-123-4567
79
+
80
+ ❌ Long paragraph of text without breaks
81
+ βœ… Short paragraphs
82
+ With bullet points
83
+ And subheadings
84
+ ```
85
+
86
+ ---
87
+
88
+ ### Von Restorff Effect (Isolation Effect)
89
+
90
+ **Principle:** An item that stands out is more likely to be remembered.
91
+
92
+ **Application:**
93
+ - CTA buttons: Distinct color from other elements
94
+ - Pricing: Highlight recommended plan
95
+ - Important info: Visual differentiation
96
+ - New features: Badge or callout
97
+
98
+ **Example:**
99
+ ```css
100
+ /* All buttons gray, primary stands out */
101
+ .btn { background: #E5E7EB; }
102
+ .btn-primary { background: #3B82F6; }
103
+
104
+ /* Recommended plan highlighted */
105
+ .pricing-card { border: 1px solid #E5E7EB; }
106
+ .pricing-card.popular {
107
+ border: 2px solid #3B82F6;
108
+ box-shadow: var(--shadow-lg);
109
+ }
110
+ ```
111
+
112
+ ---
113
+
114
+ ### Serial Position Effect
115
+
116
+ **Principle:** Items at the beginning (primacy) and end (recency) of a list are remembered best.
117
+
118
+ **Application:**
119
+ - Navigation: Most important items first and last
120
+ - Lists: Key info at top and bottom
121
+ - Forms: Most critical fields at start
122
+ - CTAs: Repeat at top and bottom of long pages
123
+
124
+ **Example:**
125
+ ```
126
+ Navigation: Home | [key items] | Contact
127
+
128
+ Long landing page:
129
+ - CTA at hero (top)
130
+ - Content sections
131
+ - CTA repeated at bottom
132
+ ```
133
+
134
+ ### Jakob’s Law
135
+
136
+ **Principle:** Users spend most of their time on other sites. They prefer your site to work the same way as all the other sites they already know.
137
+
138
+ **Application:**
139
+ - **Patterns:** Use standard placement for search bars and carts.
140
+ - **Mental Models:** Leverage familiar icons (e.g., a magnifying glass).
141
+ - **Vocabulary:** Use "Log In" instead of "Enter the Portal."
142
+ - **Layout:** Keep the logo in the top-left for "Home" navigation.
143
+ - **Interaction:** Swiping right to go back/next should feel native.
144
+ - **Feedback:** Standard colors (Red = Error, Green = Success).
145
+
146
+ **Example:**
147
+ ```
148
+ ❌ Bad: A website where clicking the logo takes you to an "About Us" page.
149
+ βœ… Good: Clicking the logo always returns the user to the Homepage.
150
+
151
+ ❌ Bad: Using a "Star" icon to represent "Delete."
152
+ βœ… Good: Using a "Trash Can" icon to represent "Delete."
153
+ ```
154
+
155
+ ---
156
+
157
+ ### Tesler’s Law (Conservation of Complexity)
158
+
159
+ **Principle:** For any system, there is a certain amount of complexity which cannot be reduced, only shifted from user to software.
160
+
161
+ **Application:**
162
+ - **Backend:** Let the system handle formatting (e.g., currency).
163
+ - **Detection:** Auto-detect card type or city via ZIP code.
164
+ - **Automation:** Pre-fill returning user data.
165
+ - **Personalization:** Show only relevant fields based on previous answers.
166
+ - **Defaults:** Smart defaults for common settings.
167
+ - **Integration:** Use SSO (Social Logins) to offload registration friction.
168
+
169
+ **Example:**
170
+ ```
171
+ ❌ Bad: Making users type "USD $" before every price field in a form.
172
+ βœ… Good: The app automatically prefixing the "$" based on the user's location.
173
+
174
+ ❌ Bad: Forcing users to manually select their "Card Type" (Visa/Mastercard).
175
+ βœ… Good: Detecting the card type automatically from the first four digits entered.
176
+ ```
177
+
178
+ ---
179
+
180
+ ### Parkinson’s Law
181
+
182
+ **Principle:** Any task will inflate until all available time is spent.
183
+
184
+ **Application:**
185
+ - **Efficiency:** Use "Auto-save" to reduce task completion time.
186
+ - **Speed:** Limit the steps in a conversion funnel.
187
+ - **Clarity:** Use clear labels to prevent "hover-poking" for meaning.
188
+ - **Feedback:** Real-time validation to stop users from wasting time on errors.
189
+ - **Onboarding:** Quick "Express" setup for power users.
190
+ - **Constraints:** Set character limits on inputs to focus thoughts.
191
+
192
+ **Example:**
193
+ ```
194
+ ❌ Bad: A 10-page registration form that allows users to browse away and lose data.
195
+ βœ… Good: A "One-Tap Sign In" using Google or Apple ID.
196
+
197
+ ❌ Bad: Giving a user an indefinite amount of time to fill out a bio.
198
+ βœ… Good: Providing a "Suggested Bios" feature to help them finish in seconds.
199
+ ```
200
+
201
+ ---
202
+
203
+ ### Doherty Threshold
204
+
205
+ **Principle:** Productivity skyrockets when a computer and its users interact at a pace (<400ms) that ensures neither has to wait on the other.
206
+
207
+ **Application:**
208
+ - **Feedback:** Use immediate visual cues for clicks.
209
+ - **Loading:** Use skeleton screens for perceivable performance.
210
+ - **Optimism:** Update UI before the server responds (Optimistic UI).
211
+ - **Motion:** Use micro-animations to mask slight delays.
212
+ - **Caching:** Pre-load next pages or assets in the background.
213
+ - **Prioritization:** Load text content before heavy high-res images.
214
+
215
+ **Example:**
216
+ ```
217
+ ❌ Bad: A button that does nothing for 2 seconds after being clicked.
218
+ βœ… Good: A button that immediately changes color and shows a "Loading" spinner.
219
+
220
+ ❌ Bad: A blank white screen that appears while data is fetching.
221
+ βœ… Good: A skeleton screen showing the gray outlines of where content will appear.
222
+ ```
223
+
224
+ ---
225
+
226
+ ### Postel’s Law (Robustness Principle)
227
+
228
+ **Principle:** Be conservative in what you do, be liberal in what you accept from others.
229
+
230
+ **Application:**
231
+ - **Error Handling:** Don't error out for a missing space or dash.
232
+ - **Formatting:** Accept dates in DD/MM/YYYY or MM/DD/YYYY.
233
+ - **Inputs:** Strip trailing/leading white space automatically.
234
+ - **Fallbacks:** Use default avatars if a user hasn't uploaded a photo.
235
+ - **Search:** Accept typos and provide "Did you mean...?" suggestions.
236
+ - **Accessibility:** Ensure the site works across all browsers and devices.
237
+
238
+ **Example:**
239
+ ```
240
+ ❌ Bad: Rejecting a phone number because the user put a space in it.
241
+ βœ… Good: Accepting the input and stripping the spaces automatically.
242
+
243
+ ❌ Bad: Forcing users to type "January" instead of "01" or "Jan."
244
+ βœ… Good: A date field that understands all three formats.
245
+ ```
246
+
247
+ ---
248
+
249
+ ### Occam’s Razor
250
+
251
+ **Principle:** Among competing hypotheses that predict equally well, the one with the fewest assumptions should be selected. The simplest solution is usually the best.
252
+
253
+ **Application:**
254
+ - **Logic:** Remove unnecessary clicks.
255
+ - **Visuals:** Use only as many fonts/colors as strictly necessary.
256
+ - **Function:** If one field can do the work of two, combine them.
257
+ - **Copy:** Use the shortest possible text to convey meaning.
258
+ - **Layout:** Remove decorative elements that don't serve a goal.
259
+ - **Flow:** Avoid branching paths unless absolutely required.
260
+
261
+ **Example:**
262
+ ```
263
+ ❌ Bad: A "Login" button that opens a new page, then email, then password.
264
+ βœ… Good: A single login modal that asks for both on one screen.
265
+
266
+ ❌ Bad: Using 5 different font sizes and 4 colors on a single card.
267
+ βœ… Good: Using 2 font sizes and 1 accent color.
268
+ ```
269
+
270
+ ---
271
+
272
+ ## 2. Visual Perception (Gestalt Principles)
273
+
274
+ ### Law of Proximity
275
+
276
+ **Principle:** Objects that are near, or proximate to each other, tend to be grouped together.
277
+
278
+ **Application:**
279
+ - **Grouping:** Keep labels physically close to input fields.
280
+ - **Spacing:** Larger margins between unrelated content blocks.
281
+ - **Cards:** Text inside a card should be closer to its image than the border.
282
+ - **Footers:** Cluster legal links together away from social links.
283
+ - **Navigation:** Group "User" settings separate from "App" settings.
284
+ - **Forms:** Group Address fields together, separate from Credit Card fields.
285
+
286
+ **Example:**
287
+ ```
288
+ ❌ Bad: Large, equal gaps between every line of text in a form.
289
+ βœ… Good: Tight spacing between a label and its input, with larger gaps between pairs.
290
+
291
+ ❌ Bad: A "Submit" button floating in the middle of a page, far from the form.
292
+ βœ… Good: The "Submit" button placed directly under the last input field.
293
+ ```
294
+
295
+ ---
296
+
297
+ ### Law of Similarity
298
+
299
+ **Principle:** The human eye tends to perceive similar elements in a design as a complete picture, shape, or group, even if those elements are separated.
300
+
301
+ **Application:**
302
+ - **Consistency:** Consistent colors for all clickable links.
303
+ - **Iconography:** All icons in a set should have the same stroke weight.
304
+ - **Buttons:** Same shape/size for buttons with the same importance.
305
+ - **Typography:** Use the same H2 style for all section headers.
306
+ - **Feedback:** All "Delete" actions should use the same color (e.g. Red).
307
+ - **States:** Hover and Active states must be consistent across the app.
308
+
309
+ **Example:**
310
+ ```
311
+ ❌ Bad: Some links are blue, some are green, and some are just bold black.
312
+ βœ… Good: Every clickable text element in the app is the same shade of Blue.
313
+
314
+ ❌ Bad: Using a "Blue Button" for "Submit" and the same "Blue Button" for "Cancel."
315
+ βœ… Good: "Submit" is Solid Blue; "Cancel" is a Blue Outline (Ghost Button).
316
+ ```
317
+
318
+ ---
319
+
320
+ ### Law of Common Region
321
+
322
+ **Principle:** Elements tend to be perceived into groups if they are sharing an area with a clearly defined boundary.
323
+
324
+ **Application:**
325
+ - **Containerizing:** Use cards to group images and titles.
326
+ - **Borders:** Use lines to separate the sidebar from the main feed.
327
+ - **Backgrounds:** Use a different background color for the footer.
328
+ - **Modals:** Use a distinct box to separate pop-ups from the page.
329
+ - **Lists:** Alternating background colors (zebra striping) for rows.
330
+ - **Header:** A solid bar across the top to group navigation items.
331
+
332
+ **Example:**
333
+ ```
334
+ ❌ Bad: A list of news articles where the text and image of different stories overlap.
335
+ βœ… Good: Each article is contained within its own white card on a light gray background.
336
+
337
+ ❌ Bad: A footer that has the same background color as the main body.
338
+ βœ… Good: A dark-themed footer that clearly separates legal links from page content.
339
+ ```
340
+
341
+ ---
342
+
343
+ ### Law of Uniform Connectedness
344
+
345
+ **Principle:** Elements that are visually connected (e.g., via lines, arrows) are perceived as more related than elements with no connection.
346
+
347
+ **Application:**
348
+ - **Flow:** Use lines to connect steps in a progress wizard.
349
+ - **Menus:** Dropdowns that "touch" or connect to their parent button.
350
+ - **Graphs:** Lines connecting data points in a chart.
351
+ - **Relationship:** Connecting a toggle switch to the text it controls.
352
+ - **Hierarchy:** Tree structures for file directories.
353
+ - **Forms:** Connecting a "Credit Card" radio button to the fieldset below it.
354
+
355
+ **Example:**
356
+ ```
357
+ ❌ Bad: A 3-step setup where the numbers "1", "2", and "3" are scattered.
358
+ βœ… Good: A horizontal line connecting "1", "2", and "3" to show a sequence.
359
+
360
+ ❌ Bad: Floating dropdown menus that don't touch the button that opened them.
361
+ βœ… Good: A dropdown menu that visually "attaches" to the parent button.
362
+ ```
363
+
364
+ ---
365
+
366
+ ### Law of PrΓ€gnanz (Simplicity)
367
+
368
+ **Principle:** People will perceive and interpret ambiguous or complex images as the simplest form possible, because it is the interpretation that requires the least cognitive effort.
369
+
370
+ **Application:**
371
+ - **Clarity:** Use clear, geometric icons for navigation.
372
+ - **Reduction:** Remove unnecessary 3D textures or shadows.
373
+ - **Shapes:** Prefer standard rectangles/circles over complex polygons.
374
+ - **Focus:** Use high-contrast silhouettes for primary actions.
375
+ - **Logos:** Simple brand marks that are recognizable at small sizes.
376
+ - **UX:** One main goal per page to keep the "mental shape" simple.
377
+
378
+ **Example:**
379
+ ```
380
+ ❌ Bad: A hyper-realistic 3D illustration of a file folder for the "Files" icon.
381
+ βœ… Good: A simple 2D outline of a folder.
382
+
383
+ ❌ Bad: A multi-colored, complex logo used as a loading spinner.
384
+ βœ… Good: A simple, single-color circular ring.
385
+ ```
386
+
387
+ ---
388
+
389
+ ### Law of Figure/Ground
390
+
391
+ **Principle:** The eye differentiates an object from its surrounding area. a form, silhouette, or shape is perceived as figure (object), while the surrounding area is perceived as ground (background).
392
+
393
+ **Application:**
394
+ - **Focus:** Use overlays (scrims) for modals to pop the content.
395
+ - **Depth:** Drop shadows to imply the "figure" is sitting above the "ground."
396
+ - **Contrast:** Light text on dark ground (or vice versa).
397
+ - **Blur:** Use background blur to emphasize foreground text.
398
+ - **Navigation:** Floating sticky headers that stay above the page content.
399
+ - **Hover:** Elevate cards slightly on hover to define them as the figure.
400
+
401
+ **Example:**
402
+ ```
403
+ ❌ Bad: A popup window that has no shadow or border, blending into the page.
404
+ βœ… Good: A modal with a drop shadow and a dimmed background overlay.
405
+
406
+ ❌ Bad: White text placed directly over a busy, multi-colored photograph.
407
+ βœ… Good: White text placed over a dark semi-transparent "scrim."
408
+ ```
409
+
410
+ ---
411
+
412
+ ### Law of Focal Point
413
+
414
+ **Principle:** Whatever stands out visually will capture and hold the viewer’s attention first.
415
+
416
+ **Application:**
417
+ - **Entry:** Place the primary value proposition at the focal point.
418
+ - **Color:** Use one high-vibrancy "Action Color" against a neutral UI.
419
+ - **Movement:** Use subtle animation on the CTA to draw the eye.
420
+ - **Size:** The most important statistic should be the largest font.
421
+ - **Typography:** Use bold weights for headers and standard weights for body.
422
+ - **Direction:** Use arrows or gaze (images of people looking at a button).
423
+
424
+ **Example:**
425
+ ```
426
+ ❌ Bad: A homepage with 5 buttons of the same size and color.
427
+ βœ… Good: One large "Get Started" button in a bright color.
428
+
429
+ ❌ Bad: A dashboard where "Total Revenue" is the same size as "System Version."
430
+ βœ… Good: "Total Revenue" displayed in huge, bold numbers at the top center.
431
+ ```
432
+
433
+ ---
434
+
435
+ ## 3. Cognitive Biases & Behavior
436
+
437
+ ### Zeigarnik Effect
438
+
439
+ **Principle:** People remember uncompleted or interrupted tasks better than completed tasks.
440
+
441
+ **Application:**
442
+ - **Gamification:** Use "Profile 60% complete" bars.
443
+ - **Engagement:** Tease the next module in a learning path.
444
+ - **Retention:** Show a "To-Do" list of features yet to be explored.
445
+ - **Feedback:** Persistent badges for unread messages.
446
+ - **Momentum:** Show "Next" steps immediately after completing one.
447
+ - **Shopping:** "Finish your order" reminders in the cart.
448
+
449
+ **Example:**
450
+ ```
451
+ ❌ Bad: A silent onboarding process that gives no indication of what's left.
452
+ βœ… Good: A checklist that shows "3 of 5 steps finished."
453
+
454
+ ❌ Bad: An e-learning app that shows a checkmark even if a video was half-watched.
455
+ βœ… Good: A progress ring that stays half-full until the video is finished.
456
+ ```
457
+
458
+ ### Goal Gradient Effect
459
+
460
+ **Principle:** The tendency to approach a goal increases with proximity to the goal.
461
+
462
+ **Application:**
463
+ - **Momentum:** Give users "Artificial Advancement" (e.g. 2 free stamps).
464
+ - **Progress:** Break a 10-field form into two 5-field steps.
465
+ - **Feedback:** Celebrate milestones halfway through a task.
466
+ - **Motivation:** Show the user how close they are to a reward/status.
467
+ - **Navigation:** Use breadcrumbs to show how close they are to the end.
468
+ - **Loading:** Speed up the loading animation as it nears 100%.
469
+
470
+ **Example:**
471
+ ```
472
+ ❌ Bad: A progress bar that starts at 0% and feels like a long climb.
473
+ βœ… Good: A bar that starts at 20% because the user "started" by opening the app.
474
+
475
+ ❌ Bad: A checkout flow where the "Final Review" feels like a surprise 5th step.
476
+ βœ… Good: Clearly labeling the steps: "Shipping > Payment > Almost Done!"
477
+ ```
478
+
479
+ ### Peak-End Rule
480
+
481
+ **Principle:** People judge an experience largely based on how they felt at its peak (the most intense point) and at its end, rather than the total sum or average of every moment.
482
+
483
+ **Application:**
484
+ - **Success:** Make the "Order Confirmed" screen memorable.
485
+ - **Delight:** Add confetti or a unique animation at the point of value.
486
+ - **Support:** Ensure the final interaction with a chat bot is helpful.
487
+ - **Unboarding:** Even when a user leaves, make the final exit clean.
488
+ - **Onboarding:** End the first session with a clear "Win."
489
+ - **Error Handling:** Turn a 404 page into a fun, helpful interaction.
490
+
491
+ **Example:**
492
+ ```
493
+ ❌ Bad: After a 20-minute tax filing process, the app just says "Submitted."
494
+ βœ… Good: A "Congratulations!" screen with a summary of the refund amount.
495
+
496
+ ❌ Bad: A game that ends with a simple "Game Over" text in plain font.
497
+ βœ… Good: A summary screen showing high scores with celebratory music.
498
+ ```
499
+
500
+ ### Aesthetic-Usability Effect
501
+
502
+ **Principle:** Users often perceive aesthetically pleasing design as design that’s more usable.
503
+
504
+ **Application:**
505
+ - **Trust:** High-fidelity visuals buy "trust credit" for minor bugs.
506
+ - **Branding:** Consistent high-quality imagery build professionalism.
507
+ - **Engagement:** Beautiful interfaces keep users exploring longer.
508
+ - **Patience:** Users are more forgiving of load times if the UI is pretty.
509
+ - **Confidence:** Clean design makes complex tools feel more manageable.
510
+ - **Loyalty:** People form emotional bonds with beautiful products.
511
+
512
+ **Example:**
513
+ ```
514
+ ❌ Bad: A banking app with misaligned text and clashing 1990s colors.
515
+ βœ… Good: A sleek, modern banking app with smooth animations.
516
+
517
+ ❌ Bad: Using low-resolution, pixelated stock photos.
518
+ βœ… Good: Using high-definition, custom brand illustrations.
519
+ ```
520
+
521
+ ### Anchoring Bias
522
+
523
+ **Principle:** Users rely heavily on the first piece of information offered (the "anchor") when making decisions.
524
+
525
+ **Application:**
526
+ - **Pricing:** Show the original price crossed out.
527
+ - **Tiers:** Put the most expensive "Enterprise" plan on the far left.
528
+ - **Sorting:** Highlight "Most Popular" as the first recommendation.
529
+ - **Discounts:** State the "Save 20%" before showing the final price.
530
+ - **Limits:** "Limit 12 per customer" anchors the idea that it's high value.
531
+ - **Defaults:** Start with a high "Suggested Donation" amount.
532
+
533
+ **Example:**
534
+ ```
535
+ ❌ Bad: Only showing the price "$49."
536
+ βœ… Good: Showing "~~$99~~ $49 (50% Off)."
537
+
538
+ ❌ Bad: Sorting a list of laptops from cheapest to most expensive.
539
+ βœ… Good: Showing a high-end "Pro" model first to make others seem cheap.
540
+ ```
541
+
542
+ ### Social Proof
543
+
544
+ **Principle:** People copy the actions of others in an attempt to undertake behavior in a given situation.
545
+
546
+ **Application:**
547
+ - **Validation:** Display "Join 50,000+ others."
548
+ - **Reviews:** Star ratings and verified customer testimonials.
549
+ - **Logos:** "Trusted by" section showing partner brands.
550
+ - **Live Feed:** "Sarah just bought this 5 mins ago" notifications.
551
+ - **Activity:** "300 people are currently viewing this item."
552
+ - **Certificates:** Industry awards and security badges.
553
+
554
+ **Example:**
555
+ ```
556
+ ❌ Bad: A signup page with just a form.
557
+ βœ… Good: A signup page that says "Join 2 million designers."
558
+
559
+ ❌ Bad: Anonymous reviews with no names or photos.
560
+ βœ… Good: Reviews that include a face, a name, and a "Verified Buyer" tag.
561
+ ```
562
+
563
+ ### Scarcity Principle
564
+
565
+ **Principle:** Humans place a higher value on an object that is scarce, and a lower value on those that are in abundance.
566
+
567
+ **Application:**
568
+ - **Urgency:** "Only 2 items left in stock."
569
+ - **Time:** Ticking countdown timers for sales.
570
+ - **Access:** "Invite-only" betas or exclusive tiers.
571
+ - **Seasonality:** "Summer Edition" products.
572
+ - **Low Stock:** "Back in stock soon - pre-order now."
573
+ - **Demand:** "In high demand - 10 people have this in their cart."
574
+
575
+ **Example:**
576
+ ```
577
+ ❌ Bad: A sale that never ends and has no countdown.
578
+ βœ… Good: A "Deal of the Day" with a ticking timer.
579
+
580
+ ❌ Bad: Showing a product is available with no stock count.
581
+ βœ… Good: "Only 3 left at this price!"
582
+ ```
583
+
584
+ ### Authority Bias
585
+
586
+ **Principle:** The tendency to attribute greater accuracy to the opinion of an authority figure and be more influenced by that opinion.
587
+
588
+ **Application:**
589
+ - **Expertise:** Use "Expert-verified" or professional headshots.
590
+ - **Certifications:** Trust seals (Norton, ISO, HIPAA).
591
+ - **Media:** "As seen on TechCrunch/Forbes" logos.
592
+ - **Endorsements:** Testimonials from industry leaders or influencers.
593
+ - **Language:** Confident, professional, and accurate copy.
594
+ - **History:** "Established in 1950" to imply longevity and trust.
595
+
596
+ **Example:**
597
+ ```
598
+ ❌ Bad: A health blog written by "Admin."
599
+ βœ… Good: A health article "Reviewed by Dr. Jane Smith, Cardiologist."
600
+
601
+ ❌ Bad: A security app with no mentions of certifications.
602
+ βœ… Good: Displaying "ISO 27001 Certified" and "Norton Secured" logos.
603
+ ```
604
+
605
+ ### Loss Aversion
606
+
607
+ **Principle:** People generally prefer avoiding losses to acquiring equivalent gains. It is better to not lose $5 than to find $5.
608
+
609
+ **Application:**
610
+ - **Messaging:** "Don't lose your discount."
611
+ - **Trials:** "Your free trial is ending - keep your data now."
612
+ - **Scarcity:** "Once it's gone, it's gone for good."
613
+ - **Carts:** "Don't miss out on the items in your cart."
614
+ - **Loyalty:** "You've earned 500 points - don't let them expire."
615
+ - **Risk:** "30-day money-back guarantee" (reduces the "loss" of money).
616
+
617
+ **Example:**
618
+ ```
619
+ ❌ Bad: "Click here to get a $10 coupon."
620
+ βœ… Good: "You have a $10 credit waiting. Use it before it expires tonight!"
621
+
622
+ ❌ Bad: "Cancel your subscription."
623
+ βœ… Good: "If you cancel, you will lose access to your 50 saved projects."
624
+ ```
625
+
626
+ ### False-Consensus Effect
627
+
628
+ **Principle:** People tend to overestimate the extent to which their opinions, beliefs, preferences, values, and habits are normal and typical of those of others.
629
+
630
+ **Application:**
631
+ - **Testing:** You are not the user - test with real target audiences.
632
+ - **Research:** Use qualitative data (interviews) and quantitative data (analytics).
633
+ - **Bias:** Use "Blind Design Reviews" to avoid personal favoritism.
634
+ - **Persona:** Stick to established User Personas over personal hunches.
635
+ - **Variation:** Test with users from different demographics/abilities.
636
+ - **Objectivity:** Use heatmaps to see actual user behavior.
637
+
638
+ **Example:**
639
+ ```
640
+ ❌ Bad: A designer deciding a feature is "intuitive" without testing it.
641
+ βœ… Good: Running an A/B test to see which version users prefer.
642
+
643
+ ❌ Bad: Building an app entirely in English because "everyone knows English."
644
+ βœ… Good: Adding localization based on actual user location data.
645
+ ```
646
+
647
+ ### Curse of Knowledge
648
+
649
+ **Principle:** A cognitive bias that occurs when an individual, communicating with other individuals, unknowingly assumes that the others have the background to understand.
650
+
651
+ **Application:**
652
+ - **Copy:** Avoid jargon and use plain language.
653
+ - **Onboarding:** Tutorials that assume the user knows nothing.
654
+ - **Tooltips:** Explain complex terms on hover.
655
+ - **Structure:** Progressive disclosure (hide advanced settings).
656
+ - **Labels:** Use icons + text labels for navigation (don't rely on icons alone).
657
+ - **Support:** Comprehensive FAQs for first-time users.
658
+
659
+ **Example:**
660
+ ```
661
+ ❌ Bad: An error message saying "Exception: Null Pointer at 0x0045."
662
+ βœ… Good: An error message saying "Something went wrong. Please try refreshing."
663
+
664
+ ❌ Bad: Navigating a cloud app using terms like "S3 Bucket Instances."
665
+ βœ… Good: Using simple terms like "File Storage."
666
+ ```
667
+
668
+ ### Stepping Stone Effect (Foot-in-the-Door)
669
+
670
+ **Principle:** Users commit to large tasks if they start with small ones.
671
+
672
+ **Application:**
673
+ - **Funnel:** Ask for email before asking for credit card.
674
+ - **Engagement:** Ask for one preference (e.g. "Dark Mode?") before registration.
675
+ - **Onboarding:** Use a series of "Quick Yes/No" questions.
676
+ - **Trust:** Offer a free PDF/tool before asking for a subscription.
677
+ - **Profile:** Ask to upload a photo first, then fill out the bio later.
678
+ - **Sales:** Offer a low-cost "tripwire" product before the main service.
679
+
680
+ **Example:**
681
+ ```
682
+ ❌ Bad: A "Start Free Trial" button that immediately requires credit card info.
683
+ βœ… Good: Asking for an email and password first, then offering the trial.
684
+
685
+ ❌ Bad: A survey that shows all 50 questions on one page.
686
+ βœ… Good: A survey that starts with one easy "Yes/No" question.
687
+ ```
688
+
689
+ ---
690
+
691
+ ## 2. Emotional Design (Don Norman)
692
+
693
+ ### Three Levels of Processing
694
+
695
+ ```
696
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
697
+ β”‚ VISCERAL (Lizard Brain) β”‚
698
+ β”‚ ───────────────────── β”‚
699
+ β”‚ β€’ Immediate, automatic reaction β”‚
700
+ β”‚ β€’ First impressions (first 50ms) β”‚
701
+ β”‚ β€’ Aesthetics: colors, shapes, imagery β”‚
702
+ β”‚ β€’ "Wow, this looks beautiful!" β”‚
703
+ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
704
+ β”‚ BEHAVIORAL (Functional Brain) β”‚
705
+ β”‚ ───────────────────────────── β”‚
706
+ β”‚ β€’ Usability and function β”‚
707
+ β”‚ β€’ Pleasure from effective use β”‚
708
+ β”‚ β€’ Performance, reliability, ease β”‚
709
+ β”‚ β€’ "This works exactly how I expected!" β”‚
710
+ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
711
+ β”‚ REFLECTIVE (Conscious Brain) β”‚
712
+ β”‚ ───────────────────────────── β”‚
713
+ β”‚ β€’ Conscious thought and meaning β”‚
714
+ β”‚ β€’ Personal identity and values β”‚
715
+ β”‚ β€’ Long-term memory and loyalty β”‚
716
+ β”‚ β€’ "This brand represents who I am" β”‚
717
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
718
+ ```
719
+
720
+ ### Designing for Each Level
721
+
722
+ **Visceral:**
723
+ ```css
724
+ /* Beautiful first impression */
725
+ .hero {
726
+ background: linear-gradient(135deg, #0ea5e9 0%, #14b8a6 100%);
727
+ color: white;
728
+ }
729
+
730
+ /* Pleasing microinteractions */
731
+ .button:hover {
732
+ transform: translateY(-2px);
733
+ box-shadow: var(--shadow-lg);
734
+ }
735
+ ```
736
+
737
+ **Behavioral:**
738
+ ```javascript
739
+ // Instant feedback
740
+ button.onclick = () => {
741
+ button.disabled = true;
742
+ button.textContent = 'Saving...';
743
+
744
+ save().then(() => {
745
+ showSuccess('Saved!'); // Immediate confirmation
746
+ });
747
+ };
748
+ ```
749
+
750
+ **Reflective:**
751
+ ```html
752
+ <!-- Brand story and values -->
753
+ <section class="about">
754
+ <h2>Why We Exist</h2>
755
+ <p>We believe technology should empower, not complicate...</p>
756
+ </section>
757
+
758
+ <!-- Social proof connecting to identity -->
759
+ <blockquote>
760
+ "This tool helped me become the designer I wanted to be."
761
+ </blockquote>
762
+ ```
763
+
764
+ ---
765
+
766
+ ## 3. Trust Building System
767
+
768
+ ### Trust Signal Categories
769
+
770
+ | Category | Elements | Implementation |
771
+ |----------|----------|----------------|
772
+ | **Security** | SSL, badges, encryption | Visible padlock, security logos on forms |
773
+ | **Social Proof** | Reviews, testimonials, logos | Star ratings, customer photos, brand logos |
774
+ | **Transparency** | Policies, pricing, contact | Clear links, no hidden fees, real address |
775
+ | **Professional** | Design quality, consistency | No broken elements, consistent branding |
776
+ | **Authority** | Certifications, awards, media | "As seen in...", industry certifications |
777
+
778
+ ### Trust Signal Placement
779
+
780
+ ```
781
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
782
+ β”‚ HEADER: Trust banner ("Free shipping | 30-day β”‚
783
+ β”‚ returns | Secure checkout") β”‚
784
+ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
785
+ β”‚ HERO: Social proof ("Trusted by 10,000+") β”‚
786
+ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
787
+ β”‚ PRODUCT: Reviews visible, security badges β”‚
788
+ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
789
+ β”‚ CHECKOUT: Payment icons, SSL badge, guarantee β”‚
790
+ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
791
+ β”‚ FOOTER: Contact info, policies, certifications β”‚
792
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
793
+ ```
794
+
795
+ ### Trust-Building CSS Patterns
796
+
797
+ ```css
798
+ /* Trust badge styling */
799
+ .trust-badge {
800
+ display: flex;
801
+ align-items: center;
802
+ gap: 8px;
803
+ padding: 12px 16px;
804
+ background: #F0FDF4; /* Light green = security */
805
+ border-radius: 2px; /* Sharp for trust = precision feel */
806
+ font-size: 14px;
807
+ color: #166534;
808
+ }
809
+
810
+ /* Secure form indicator */
811
+ .secure-form::before {
812
+ content: 'πŸ”’ Secure form';
813
+ display: block;
814
+ font-size: 12px;
815
+ color: #166534;
816
+ margin-bottom: 8px;
817
+ }
818
+
819
+ /* Testimonial card */
820
+ .testimonial {
821
+ display: flex;
822
+ gap: 16px;
823
+ padding: 24px;
824
+ background: white;
825
+ border-radius: 16px; /* Friendly = larger radius */
826
+ box-shadow: var(--shadow-sm);
827
+ }
828
+
829
+ .testimonial-avatar {
830
+ width: 48px;
831
+ height: 48px;
832
+ border-radius: 50%; /* Real photos > initials */
833
+ }
834
+ ```
835
+
836
+ ---
837
+
838
+ ## 4. Cognitive Load Management
839
+
840
+ ### Three Types of Cognitive Load
841
+
842
+ | Type | Definition | Designer's Role |
843
+ |------|------------|-----------------|
844
+ | **Intrinsic** | Inherent complexity of task | Break into smaller steps |
845
+ | **Extraneous** | Load from poor design | Eliminate this! |
846
+ | **Germane** | Effort for learning | Support and encourage |
847
+
848
+ ### Reduction Strategies
849
+
850
+ **1. Simplify (Reduce Extraneous)**
851
+ ```css
852
+ /* Visual noise β†’ Clean */
853
+ .card-busy {
854
+ border: 2px solid red;
855
+ background: linear-gradient(...);
856
+ box-shadow: 0 0 20px ...;
857
+ /* Too much! */
858
+ }
859
+
860
+ .card-clean {
861
+ background: white;
862
+ border-radius: 16px;
863
+ box-shadow: 0 10px 30px -10px rgba(0,0,0,0.1);
864
+ /* Calm, focused */
865
+ }
866
+ ```
867
+
868
+ **2. Chunk Information**
869
+ ```html
870
+ <!-- Overwhelming -->
871
+ <form>
872
+ <!-- 15 fields at once -->
873
+ </form>
874
+
875
+ <!-- Chunked -->
876
+ <form>
877
+ <fieldset>
878
+ <legend>Step 1: Personal Info</legend>
879
+ <!-- 3-4 fields -->
880
+ </fieldset>
881
+ <fieldset>
882
+ <legend>Step 2: Shipping</legend>
883
+ <!-- 3-4 fields -->
884
+ </fieldset>
885
+ </form>
886
+ ```
887
+
888
+ **3. Progressive Disclosure**
889
+ ```html
890
+ <!-- Hide complexity until needed -->
891
+ <div class="filters">
892
+ <div class="filters-basic">
893
+ <!-- Common filters visible -->
894
+ </div>
895
+ <button onclick="toggleAdvanced()">
896
+ Advanced Options β–Ό
897
+ </button>
898
+ <div class="filters-advanced" hidden>
899
+ <!-- Complex filters hidden -->
900
+ </div>
901
+ </div>
902
+ ```
903
+
904
+ **4. Use Familiar Patterns**
905
+ ```
906
+ βœ… Standard navigation placement
907
+ βœ… Expected icon meanings (πŸ” = search)
908
+ βœ… Conventional form layouts
909
+ βœ… Common gesture patterns (swipe, pinch)
910
+ ```
911
+
912
+ **5. Offload Information**
913
+ ```html
914
+ <!-- Don't make users remember -->
915
+ <label>
916
+ Card Number
917
+ <input type="text" inputmode="numeric"
918
+ autocomplete="cc-number"
919
+ placeholder="1234 5678 9012 3456">
920
+ </label>
921
+
922
+ <!-- Show what they entered -->
923
+ <div class="order-summary">
924
+ <p>Shipping to: <strong>John Doe, 123 Main St...</strong></p>
925
+ <a href="#">Edit</a>
926
+ </div>
927
+ ```
928
+
929
+ ---
930
+
931
+ ## 5. Persuasive Design (Ethical)
932
+
933
+ ### Ethical Persuasion Techniques
934
+
935
+ | Technique | Ethical Use | Dark Pattern (Avoid) |
936
+ |-----------|-------------|----------------------|
937
+ | **Scarcity** | Real stock levels | Fake countdown timers |
938
+ | **Social Proof** | Genuine reviews | Fake testimonials |
939
+ | **Authority** | Real credentials | Misleading badges |
940
+ | **Urgency** | Real deadlines | Manufactured FOMO |
941
+ | **Commitment** | Progress saving | Guilt-tripping |
942
+
943
+ ### Nudge Patterns
944
+
945
+ **Smart Defaults:**
946
+ ```html
947
+ <!-- Pre-select the recommended option -->
948
+ <input type="radio" name="plan" value="monthly">
949
+ <input type="radio" name="plan" value="annual" checked>
950
+ Annual (Save 20%)
951
+ ```
952
+
953
+ **Anchoring:**
954
+ ```html
955
+ <!-- Show original price to frame discount -->
956
+ <div class="price">
957
+ <span class="original">$99</span>
958
+ <span class="current">$79</span>
959
+ <span class="savings">Save 20%</span>
960
+ </div>
961
+ ```
962
+
963
+ **Social Proof:**
964
+ ```html
965
+ <!-- Real-time activity -->
966
+ <div class="activity">
967
+ <span class="avatar">πŸ‘€</span>
968
+ <span>Sarah from NYC just purchased</span>
969
+ </div>
970
+
971
+ <!-- Aggregate proof -->
972
+ <p>Join 50,000+ designers who use our tool</p>
973
+ ```
974
+
975
+ **Progress & Commitment:**
976
+ ```html
977
+ <!-- Show progress to encourage completion -->
978
+ <div class="progress">
979
+ <div class="progress-bar" style="width: 60%"></div>
980
+ <span>60% complete - almost there!</span>
981
+ </div>
982
+ ```
983
+
984
+ ---
985
+
986
+ ## 6. User Persona Quick Reference
987
+
988
+ ### Gen Z (Born 1997-2012)
989
+
990
+ ```
991
+ CHARACTERISTICS:
992
+ - Digital natives, mobile-first
993
+ - Value authenticity, diversity
994
+ - Short attention spans
995
+ - Visual learners
996
+
997
+ DESIGN APPROACH:
998
+ β”œβ”€β”€ Colors: Vibrant, hypercolor, bold gradients
999
+ β”œβ”€β”€ Typography: Large, variable, experimental
1000
+ β”œβ”€β”€ Layout: Vertical scroll, mobile-native
1001
+ β”œβ”€β”€ Interactions: Fast, gamified, gesture-based
1002
+ β”œβ”€β”€ Content: Short-form video, memes, stories
1003
+ └── Trust: Peer reviews > authority
1004
+ ```
1005
+
1006
+ ### Millennials (Born 1981-1996)
1007
+
1008
+ ```
1009
+ CHARACTERISTICS:
1010
+ - Value experiences over things
1011
+ - Research before buying
1012
+ - Socially conscious
1013
+ - Price-sensitive but quality-aware
1014
+
1015
+ DESIGN APPROACH:
1016
+ β”œβ”€β”€ Colors: Muted pastels, earth tones
1017
+ β”œβ”€β”€ Typography: Clean, readable sans-serif
1018
+ β”œβ”€β”€ Layout: Responsive, card-based
1019
+ β”œβ”€β”€ Interactions: Smooth, purposeful animations
1020
+ β”œβ”€β”€ Content: Value-driven, transparent
1021
+ └── Trust: Reviews, sustainability, values
1022
+ ```
1023
+
1024
+ ### Gen X (Born 1965-1980)
1025
+
1026
+ ```
1027
+ CHARACTERISTICS:
1028
+ - Independent, self-reliant
1029
+ - Value efficiency
1030
+ - Skeptical of marketing
1031
+ - Balanced tech comfort
1032
+
1033
+ DESIGN APPROACH:
1034
+ β”œβ”€β”€ Colors: Professional, trustworthy
1035
+ β”œβ”€β”€ Typography: Familiar, conservative
1036
+ β”œβ”€β”€ Layout: Clear hierarchy, traditional
1037
+ β”œβ”€β”€ Interactions: Functional, not flashy
1038
+ β”œβ”€β”€ Content: Direct, fact-based
1039
+ └── Trust: Expertise, track record
1040
+ ```
1041
+
1042
+ ### Baby Boomers (Born 1946-1964)
1043
+
1044
+ ```
1045
+ CHARACTERISTICS:
1046
+ - Detail-oriented
1047
+ - Loyal when trusted
1048
+ - Value personal service
1049
+ - Less tech-confident
1050
+
1051
+ DESIGN APPROACH:
1052
+ β”œβ”€β”€ Colors: High contrast, simple palette
1053
+ β”œβ”€β”€ Typography: Large (18px+), high contrast
1054
+ β”œβ”€β”€ Layout: Simple, linear, spacious
1055
+ β”œβ”€β”€ Interactions: Minimal, clear feedback
1056
+ β”œβ”€β”€ Content: Comprehensive, detailed
1057
+ └── Trust: Phone numbers, real people
1058
+ ```
1059
+
1060
+ ---
1061
+
1062
+ ## 7. Emotion Color Mapping
1063
+
1064
+ ```
1065
+ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
1066
+ β”‚ EMOTION β”‚ COLORS β”‚ USE β”‚
1067
+ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
1068
+ β”‚ Trust β”‚ Blue, Green β”‚ Finance β”‚
1069
+ β”‚ Excitement β”‚ Red, Orange β”‚ Sales β”‚
1070
+ β”‚ Calm β”‚ Blue, Soft green β”‚ Wellness β”‚
1071
+ β”‚ Luxury β”‚ Black, Gold β”‚ Premium β”‚
1072
+ β”‚ Creativity β”‚ Teal, Pink β”‚ Art β”‚
1073
+ β”‚ Energy β”‚ Yellow, Orange β”‚ Sports β”‚
1074
+ β”‚ Nature β”‚ Green, Brown β”‚ Eco β”‚
1075
+ β”‚ Happiness β”‚ Yellow, Orange β”‚ Kids β”‚
1076
+ β”‚ Sophistication β”‚ Gray, Navy β”‚ Corporate β”‚
1077
+ β”‚ Urgency β”‚ Red β”‚ Errors β”‚
1078
+ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
1079
+ ```
1080
+
1081
+ ---
1082
+
1083
+ ## 8. Psychology Checklist
1084
+
1085
+ ### Before Launch
1086
+
1087
+ - [ ] **Hick's Law:** No more than 7 choices in navigation. Have choices been narrowed to reduce decision fatigue?
1088
+ - [ ] **Fitts' Law:** Primary CTAs are large and reachable. Are the most important buttons easy to hit on mobile?
1089
+ - [ ] **Miller's Law:** Content is chunked appropriately. Is information grouped into digestible units of 5-7?
1090
+ - [ ] **Jakob's Law:** Does the site follow standard web conventions that users already understand?
1091
+ - [ ] **Doherty Threshold:** Does the system provide feedback within 400ms? Are skeleton screens in place?
1092
+ - [ ] **Tesler's Law:** Has complexity been moved from the user to the system where possible?
1093
+ - [ ] **Parkinson’s Law:** Are there features like "One-Click Checkout" to minimize task completion time?
1094
+ - [ ] **Von Restorff:** Does the primary CTA visually stand out from all other elements?
1095
+ - [ ] **Serial Position:** Is the most critical information at the very beginning or end of lists?
1096
+ - [ ] **Gestalt Laws:** Are related items physically grouped together (Proximity) or within a Card (Common Region)?
1097
+ - [ ] **Zeigarnik Effect:** Are there visual indicators (like progress bars) for incomplete tasks?
1098
+ - [ ] **Goal Gradient:** Is the user given a "head start" (e.g., 20% progress) to encourage completion?
1099
+ - [ ] **Peak-End Rule:** Does the final "Success" screen create a moment of delight?
1100
+ - [ ] **Occam’s Razor:** Have unnecessary visual or functional elements been removed?
1101
+ - [ ] **Aesthetic-Usability:** Is the UI high-fidelity enough to build initial user trust?
1102
+ - [ ] **Trust & Authority:** Are security badges, reviews, and expert certifications visible?
1103
+ - [ ] **Social Proof:** Are real user numbers or testimonials visible at decision points?
1104
+ - [ ] **Scarcity & Urgency:** If used, is the scarcity real and ethical (e.g., actual low stock)?
1105
+ - [ ] **Loss Aversion:** Does the copy emphasize what the user stands to keep rather than just gain?
1106
+ - [ ] **Anchoring:** Is the pricing presented in a way that frames the desired choice as a great value?
1107
+ - [ ] **Postel’s Law:** Is the system flexible enough to accept various input formats without errors?
1108
+ - [ ] **False-Consensus:** Has the design been tested with real users rather than just the internal team?
1109
+ - [ ] **Curse of Knowledge:** Is the copy free of technical jargon and easy for a beginner to understand?
1110
+ - [ ] **Stepping Stone:** Does the funnel start with low-friction tasks (e.g., email only)?
1111
+ - [ ] **Cognitive Load:** Is extraneous visual noise minimized to keep the interface clean?
1112
+ - [ ] **Emotional Design:** Does the color palette and imagery evoke the intended visceral reaction?
1113
+ - [ ] **Feedback:** Do all interactive elements have immediate hover, active, and success states?
1114
+ - [ ] **Accessibility:** Is the contrast ratio sufficient, and is the site navigable via keyboard/screen reader?
1115
+ - [ ] **PrΓ€gnanz:** Are icons and shapes simple enough to be recognized at a glance?
1116
+ - [ ] **Figure/Ground:** Is it clear which element is in focus (e.g., using shadows or scrims for modals)?