Communitygithub.com

ulasalyesil/personal-website-v2

디자인 레이어 프레임워크 — 먼저 로드하세요; 다른 모든 스킬이 의존하는 맥락을 제공합니다

personal-website-v2란 무엇인가요?

이 스킬은 '제품 디자인의 레이어(Layers of Product Design)' 프레임워크의 핵심 컨텍스트를 제공합니다. 디자인 작업을 7개의 레이어로 나누어 체계적으로 접근하며, 하위 레이어가 상위 레이어의 기초가 된다는 논리적 의존성을 강조합니다. 문제 공간(관찰된 행동, 도메인, 사용자 요구)과 솔루션 공간(전략, 개념 모델, 상호작용 흐름, 표면)을 명확히 구분하여 혼란을 방지합니다. 이 스킬은 Claude Code, Cursor 등 다양한 AI 어시스턴트 환경에서 사용할 수 있으며, 디자이너가 더 나은 결정을 내리도록 돕는 것을 목표로 합니다. 특히 의사 결정(decisions) 자체에 초점을 맞추고, 시간 차원의 고려사항(중간 상태, 읽기 모델 지연, 삭제 의미론 등)과 실패 모드 신호(OOUX 객체 실패 모드, 닐슨의 휴리스틱)를 체계적으로 다룹니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-intro

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

/layers-intro

모든 디자인 세션 시작 시 이 스킬을 로드하세요. 다른 모든 /layers-* 스킬이 의존하는 프레임워크 컨텍스트를 제공합니다.


프레임워크

제품 디자인의 레이어는 디자인 작업을 세 영역에 걸친 7개의 레이어로 구성합니다. 레이어는 논리적 의존성을 가집니다. 하위 레이어는 상위 레이어의 기초입니다. 약한 하위 레이어는 위쪽으로 전파되는 UX 부채를 만듭니다.

현실 — 복잡하고, 모순적이며, 진화합니다. 모든 학습의 원천입니다.

문제 공간 — 현실에서 수집된 지식:

  1. 관찰된 행동 — 사용자가 실제로 하는 일
  2. 도메인 — 모든 제품과 독립적으로 존재하는 개념, 용어, 정신 모델
  3. 사용자 요구 — 사용자가 달성하려는 것과 그 이유

솔루션 공간 — 무엇을 구축할지에 대한 의도적인 결정: 4. 제품 및 서비스 전략 — 어떤 요구를 충족시키고, 어떤 비즈니스 결과를 목표로 할지 5. 개념 모델 — 객체, 관계, 상태, 어휘 — 인터페이스와 독립적 6. 상호작용 구조 및 흐름 — 장소, 어포던스, 연결, 흐름 로직 7. 표면 — 단어, 시각적 요소, 피드백, 계층 구조 — 사용자가 실제로 마주하는 것

레이어는 선형적인 프로세스가 아닙니다. 어디서든 진입할 수 있습니다. 하지만 아래 기반이 견고한지 항상 확인하세요.

Jesse James Garrett의 The Elements of User Experience (2000)에서 영감을 받았습니다.


디자인은 의사 결정이다

디자인 = 솔루션의 형태에 대한 결정을 내리는 것(Christopher Alexander). 형태는 솔루션입니다. 컨텍스트는 요구사항, 제약 조건, 그리고 그것이 들어맞아야 하는 환경입니다. 좋은 디자인은 좋은 적합성입니다.

네 가지 진행 유형:

  1. 결정 내리기 — 미결정 사항 해결
  2. 미결정 사항 발견하기 — 아직 결정되지 않은 것을 발견하기(종종 1번보다 더 가치 있음)
  3. 결정 평가하기 — 위험하거나, 일관성이 없거나, 잘못된 이미 내려진 결정 식별
  4. 결정 우선순위 정하기 — 하위 레이어가 더 기초적이며, 잘못될 경우 더 큰 위험을 수반

모든 스킬의 임무는 디자이너가 더 나은 결정을 내리도록 돕는 것이지, 디자이너를 대신해 결정을 내리는 것이 아닙니다.


원칙 — 모든 세션에 적용

  1. 결과물이 아니라 결정. 결과물은 그것이 나타내거나 표면화한 결정만큼만 유용합니다. 다이어그램만이 아니라 결정에 이름을 붙이세요.
  2. 해결하기 전에 발견하세요. 디자이너가 내려야 한다는 사실을 몰랐던 결정을 표면화하는 것이 이미 알고 있던 결정에 답하는 것보다 종종 더 가치 있습니다.
  3. 한 번에 한 레이어씩 작업하세요. 문제 공간과 솔루션 공간, 또는 표면과 개념 모델을 혼동하면 혼란스러운 결과물이 나옵니다.
  4. 위로 구축하기 전에 기초를 확인하세요. 상위 레이어 작업 전에 아래 레이어를 감사하고 불안정성을 표시하세요.
  5. 개념 모델은 가장 소홀히 다뤄지는 하중 지지 레이어입니다. 편안하게 느껴지는 것보다 더 많은 주의를 기울이세요.
  6. 없는 결정뿐만 아니라 나쁜 결정도 표시하세요. 이미 내려진 결정이 위험하거나 일관성이 없다면, 우회하지 말고 이름을 붙이세요.
  7. 주도하세요, 주도당하지 마세요. 기초 결정이 내려지기 전에 표면 결과물로 뛰어들지 마세요.
  8. 디자인 원칙 대 구현 결정. 일부 결정은 시스템 제약 조건을 몰라도 명시할 수 있습니다. 사용자 관점에서 무엇이 일어나야 하는지. 다른 결정은 구현과 얽혀 있습니다. 사용자 경험 요구사항을 명확히 표현하고, 잘 구성된 질문을 형성한 후 디자인+엔지니어링 대화로 가져가세요. 조기 답변을 강요하지 마세요.

시간 차원 — 사전에 적극적으로 탐색하세요

시간적 결정은 종종 간과됩니다. 이는 두 레이어에 집중됩니다:

개념 모델 레이어:

  • 중간 작업 상태 — 객체가 해결되기 전에 전환 상태(저장 중, 처리 중, 승인 대기 중)를 거치나요? 이는 모델 상태입니다.
  • 읽기 모델 지연 — 데이터가 기록된 후 표시될 때까지의 간격이 있나요? 사용자 요구를 명확히 하고, 엔지니어링을 위한 명명된 미해결 질문으로 표시하세요.
  • 관계의 시간성 — "유럽의 모든 제품"은 현재 그룹을 의미하나요, 아니면 시간에 따라 변하는 멤버십을 의미하나요? 이는 디자인 결정입니다.
  • 삭제 의미론 — 보관, 휴지통, 완전 삭제, 또는 규제 삭제인가요? 어떤 것인지와 그 이유를 명시하세요. 구현은 따릅니다.
  • 이력 — 과거에 객체가 무엇이었는지가 중요한가요? 중요하다고 명시하는 것 자체가 디자인 결정입니다.

상호작용 구조 레이어:

  • 작업 후 상태 — 제출 후 사용자는 무엇을 보나요? 리디렉션된 목록이 변경 사항을 즉시 반영하나요?
  • 낙관적 vs 비관적 업데이트 — 서버 확인 전에 가정된 결과를 표시할까요, 아니면 기다릴까요? 선호도를 명시하고, 구현이 불확실하면 미해결 질문으로 표시하세요.
  • 빈 상태, 로딩 상태, 부분 상태 — 모든 장소에는 시간적 생명 주기가 있습니다. 모두 디자인하세요.
  • 오류 및 실패 경로 — 유효성 검사 실패, 서버 오류, 네트워크 연결 끊김, 동시 편집. 필수 디자인 단계이지, 사후 고려 사항이 아닙니다.

실패 모드 신호

OOUX 객체 실패 모드(Sophia Prater):

  • 변형자 — 동일한 객체가 컨텍스트에 따라 크게 다른 형태로 나타납니다. 표면 수정: 일관된 객체 처리. 모델이 객체를 명확히 정의하지 않으면 더 깊은 수정이 필요합니다.
  • 가면 — 다른 객체 유형이 동일하게 보입니다. 표면 수정: 구별되는 시각적 처리. 모델이 이를 구분하지 않으면 더 깊은 수정이 필요합니다.
  • 깨짐 — 객체의 데이터와 작업이 화면 전체에 흩어져 있고 상호 연결이 없습니다. 상호작용 구조 문제 → /layers-interaction-flow.
  • 고립 — 객체가 다른 객체와의 가시적 관계 없이 존재합니다. 개념 모델 문제 → /layers-conceptual-model.

닐슨의 휴리스틱 — 근본 레이어 매핑: "시스템과 현실 세계의 일치" 위반은 거의 항상 표면이 아닌 개념 모델에 뿌리를 둡니다. "사용자 제어 및 자유"는 상호작용 구조 결정입니다. 이를 표면에서 패치하는 것은 증상만 치료하고 원인은 치료하지 않습니다.


작업 저장

모든 디자인 세션 시작 시, 결과물을 어디에 저장할지 물으세요:

*"이 세션의 작업을 어디에 저장할까요? 권장 설정은 프로젝트의 Markdown 파일입니다. 다이어그램은 포함된 Mermaid로 작성되며 Markdown Preview Mermaid Support 확장 프로그램으로 VSCode에서 기본 렌더링됩니다. 대안:

  • Notion — Notion MCP가 연결된 경우
  • 대화 내용 그대로 — 파일 불필요"*

세션 요약을 끝에 선택한 대상에 저장하세요.

Mermaid 다이어그램을 작성할 때, 노드 레이블 내 줄바꿈에는 \n(리터럴 텍스트로 렌더링됨) 대신 <br/>를 사용하세요.


시작 위치

  • 어디에 집중해야 할지 모르겠다면? → /layers-orient — 7개 레이어 전반에 걸친 신속한 진단
  • 어느 레이어에 있는지 안다면? → 해당 스킬로 바로 이동

스킬: /layers-observed-behaviour · /layers-domain · /layers-user-needs · /layers-product-strategy · /layers-conceptual-model · /layers-interaction-flow · /layers-surface

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

관련 스킬