feat(ux): add Apple's 10 Essential Design Principles (WWDC 2017)#351
Open
fazalrshah wants to merge 1 commit into
Open
feat(ux): add Apple's 10 Essential Design Principles (WWDC 2017)#351fazalrshah wants to merge 1 commit into
fazalrshah wants to merge 1 commit into
Conversation
Add the ten foundational, human-centered design principles from Apple's WWDC 2017 "Essential Design Principles" (session 802) to the UX knowledge base, so they are both searchable data and concept-stage guidance. - data/ux-guidelines.csv: +10 rows under category "Apple Design Principles" (Wayfinding, Feedback, Visibility, Consistency, Mental Models, Proximity & Grouping, Mapping, Affordances, Progressive Disclosure, Symmetry & Balance) — each with description / do / don't / examples / severity. Surfaced via `--domain ux` and `--design-system`. - templates/base/quick-reference.md + .claude SKILL.md: add a "Foundational Design Principles" section framing the *why* behind the tactical rule categories (the talk's safety / meaning / achievement / beauty goal). - Bump advertised guideline count 99 -> 109 across metadata and platform template descriptions. - Synced src/ -> cli/assets/ per the contributor guide. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What & why
Adds Apple's ten Essential Design Principles from WWDC 2017 — Session 802 "Essential Design Principles" (Mike Stern) to the UX knowledge base. These are timeless, human-centered product principles that complement the skill's existing tactical rules — they describe the why (the experience you're designing for) where the current rule categories describe the measurable how.
The talk's framing — design to meet four human needs: safety, meaning, achievement, and beauty — is captured as the section intro.
Changes
Data (the core contribution)
src/ui-ux-pro-max/data/ux-guidelines.csv— +10 rows under a newApple Design Principlescategory, each with description / Do / Don't / good + bad examples / severity:Wayfinding · Feedback · Visibility · Consistency · Mental Models · Proximity & Grouping · Mapping · Affordances · Progressive Disclosure · Symmetry & Balance
search.pyand surface via--domain uxand the--design-systemflow.Guidance
src/ui-ux-pro-max/templates/base/quick-reference.md+.claude/skills/ui-ux-pro-max/SKILL.md— a new "Foundational Design Principles" section placed just above the Rule Categories table, so the principles are read at the concept stage.Housekeeping
skill.json,README.md, and the platform template descriptions.src/→cli/assets/per the contributor guide in the README.Verification
search.py "apple design principles" --domain uxreturns the new rows.cli/assetskept byte-in-sync withsrc/for the touched files.Notes