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.
Files changed (25) hide show
  1. code_factory_4_design-0.3.0/LICENSE-APACHE +8 -0
  2. code_factory_4_design-0.3.0/LICENSE-MIT +10 -0
  3. code_factory_4_design-0.3.0/NOTICE +3 -0
  4. code_factory_4_design-0.3.0/PKG-INFO +154 -0
  5. code_factory_4_design-0.3.0/README.md +140 -0
  6. code_factory_4_design-0.3.0/code_factory_4_design.egg-info/PKG-INFO +154 -0
  7. code_factory_4_design-0.3.0/code_factory_4_design.egg-info/SOURCES.txt +23 -0
  8. code_factory_4_design-0.3.0/code_factory_4_design.egg-info/dependency_links.txt +1 -0
  9. code_factory_4_design-0.3.0/code_factory_4_design.egg-info/entry_points.txt +2 -0
  10. code_factory_4_design-0.3.0/code_factory_4_design.egg-info/requires.txt +3 -0
  11. code_factory_4_design-0.3.0/code_factory_4_design.egg-info/top_level.txt +1 -0
  12. code_factory_4_design-0.3.0/prestige_design/__init__.py +15 -0
  13. code_factory_4_design-0.3.0/prestige_design/adapters.py +28 -0
  14. code_factory_4_design-0.3.0/prestige_design/attribution.py +51 -0
  15. code_factory_4_design-0.3.0/prestige_design/audit.py +148 -0
  16. code_factory_4_design-0.3.0/prestige_design/biases.py +119 -0
  17. code_factory_4_design-0.3.0/prestige_design/cli.py +246 -0
  18. code_factory_4_design-0.3.0/prestige_design/cta_hooks.py +97 -0
  19. code_factory_4_design-0.3.0/prestige_design/mobile_judge.py +57 -0
  20. code_factory_4_design-0.3.0/prestige_design/purpose.py +301 -0
  21. code_factory_4_design-0.3.0/prestige_design/score.py +128 -0
  22. code_factory_4_design-0.3.0/prestige_design/workflows.py +97 -0
  23. code_factory_4_design-0.3.0/pyproject.toml +24 -0
  24. code_factory_4_design-0.3.0/setup.cfg +4 -0
  25. 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,3 @@
1
+ The Digital Architect of Prestige โ€” premium design skill for coding agents
2
+ Copyright 2026 WizeMe.APP
3
+ Dual-licensed under Apache-2.0 OR MIT at your option.
@@ -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,2 @@
1
+ [console_scripts]
2
+ prestige = prestige_design.cli:main
@@ -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