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.
- package/.claude/CLAUDE.md +10 -4
- package/.claude/hooks/enforce-architecture-first.py +197 -197
- package/.claude/hooks/enforce-git-push-authority.sh +25 -4
- package/.claude/hooks/mind-clone-governance.py +193 -193
- package/.claude/hooks/read-protection.py +152 -152
- package/.claude/hooks/sql-governance.py +183 -183
- package/.claude/hooks/verify-packages.cjs +83 -0
- package/.claude/hooks/write-path-validation.py +195 -195
- package/.claude/rules/hook-governance.md +1 -0
- package/.claude/rules/mandatory-delegation.md +24 -0
- package/.claude/rules/project-intelligence.md +63 -0
- package/.claude/rules/response-format.md +4 -0
- package/.claude/rules/safe-collaboration.md +4 -2
- package/.claude/rules/security-data-protection.md +18 -0
- package/.claude/rules/squad-awareness.md +93 -67
- package/.claude/rules/token-economy.md +148 -0
- package/.codex/agents/analyst.md +90 -0
- package/.codex/agents/architect.md +78 -0
- package/.codex/agents/data-engineer.md +38 -0
- package/.codex/agents/developer.md +97 -0
- package/.codex/agents/devops.md +121 -0
- package/.codex/agents/product-lead.md +27 -0
- package/.codex/agents/project-lead.md +28 -0
- package/.codex/agents/quality-gate.md +89 -0
- package/.codex/agents/sprint-lead.md +28 -0
- package/.codex/agents/squad-creator.md +58 -0
- package/.codex/agents/ux-design-expert.md +28 -0
- package/.sinapse-ai/core/code-intel/registry-syncer.js +56 -3
- package/.sinapse-ai/core/doctor/checks/agent-memory.js +5 -1
- package/.sinapse-ai/core/doctor/checks/claude-md.js +4 -1
- package/.sinapse-ai/core/doctor/checks/code-intel.js +5 -1
- package/.sinapse-ai/core/doctor/checks/commands-count.js +4 -1
- package/.sinapse-ai/core/doctor/checks/constitution-consistency.js +4 -1
- package/.sinapse-ai/core/doctor/checks/core-config.js +4 -1
- package/.sinapse-ai/core/doctor/checks/entity-registry.js +6 -1
- package/.sinapse-ai/core/doctor/checks/git-hooks.js +5 -1
- package/.sinapse-ai/core/doctor/checks/graph-dashboard.js +4 -1
- package/.sinapse-ai/core/doctor/checks/hooks-claude-count.js +5 -1
- package/.sinapse-ai/core/doctor/checks/ide-sync.js +4 -1
- package/.sinapse-ai/core/doctor/checks/node-version.js +4 -1
- package/.sinapse-ai/core/doctor/checks/npm-packages.js +4 -1
- package/.sinapse-ai/core/doctor/checks/rules-files.js +4 -1
- package/.sinapse-ai/core/doctor/checks/settings-json.js +4 -1
- package/.sinapse-ai/core/doctor/checks/skills-count.js +4 -1
- package/.sinapse-ai/core/doctor/index.js +157 -50
- package/.sinapse-ai/core/ids/registry-updater.js +6 -1
- package/.sinapse-ai/core/logger/index.js +319 -0
- package/.sinapse-ai/core/orchestration/terminal-spawner.js +2 -2
- package/.sinapse-ai/core/telemetry/index.js +247 -0
- package/.sinapse-ai/data/entity-registry.yaml +1384 -944
- package/.sinapse-ai/development/agents/architect.md +5 -0
- package/.sinapse-ai/development/agents/data-engineer.md +38 -0
- package/.sinapse-ai/development/agents/developer.md +28 -0
- package/.sinapse-ai/development/agents/devops.md +4 -0
- package/.sinapse-ai/development/agents/product-lead.md +27 -0
- package/.sinapse-ai/development/agents/project-lead.md +28 -0
- package/.sinapse-ai/development/agents/quality-gate.md +4 -0
- package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md +8 -0
- package/.sinapse-ai/development/agents/sprint-lead.md +28 -0
- package/.sinapse-ai/development/agents/squad-creator.md +58 -0
- package/.sinapse-ai/development/agents/ux-design-expert.md +28 -0
- package/.sinapse-ai/development/knowledge-base/agent-communication-protocol.md +127 -0
- package/.sinapse-ai/development/knowledge-base/database-scaling-patterns.md +374 -0
- package/.sinapse-ai/development/knowledge-base/environment-deployment-patterns.md +353 -0
- package/.sinapse-ai/development/knowledge-base/gotchas-patterns.md +224 -0
- package/.sinapse-ai/development/knowledge-base/infrastructure-decision-framework.md +221 -0
- package/.sinapse-ai/development/knowledge-base/security-pre-deploy-checklist.md +410 -0
- package/.sinapse-ai/development/knowledge-base/software-architecture-patterns.md +299 -0
- package/.sinapse-ai/development/knowledge-base/token-economy-guide.md +198 -0
- package/.sinapse-ai/development/scripts/populate-entity-registry.js +5 -1
- package/.sinapse-ai/development/skills/captcha-handler.md +82 -0
- package/.sinapse-ai/development/skills/chrome-brain.md +81 -0
- package/.sinapse-ai/development/skills/deploy-readiness.md +93 -0
- package/.sinapse-ai/development/skills/model-router.md +92 -0
- package/.sinapse-ai/development/skills/sinapse-methodology.md +175 -0
- package/.sinapse-ai/development/skills/story-fast-track.md +71 -0
- package/.sinapse-ai/development/tasks/dev-develop-story.md +10 -0
- package/.sinapse-ai/development/tasks/environment-promotion-pipeline.md +582 -0
- package/.sinapse-ai/development/tasks/generate-agent-handoff.md +223 -0
- package/.sinapse-ai/development/tasks/infrastructure-assessment.md +432 -0
- package/.sinapse-ai/development/tasks/load-testing-setup.md +611 -0
- package/.sinapse-ai/development/tasks/observability-blueprint.md +562 -0
- package/.sinapse-ai/development/templates/legal/breach-notification-tmpl.md +113 -0
- package/.sinapse-ai/development/templates/legal/privacy-policy-tmpl.md +93 -0
- package/.sinapse-ai/development/templates/legal/terms-of-service-tmpl.md +85 -0
- package/.sinapse-ai/development/templates/service-template/README.md.hbs +159 -159
- package/.sinapse-ai/development/templates/service-template/__tests__/index.test.ts.hbs +238 -238
- package/.sinapse-ai/development/templates/service-template/client.ts.hbs +404 -404
- package/.sinapse-ai/development/templates/service-template/errors.ts.hbs +183 -183
- package/.sinapse-ai/development/templates/service-template/index.ts.hbs +121 -121
- package/.sinapse-ai/development/templates/service-template/package.json.hbs +88 -88
- package/.sinapse-ai/development/templates/service-template/types.ts.hbs +146 -146
- package/.sinapse-ai/development/templates/squad-template/LICENSE +22 -22
- package/.sinapse-ai/development/workflows/story-development-cycle.yaml +40 -1
- package/.sinapse-ai/hooks/ids-post-commit.js +22 -0
- package/.sinapse-ai/infrastructure/contracts/compatibility/README.md +42 -0
- package/.sinapse-ai/infrastructure/contracts/compatibility/sinapse-current.yaml +35 -0
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/claude-free-tracked.cmd +127 -127
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-proxy.cmd +71 -71
- package/.sinapse-ai/infrastructure/scripts/llm-routing/templates/deepseek-usage.cmd +51 -51
- package/.sinapse-ai/infrastructure/scripts/pr-review-ai.js +16 -13
- package/.sinapse-ai/infrastructure/scripts/setup-project-infra.js +128 -0
- package/.sinapse-ai/infrastructure/scripts/test-discovery.js +8 -3
- package/.sinapse-ai/infrastructure/scripts/validate-manifest-parity.js +380 -0
- package/.sinapse-ai/infrastructure/scripts/validate-parity.js +76 -25
- package/.sinapse-ai/infrastructure/templates/coderabbit.yaml.template +280 -280
- package/.sinapse-ai/infrastructure/templates/config/env.example +16 -0
- package/.sinapse-ai/infrastructure/templates/config/gitignore-additions.tmpl +59 -0
- package/.sinapse-ai/infrastructure/templates/github/CODEOWNERS.template +12 -0
- package/.sinapse-ai/infrastructure/templates/github/PULL_REQUEST_TEMPLATE.md +29 -0
- package/.sinapse-ai/infrastructure/templates/github/ci-template.yml +77 -0
- package/.sinapse-ai/infrastructure/templates/github/issue-templates/bug_report.md +34 -0
- package/.sinapse-ai/infrastructure/templates/github/issue-templates/feature_request.md +19 -0
- package/.sinapse-ai/infrastructure/templates/github-workflows/ci.yml.template +170 -170
- package/.sinapse-ai/infrastructure/templates/github-workflows/pr-automation.yml.template +331 -331
- package/.sinapse-ai/infrastructure/templates/github-workflows/release.yml.template +197 -197
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-brownfield-merge.tmpl +19 -19
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-node.tmpl +86 -86
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-python.tmpl +146 -146
- package/.sinapse-ai/infrastructure/templates/gitignore/gitignore-sinapse-base.tmpl +64 -64
- package/.sinapse-ai/infrastructure/templates/sinapse-sync.yaml.template +183 -183
- package/.sinapse-ai/install-manifest.yaml +275 -140
- package/.sinapse-ai/local-config.yaml.template +65 -65
- package/.sinapse-ai/monitor/hooks/lib/__init__.py +2 -2
- package/.sinapse-ai/monitor/hooks/lib/enrich.py +59 -59
- package/.sinapse-ai/monitor/hooks/lib/send_event.py +48 -48
- package/.sinapse-ai/monitor/hooks/notification.py +30 -30
- package/.sinapse-ai/monitor/hooks/post_tool_use.py +46 -46
- package/.sinapse-ai/monitor/hooks/pre_compact.py +30 -30
- package/.sinapse-ai/monitor/hooks/pre_tool_use.py +41 -41
- package/.sinapse-ai/monitor/hooks/stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/subagent_stop.py +30 -30
- package/.sinapse-ai/monitor/hooks/user_prompt_submit.py +39 -39
- package/.sinapse-ai/product/templates/adr.hbs +126 -126
- package/.sinapse-ai/product/templates/dbdr.hbs +242 -242
- package/.sinapse-ai/product/templates/epic.hbs +213 -213
- package/.sinapse-ai/product/templates/pmdr.hbs +187 -187
- package/.sinapse-ai/product/templates/prd-v2.0.hbs +217 -217
- package/.sinapse-ai/product/templates/prd.hbs +202 -202
- package/.sinapse-ai/product/templates/story-tmpl.yaml +59 -0
- package/.sinapse-ai/product/templates/story.hbs +264 -264
- package/.sinapse-ai/product/templates/task.hbs +171 -171
- package/.sinapse-ai/product/templates/tmpl-comment-on-examples.sql +159 -159
- package/.sinapse-ai/product/templates/tmpl-migration-script.sql +92 -92
- package/.sinapse-ai/product/templates/tmpl-rls-granular-policies.sql +105 -105
- package/.sinapse-ai/product/templates/tmpl-rls-kiss-policy.sql +11 -11
- package/.sinapse-ai/product/templates/tmpl-rls-roles.sql +136 -136
- package/.sinapse-ai/product/templates/tmpl-rls-simple.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-rls-tenant.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-rollback-script.sql +78 -78
- package/.sinapse-ai/product/templates/tmpl-seed-data.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-smoke-test.sql +17 -17
- package/.sinapse-ai/product/templates/tmpl-staging-copy-merge.sql +140 -140
- package/.sinapse-ai/product/templates/tmpl-stored-proc.sql +141 -141
- package/.sinapse-ai/product/templates/tmpl-trigger.sql +153 -153
- package/.sinapse-ai/product/templates/tmpl-view-materialized.sql +134 -134
- package/.sinapse-ai/product/templates/tmpl-view.sql +178 -178
- package/.sinapse-ai/scripts/diagnostics/health-dashboard/package-lock.json +427 -355
- package/LICENSE +34 -34
- package/README.en.md +167 -20
- package/README.md +190 -22
- package/bin/cli.js +510 -196
- package/bin/postinstall.js +564 -0
- package/bin/sinapse-cli +283 -283
- package/bin/sinapse-graph.js +9 -0
- package/bin/sinapse-init.js +36 -4
- package/bin/sinapse-minimal.js +20 -9
- package/bin/sinapse.js +202 -122
- package/bin/utils/deprecation-warning.js +46 -0
- package/bin/utils/pre-push-safety.js +14 -0
- package/docs/TELEMETRY.md +131 -0
- package/docs/chrome-brain-upgrade-plan.md +624 -0
- package/docs/framework/orqx-plan.md +1 -1
- package/docs/installation/chrome-brain.md +17 -7
- package/docs/mega-upgrade-orchestration-plan.md +71 -0
- package/docs/pt/contributing.md +20 -0
- package/docs/research-synthesis-for-upgrade.md +511 -0
- package/docs/security-audit-report.md +306 -0
- package/package.json +20 -8
- package/packages/installer/src/config/configure-environment.js +19 -44
- package/packages/installer/src/detection/detect-project-type.js +181 -63
- package/packages/installer/src/installer/manifest-signature.js +32 -17
- package/packages/installer/src/wizard/i18n.js +12 -0
- package/packages/installer/src/wizard/ide-config-generator.js +8 -39
- package/packages/installer/src/wizard/index.js +119 -14
- package/packages/installer/src/wizard/questions.js +2 -3
- package/packages/installer/tests/integration/environment-configuration.test.js +7 -5
- package/packages/installer/tests/unit/detection/detect-project-type.test.js +138 -1
- package/packages/installer/tests/unit/doctor/doctor-orchestrator.test.js +3 -3
- package/packages/sinapse-install/bin/edmcp.js +0 -0
- package/packages/sinapse-install/bin/sinapse-install.js +0 -0
- package/packages/sinapse-pro-cli/bin/sinapse-pro.js +0 -0
- package/scripts/check-markdown-links.py +353 -353
- package/scripts/coverage-report-summary.js +169 -0
- package/scripts/generate-install-manifest.js +6 -2
- package/scripts/release-readiness.js +169 -0
- package/scripts/test-install-matrix-local.sh +153 -0
- package/scripts/validate-install-docs.js +394 -0
- package/scripts/validate-no-external-refs.js +376 -0
- package/scripts/validate-squad-orqx.js +302 -0
- package/scripts/validate-story-meta.js +263 -0
- package/squads/claude-code-mastery/CHANGELOG.md +1 -1
- package/squads/claude-code-mastery/README.md +2 -2
- package/squads/claude-code-mastery/squad.yaml +1 -1
- package/squads/squad-artdir/README.md +90 -0
- package/squads/squad-artdir/agents/accessibility-guardian.md +184 -0
- package/squads/squad-artdir/agents/artdir-orqx.md +145 -0
- package/squads/squad-artdir/agents/color-psychologist.md +166 -0
- package/squads/squad-artdir/agents/cro-persuasion.md +161 -0
- package/squads/squad-artdir/agents/design-system-architect.md +100 -0
- package/squads/squad-artdir/agents/ia-architect.md +169 -0
- package/squads/squad-artdir/agents/interaction-designer.md +162 -0
- package/squads/squad-artdir/agents/layout-engineer.md +163 -0
- package/squads/squad-artdir/agents/motion-architect.md +185 -0
- package/squads/squad-artdir/agents/platform-aesthetic-director.md +84 -0
- package/squads/squad-artdir/agents/premium-packaging-strategist.md +107 -0
- package/squads/squad-artdir/agents/product-surface-director.md +86 -0
- package/squads/squad-artdir/agents/type-systemist.md +138 -0
- package/squads/squad-artdir/agents/visual-strategist.md +127 -0
- package/squads/squad-artdir/checklists/seven-pillars-validation-checklist.md +172 -0
- package/squads/squad-artdir/knowledge-base/case-nyo-ia-reference.md +289 -0
- package/squads/squad-artdir/knowledge-base/deliverables-templates.md +457 -0
- package/squads/squad-artdir/knowledge-base/motion-technique-catalog.md +247 -0
- package/squads/squad-artdir/knowledge-base/premium-packaging-principles.md +133 -0
- package/squads/squad-artdir/knowledge-base/psychological-toolkit.md +229 -0
- package/squads/squad-artdir/knowledge-base/saas-art-direction-canon.md +242 -0
- package/squads/squad-artdir/knowledge-base/seven-pillars-framework.md +289 -0
- package/squads/squad-artdir/knowledge-base/ten-pillars-framework.md +221 -0
- package/squads/squad-artdir/package.json +20 -0
- package/squads/squad-artdir/squad.yaml +271 -0
- package/squads/squad-artdir/tasks/audit-conversion.md +97 -0
- package/squads/squad-artdir/tasks/audit-drift-multi-surface.md +55 -0
- package/squads/squad-artdir/tasks/consult-saas-canon.md +54 -0
- package/squads/squad-artdir/tasks/create-art-direction-brief.md +110 -0
- package/squads/squad-artdir/tasks/create-premium-packaging-brief.md +61 -0
- package/squads/squad-artdir/tasks/create-wireflow.md +84 -0
- package/squads/squad-artdir/tasks/design-color-system.md +81 -0
- package/squads/squad-artdir/tasks/design-product-surface.md +60 -0
- package/squads/squad-artdir/tasks/design-token-system.md +58 -0
- package/squads/squad-artdir/tasks/diagnose-visual-language.md +92 -0
- package/squads/squad-artdir/tasks/first-5-minutes-choreography.md +65 -0
- package/squads/squad-artdir/tasks/specify-motion-system.md +84 -0
- package/squads/squad-artdir/tasks/validate-against-pillars.md +143 -0
- package/squads/squad-artdir/templates/art-direction-brief-template.md +215 -0
- package/squads/squad-artdir/workflows/conversion-audit-cycle.yaml +78 -0
- package/squads/squad-artdir/workflows/full-art-direction-cycle.yaml +98 -0
- package/squads/squad-artdir/workflows/saas-platform-art-direction-cycle.yaml +174 -0
- package/squads/squad-brand/knowledge-base/ai-visual-generation-canon.md +234 -0
- package/squads/squad-brand/squad.yaml +20 -6
- package/squads/squad-claude/knowledge-base/context-window-optimization.md +1 -1
- package/squads/squad-claude/knowledge-base/swarm-orchestration-patterns.md +2 -2
- package/squads/squad-content/knowledge-base/ai-native-content-loop.md +220 -0
- package/squads/squad-content/knowledge-base/signal-intelligence-v2.md +234 -0
- package/squads/squad-content/knowledge-base/task-ownership-map.md +235 -0
- package/squads/squad-content/squad.yaml +187 -27
- package/squads/squad-copy/knowledge-base/ai-copy-human-loop-canon.md +235 -0
- package/squads/squad-copy/squad.yaml +19 -4
- package/squads/squad-design/knowledge-base/cross-surface-token-canon.md +209 -0
- package/squads/squad-design/squad.yaml +19 -4
- package/.sinapse-ai/core/registry/service-registry.json +0 -6346
- package/.sinapse-ai/data/registry-update-log.jsonl +0 -1323
- package/.sinapse-ai/manifests/agents.csv +0 -29
- package/.sinapse-ai/manifests/tasks.csv +0 -204
- package/.sinapse-ai/manifests/workers.csv +0 -196
- package/squads/squad-growth/tasks/calculate-sample-size.md +0 -121
- 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*
|