sinapse-ai 9.4.0 → 9.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (266) hide show
  1. package/.claude/CLAUDE.md +10 -4
  2. package/.claude/hooks/enforce-architecture-first.py +197 -197
  3. package/.claude/hooks/enforce-git-push-authority.sh +25 -4
  4. package/.claude/hooks/mind-clone-governance.py +193 -193
  5. package/.claude/hooks/read-protection.py +152 -152
  6. package/.claude/hooks/sql-governance.py +183 -183
  7. package/.claude/hooks/verify-packages.cjs +83 -0
  8. package/.claude/hooks/write-path-validation.py +195 -195
  9. package/.claude/rules/hook-governance.md +1 -0
  10. package/.claude/rules/mandatory-delegation.md +24 -0
  11. package/.claude/rules/project-intelligence.md +63 -0
  12. package/.claude/rules/response-format.md +4 -0
  13. package/.claude/rules/safe-collaboration.md +4 -2
  14. package/.claude/rules/security-data-protection.md +18 -0
  15. package/.claude/rules/squad-awareness.md +93 -67
  16. package/.claude/rules/token-economy.md +148 -0
  17. package/.codex/agents/analyst.md +90 -0
  18. package/.codex/agents/architect.md +78 -0
  19. package/.codex/agents/data-engineer.md +38 -0
  20. package/.codex/agents/developer.md +97 -0
  21. package/.codex/agents/devops.md +121 -0
  22. package/.codex/agents/product-lead.md +27 -0
  23. package/.codex/agents/project-lead.md +28 -0
  24. package/.codex/agents/quality-gate.md +89 -0
  25. package/.codex/agents/sprint-lead.md +28 -0
  26. package/.codex/agents/squad-creator.md +58 -0
  27. package/.codex/agents/ux-design-expert.md +28 -0
  28. package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
  29. package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
  30. package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
  31. package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
  32. package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
  33. package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
  34. package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
  35. package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
  36. package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
  37. package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
  38. package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
  39. package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
  40. package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
  41. package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
  42. package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
  43. package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
  44. package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
  45. package/.sinapse-ai/core/doctor/index.js +157 -50
  46. package/.sinapse-ai/core/ids/registry-updater.js +6 -1
  47. package/.sinapse-ai/core/logger/index.js +319 -0
  48. package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
  49. package/.sinapse-ai/core/telemetry/index.js +247 -0
  50. package/.sinapse-ai/data/entity-registry.yaml +1384 -944
  51. package/.sinapse-ai/development/agents/architect.md +5 -0
  52. package/.sinapse-ai/development/agents/data-engineer.md +38 -0
  53. package/.sinapse-ai/development/agents/developer.md +28 -0
  54. package/.sinapse-ai/development/agents/devops.md +4 -0
  55. package/.sinapse-ai/development/agents/product-lead.md +27 -0
  56. package/.sinapse-ai/development/agents/project-lead.md +28 -0
  57. package/.sinapse-ai/development/agents/quality-gate.md +4 -0
  58. package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
  59. package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
  60. package/.sinapse-ai/development/agents/squad-creator.md +58 -0
  61. package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
  62. package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
  63. package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
  64. package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
  65. package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
  66. package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
  67. package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
  68. package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
  69. package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
  70. package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
  71. package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
  72. package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
  73. package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
  74. package/.sinapse-ai/development/skills/model-router.md +92 -0
  75. package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
  76. package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
  77. package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
  78. package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
  79. package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
  80. package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
  81. package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
  82. package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
  83. package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
  84. package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
  85. package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
  86. package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
  87. package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
  88. package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
  89. package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
  90. package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
  91. package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
  92. package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
  93. package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
  94. package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
  95. package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
  96. package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
  97. package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
  98. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
  99. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
  100. package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
  101. package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
  102. package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
  103. package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
  104. package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
  105. package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
  106. package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
  107. package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
  108. package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
  109. package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
  110. package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
  111. package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
  112. package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
  113. package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
  114. package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
  115. package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
  116. package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
  117. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
  118. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
  119. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
  120. package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
  121. package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
  122. package/.sinapse-ai/install-manifest.yaml +275 -140
  123. package/.sinapse-ai/local-config.yaml.template +65 -65
  124. package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
  125. package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
  126. package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
  127. package/.sinapse-ai/monitor/hooks/notification.py +30 -30
  128. package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
  129. package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
  130. package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
  131. package/.sinapse-ai/monitor/hooks/stop.py +30 -30
  132. package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
  133. package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
  134. package/.sinapse-ai/product/templates/adr.hbs +126 -126
  135. package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
  136. package/.sinapse-ai/product/templates/epic.hbs +213 -213
  137. package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
  138. package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
  139. package/.sinapse-ai/product/templates/prd.hbs +202 -202
  140. package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
  141. package/.sinapse-ai/product/templates/story.hbs +264 -264
  142. package/.sinapse-ai/product/templates/task.hbs +171 -171
  143. package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
  144. package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
  145. package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
  146. package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
  147. package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
  148. package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
  149. package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
  150. package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
  151. package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
  152. package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
  153. package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
  154. package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
  155. package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
  156. package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
  157. package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
  158. package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
  159. package/LICENSE +34 -34
  160. package/README.en.md +167 -20
  161. package/README.md +190 -22
  162. package/bin/cli.js +510 -196
  163. package/bin/postinstall.js +564 -0
  164. package/bin/sinapse-cli +283 -283
  165. package/bin/sinapse-graph.js +9 -0
  166. package/bin/sinapse-init.js +36 -4
  167. package/bin/sinapse-minimal.js +20 -9
  168. package/bin/sinapse.js +202 -122
  169. package/bin/utils/deprecation-warning.js +46 -0
  170. package/bin/utils/pre-push-safety.js +14 -0
  171. package/docs/TELEMETRY.md +131 -0
  172. package/docs/chrome-brain-upgrade-plan.md +624 -0
  173. package/docs/framework/orqx-plan.md +1 -1
  174. package/docs/installation/chrome-brain.md +17 -7
  175. package/docs/mega-upgrade-orchestration-plan.md +71 -0
  176. package/docs/pt/contributing.md +20 -0
  177. package/docs/research-synthesis-for-upgrade.md +511 -0
  178. package/docs/security-audit-report.md +306 -0
  179. package/package.json +20 -8
  180. package/packages/installer/src/config/configure-environment.js +19 -44
  181. package/packages/installer/src/detection/detect-project-type.js +181 -63
  182. package/packages/installer/src/installer/manifest-signature.js +32 -17
  183. package/packages/installer/src/wizard/i18n.js +12 -0
  184. package/packages/installer/src/wizard/ide-config-generator.js +8 -39
  185. package/packages/installer/src/wizard/index.js +119 -14
  186. package/packages/installer/src/wizard/questions.js +2 -3
  187. package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
  188. package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
  189. package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
  190. package/packages/sinapse-install/bin/edmcp.js +0 -0
  191. package/packages/sinapse-install/bin/sinapse-install.js +0 -0
  192. package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
  193. package/scripts/check-markdown-links.py +353 -353
  194. package/scripts/coverage-report-summary.js +169 -0
  195. package/scripts/generate-install-manifest.js +6 -2
  196. package/scripts/release-readiness.js +169 -0
  197. package/scripts/test-install-matrix-local.sh +153 -0
  198. package/scripts/validate-install-docs.js +394 -0
  199. package/scripts/validate-no-external-refs.js +376 -0
  200. package/scripts/validate-squad-orqx.js +302 -0
  201. package/scripts/validate-story-meta.js +263 -0
  202. package/squads/claude-code-mastery/CHANGELOG.md +1 -1
  203. package/squads/claude-code-mastery/README.md +2 -2
  204. package/squads/claude-code-mastery/squad.yaml +1 -1
  205. package/squads/squad-artdir/README.md +90 -0
  206. package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
  207. package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
  208. package/squads/squad-artdir/agents/color-psychologist.md +166 -0
  209. package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
  210. package/squads/squad-artdir/agents/design-system-architect.md +100 -0
  211. package/squads/squad-artdir/agents/ia-architect.md +169 -0
  212. package/squads/squad-artdir/agents/interaction-designer.md +162 -0
  213. package/squads/squad-artdir/agents/layout-engineer.md +163 -0
  214. package/squads/squad-artdir/agents/motion-architect.md +185 -0
  215. package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
  216. package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
  217. package/squads/squad-artdir/agents/product-surface-director.md +86 -0
  218. package/squads/squad-artdir/agents/type-systemist.md +138 -0
  219. package/squads/squad-artdir/agents/visual-strategist.md +127 -0
  220. package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
  221. package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
  222. package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
  223. package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
  224. package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
  225. package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
  226. package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
  227. package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
  228. package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
  229. package/squads/squad-artdir/package.json +20 -0
  230. package/squads/squad-artdir/squad.yaml +271 -0
  231. package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
  232. package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
  233. package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
  234. package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
  235. package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
  236. package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
  237. package/squads/squad-artdir/tasks/design-color-system.md +81 -0
  238. package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
  239. package/squads/squad-artdir/tasks/design-token-system.md +58 -0
  240. package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
  241. package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
  242. package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
  243. package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
  244. package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
  245. package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
  246. package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
  247. package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
  248. package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
  249. package/squads/squad-brand/squad.yaml +20 -6
  250. package/squads/squad-claude/knowledge-base/context-window-optimization.md +1 -1
  251. package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +2 -2
  252. package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
  253. package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
  254. package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
  255. package/squads/squad-content/squad.yaml +187 -27
  256. package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
  257. package/squads/squad-copy/squad.yaml +19 -4
  258. package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
  259. package/squads/squad-design/squad.yaml +19 -4
  260. package/.sinapse-ai/core/registry/service-registry.json +0 -6346
  261. package/.sinapse-ai/data/registry-update-log.jsonl +0 -1323
  262. package/.sinapse-ai/manifests/agents.csv +0 -29
  263. package/.sinapse-ai/manifests/tasks.csv +0 -204
  264. package/.sinapse-ai/manifests/workers.csv +0 -196
  265. package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
  266. package/squads/squad-paidmedia/tasks/calculate-sample-size.md +0 -57
@@ -0,0 +1,133 @@
1
+ # Premium Packaging Principles — The 5 Non-Negotiables
2
+
3
+ > Output of a 30-minute strategic pressurization session by @council-orqx (Zenith). Question: **"What is the visual/experiential DNA of a SaaS that can charge 3x more than its direct competitor?"**
4
+ >
5
+ > Every principle is traceable to a named mental model or decision framework. No invention. These are the non-negotiables that Aura (premium-packaging-strategist) applies to every briefing.
6
+
7
+ **Session date:** 2026-04-12
8
+ **Facilitator:** @council-orqx (Zenith)
9
+ **Mental models consulted:** Veblen goods, Signaling theory (Spence), Cognitive restraint (System 1/2 — Kahneman), Trust hierarchies (Ariely), Galbraith's affluence paradox, Porter's differentiation positioning, Bourdieu's distinction
10
+
11
+ ---
12
+
13
+ ## The 5 Non-Negotiable Principles
14
+
15
+ ### Principle 1 — Restraint reads as confidence
16
+
17
+ **Mental model:** Signaling theory (Spence, 1973). A signal is costly to fake. Restraint in design is costly because it requires conviction — it signals "we know exactly what matters and what does not."
18
+
19
+ **Application:**
20
+ - Max 1 accent color across the entire product
21
+ - Max 3 type weights in any surface
22
+ - Max 3 CTAs per viewport
23
+ - Empty space is not wasted real estate — it is a confidence signal
24
+ - Avoid feature dumps, testimonial walls, mascot clutter
25
+
26
+ **Anti-pattern:** The "everything everywhere all at once" landing page. Every section screams. The user subconsciously concludes: "this is insecure pricing."
27
+
28
+ **Aura's enforcement:** If a briefing requests more than one accent color, escalate. If a pricing page has more than 4 tiers, escalate.
29
+
30
+ ---
31
+
32
+ ### Principle 2 — Custom craft = unfakeable signal
33
+
34
+ **Mental model:** Veblen goods + Bourdieu's distinction. Premium status requires conspicuous consumption of something the commodity alternative cannot access.
35
+
36
+ **Application:**
37
+ - At least ONE element must be custom-made and visibly so:
38
+ - Custom typography (Stripe's Sohne, Vercel's Geist)
39
+ - Custom iconography (single-weight, consistent, proprietary)
40
+ - Custom motion signature (a unique easing curve or hero animation)
41
+ - Custom illustration language (only if it is genuinely proprietary)
42
+ - "Stock" anything is forbidden at the premium tier: stock photos, stock icons, stock fonts that every competitor also uses
43
+
44
+ **Anti-pattern:** Using Inter + Feather icons + a Figma community template. Instantly reads as commodity — even if the product is excellent.
45
+
46
+ **Aura's enforcement:** Every premium brief must identify the 1-2 custom craft elements that will be built. If the budget does not allow custom type, prescribe custom iconography as the minimum viable premium signal.
47
+
48
+ ---
49
+
50
+ ### Principle 3 — Friction at the right moment creates value
51
+
52
+ **Mental model:** Ariely on the ownership effect + the IKEA effect. Effort expended creates perceived value. Strategic friction makes the purchase feel earned.
53
+
54
+ **Application:**
55
+ - "Contact sales" as a tier for Enterprise — deliberate friction signaling premium
56
+ - Invitation-only onboarding for early access
57
+ - Waitlists as design exhibits (Arc, Superhuman)
58
+ - Manual decision moments in onboarding instead of auto-everything (the user chooses = the user commits)
59
+ - Pricing pages that require reading, not just scanning
60
+
61
+ **Anti-pattern:** Frictionless commoditization. Free trial with one-click signup, frictionless checkout, zero commitment required. Optimizes for conversion volume, kills perceived value.
62
+
63
+ **Aura's enforcement:** Every premium brief must identify AT LEAST ONE strategic friction point in the funnel. If there is none, the product is priced as commodity regardless of the actual price tag.
64
+
65
+ ---
66
+
67
+ ### Principle 4 — Presentation determines perceived value more than intrinsic quality
68
+
69
+ **Mental model:** Framing effect (Kahneman/Tversky) + Veblen goods + Superhuman's $30/month email pricing case study.
70
+
71
+ **Application:**
72
+ - Premium unboxing in digital form = a choreographed first-run experience
73
+ - The first 5 minutes must feel like an Apple product intro, not a feature walkthrough
74
+ - Onboarding has a "ceremony" phase (see Arc, Superhuman onboarding) — intentional theater that communicates: "you are entering something serious"
75
+ - Pricing pages must be exhibits. Comparison tables come AFTER the emotional pitch, never before
76
+ - Empty states are second impressions — treat them like mini-LPs
77
+
78
+ **Anti-pattern:** "Skip tutorial" button in the first 10 seconds. Commodity move. You are saying: our onboarding is a cost to minimize, not an experience to savor.
79
+
80
+ **Aura's enforcement:** Every premium brief must have a documented "First 5 Minutes Choreography" section. Unscripted first-run = commodity experience.
81
+
82
+ ---
83
+
84
+ ### Principle 5 — Consistency across surfaces is the strongest price defense
85
+
86
+ **Mental model:** Cognitive consistency theory (Festinger) + Trust hierarchies (if any single surface degrades, all surfaces lose credibility).
87
+
88
+ **Application:**
89
+ - The design tokens flowing from brand -> marketing site -> product -> email -> docs -> invoices must be RIGOROUSLY identical
90
+ - One weak surface (an ugly invoice PDF, a Mailchimp-default transactional email, a docs site that looks like GitBook) destroys premium perception for the entire product
91
+ - Atlas (design-system-architect) OWNS this — the multi-surface token architecture is the enforcement mechanism
92
+ - Versioning of the design system is non-negotiable: breaking changes must ship with migration guides
93
+
94
+ **Anti-pattern:** Beautiful product + Mailchimp-default emails + Zendesk-branded help center + Stripe Checkout that does not match the brand. Each inconsistency is a small tax on perceived value. Stack enough taxes and no amount of product quality justifies the price tag.
95
+
96
+ **Aura's enforcement:** Every premium brief must include a full surface inventory (marketing, product, email, docs, support, billing, mobile) with a consistency audit. If ANY surface is missing from the audit, the brief is incomplete.
97
+
98
+ ---
99
+
100
+ ## Cross-Principle Summary
101
+
102
+ | # | Principle | Mental Model Anchor | Primary Enforcer Agent |
103
+ |---|-----------|---------------------|-----------------------|
104
+ | 1 | Restraint reads as confidence | Signaling theory | Aura + Canvas |
105
+ | 2 | Custom craft = unfakeable signal | Veblen + Bourdieu | Aura + Kern (type) or Spectrum (color) |
106
+ | 3 | Friction at the right moment creates value | Ariely / IKEA effect | Aura + Convert (CRO) |
107
+ | 4 | Presentation > intrinsic quality | Framing + Kahneman | Aura + Axiom (product surface) |
108
+ | 5 | Consistency across surfaces | Cognitive consistency | Aura + Atlas (design system) |
109
+
110
+ ## Diagnostic Questions (Aura asks on every briefing)
111
+
112
+ 1. What is the ONE custom craft element this product will own? (typography, icons, motion, illustration)
113
+ 2. Where is the strategic friction in the funnel that creates earned-value feeling?
114
+ 3. What is the choreography of the first 5 minutes after signup?
115
+ 4. Is there a documented multi-surface token system? If not, how do we prevent surface drift?
116
+ 5. If I audit the invoice PDF and the transactional emails, do they match the marketing site quality?
117
+
118
+ **If any answer is "no" or "we do not know," the product is pricing itself as commodity regardless of the sticker price.**
119
+
120
+ ## How to USE this KB
121
+
122
+ - **Aura (premium-packaging-strategist)** consults this KB on every new brief, produces a Premium Packaging Brief using the 5 diagnostic questions
123
+ - **Canvas (artdir-orqx)** validates against these principles before approving any deliverable for platforms claiming premium positioning
124
+ - **Atlas (design-system-architect)** uses Principle 5 as the justification for multi-surface versioning work
125
+ - **Axiom (product-surface-director)** uses Principle 4 for onboarding choreography
126
+
127
+ ## Provenance
128
+
129
+ Output of @council-orqx (Zenith) strategic pressurization session, 2026-04-12. All principles cite public mental models. Case studies cite publicly-analyzed products (Linear, Vercel, Stripe, Framer, Arc, Raycast, Superhuman).
130
+
131
+ ---
132
+
133
+ *@council-orqx (Zenith) | squad-artdir v2.0 | KB v1.0*
@@ -0,0 +1,229 @@
1
+ # Psychological Toolkit for Art Direction
2
+
3
+ > Arsenal completo de principios psicologicos aplicados a design de conversao.
4
+ > Cada entrada inclui principio, mecanismo, aplicacao em web design e quando usar.
5
+
6
+ ---
7
+
8
+ ## Parte 1: 10 Cognitive Biases for Conversion
9
+
10
+ ### 1. Loss Aversion (Kahneman & Tversky)
11
+
12
+ - **Principio:** Perdas pesam ~2x mais que ganhos equivalentes
13
+ - **Mecanismo:** Amigdala processa perdas mais intensamente que cortex pre-frontal processa ganhos
14
+ - **Aplicacao web:**
15
+ - "Voce esta perdendo R$X/mes sem automacao" (frame como perda)
16
+ - "Sua oferta expira em 48h" (medo de perder)
17
+ - "Cancele quando quiser — sem multa" (remove medo de perda)
18
+ - **Quando usar:** CTAs de urgencia, pricing comparisons, risk reversal copy
19
+ - **Cuidado:** Nao exagerar — excesso de fear mongering gera rejeicao
20
+
21
+ ### 2. Anchoring Effect (Tversky & Kahneman)
22
+
23
+ - **Principio:** Primeiro numero apresentado serve como ancora para todos os julgamentos seguintes
24
+ - **Mecanismo:** Cortex pre-frontal usa primeiro dado como referencia automatica
25
+ - **Aplicacao web:**
26
+ - Mostrar preco "de" antes do preco "por": ~~R$497~~ R$197
27
+ - Apresentar tier mais caro primeiro na comparison table
28
+ - Usar metricas grandes antes de pedir compromisso: "327% mais rapido"
29
+ - **Quando usar:** Pricing pages, comparison tables, hero metrics
30
+ - **Cuidado:** Ancora deve ser crivel — se muito distante da realidade, perde efeito
31
+
32
+ ### 3. Endowment Effect (Thaler)
33
+
34
+ - **Principio:** Pessoas valorizam mais o que ja possuem (ou sentem que possuem)
35
+ - **Mecanismo:** Posse psicologica aumenta valor percebido
36
+ - **Aplicacao web:**
37
+ - Free trial: usuario sente que "ja tem" e nao quer perder
38
+ - "Seu dashboard esta pronto" (antes de assinar)
39
+ - Wizard de onboarding que configura antes de pagar
40
+ - "Sua conta foi criada com sucesso" — agora pague para manter
41
+ - **Quando usar:** Free trials, freemium, onboarding flows
42
+ - **Cuidado:** Se o trial for ruim, endowment nao salva
43
+
44
+ ### 4. Social Proof (Cialdini)
45
+
46
+ - **Principio:** Pessoas usam o comportamento dos outros como guia para o proprio
47
+ - **Mecanismo:** Mirror neurons + conformity bias — copiar e seguro evolutivamente
48
+ - **Aplicacao web:**
49
+ - Logos de clientes: "Usado por Google, Meta, Stripe"
50
+ - Live counters: "1,247 usuarios ativos agora"
51
+ - Testimonials com foto + cargo + resultado especifico
52
+ - Star ratings: "4.9/5 — 2,847 reviews"
53
+ - Activity feed: "Maria acabou de assinar o plano Pro"
54
+ - **Quando usar:** SEMPRE. Social proof e o padrao com maior impacto universal
55
+ - **Cuidado:** Deve ser real e verificavel. Fake social proof destroi confianca
56
+
57
+ ### 5. Scarcity Principle (Cialdini)
58
+
59
+ - **Principio:** Coisas escassas sao percebidas como mais valiosas
60
+ - **Mecanismo:** Medo de perda oportunidade (relacionado a loss aversion)
61
+ - **Aplicacao web:**
62
+ - "7 de 20 vagas restantes" (quantity scarcity)
63
+ - Countdown timer com deadline real (time scarcity)
64
+ - "Preco sobe em 3 dias" (temporal scarcity)
65
+ - Badge "Limited Edition" (exclusivity)
66
+ - **Quando usar:** APENAS quando a escassez e REAL. Fake scarcity e dark pattern
67
+ - **Cuidado:** Scarcity falsa e detectada rapidamente e destroi toda a confianca
68
+
69
+ ### 6. Authority Principle (Cialdini)
70
+
71
+ - **Principio:** Pessoas confiam mais em fontes percebidas como autoridades
72
+ - **Mecanismo:** Heuristico de eficiencia cognitiva — confiar no expert poupa energia
73
+ - **Aplicacao web:**
74
+ - Certificacoes e badges (SOC2, ISO, LGPD compliance)
75
+ - "Featured in TechCrunch, Forbes, Exame"
76
+ - Expert testimonials com credenciais visiveis
77
+ - Data-driven claims com fontes citadas
78
+ - "Fundada por ex-Google, ex-Meta"
79
+ - **Quando usar:** Trust sections, about page, pricing, security claims
80
+ - **Cuidado:** Authority sem relevancia nao funciona — "recomendado por dentista" nao ajuda SaaS
81
+
82
+ ### 7. Reciprocity (Cialdini)
83
+
84
+ - **Principio:** Pessoas retribuem favores — mesmo nao solicitados
85
+ - **Mecanismo:** Obrigacao social de reciprocar
86
+ - **Aplicacao web:**
87
+ - Dar valor antes de pedir (free content, tools, templates)
88
+ - "Guia gratuito: 10 estrategias de X" antes do paywall
89
+ - Free tier generoso que demonstra valor
90
+ - Conteudo educativo no blog antes de vender
91
+ - **Quando usar:** Content marketing, lead magnets, freemium
92
+ - **Cuidado:** O "presente" deve ter valor real, nao ser apenas bait
93
+
94
+ ### 8. Commitment & Consistency (Cialdini)
95
+
96
+ - **Principio:** Pessoas agem de forma consistente com compromissos anteriores
97
+ - **Mecanismo:** Dissonancia cognitiva — inconsistencia causa desconforto
98
+ - **Aplicacao web:**
99
+ - Multi-step forms: cada step e um micro-compromisso
100
+ - "Voce concorda que X e importante?" → "Entao voce precisa de Y"
101
+ - Progress bars: "Passo 3 de 5 — quase la"
102
+ - Free trial que pede cartao = compromisso maior, churn menor
103
+ - **Quando usar:** Forms, onboarding, upgrade flows
104
+ - **Cuidado:** Escalation natural — nao pular de "email" para "cartao de credito"
105
+
106
+ ### 9. Framing Effect (Tversky & Kahneman)
107
+
108
+ - **Principio:** A forma de apresentar informacao muda a decisao, mesmo com dados identicos
109
+ - **Mecanismo:** Cortex pre-frontal avalia contexto, nao apenas conteudo
110
+ - **Aplicacao web:**
111
+ - "Economize R$2.400/ano" vs "R$200/mes" (annual framing)
112
+ - "99.97% uptime" vs "Down 2.6 horas/ano" (positive framing)
113
+ - Comparison table que enquadra features favorecendo voce
114
+ - "De R$497 por R$197" vs "R$197" (anchor + deal framing)
115
+ - **Quando usar:** Pricing, comparison tables, hero metrics, testimonials
116
+ - **Cuidado:** Framing nao e mentir — e apresentar a mesma verdade de forma favoravel
117
+
118
+ ### 10. Decoy Effect (Ariely)
119
+
120
+ - **Principio:** Adicionar uma opcao inferior faz a opcao-alvo parecer melhor
121
+ - **Mecanismo:** Comparacao relativa — a mente precisa de contexto para decidir
122
+ - **Aplicacao web:**
123
+ - 3 pricing tiers: Basic, Pro (target), Enterprise
124
+ - Basic e limitado demais, Enterprise e caro demais → Pro e "a escolha inteligente"
125
+ - O tier "decoy" existe para fazer o target parecer value for money
126
+ - **Quando usar:** Pricing pages, plan comparison, subscription tiers
127
+ - **Cuidado:** O decoy deve ser crivel — opcao obviamente ruim e transparente
128
+
129
+ ---
130
+
131
+ ## Parte 2: 6 Retention Principles
132
+
133
+ ### 1. Zeigarnik Effect
134
+
135
+ - **Principio:** Tarefas incompletas sao lembradas melhor que as completas
136
+ - **Aplicacao:** Progress bars, headlines com lacuna, reveals parciais, counters que animam
137
+ - **Exemplo:** "O que 97% dos founders nao sabem sobre..." → scroll para descobrir
138
+
139
+ ### 2. Goal Gradient Effect
140
+
141
+ - **Principio:** Esforco aumenta conforme proximidade do objetivo
142
+ - **Aplicacao:** Progress indicators, "quase la", sunk cost visual
143
+ - **Exemplo:** "Passo 4 de 5 — voce esta quase la!" → usuario persiste
144
+
145
+ ### 3. Peak-End Rule (Kahneman)
146
+
147
+ - **Principio:** Experiencia e julgada pelo pico emocional e pelo final
148
+ - **Aplicacao:** Momento memoravel mid-page + footer com valor real
149
+ - **Exemplo:** Demo interativa (pico) + footer com human touch (final)
150
+
151
+ ### 4. Serial Position Effect
152
+
153
+ - **Principio:** Primeiro e ultimo items de uma lista sao mais lembrados
154
+ - **Aplicacao:** Colocar beneficio principal primeiro e CTA por ultimo
155
+ - **Exemplo:** Feature #1 e a mais forte, ultima secao e o CTA final
156
+
157
+ ### 5. Cognitive Fluency
158
+
159
+ - **Principio:** Informacao facil de processar e percebida como mais verdadeira
160
+ - **Aplicacao:** Linguagem simples, tipografia clara, layout previsivel
161
+ - **Exemplo:** Sans-serif, high contrast, short paragraphs → percepacao de confianca
162
+
163
+ ### 6. Mere Exposure Effect (Zajonc)
164
+
165
+ - **Principio:** Familiaridade gera preferencia
166
+ - **Aplicacao:** Repetir mensagem-chave em diferentes formatos ao longo da pagina
167
+ - **Exemplo:** Proposta de valor no hero, nos features, no CTA, no footer
168
+
169
+ ---
170
+
171
+ ## Parte 3: 6 UX Cognitive Laws
172
+
173
+ ### 1. Hick's Law
174
+ - **Formula:** RT = a + b * log2(n)
175
+ - **Traducao:** Cada opcao adicional aumenta tempo de decisao
176
+ - **Regra:** Max 3 opcoes de CTA, max 5 nav items, max 3 pricing tiers
177
+
178
+ ### 2. Fitts's Law
179
+ - **Formula:** MT = a + b * log2(D/W + 1)
180
+ - **Traducao:** Alvos maiores e mais proximos sao alcancados mais rapido
181
+ - **Regra:** CTAs min 44x44px, proximos ao conteudo convincente, area clicavel generosa
182
+
183
+ ### 3. Miller's Law (7 +/- 2)
184
+ - **Principio:** Working memory processa ~7 chunks de informacao
185
+ - **Regra:** Max 7 features por showcase, max 5-7 nav items, chunk info em grupos
186
+
187
+ ### 4. Jakob's Law
188
+ - **Principio:** Usuarios esperam que seu site funcione como os que ja conhecem
189
+ - **Regra:** Seguir convencoes da categoria (nav no topo, logo top-left, CTA top-right)
190
+
191
+ ### 5. Tesler's Law (Conservation of Complexity)
192
+ - **Principio:** Toda aplicacao tem complexidade irredutivel — alguem deve absorve-la
193
+ - **Regra:** O sistema absorve complexidade, nao o usuario. Smart defaults, auto-detection
194
+
195
+ ### 6. Postel's Law (Robustness Principle)
196
+ - **Principio:** Seja conservador no que envia, liberal no que aceita
197
+ - **Regra:** Aceitar formatos variados de input (telefone com/sem mascara, email case-insensitive)
198
+
199
+ ---
200
+
201
+ ## Parte 4: 7 Gestalt Principles for Visual Design
202
+
203
+ ### 1. Proximity
204
+ Elementos proximos sao percebidos como grupo.
205
+ → Icon + label juntos = feature unit
206
+
207
+ ### 2. Similarity
208
+ Elementos com mesma aparencia sao percebidos como mesma categoria.
209
+ → Cards com mesmo estilo = comparaveis
210
+
211
+ ### 3. Closure
212
+ A mente completa formas incompletas.
213
+ → Progress bars, loading circles, partially visible elements
214
+
215
+ ### 4. Continuity
216
+ O olho segue linhas e curvas naturalmente.
217
+ → Scroll flow, connecting lines between sections
218
+
219
+ ### 5. Figure/Ground
220
+ Separacao entre conteudo principal e fundo.
221
+ → Cards elevados, modals sobre overlay escuro
222
+
223
+ ### 6. Common Region
224
+ Elementos dentro da mesma area visual sao percebidos como grupo.
225
+ → Sections com backgrounds alternados
226
+
227
+ ### 7. Focal Point
228
+ O elemento com maior contraste visual atrai primeiro.
229
+ → CTA em accent color em pagina neutral = focal point
@@ -0,0 +1,242 @@
1
+ # SaaS Art Direction Canon — 6 Premium References
2
+
3
+ > Canonical benchmark of 6 premium SaaS aesthetic references. Extracted by @analyst (Scope) for squad-artdir v2.0. Every claim in this KB must be traceable to a public surface of the reference product or its published design system docs. No invention — if we cannot cite it, we do not claim it.
4
+
5
+ **Purpose:** Prevent commodity aesthetics. Provide canonical reference DNA that Vertex (platform-aesthetic-director) applies on every new platform briefing.
6
+
7
+ **Re-benchmark cadence:** Quarterly. Aesthetic drift is real — Linear looked different in 2022.
8
+
9
+ ---
10
+
11
+ ## Analysis Framework — 5 Dimensions per Reference
12
+
13
+ Each reference is decomposed across 5 dimensions:
14
+
15
+ 1. **Visual DNA** — color logic, typography pairing, density posture, dark-mode priority
16
+ 2. **Hero / Landing pattern** — what the first 600px does to the visitor
17
+ 3. **Design system architecture** — token strategy, versioning, public docs presence
18
+ 4. **Pricing page pattern** — how it defends the price tag visually
19
+ 5. **Onboarding / Empty-state aesthetic** — how the logged-in first impression is choreographed
20
+
21
+ ---
22
+
23
+ ## 1. Linear (linear.app)
24
+
25
+ ### Visual DNA
26
+ - **Color logic:** Near-monochrome. Single accent (purple) used with extreme restraint. Dark-first (dark mode is default; light mode is the alternate).
27
+ - **Typography:** Inter as the sole workhorse. Tight tracking on headings. No serif. Weight hierarchy (400/500/600) does all the work.
28
+ - **Density posture:** High density, low noise. Information packs tightly but each element is surrounded by calibrated space.
29
+ - **Dark-mode priority:** Dark-first is doctrine.
30
+
31
+ ### Hero pattern
32
+ - Headline + one supporting line + one CTA + a single product screenshot rendered with subtle motion
33
+ - No hero illustration. No stock photography.
34
+ - The product IS the hero.
35
+
36
+ ### Design system
37
+ - Public design system references via published articles (brand guidelines, iconography posts).
38
+ - Icon library: custom, single-weight, monochrome.
39
+ - Spacing: 4/8/12/16/24/32/48 — fibonacci-adjacent, no arbitrary values.
40
+
41
+ ### Pricing pattern
42
+ - 3 tiers max. Horizontal cards. The recommended tier is elevated (Von Restorff via shadow + border + label, not color).
43
+ - No fake urgency. No countdown. The restraint itself signals premium.
44
+
45
+ ### Onboarding
46
+ - Empty state of a new workspace: tutorial guided flow inside the product, not a modal wall. Uses real keyboard shortcuts from day one (teaches velocity from first minute).
47
+
48
+ ### Extracted DNA
49
+ - **"Velocity is the aesthetic."** Everything says "this tool respects your time."
50
+ - **One accent. Forever.** The purple is non-negotiable.
51
+ - **Product is the hero, not decorations.**
52
+
53
+ ---
54
+
55
+ ## 2. Vercel (vercel.com)
56
+
57
+ ### Visual DNA
58
+ - **Color logic:** True black / true white duality. Geometric accent colors (cyan, magenta, amber) used as gradients on hero objects only.
59
+ - **Typography:** Geist Sans + Geist Mono (custom typefaces — the tools-are-craft signal).
60
+ - **Density posture:** Editorial density. Whitespace is luxurious on marketing, compressed on product.
61
+ - **Dark-mode priority:** Dark-first on marketing, toggle on docs.
62
+
63
+ ### Hero pattern
64
+ - Big geometric headline (display weight). Supporting line. Two CTAs (primary + secondary). Often an abstract WebGL/shader background animation that reinforces "we are builders."
65
+ - Frequently uses live code / terminal snippets in the hero to say "this is a dev tool."
66
+
67
+ ### Design system
68
+ - Public: Geist Design System (geist-ui.dev, now part of the Next.js ecosystem).
69
+ - Token system: CSS variables, semantic naming, documented migration guides between versions.
70
+
71
+ ### Pricing pattern
72
+ - 4 tiers (Hobby / Pro / Enterprise / Custom). Compare-all table after the 4 cards.
73
+ - Enterprise = "Contact us" = deliberate friction signaling premium.
74
+
75
+ ### Onboarding
76
+ - Dashboard: the git integration is the first interaction. The product reveals itself via the first deploy. Empty state is a CLI command.
77
+
78
+ ### Extracted DNA
79
+ - **"Craft signaling via custom type."** Owning a typeface is an unfakeable premium flex.
80
+ - **Terminal in the hero = audience signal.**
81
+ - **Shader in the hero = product confidence.**
82
+
83
+ ---
84
+
85
+ ## 3. Stripe (stripe.com)
86
+
87
+ ### Visual DNA
88
+ - **Color logic:** Blurple (Stripe's proprietary violet-blue) as identity anchor. Paired with extremely saturated secondary colors (orange, yellow, teal) used ONLY inside animated hero gradients.
89
+ - **Typography:** Sohne (licensed premium typeface — again the custom-type signal).
90
+ - **Density posture:** Editorial marketing, extremely dense product.
91
+ - **Dark-mode priority:** Light-first on marketing (unusual for premium SaaS — signals "financial institution trust"), dark option on product.
92
+
93
+ ### Hero pattern
94
+ - THE iconic animated gradient band. 2019-present. Industry-defining.
95
+ - Large headline + short subhead + one primary CTA.
96
+ - Under the hero: immediate proof via customer logo wall (trust signaling).
97
+
98
+ ### Design system
99
+ - Internal-only until recently; now partially public via docs.
100
+ - Famously rigorous: "Stripe press" level of documentation.
101
+
102
+ ### Pricing pattern
103
+ - Transparent per-transaction pricing (a radical move for a fintech). The honesty IS the art direction.
104
+ - Comparison tables are exhaustive and unashamed of their complexity.
105
+
106
+ ### Onboarding
107
+ - Dashboard: "create a payment" is the first action. Empty state is a test-mode toggle + a code snippet. The product pedagogically teaches via the surface itself.
108
+
109
+ ### Extracted DNA
110
+ - **"Light-first as trust signal."** Inverts the SaaS dark-first default, on purpose.
111
+ - **Animated gradient = identity lock.** An aesthetic signature so strong it cannot be stolen.
112
+ - **Honesty in pricing is art direction.** No "contact sales" theater.
113
+
114
+ ---
115
+
116
+ ## 4. Framer (framer.com)
117
+
118
+ ### Visual DNA
119
+ - **Color logic:** White-dominant with one chromatic accent (blue) + frequent use of real product screenshots as color blocks.
120
+ - **Typography:** Inter + a bold display pairing for hero.
121
+ - **Density posture:** Extremely generous whitespace. Magazine-editorial.
122
+ - **Dark-mode priority:** Light-first (creative tool convention).
123
+
124
+ ### Hero pattern
125
+ - Massive display headline (often 120px+ on desktop). One animated product demo below. No CTA clutter.
126
+ - Hero is a stage, not a sales pitch.
127
+
128
+ ### Design system
129
+ - Public tokens via Framer's own design system (meta — they sell design tools).
130
+ - Strong component library thinking.
131
+
132
+ ### Pricing pattern
133
+ - Vertical cards, generous padding, annual/monthly toggle with savings-percentage highlight.
134
+ - Free tier is loud (growth loop signal).
135
+
136
+ ### Onboarding
137
+ - Canvas is the empty state. The tool opens and immediately invites interaction.
138
+ - No tutorial modal walls.
139
+
140
+ ### Extracted DNA
141
+ - **"Creative tools earn the right to be airy."** Whitespace = creative confidence.
142
+ - **Product demos > feature lists.**
143
+ - **The empty state IS the product.**
144
+
145
+ ---
146
+
147
+ ## 5. Arc (arc.net / The Browser Company)
148
+
149
+ ### Visual DNA
150
+ - **Color logic:** Gradient-native. The interface itself morphs color based on the active space. Whimsy is the brand.
151
+ - **Typography:** Custom sans + handwritten accent in marketing (signaling human warmth).
152
+ - **Density posture:** Low density, high personality.
153
+ - **Dark-mode priority:** Both work, but the color-morph logic means dark/light is almost irrelevant.
154
+
155
+ ### Hero pattern
156
+ - Video-first hero (product demo video auto-playing).
157
+ - Headline is poetic, not functional. "A calmer, more personal internet."
158
+ - Hero says "we are making something you will fall in love with," not "we have features."
159
+
160
+ ### Design system
161
+ - Not publicly documented — Arc's design is intentionally opaque to reinforce the "handcrafted" narrative.
162
+
163
+ ### Pricing pattern
164
+ - Free (at launch) — the pricing page itself is a philosophical manifesto.
165
+
166
+ ### Onboarding
167
+ - Highly choreographed. Literally a guided tour with personality. Animation-heavy.
168
+ - First 5 minutes feel like an Apple product intro.
169
+
170
+ ### Extracted DNA
171
+ - **"Personality is premium when the category is commodity."** Browsers are commodity — Arc sells personality.
172
+ - **Video-first hero for products that need to be felt, not explained.**
173
+ - **Onboarding as a theatrical performance.**
174
+
175
+ ---
176
+
177
+ ## 6. Raycast (raycast.com)
178
+
179
+ ### Visual DNA
180
+ - **Color logic:** Deep true black + single red accent. Pairs with product screenshots rendered in ultra-crisp dark UI.
181
+ - **Typography:** Inter + monospace accents (dev tool signal).
182
+ - **Density posture:** Compact, efficient, keyboard-centric.
183
+ - **Dark-mode priority:** Dark-first, absolute.
184
+
185
+ ### Hero pattern
186
+ - Product screenshot in hero, large. Headline + short subhead + one CTA.
187
+ - Keyboard shortcut hints visible everywhere.
188
+
189
+ ### Design system
190
+ - Public brand guidelines + icon library. Strong opinion on iconography (monochrome, consistent stroke).
191
+
192
+ ### Pricing pattern
193
+ - 3 tiers, clean horizontal layout. Pro tier elevated via subtle red accent (Von Restorff executed correctly).
194
+ - Free is real — not a 14-day trial.
195
+
196
+ ### Onboarding
197
+ - Cmd-space opens Raycast. That IS the onboarding. The product teaches by existing.
198
+
199
+ ### Extracted DNA
200
+ - **"Keyboard-first is an aesthetic."** Showing shortcut hints everywhere is design theater for power users.
201
+ - **One red dot on one page can justify $10/month.**
202
+ - **Free forever + paid pro = trust.**
203
+
204
+ ---
205
+
206
+ ## Comparative Matrix
207
+
208
+ | Ref | Density | Accent Strategy | Hero Anchor | Type Strategy | Dark/Light | Pricing Tiers | Onboarding Posture |
209
+ |-----|---------|----------------|-------------|---------------|------------|---------------|-------------------|
210
+ | Linear | High | 1 purple | Product screenshot | Inter only | Dark-first | 3 | Velocity-first |
211
+ | Vercel | Editorial/compressed | Gradient accents | Code snippet + shader | Custom Geist | Dark-first | 4 | CLI-first |
212
+ | Stripe | Editorial/very dense | Blurple + gradients | Animated gradient | Custom Sohne | Light-first | Per-transaction | Code-snippet pedagogy |
213
+ | Framer | Airy | One blue | Display type | Inter + bold | Light-first | Tiered + free | Canvas-native |
214
+ | Arc | Low/playful | Gradient morph | Video | Custom + handwriting | Agnostic | Free | Theatrical tour |
215
+ | Raycast | Compact | One red | Product screenshot | Inter + mono | Dark-first | 3 | Cmd-space reveal |
216
+
217
+ ## Cross-Reference Patterns (extracted principles)
218
+
219
+ 1. **Custom typography = premium signal** (Vercel, Stripe, Arc). Licensing a proprietary face is one of the strongest unfakeable premium moves.
220
+ 2. **One accent. Forever.** (Linear, Raycast, Framer). Restraint reads as confidence.
221
+ 3. **Dark-first is the SaaS default** — except when the category explicitly needs trust signaling (Stripe, Framer) where light-first wins.
222
+ 4. **Hero should showcase the product, not decorate around it.** Stock photography, hero illustrations, mascots — absent in all 6.
223
+ 5. **Onboarding is a choreographed performance, not a feature walkthrough.** Every ref has a distinct first-5-minutes philosophy.
224
+ 6. **Pricing pages are design exhibits, not spreadsheets.** Comparative matrices are used AFTER the emotional pitch via the 3-4 cards.
225
+ 7. **Empty states are second impressions — treat them like mini-LPs.**
226
+ 8. **Shader/WebGL in hero signals technical confidence** when your audience is technical (Vercel).
227
+ 9. **"Contact Sales" as a tier is a deliberate premium friction play** (Vercel Enterprise, most B2B SaaS).
228
+
229
+ ## How to USE this KB
230
+
231
+ - **Vertex (platform-aesthetic-director)** consults this KB before every new platform briefing to pattern-match the category fit
232
+ - **Atlas (design-system-architect)** references the design system columns to propose token strategies
233
+ - **Axiom (product-surface-director)** references onboarding/empty-state rows for logged-in product decisions
234
+ - **Aura (premium-packaging-strategist)** references the cross-reference patterns as the raw material for her packaging briefs
235
+
236
+ ## Provenance
237
+
238
+ Compiled 2026-04-12 from public surfaces of the 6 reference products and their public design system documentation. Recent-year updates may have shifted details — re-benchmark quarterly.
239
+
240
+ ---
241
+
242
+ *@analyst (Scope) | squad-artdir v2.0 | KB v1.0*