code-factory-4-design 0.3.0__tar.gz
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.
- code_factory_4_design-0.3.0/LICENSE-APACHE +8 -0
- code_factory_4_design-0.3.0/LICENSE-MIT +10 -0
- code_factory_4_design-0.3.0/NOTICE +3 -0
- code_factory_4_design-0.3.0/PKG-INFO +154 -0
- code_factory_4_design-0.3.0/README.md +140 -0
- code_factory_4_design-0.3.0/code_factory_4_design.egg-info/PKG-INFO +154 -0
- code_factory_4_design-0.3.0/code_factory_4_design.egg-info/SOURCES.txt +23 -0
- code_factory_4_design-0.3.0/code_factory_4_design.egg-info/dependency_links.txt +1 -0
- code_factory_4_design-0.3.0/code_factory_4_design.egg-info/entry_points.txt +2 -0
- code_factory_4_design-0.3.0/code_factory_4_design.egg-info/requires.txt +3 -0
- code_factory_4_design-0.3.0/code_factory_4_design.egg-info/top_level.txt +1 -0
- code_factory_4_design-0.3.0/prestige_design/__init__.py +15 -0
- code_factory_4_design-0.3.0/prestige_design/adapters.py +28 -0
- code_factory_4_design-0.3.0/prestige_design/attribution.py +51 -0
- code_factory_4_design-0.3.0/prestige_design/audit.py +148 -0
- code_factory_4_design-0.3.0/prestige_design/biases.py +119 -0
- code_factory_4_design-0.3.0/prestige_design/cli.py +246 -0
- code_factory_4_design-0.3.0/prestige_design/cta_hooks.py +97 -0
- code_factory_4_design-0.3.0/prestige_design/mobile_judge.py +57 -0
- code_factory_4_design-0.3.0/prestige_design/purpose.py +301 -0
- code_factory_4_design-0.3.0/prestige_design/score.py +128 -0
- code_factory_4_design-0.3.0/prestige_design/workflows.py +97 -0
- code_factory_4_design-0.3.0/pyproject.toml +24 -0
- code_factory_4_design-0.3.0/setup.cfg +4 -0
- code_factory_4_design-0.3.0/tests/test_prestige.py +275 -0
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
4
|
+
you may not use this file except in compliance with the License.
|
|
5
|
+
You may obtain a copy at http://www.apache.org/licenses/LICENSE-2.0
|
|
6
|
+
Distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
7
|
+
KIND. Full text: http://www.apache.org/licenses/LICENSE-2.0.txt
|
|
8
|
+
Copyright 2026 WizeMe.APP
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 WizeMe.APP
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including the rights to use, copy, modify,
|
|
8
|
+
merge, publish, distribute, sublicense, and/or sell copies, subject to
|
|
9
|
+
including the above notice. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY
|
|
10
|
+
OF ANY KIND. Full text: https://opensource.org/licenses/MIT
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: code-factory-4-design
|
|
3
|
+
Version: 0.3.0
|
|
4
|
+
Summary: The Digital Architect of Prestige โ a coding-agent skill for designing premium, high-conversion websites and mobile UIs using applied psychology and trust engineering. Ships a SKILL.md contract plus an executable design-linter that audits generated HTML/CSS against the Halo Effect, Cognitive Fluency, Trust Engineering, Peak-End Rule, and Horn-Effect triggers.
|
|
5
|
+
License-Expression: MIT OR Apache-2.0
|
|
6
|
+
Requires-Python: >=3.11
|
|
7
|
+
Description-Content-Type: text/markdown
|
|
8
|
+
License-File: LICENSE-APACHE
|
|
9
|
+
License-File: LICENSE-MIT
|
|
10
|
+
License-File: NOTICE
|
|
11
|
+
Provides-Extra: dev
|
|
12
|
+
Requires-Dist: pytest>=8.0; extra == "dev"
|
|
13
|
+
Dynamic: license-file
|
|
14
|
+
|
|
15
|
+
# The Digital Architect of Prestige ๐
|
|
16
|
+
|
|
17
|
+
A **coding-agent skill** for designing premium, high-conversion websites and
|
|
18
|
+
mobile UIs โ for Claude Code, Codex, OpenCode, Cursor, and any agent that reads
|
|
19
|
+
a project skill file. It moves the agent beyond aesthetics into **applied
|
|
20
|
+
psychology and trust engineering**, and ships an **executable design linter** so
|
|
21
|
+
the agent can *verify* its output against the principles, not just intend them.
|
|
22
|
+
|
|
23
|
+
> Users judge credibility in ~50ms from visuals alone. If it looks
|
|
24
|
+
> professional, they assume the service is too (the Halo Effect). This skill
|
|
25
|
+
> engineers that halo โ and refuses to let a pretty page ship over a broken one.
|
|
26
|
+
|
|
27
|
+
## Workflow at a glance
|
|
28
|
+
|
|
29
|
+
```mermaid
|
|
30
|
+
flowchart LR
|
|
31
|
+
A["User journey or page brief"] --> B["Select workflow and purpose"]
|
|
32
|
+
B --> C["Build premium UI"]
|
|
33
|
+
C --> D["Audit five laws"]
|
|
34
|
+
D --> E["Score bias, CTA, hook, mobile, and purpose fit"]
|
|
35
|
+
E -->|"fails"| F["Fix ranked recommendations"]
|
|
36
|
+
F --> D
|
|
37
|
+
E -->|"passes"| G["Ship UI with design receipt"]
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Install into your agent (any OS)
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
python install.py # Windows / macOS / Linux (installs + verifies)
|
|
44
|
+
# then, inside your project:
|
|
45
|
+
prestige install claude # or: codex ยท opencode ยท cursor ยท generic
|
|
46
|
+
```
|
|
47
|
+
That drops `SKILL.md` where your agent auto-reads it. From then on, any
|
|
48
|
+
"design a landing page / make this premium / build a checkout" request triggers
|
|
49
|
+
the skill.
|
|
50
|
+
|
|
51
|
+
## What the agent gets
|
|
52
|
+
|
|
53
|
+
**A design contract (`SKILL.md`)** encoding five laws it applies every time:
|
|
54
|
+
|
|
55
|
+
1. **The 50ms Halo** โ hero section, one bold headline, high-fidelity cover imagery.
|
|
56
|
+
2. **Cognitive Fluency** โ Hick's/Miller's Law, extreme whitespace, one goal per section, `line-height โฅ 1.6`.
|
|
57
|
+
3. **Trust Engineering** โ security + social-proof cues at decision points, total price incl. fees upfront, guest checkout.
|
|
58
|
+
4. **Peak-End Rule** โ micro-interactions at the peaks, inline form validation, a rewarding confirmation ending.
|
|
59
|
+
5. **Horn-Effect Defense** โ one Visual DNA in CSS variables, mobile-first stability, no dated cues.
|
|
60
|
+
|
|
61
|
+
**An executable linter (`prestige audit`)** that scores generated HTML/CSS on all
|
|
62
|
+
five laws and **hard-fails on major functional flaws** โ because the skill's one
|
|
63
|
+
non-negotiable rule is *never let aesthetics mask a broken primary action or an
|
|
64
|
+
inaccessible UI.*
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
prestige scaffold site.html # premium starter (scores 100/100)
|
|
68
|
+
prestige audit site.html # score the five laws + catch Horn-Effect triggers
|
|
69
|
+
prestige purpose site.html --purpose developer # opinionated purpose-fit audit
|
|
70
|
+
prestige audit site.html --strict # exit 1 if failing โ use as an agent/CI gate
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Example on a deliberately clunky page:
|
|
74
|
+
```
|
|
75
|
+
Overall: 18/100 Verdict: NEEDS WORK
|
|
76
|
+
halo:15 fluency:20 trust:20 peak:20 horn:15
|
|
77
|
+
โ HARD FAILURES (fix before shipping โ function over aesthetics):
|
|
78
|
+
MAJOR_FLAW: primary action button has no accessible label/text.
|
|
79
|
+
โ [trust] T_NO_SECURITY: Transactional UI with no security cue near actions.
|
|
80
|
+
โ [horn] C_NO_VIEWPORT: Missing viewport meta โ mobile layout will break.
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## The workflow the skill teaches
|
|
84
|
+
|
|
85
|
+
`Discovery` (audit the journey for trust gaps) โ `Build` (apply the five laws)
|
|
86
|
+
โ `Verify` (`prestige audit`, fix flags, then present). The agent treats a
|
|
87
|
+
failing audit like a failing test โ which is exactly how "premium" stops being
|
|
88
|
+
a vibe and becomes a checkable property.
|
|
89
|
+
|
|
90
|
+
## The psychology, sourced
|
|
91
|
+
Halo Effect & the 50ms window ยท Aesthetic-Usability Effect ยท Hick's & Miller's
|
|
92
|
+
Law ยท Fitts's Law ยท Peak-End Rule ยท Negativity/Horn Effect. Detailed playbooks
|
|
93
|
+
in `references/` (hero-halo, cognitive-fluency, trust-engineering, peak-end).
|
|
94
|
+
|
|
95
|
+
## v0.2 โ deeper psychology, stricter scoring, five workflows
|
|
96
|
+
|
|
97
|
+
- **Cognitive Bias Engine** โ six research-backed biases (Von Restorff, Anchoring,
|
|
98
|
+
Social Proof, Loss Aversion, Reciprocity, Cognitive Fluency) with detectors,
|
|
99
|
+
quality scoring, and precise recommendations.
|
|
100
|
+
- **CTA & Hook Verification** โ scores whether your call-to-action and headline
|
|
101
|
+
are engineered to convert (weak-verb detection, reader-focus, power words,
|
|
102
|
+
CTA-competition penalty) with exact rewrites.
|
|
103
|
+
- **Strict Mobile Judge** โ thumb-reach tap targets, viewport discipline, real
|
|
104
|
+
breakpoints, legible base text, sticky-CTA guidance โ because trust breaks on
|
|
105
|
+
mobile first.
|
|
106
|
+
- **Five Design-Principle Workflows** โ Conversion Architect, Luxury Minimalist,
|
|
107
|
+
Trust Engineer, Editorial Storyteller, Product-Led Pragmatist. Each is a
|
|
108
|
+
distinct optimization strategy that re-weights the score.
|
|
109
|
+
- **Precision Scoring** โ `prestige score <file> --workflow <key>` fuses laws +
|
|
110
|
+
biases + CTA/hooks + mobile into a 0โ100 conversion-readiness grade with
|
|
111
|
+
**recommendations ranked by conversion impact**.
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
prestige workflows # see the five lenses
|
|
115
|
+
prestige score site.html --workflow trust # precise score + ranked fixes
|
|
116
|
+
prestige score site.html --strict # exit 1 if not conversion-ready
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Grounded in current research: credibility forms in ~0.05s (Google), trigger-driven
|
|
120
|
+
UX lifts conversion ~34% on average (Nielsen Norman 2024).
|
|
121
|
+
|
|
122
|
+
## v0.3 - purpose-fit design judgment
|
|
123
|
+
|
|
124
|
+
Workflows answer **what the page optimizes for**. Purpose lenses answer **what
|
|
125
|
+
psychological job the design must do for this audience and domain**.
|
|
126
|
+
|
|
127
|
+
Prestige now ships deterministic purpose-fit profiles:
|
|
128
|
+
|
|
129
|
+
- `developer` - concrete proof, docs, CLI/API clarity, GitHub/demo trust.
|
|
130
|
+
- `healthcare` - calm reassurance, privacy, clinician proof, no miracle hype.
|
|
131
|
+
- `fintech` - security, transparent fees/rates, control, compliance cues.
|
|
132
|
+
- `luxury` - restraint, craft, whitespace, fewer louder elements.
|
|
133
|
+
- `marketplace` - bilateral buyer/seller trust, reviews, protection, comparison.
|
|
134
|
+
- `saas` - product visibility, integrations, ROI, low-friction activation.
|
|
135
|
+
- `editorial` - narrative rhythm, sources, evidence, satisfying end beat.
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
prestige purposes
|
|
139
|
+
prestige purpose site.html --purpose healthcare --strict
|
|
140
|
+
prestige score site.html --workflow trust --purpose healthcare
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
The purpose gate scores intent clarity, proof fit, visual theme fit, action
|
|
144
|
+
language, and purpose-specific anti-patterns. This makes Prestige more
|
|
145
|
+
opinionated in the right way: not just "pretty," but fit for the decision the
|
|
146
|
+
interface exists to change.
|
|
147
|
+
|
|
148
|
+
## License
|
|
149
|
+
Dual-licensed **Apache-2.0 OR MIT** โ pick whichever your project prefers.
|
|
150
|
+
## Criterion attribution
|
|
151
|
+
|
|
152
|
+
Prestige 0.2.1 wraps its existing five per-law scores in the factory attribution
|
|
153
|
+
envelope. Run `prestige audit page.html --json` to receive one unit per design
|
|
154
|
+
criterion, its score and threshold, and the unchanged overall verdict.
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
# The Digital Architect of Prestige ๐
|
|
2
|
+
|
|
3
|
+
A **coding-agent skill** for designing premium, high-conversion websites and
|
|
4
|
+
mobile UIs โ for Claude Code, Codex, OpenCode, Cursor, and any agent that reads
|
|
5
|
+
a project skill file. It moves the agent beyond aesthetics into **applied
|
|
6
|
+
psychology and trust engineering**, and ships an **executable design linter** so
|
|
7
|
+
the agent can *verify* its output against the principles, not just intend them.
|
|
8
|
+
|
|
9
|
+
> Users judge credibility in ~50ms from visuals alone. If it looks
|
|
10
|
+
> professional, they assume the service is too (the Halo Effect). This skill
|
|
11
|
+
> engineers that halo โ and refuses to let a pretty page ship over a broken one.
|
|
12
|
+
|
|
13
|
+
## Workflow at a glance
|
|
14
|
+
|
|
15
|
+
```mermaid
|
|
16
|
+
flowchart LR
|
|
17
|
+
A["User journey or page brief"] --> B["Select workflow and purpose"]
|
|
18
|
+
B --> C["Build premium UI"]
|
|
19
|
+
C --> D["Audit five laws"]
|
|
20
|
+
D --> E["Score bias, CTA, hook, mobile, and purpose fit"]
|
|
21
|
+
E -->|"fails"| F["Fix ranked recommendations"]
|
|
22
|
+
F --> D
|
|
23
|
+
E -->|"passes"| G["Ship UI with design receipt"]
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Install into your agent (any OS)
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
python install.py # Windows / macOS / Linux (installs + verifies)
|
|
30
|
+
# then, inside your project:
|
|
31
|
+
prestige install claude # or: codex ยท opencode ยท cursor ยท generic
|
|
32
|
+
```
|
|
33
|
+
That drops `SKILL.md` where your agent auto-reads it. From then on, any
|
|
34
|
+
"design a landing page / make this premium / build a checkout" request triggers
|
|
35
|
+
the skill.
|
|
36
|
+
|
|
37
|
+
## What the agent gets
|
|
38
|
+
|
|
39
|
+
**A design contract (`SKILL.md`)** encoding five laws it applies every time:
|
|
40
|
+
|
|
41
|
+
1. **The 50ms Halo** โ hero section, one bold headline, high-fidelity cover imagery.
|
|
42
|
+
2. **Cognitive Fluency** โ Hick's/Miller's Law, extreme whitespace, one goal per section, `line-height โฅ 1.6`.
|
|
43
|
+
3. **Trust Engineering** โ security + social-proof cues at decision points, total price incl. fees upfront, guest checkout.
|
|
44
|
+
4. **Peak-End Rule** โ micro-interactions at the peaks, inline form validation, a rewarding confirmation ending.
|
|
45
|
+
5. **Horn-Effect Defense** โ one Visual DNA in CSS variables, mobile-first stability, no dated cues.
|
|
46
|
+
|
|
47
|
+
**An executable linter (`prestige audit`)** that scores generated HTML/CSS on all
|
|
48
|
+
five laws and **hard-fails on major functional flaws** โ because the skill's one
|
|
49
|
+
non-negotiable rule is *never let aesthetics mask a broken primary action or an
|
|
50
|
+
inaccessible UI.*
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
prestige scaffold site.html # premium starter (scores 100/100)
|
|
54
|
+
prestige audit site.html # score the five laws + catch Horn-Effect triggers
|
|
55
|
+
prestige purpose site.html --purpose developer # opinionated purpose-fit audit
|
|
56
|
+
prestige audit site.html --strict # exit 1 if failing โ use as an agent/CI gate
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
Example on a deliberately clunky page:
|
|
60
|
+
```
|
|
61
|
+
Overall: 18/100 Verdict: NEEDS WORK
|
|
62
|
+
halo:15 fluency:20 trust:20 peak:20 horn:15
|
|
63
|
+
โ HARD FAILURES (fix before shipping โ function over aesthetics):
|
|
64
|
+
MAJOR_FLAW: primary action button has no accessible label/text.
|
|
65
|
+
โ [trust] T_NO_SECURITY: Transactional UI with no security cue near actions.
|
|
66
|
+
โ [horn] C_NO_VIEWPORT: Missing viewport meta โ mobile layout will break.
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
## The workflow the skill teaches
|
|
70
|
+
|
|
71
|
+
`Discovery` (audit the journey for trust gaps) โ `Build` (apply the five laws)
|
|
72
|
+
โ `Verify` (`prestige audit`, fix flags, then present). The agent treats a
|
|
73
|
+
failing audit like a failing test โ which is exactly how "premium" stops being
|
|
74
|
+
a vibe and becomes a checkable property.
|
|
75
|
+
|
|
76
|
+
## The psychology, sourced
|
|
77
|
+
Halo Effect & the 50ms window ยท Aesthetic-Usability Effect ยท Hick's & Miller's
|
|
78
|
+
Law ยท Fitts's Law ยท Peak-End Rule ยท Negativity/Horn Effect. Detailed playbooks
|
|
79
|
+
in `references/` (hero-halo, cognitive-fluency, trust-engineering, peak-end).
|
|
80
|
+
|
|
81
|
+
## v0.2 โ deeper psychology, stricter scoring, five workflows
|
|
82
|
+
|
|
83
|
+
- **Cognitive Bias Engine** โ six research-backed biases (Von Restorff, Anchoring,
|
|
84
|
+
Social Proof, Loss Aversion, Reciprocity, Cognitive Fluency) with detectors,
|
|
85
|
+
quality scoring, and precise recommendations.
|
|
86
|
+
- **CTA & Hook Verification** โ scores whether your call-to-action and headline
|
|
87
|
+
are engineered to convert (weak-verb detection, reader-focus, power words,
|
|
88
|
+
CTA-competition penalty) with exact rewrites.
|
|
89
|
+
- **Strict Mobile Judge** โ thumb-reach tap targets, viewport discipline, real
|
|
90
|
+
breakpoints, legible base text, sticky-CTA guidance โ because trust breaks on
|
|
91
|
+
mobile first.
|
|
92
|
+
- **Five Design-Principle Workflows** โ Conversion Architect, Luxury Minimalist,
|
|
93
|
+
Trust Engineer, Editorial Storyteller, Product-Led Pragmatist. Each is a
|
|
94
|
+
distinct optimization strategy that re-weights the score.
|
|
95
|
+
- **Precision Scoring** โ `prestige score <file> --workflow <key>` fuses laws +
|
|
96
|
+
biases + CTA/hooks + mobile into a 0โ100 conversion-readiness grade with
|
|
97
|
+
**recommendations ranked by conversion impact**.
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
prestige workflows # see the five lenses
|
|
101
|
+
prestige score site.html --workflow trust # precise score + ranked fixes
|
|
102
|
+
prestige score site.html --strict # exit 1 if not conversion-ready
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Grounded in current research: credibility forms in ~0.05s (Google), trigger-driven
|
|
106
|
+
UX lifts conversion ~34% on average (Nielsen Norman 2024).
|
|
107
|
+
|
|
108
|
+
## v0.3 - purpose-fit design judgment
|
|
109
|
+
|
|
110
|
+
Workflows answer **what the page optimizes for**. Purpose lenses answer **what
|
|
111
|
+
psychological job the design must do for this audience and domain**.
|
|
112
|
+
|
|
113
|
+
Prestige now ships deterministic purpose-fit profiles:
|
|
114
|
+
|
|
115
|
+
- `developer` - concrete proof, docs, CLI/API clarity, GitHub/demo trust.
|
|
116
|
+
- `healthcare` - calm reassurance, privacy, clinician proof, no miracle hype.
|
|
117
|
+
- `fintech` - security, transparent fees/rates, control, compliance cues.
|
|
118
|
+
- `luxury` - restraint, craft, whitespace, fewer louder elements.
|
|
119
|
+
- `marketplace` - bilateral buyer/seller trust, reviews, protection, comparison.
|
|
120
|
+
- `saas` - product visibility, integrations, ROI, low-friction activation.
|
|
121
|
+
- `editorial` - narrative rhythm, sources, evidence, satisfying end beat.
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
prestige purposes
|
|
125
|
+
prestige purpose site.html --purpose healthcare --strict
|
|
126
|
+
prestige score site.html --workflow trust --purpose healthcare
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
The purpose gate scores intent clarity, proof fit, visual theme fit, action
|
|
130
|
+
language, and purpose-specific anti-patterns. This makes Prestige more
|
|
131
|
+
opinionated in the right way: not just "pretty," but fit for the decision the
|
|
132
|
+
interface exists to change.
|
|
133
|
+
|
|
134
|
+
## License
|
|
135
|
+
Dual-licensed **Apache-2.0 OR MIT** โ pick whichever your project prefers.
|
|
136
|
+
## Criterion attribution
|
|
137
|
+
|
|
138
|
+
Prestige 0.2.1 wraps its existing five per-law scores in the factory attribution
|
|
139
|
+
envelope. Run `prestige audit page.html --json` to receive one unit per design
|
|
140
|
+
criterion, its score and threshold, and the unchanged overall verdict.
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: code-factory-4-design
|
|
3
|
+
Version: 0.3.0
|
|
4
|
+
Summary: The Digital Architect of Prestige โ a coding-agent skill for designing premium, high-conversion websites and mobile UIs using applied psychology and trust engineering. Ships a SKILL.md contract plus an executable design-linter that audits generated HTML/CSS against the Halo Effect, Cognitive Fluency, Trust Engineering, Peak-End Rule, and Horn-Effect triggers.
|
|
5
|
+
License-Expression: MIT OR Apache-2.0
|
|
6
|
+
Requires-Python: >=3.11
|
|
7
|
+
Description-Content-Type: text/markdown
|
|
8
|
+
License-File: LICENSE-APACHE
|
|
9
|
+
License-File: LICENSE-MIT
|
|
10
|
+
License-File: NOTICE
|
|
11
|
+
Provides-Extra: dev
|
|
12
|
+
Requires-Dist: pytest>=8.0; extra == "dev"
|
|
13
|
+
Dynamic: license-file
|
|
14
|
+
|
|
15
|
+
# The Digital Architect of Prestige ๐
|
|
16
|
+
|
|
17
|
+
A **coding-agent skill** for designing premium, high-conversion websites and
|
|
18
|
+
mobile UIs โ for Claude Code, Codex, OpenCode, Cursor, and any agent that reads
|
|
19
|
+
a project skill file. It moves the agent beyond aesthetics into **applied
|
|
20
|
+
psychology and trust engineering**, and ships an **executable design linter** so
|
|
21
|
+
the agent can *verify* its output against the principles, not just intend them.
|
|
22
|
+
|
|
23
|
+
> Users judge credibility in ~50ms from visuals alone. If it looks
|
|
24
|
+
> professional, they assume the service is too (the Halo Effect). This skill
|
|
25
|
+
> engineers that halo โ and refuses to let a pretty page ship over a broken one.
|
|
26
|
+
|
|
27
|
+
## Workflow at a glance
|
|
28
|
+
|
|
29
|
+
```mermaid
|
|
30
|
+
flowchart LR
|
|
31
|
+
A["User journey or page brief"] --> B["Select workflow and purpose"]
|
|
32
|
+
B --> C["Build premium UI"]
|
|
33
|
+
C --> D["Audit five laws"]
|
|
34
|
+
D --> E["Score bias, CTA, hook, mobile, and purpose fit"]
|
|
35
|
+
E -->|"fails"| F["Fix ranked recommendations"]
|
|
36
|
+
F --> D
|
|
37
|
+
E -->|"passes"| G["Ship UI with design receipt"]
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Install into your agent (any OS)
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
python install.py # Windows / macOS / Linux (installs + verifies)
|
|
44
|
+
# then, inside your project:
|
|
45
|
+
prestige install claude # or: codex ยท opencode ยท cursor ยท generic
|
|
46
|
+
```
|
|
47
|
+
That drops `SKILL.md` where your agent auto-reads it. From then on, any
|
|
48
|
+
"design a landing page / make this premium / build a checkout" request triggers
|
|
49
|
+
the skill.
|
|
50
|
+
|
|
51
|
+
## What the agent gets
|
|
52
|
+
|
|
53
|
+
**A design contract (`SKILL.md`)** encoding five laws it applies every time:
|
|
54
|
+
|
|
55
|
+
1. **The 50ms Halo** โ hero section, one bold headline, high-fidelity cover imagery.
|
|
56
|
+
2. **Cognitive Fluency** โ Hick's/Miller's Law, extreme whitespace, one goal per section, `line-height โฅ 1.6`.
|
|
57
|
+
3. **Trust Engineering** โ security + social-proof cues at decision points, total price incl. fees upfront, guest checkout.
|
|
58
|
+
4. **Peak-End Rule** โ micro-interactions at the peaks, inline form validation, a rewarding confirmation ending.
|
|
59
|
+
5. **Horn-Effect Defense** โ one Visual DNA in CSS variables, mobile-first stability, no dated cues.
|
|
60
|
+
|
|
61
|
+
**An executable linter (`prestige audit`)** that scores generated HTML/CSS on all
|
|
62
|
+
five laws and **hard-fails on major functional flaws** โ because the skill's one
|
|
63
|
+
non-negotiable rule is *never let aesthetics mask a broken primary action or an
|
|
64
|
+
inaccessible UI.*
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
prestige scaffold site.html # premium starter (scores 100/100)
|
|
68
|
+
prestige audit site.html # score the five laws + catch Horn-Effect triggers
|
|
69
|
+
prestige purpose site.html --purpose developer # opinionated purpose-fit audit
|
|
70
|
+
prestige audit site.html --strict # exit 1 if failing โ use as an agent/CI gate
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
Example on a deliberately clunky page:
|
|
74
|
+
```
|
|
75
|
+
Overall: 18/100 Verdict: NEEDS WORK
|
|
76
|
+
halo:15 fluency:20 trust:20 peak:20 horn:15
|
|
77
|
+
โ HARD FAILURES (fix before shipping โ function over aesthetics):
|
|
78
|
+
MAJOR_FLAW: primary action button has no accessible label/text.
|
|
79
|
+
โ [trust] T_NO_SECURITY: Transactional UI with no security cue near actions.
|
|
80
|
+
โ [horn] C_NO_VIEWPORT: Missing viewport meta โ mobile layout will break.
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
## The workflow the skill teaches
|
|
84
|
+
|
|
85
|
+
`Discovery` (audit the journey for trust gaps) โ `Build` (apply the five laws)
|
|
86
|
+
โ `Verify` (`prestige audit`, fix flags, then present). The agent treats a
|
|
87
|
+
failing audit like a failing test โ which is exactly how "premium" stops being
|
|
88
|
+
a vibe and becomes a checkable property.
|
|
89
|
+
|
|
90
|
+
## The psychology, sourced
|
|
91
|
+
Halo Effect & the 50ms window ยท Aesthetic-Usability Effect ยท Hick's & Miller's
|
|
92
|
+
Law ยท Fitts's Law ยท Peak-End Rule ยท Negativity/Horn Effect. Detailed playbooks
|
|
93
|
+
in `references/` (hero-halo, cognitive-fluency, trust-engineering, peak-end).
|
|
94
|
+
|
|
95
|
+
## v0.2 โ deeper psychology, stricter scoring, five workflows
|
|
96
|
+
|
|
97
|
+
- **Cognitive Bias Engine** โ six research-backed biases (Von Restorff, Anchoring,
|
|
98
|
+
Social Proof, Loss Aversion, Reciprocity, Cognitive Fluency) with detectors,
|
|
99
|
+
quality scoring, and precise recommendations.
|
|
100
|
+
- **CTA & Hook Verification** โ scores whether your call-to-action and headline
|
|
101
|
+
are engineered to convert (weak-verb detection, reader-focus, power words,
|
|
102
|
+
CTA-competition penalty) with exact rewrites.
|
|
103
|
+
- **Strict Mobile Judge** โ thumb-reach tap targets, viewport discipline, real
|
|
104
|
+
breakpoints, legible base text, sticky-CTA guidance โ because trust breaks on
|
|
105
|
+
mobile first.
|
|
106
|
+
- **Five Design-Principle Workflows** โ Conversion Architect, Luxury Minimalist,
|
|
107
|
+
Trust Engineer, Editorial Storyteller, Product-Led Pragmatist. Each is a
|
|
108
|
+
distinct optimization strategy that re-weights the score.
|
|
109
|
+
- **Precision Scoring** โ `prestige score <file> --workflow <key>` fuses laws +
|
|
110
|
+
biases + CTA/hooks + mobile into a 0โ100 conversion-readiness grade with
|
|
111
|
+
**recommendations ranked by conversion impact**.
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
prestige workflows # see the five lenses
|
|
115
|
+
prestige score site.html --workflow trust # precise score + ranked fixes
|
|
116
|
+
prestige score site.html --strict # exit 1 if not conversion-ready
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
Grounded in current research: credibility forms in ~0.05s (Google), trigger-driven
|
|
120
|
+
UX lifts conversion ~34% on average (Nielsen Norman 2024).
|
|
121
|
+
|
|
122
|
+
## v0.3 - purpose-fit design judgment
|
|
123
|
+
|
|
124
|
+
Workflows answer **what the page optimizes for**. Purpose lenses answer **what
|
|
125
|
+
psychological job the design must do for this audience and domain**.
|
|
126
|
+
|
|
127
|
+
Prestige now ships deterministic purpose-fit profiles:
|
|
128
|
+
|
|
129
|
+
- `developer` - concrete proof, docs, CLI/API clarity, GitHub/demo trust.
|
|
130
|
+
- `healthcare` - calm reassurance, privacy, clinician proof, no miracle hype.
|
|
131
|
+
- `fintech` - security, transparent fees/rates, control, compliance cues.
|
|
132
|
+
- `luxury` - restraint, craft, whitespace, fewer louder elements.
|
|
133
|
+
- `marketplace` - bilateral buyer/seller trust, reviews, protection, comparison.
|
|
134
|
+
- `saas` - product visibility, integrations, ROI, low-friction activation.
|
|
135
|
+
- `editorial` - narrative rhythm, sources, evidence, satisfying end beat.
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
prestige purposes
|
|
139
|
+
prestige purpose site.html --purpose healthcare --strict
|
|
140
|
+
prestige score site.html --workflow trust --purpose healthcare
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
The purpose gate scores intent clarity, proof fit, visual theme fit, action
|
|
144
|
+
language, and purpose-specific anti-patterns. This makes Prestige more
|
|
145
|
+
opinionated in the right way: not just "pretty," but fit for the decision the
|
|
146
|
+
interface exists to change.
|
|
147
|
+
|
|
148
|
+
## License
|
|
149
|
+
Dual-licensed **Apache-2.0 OR MIT** โ pick whichever your project prefers.
|
|
150
|
+
## Criterion attribution
|
|
151
|
+
|
|
152
|
+
Prestige 0.2.1 wraps its existing five per-law scores in the factory attribution
|
|
153
|
+
envelope. Run `prestige audit page.html --json` to receive one unit per design
|
|
154
|
+
criterion, its score and threshold, and the unchanged overall verdict.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
LICENSE-APACHE
|
|
2
|
+
LICENSE-MIT
|
|
3
|
+
NOTICE
|
|
4
|
+
README.md
|
|
5
|
+
pyproject.toml
|
|
6
|
+
code_factory_4_design.egg-info/PKG-INFO
|
|
7
|
+
code_factory_4_design.egg-info/SOURCES.txt
|
|
8
|
+
code_factory_4_design.egg-info/dependency_links.txt
|
|
9
|
+
code_factory_4_design.egg-info/entry_points.txt
|
|
10
|
+
code_factory_4_design.egg-info/requires.txt
|
|
11
|
+
code_factory_4_design.egg-info/top_level.txt
|
|
12
|
+
prestige_design/__init__.py
|
|
13
|
+
prestige_design/adapters.py
|
|
14
|
+
prestige_design/attribution.py
|
|
15
|
+
prestige_design/audit.py
|
|
16
|
+
prestige_design/biases.py
|
|
17
|
+
prestige_design/cli.py
|
|
18
|
+
prestige_design/cta_hooks.py
|
|
19
|
+
prestige_design/mobile_judge.py
|
|
20
|
+
prestige_design/purpose.py
|
|
21
|
+
prestige_design/score.py
|
|
22
|
+
prestige_design/workflows.py
|
|
23
|
+
tests/test_prestige.py
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
prestige_design
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"""The Digital Architect of Prestige โ premium web/mobile design as a skill.
|
|
2
|
+
|
|
3
|
+
Encodes five design laws as an executable audit so any coding agent (Claude
|
|
4
|
+
Code / Codex / OpenCode / Cursor / โฆ) doesn't just *know* the principles but
|
|
5
|
+
can *verify* its own output before shipping:
|
|
6
|
+
|
|
7
|
+
1. The 50ms Halo โ hero section, high-fidelity imagery, instant credibility
|
|
8
|
+
2. Cognitive Fluency โ Hick's/Miller's Law, whitespace, one goal per section
|
|
9
|
+
3. Trust Engineering โ security cues + social proof at decision points, price transparency
|
|
10
|
+
4. Peak-End Rule โ micro-interactions at peaks, a rewarding conclusion
|
|
11
|
+
5. Horn-Effect Defense โ ruthless consistency, mobile stability, no dated cues
|
|
12
|
+
|
|
13
|
+
The warning is enforced too: aesthetics never mask a MAJOR functional flaw.
|
|
14
|
+
"""
|
|
15
|
+
__version__ = "0.3.0"
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
"""Install this skill into any coding agent. The SKILL.md is the contract;
|
|
2
|
+
each agent reads it from a different location."""
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
def skill_text() -> str:
|
|
7
|
+
return (Path(__file__).resolve().parent/"SKILL.md").read_text()
|
|
8
|
+
|
|
9
|
+
TARGETS = {
|
|
10
|
+
"claude": [".claude/skills/prestige-design/SKILL.md"],
|
|
11
|
+
"codex": ["AGENTS.md"], # appended, not overwritten
|
|
12
|
+
"opencode": [".opencode/skills/prestige-design.md"],
|
|
13
|
+
"cursor": [".cursor/rules/prestige-design.md"],
|
|
14
|
+
"generic": ["SKILL-prestige-design.md"],
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
def install(root: Path, agent: str) -> list[Path]:
|
|
18
|
+
root = Path(root); created = []
|
|
19
|
+
key = {"claude-code":"claude"}.get(agent, agent)
|
|
20
|
+
text = skill_text()
|
|
21
|
+
for rel in TARGETS.get(key, ["AGENTS.md"]):
|
|
22
|
+
dst = root/rel; dst.parent.mkdir(parents=True, exist_ok=True)
|
|
23
|
+
if dst.name == "AGENTS.md" and dst.exists():
|
|
24
|
+
dst.write_text(dst.read_text().rstrip()+"\n\n"+text)
|
|
25
|
+
else:
|
|
26
|
+
dst.write_text(text)
|
|
27
|
+
created.append(dst)
|
|
28
|
+
return created
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
"""Attribution wrapper for Prestige's existing per-criterion scores."""
|
|
2
|
+
from dataclasses import asdict, dataclass
|
|
3
|
+
from enum import Enum
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
class FailureClass(str, Enum):
|
|
7
|
+
AMBIGUOUS_REQUIREMENT = "ambiguous_requirement"
|
|
8
|
+
UNTYPED_INPUT = "untyped_input"
|
|
9
|
+
SCOPE_ESCAPE = "scope_escape"
|
|
10
|
+
INVENTED_PARAM = "invented_param"
|
|
11
|
+
SIGNATURE_DRIFT = "signature_drift"
|
|
12
|
+
STUB_UNFILLED = "stub_unfilled"
|
|
13
|
+
COMPLEXITY_EXCEEDED = "complexity_exceeded"
|
|
14
|
+
INCONSISTENT_LOGIC = "inconsistent_logic"
|
|
15
|
+
RUNTIME_CRASH = "runtime_crash"
|
|
16
|
+
RUNTIME_TIMEOUT = "runtime_timeout"
|
|
17
|
+
WRONG_OUTPUT = "wrong_output"
|
|
18
|
+
ACCURACY_REGRESSION = "accuracy_regression"
|
|
19
|
+
NONDETERMINISM = "nondeterminism"
|
|
20
|
+
SECURITY_FINDING = "security_finding"
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
@dataclass(frozen=True)
|
|
24
|
+
class UnitResult:
|
|
25
|
+
unit: str
|
|
26
|
+
stage: str
|
|
27
|
+
passed: bool
|
|
28
|
+
evidence: str
|
|
29
|
+
failure_class: FailureClass | None = None
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
@dataclass
|
|
33
|
+
class Attribution:
|
|
34
|
+
stage: str
|
|
35
|
+
n_checked: int
|
|
36
|
+
n_passed: int
|
|
37
|
+
units: list[UnitResult]
|
|
38
|
+
|
|
39
|
+
@property
|
|
40
|
+
def rate(self):
|
|
41
|
+
return self.n_passed / self.n_checked if self.n_checked else 0.0
|
|
42
|
+
|
|
43
|
+
def dominant_failure_class(self):
|
|
44
|
+
return FailureClass.WRONG_OUTPUT if self.n_passed < self.n_checked else None
|
|
45
|
+
|
|
46
|
+
def to_dict(self):
|
|
47
|
+
value = asdict(self)
|
|
48
|
+
value["rate"] = self.rate
|
|
49
|
+
dominant = self.dominant_failure_class()
|
|
50
|
+
value["dominant_failure_class"] = dominant.value if dominant else None
|
|
51
|
+
return value
|