Communitygithub.com

ulasalyesil/personal-website-v2

개념적 모델은 제품이 인식하는 객체, 관계, 상태 및 용어를 모든 인터페이스와 독립적으로 정의하는 가장 중요한 부담 레이어입니다.

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

이 스킬은 소프트웨어 제품 설계의 핵심인 개념적 모델(Conceptual Model) 레이어를 체계적으로 구축하는 방법을 안내합니다. 개념적 모델은 사용자의 혼란스러운 도메인을 명확하고 의도적인 구조로 재정의하는 설계 결정으로, 데이터베이스 스키마, 와이어프레임, 또는 사용자 흐름과는 다릅니다. 이 스킬은 Claire Code, Cursor, Codex 등 다양한 AI 어시스턴트 플랫폼에서 사용할 수 있도록 설계되었으며, 명사 수집(Noun Foraging), OOUX, 시맨틱 상호작용 디자인(Semantic IxD), 이벤트 스토밍(Event Storming) 등 다양한 방법을 제공합니다. 사용자는 6단계 가이드 세션을 통해 객체 발견, 객체 정의, 객체 맵 생성, 상태 전이 분석, 그리고 보편적 언어(Ubiquitous Language) 구축을 수행하며, 최종적으로 객체 정의서, ER 다이어그램, 상태 다이어그램, 용어 사전을 산출합니다.

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

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

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

문서

/layers-conceptual-model

프레임워크 컨텍스트를 위해 /layers-intro가 로드되었다고 가정합니다.

개념적 모델은 가장 소홀히 다뤄지지만 가장 중요한 부담 레이어입니다. 이 모델은 제품이 인식하는 객체, 객체 간의 관계, 객체가 가질 수 있는 상태, 그리고 모든 것에 사용되는 용어를 정의합니다. 이 모델은 솔루션 공간에 존재합니다. 사용자의 기존 정신 모델(모순적이고 혼란스러운 — 이것은 도메인 레이어의 역할)을 캡처하는 것이 아니라, 제품이 자신의 도메인을 어떻게 모델링할지에 대한 의도적인 설계 결정입니다.

무엇인지 — 그리고 무엇이 아닌지:

  • 혼란스러운 도메인을 일관되고 독단적인 구조로 해결하는 설계 결정
  • 데이터베이스 스키마가 아님 — 엔지니어는 자신의 데이터 결정을 내리지만, 이 모델과 엔지니어가 구축하는 것 사이의 차이가 중요합니다. 크고 검토되지 않은 차이는 UX 부채(사용자가 모델과 모순되는 제품을 경험함)이자 기술 부채(시스템을 진화시키기 어려워짐)입니다.
  • 와이어프레임이나 흐름이 아님 — 화면이나 내비게이션이 없습니다. 그것들은 위 레이어에 속합니다.
  • 중립적이지 않음 — 모든 명명 결정, 모든 관계 경계, 포함되거나 제외된 모든 객체는 관점을 반영합니다.

이 레이어가 내려야 할 결정:

  • 이 제품이 인식할 객체는 무엇이며, 그 경계는 무엇인가?
  • 그 객체들은 서로 어떻게 관련되는가?
  • 사용자는 각 객체로 무엇을 할 수 있는가?
  • 각 객체는 어떤 상태를 가질 수 있으며, 어떤 전환이 중요한가?
  • 제품의 용어는 무엇인가 — 개념당 하나의 이름, 선택하고 약속한 것?

방법:

방법적용 시기
명사 수집 + OOUX (Sophia Prater)연구나 도메인 노트를 마이닝할 기본 방법. 자연어에서 객체를 추출합니다.
시맨틱 IxD / 행동 문법 (Daniel Rosenberg)많은 객체에 걸쳐 많은 행동이 있고 동사 일관성과 정밀성을 감사하려는 경우.
이벤트 스토밍 — 명령/정책 단계 (Brandolini)도메인에 복잡한 프로세스가 있는 경우. 발생하는 일부터 시작하여 관련 객체로 거슬러 올라갑니다.
카드 분류용어가 사용자나 팀 간에 불명확하거나 논쟁 중인 경우.
DDD 바운디드 컨텍스트 매핑여러 사용자 유형이 같은 단어를 다르게 사용하는 경우 — 모델이 자연스러운 경계를 가진 곳을 드러냅니다.
기존 제품 살펴보기리디자인 중인 경우. 현재 UI가 암시적 모델을 드러냅니다 — 사용자가 실제로 어떻게 생각하는지와 비교하세요.

기본값: 명사 수집 및 객체 정의.

품질 신호 — 좋은 모델의 특징:

  • 모든 객체는 사용자에게 독립적으로 의미가 있습니다 — UI 요소가 아니고, 모호한 추상화도 아닙니다.
  • 객체가 여러 역할을 할 수 있는 경우 관계 역할이 명시적으로 명명됩니다.
  • 실제로는 관계인 속성이 도전받고 변환되었습니다.
  • 추측성 추가가 없습니다 — 모든 객체, 속성, 관계는 사용자 필요로 추적됩니다.
  • 상태 전이는 객체의 상태가 사용자가 할 수 있는 일을 실질적으로 변경하는 객체에 대해 정의됩니다.
  • 시간 관련 결정이 다루어집니다: 삭제 의미론, 관계 시간성, 히스토리.
  • 보편적 언어가 확립됩니다: 개념당 하나의 이름, 이름당 하나의 개념.

가이드 세션

모델을 정의할 제품이나 기능을 알려주거나, "안내해 주세요"라고 말하면 명사 수집 및 객체 정의를 시작합니다.

질문: "이 세션의 작업을 어디에 기록해야 하나요?" (/layers-intro의 옵션 참조)

디자이너가 문제 공간에서 가진 것(도메인 노트, 연구, 사용자 필요)을 확인합니다. 아무것도 없으면: 진행하지만 도메인 지식 없이 구축된 모델은 종종 사용자의 현실보다 가정을 더 많이 반영한다는 점을 표시합니다.

리디자인 중인 경우: "현재 모델을 설명해 주세요, 비공식적으로라도 — 기존 제품은 어떤 암시적 모델을 가지고 있나요?"


1단계 — 범위 설정

  1. 개념적 모델을 정의할 제품이나 기능은 무엇인가요?
  2. 사용자가 이 기능으로 수행하려는 핵심 작업은 무엇인가요?
  3. 어떤 자료를 가지고 작업하고 있나요?

2단계 — 객체 발견

연구 또는 도메인 노트에서: 모든 명사(사물, 사람, 역할, 문서, 장소, 상태, 개념, 이벤트)를 추출합니다. 넓게 퍼뜨리세요; 아직 필터링하지 마세요. 원시 목록을 제시한 후 질문: 누락된 명사가 있나요? 다른 이름으로 같은 것이 있나요?

기존 제품에서: 함께 살펴봅니다. "사용자가 여기서 보고 있는 것은 무엇인가요? 이 것은 무엇이라고 불리나요?"

처음부터: "사용자가 손을 뻗어 동료에게 건넬 수 있다면 무엇을 건네겠나요?"

다음으로 분류:

  • 객체 — 지속되고, 독자적인 속성을 가지며, 그 자체로 사용자에게 중요한 것
  • 속성 — 객체를 설명하는 특성, 객체 자체가 아님
  • 제쳐둠 — UI 요소, 모호한 추상화, 명사로 위장된 행동

진정한 객체는 사용자에게 독립적으로 의미가 있어야 하며, 다른 것의 속성일 뿐이어서는 안 됩니다.

3단계 — 각 객체 정의

각 핵심 객체를 작업합니다:

객체: [이름]
정의: [사용자 관점에서 한 문장]
속성: [사용자가 알거나 관심을 갖는 특성]
관계: [다른 객체와의 연결 — 카디널리티와 역할 이름]
행동 (CTA): [사용자가 이 객체에 대해 할 수 있는 것]

네 가지 규율 검사:

  1. 관계 역할: 관계가 여러 역할을 수행할 수 있는 객체(예: 추천인과 추천 대상 모두인 사용자)에 연결될 때, 역할을 명시적으로 지정하세요: "한 사용자(추천인으로서)에 속함"이 아니라 "한 사용자에 속함."

  2. 실제로는 관계인 속성: 속성이 단지 모델 내 다른 객체의 이름이나 ID라면, 그것은 관계입니다 — 모델링하고 속성으로 중복하지 마세요.

  3. 추측성 추가 금지: 명시된 사용자 필요에 근거하지 않은 속성, 관계, 행동을 추가하지 마세요. 개념적 모델 레이어의 범위 확장은 위의 모든 레이어로 전파됩니다.

  4. 구현 대 설계 결정: 대화가 무언가가 생성, 저장, 계산되는 방식으로 흘러갈 때 — 방향을 전환: "생성 방식은 엔지니어링 영역입니다. 여기서 중요한 것은: 사용자가 이것을 변경할 수 있나요? 이미 참조하고 있던 것에는 어떤 일이 일어나나요?"

  5. 동사 정밀성: 각 행동에 대해, 동사가 사용자에게 최종 결과나 수행 중인 실제 작업을 알려주는지 질문하세요. "PIN 입력"은 PIN이 이미 존재한다는 것을 암시하기 때문에 실패합니다 — "생성"이 정확합니다. 더 중요하게: 일반 동사(편집, 삭제, 업데이트)가 의미 있게 다른 실제 결과를 가진 작업을 숨기고 있는지 확인하세요. "주소 편집"은 오타 수정(덮어쓰기 가능)과 이사 기록(새 레코드를 생성하고 이전 것을 보존해야 함)이라는 두 가지 작업을 혼동합니다 — 하나는 히스토리를 보존하고 하나는 보존하지 않는 두 작업으로, 다른 시스템 동작과 다른 사용자 의도가 필요합니다. 연역적 인터페이스는 일반 동사를 사용하고 사용자가 자신의 의도를 매핑하도록 요청합니다; 귀납적 인터페이스는 실제 작업을 명명하고("주소 변경 등록") 그 의미를 보존합니다. 일반 동사가 사용자가 실제로 하려는 것에 따라 다른 것을 의미할 수 있을 때, 작업을 별도로 명명하세요.

4단계 — 객체 맵

관계형 객체 맵을 생성합니다: 엔티티는 노드로, 관계는 카디널리티 표시가 있는 레이블이 지정된 선으로 표시합니다. 고정된 방향은 없습니다 — 관계를 가장 읽기 쉽게 만드는 방식을 따르세요. Mermaid에서는 erDiagram을 사용합니다.

제시할 때 카디널리티를 설명하세요: || = 정확히 하나, o{ = 0 또는 다수, |{ = 1 또는 다수. 까마귀 발은 항상 "다수" 쪽에 있습니다. 관계 레이블은 선언된 방향으로 읽습니다(첫 번째 엔티티 → 두 번째 엔티티).

질문: "이것이 이러한 것들에 대한 당신의 생각을 반영하나요? 누락된 관계, 반대 방향, 있어서는 안 될 연결이 있나요?"

5단계 — 상태 전이 및 시간 관련 결정

생애주기나 상태가 중요한 각 객체에 대해: "[객체]는 어떤 상태를 가질 수 있나요? 무엇이 상태 사이를 이동시키나요? 각 상태에서 무엇이 불가능해지나요?"

상태 다이어그램을 생성합니다: 상태는 노드로, 전이는 레이블이 지정된 화살표로, 명확한 시작 상태로 표시합니다. 상태 수에 따라 위에서 아래로 또는 왼쪽에서 오른쪽으로 배열합니다. Mermaid에서는 stateDiagram-v2를 사용합니다.

또한 시간 관련 결정(/layers-intro에서)을 탐색합니다: 중간 작업 상태, 읽기 모델 지연, 관계 시간성, 삭제 의미론, 히스토리. 구현과 얽힌 질문에 대해 성급한 답변을 강요하지 마세요 — 사용자 경험 요구 사항을 명확히 하고 엔지니어링 대화를 위한 명명된 미해결 질문으로 플래그를 지정하세요.

6단계 — 보편적 언어

보편적 언어는 명사(객체, 속성)와 동사(행동) 모두를 다룹니다. 두 가지 모두에 동일한 원칙이 적용됩니다: 개념당 하나의 단어, 단어당 하나의 개념.

명사: 선택된 모든 객체 및 속성 이름을 나열합니다. 동의어나 명명 충돌이 있는 명사에 대해:

용어: [선택된 이름]
거부된 대안: [나타난 다른 이름들]
결정: [이 용어가 선택된 이유]

동사 — 행동 용어: 모든 객체에 걸친 모든 행동 동사를 컴파일합니다. 두 가지 테스트를 적용합니다:

동의어 검사: 여러 동사가 같은 작업에 사용되고 있나요? 같은 작업 유형에 대해 "생성"과 "추가"를 통합해야 합니다. 동사 용어를 최소화하면 사용자가 배워야 할 양이 줄어듭니다 — 같은 동사가 모든 객체에서 동일하게 작동하면(잘라내기/복사/붙여넣기처럼) 사용자는 한 번 배워서 모든 곳에 전이할 수 있습니다. 모든 동의어는 새로 기억해야 할 것입니다.

평탄화 검사: 반대 위험 — 하나의 동사가 실질적으로 다른 작업을 덮고 있는 경우입니다. "주소 편집"은 간단해 보이지만 두 가지를 혼동합니다: 오타 수정(덮어쓰기 가능)과 이사 기록(새 레코드를 생성하고 이전 것을 보존해야 함). 도메인은 이들을 다르게 취급합니다; 인터페이스는 그것을 숨겨서는 안 됩니다. 각 일반 CRUD 동사(편집, 삭제, 업데이트, 생성)에 대해 질문하세요: 이것이 다른 실제 결과(다른 히스토리 함의, 다른 하류 효과, 사용자가 실제로 달성하려는 다른 것)를 가진 작업을 덮을 수 있나요? 그렇다면 별도의 이름을 부여하세요. "주소 변경 등록"과 "주소 수정"은 장황한 것이 아니라 정확한 것입니다.

동사: [선택된 행동 이름]
적용 대상: [어떤 객체]
거부된 대안: [고려된 다른 동사]
결정: [이 동사를 선택한 이유; 명명된 실제 작업]

"이것이 당신 제품의 보편적 언어입니다. 이 용어를 일관되게 사용하세요 — UI에서, 도움말 텍스트에서, API 이름에서, 내부 대화에서. 이 모델과 표면 사이의 모든 불일치는 사용자에게 인지 부하를 만듭니다."


완료

다음을 생성합니다:

  1. 객체 정의 — 속성, 관계, 행동
  2. 객체 맵 — erDiagram
  3. 상태 전이 다이어그램 — 의미 있는 생애주기가 있는 객체의 경우
  4. 보편적 언어 — 해결된 충돌과 결정이 있는 선택된 명사 및 동사
  5. 미해결 질문 — 연기된 결정, 얇게 느껴진 객체, 플래그가 지정되었지만 해결되지 않은 모든 것

다음으로 마무리: "개념적 모델은 이 제품에 존재하는 것을 정의합니다. 다음: 사용자가 이러한 객체와 상호작용하는 방식을 설계합니다. /layers-interaction-flow를 실행하세요."

도메인 작업이 수행되지 않은 경우: "이 모델은 도메인 연구 없이 구축되었습니다 — 가설입니다. 증거를 확보한 후 재방문할 계획을 세우세요."

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

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

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

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

관련 스킬