Communitygithub.com

ulasalyesil/personal-website-v2

인터랙션 구조와 흐름을 매핑하여 엣지 케이스, 실패 경로, 미결정 사항을 포함한 브레드보드 표기법을 생성합니다.

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

이 스킬은 제품 인터랙션 흐름을 설계하고 문서화하는 체계적인 방법론을 제공합니다. 특히 Ryan Singer의 'Shape Up' 방법론에서 사용하는 브레드보드(Breadboarding) 표기법을 기본 도구로 활용하여, 사용자가 제품과 상호작용하는 장소(Place), 제공되는 행동(Affordance), 이동 경로(Destination)를 텍스트 기반으로 명확히 정의합니다. 주요 기능으로는 사용자 여정 프레이밍, 장소 식별, 행동 및 연결 매핑, 성공/실패/엣지 케이스 워크스루, 흐름 검증, 최종 브레드보드 및 Mermaid 순서도 생성이 포함됩니다. 빈 상태, 로딩 상태, 낙관적 업데이트 vs 비관적 업데이트, 취소 경로, 대체 진입점 등 실질적인 설계 결정이 필요한 지점들을 명시적으로 드러내어, 개발자가 시각적 디자인보다 먼저 인터랙션 로직을 평가하고 비용이 많이 드는 변경을 사전에 방지할 수 있도록 돕습니다. 이 스킬은 Claude Code, Cursor 등 AI 에이전트와 함께 사용하기에 적합하며, 제품 설계 초기 단계에서 개념 모델이 안정화되기 전에 흐름을 정의할 경우 추후 재작업이 필요할 수 있음을 경고합니다.

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

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

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

문서

/layers-interaction-flow

프레임워크 맥락을 위해 /layers-intro가 로드되었다고 가정합니다.

인터랙션 구조와 흐름 레이어는 사용자가 제품과 상호작용하는 방식을 정의합니다. 즉, 사용자가 탐색하는 장소, 제공되는 기능, 표시되는 콘텐츠, 상태 간 흐름을 다룹니다. 이 레이어는 개념 모델(무엇이 존재하는지를 정의) 위에 있으며, 표면 레이어(어떻게 보이는지를 정의) 아래에 위치합니다.

이 레이어가 결정해야 할 사항:

  • 이 흐름이 이동하는 고유한 장소는 무엇인가?
  • 각 장소에서 사용자가 할 수 있는 일은 무엇이며, 각 작업은 어디로 연결되는가?
  • 각 장소에 표시해야 할 콘텐츠는 무엇인가?
  • 실패 경로, 빈 상태, 엣지 케이스에서 어떤 일이 발생하는가?
  • 작업을 수행하면서 가능한 한 단순한 흐름인가?

방법:

방법사용 시기
브레드보딩 (Ryan Singer / Shape Up)대부분의 흐름에 기본으로 사용. 텍스트 기반 표기법으로, 시각적 디자인이 변경 비용을 높이기 전에 인터랙션 로직을 평가하도록 강제합니다.
사용자 스토리 매핑 (Jeff Patton)복잡한 제품, 다양한 사용자 유형, 점진적 계획 수립 시. 활동 → 작업 → 스토리를 타임라인에 매핑합니다.
작업 분석기존 흐름 재설계 시. 현재 작업을 분해하여 마찰, 오류, 해결책이 집중된 부분을 찾습니다.
서비스 블루프린팅흐름이 여러 채널에 걸쳐 있거나 사용자 경험에 영향을 미치는 백스테이지 운영(직원, 시스템, 제3자)이 포함된 경우.
핵심 사용자 여정 (CUJ)작업할 흐름을 결정할 때. CUJ는 핵심 제품 가치를 실현하는 최소 경로입니다. 유형: 높은 트래픽, 높은 수익 또는 지표 중요.

기본: 브레드보딩.

브레드보드 표기법:

장소 이름
- 행동 → 도착 장소
- 행동 → 도착 장소
[ 이 장소에 표시되는 콘텐츠 ]

품질 신호 — 좋은 설계의 기준:

  • 모든 행동에는 이름이 지정된 도착 장소가 있습니다.
  • 실패 경로가 브레드보드에 포함되어 있으며, 사후 고려 사항으로 남겨지지 않았습니다.
  • 빈 상태, 로딩 상태, 작업 후 상태가 정의되어 있습니다.
  • 분리된 객체가 없습니다. 객체의 속성과 행동은 함께 제공되며, 화면 간에 분산되어 상호 연결되지 않는 경우가 없습니다.
  • 고립된 객체가 없습니다. 개념 모델의 관계는 흐름에서 시각적으로 확인하고 탐색할 수 있습니다.
  • 흐름은 최소화됩니다. 단일 작업 스토리에 대해 5~6개 이상의 장소가 있으면 축소할 부분을 찾아야 한다는 신호입니다.

가이드 세션

설계 중인 사용자 여정을 알려주거나, 브레드보딩 세션을 시작하려면 "안내해 주세요"라고 말씀하세요.

질문: "이 세션의 작업 결과를 어디에 저장해야 하나요?" (옵션은 /layers-intro 참조)

아래 레이어 확인: "작업할 개념 모델(정의된 객체, 관계, 용어)이 있나요? 아니면 정착된 모델 없이 흐름을 설계하는 건가요?" 개념 모델이 안정화되기 전에 구축된 흐름은 종종 재검토가 필요합니다.

질문: "어떤 사용자 여정 또는 작업 스토리를 위해 설계하고 있나요?" 브레드보드는 항상 특정 상황에서 특정 작업을 수행하는 특정 사용자를 위한 것입니다.


1단계 — 흐름 프레이밍

  1. 이 흐름이 제공하는 작업 스토리는 무엇인가요?
  2. 사용자는 어디에서 시작하나요? 어떤 상황에 처해 있나요?
  3. 성공은 어떤 모습인가요? 흐름이 완료되면 사용자가 무엇을 달성했나요?
  4. 새로운 흐름, 재설계, 아니면 기존 흐름의 확장인가요?

재설계하는 경우: 현재 흐름을 먼저 설명하세요. 대략적으로라도 괜찮습니다. 기존 흐름은 이미 내려진 결정을 드러냅니다. 일부는 의도적이고, 대부분은 그렇지 않습니다.

2단계 — 장소 식별

"이 흐름이 이동하는 고유한 장소 — 화면 또는 상태 — 는 무엇인가요? 아직 레이아웃에 대해 생각하지 마세요. 장소 이름만 정하세요."

질문: 이 중 같은 장소가 다른 상태인 경우가 있나요? 별도의 장소로 두어야 할까요, 아니면 하나의 장소에 상태를 두어야 할까요? 제품 내 다른 곳에 이 흐름이 연결되는 장소가 있나요?

장소 이름을 정하는 것 자체가 설계 결정입니다. 설명적이고 사용자에게 의미 있는 이름을 사용하세요: "페이지 3"이 아닌 "추천 대시보드".

3단계 — 행동 및 연결 매핑

각 장소에 대해 사용자가 할 수 있는 일과 각 작업이 어디로 연결되는지 파악합니다. 위의 브레드보드 표기법을 사용하세요.

각 행동에 대해: 정확히 어디로 가나요? 성공하면 어떻게 되나요? 실패하면? 항상 사용 가능한가요, 아니면 특정 조건에서만 가능한가요?

조건 — 행동이 가능하거나 불가능한 시점 — 은 실제 설계 결정이 숨겨져 있는 곳인 경우가 많습니다.

4단계 — 흐름 살펴보기

사용자 입장에서 서술: "저는 [작업 스토리 상황]의 사용자입니다. [시작 장소]에 도착합니다. [콘텐츠]를 봅니다. [동기]를 원합니다. 그래서 [행동]을 합니다..."

전체 성공 경로를 살펴봅니다. 그런 다음 엣지 케이스를 살펴봅니다:

  • 빈 상태: 데이터가 존재하기 전에 이 장소는 어떻게 보이나요? 종종 새 사용자가 가장 먼저 보는 화면입니다.
  • 로딩 / 비동기 상태: 데이터를 가져오거나 작업을 처리하는 동안 사용자는 무엇을 보나요?
  • 작업 후 상태: 제출 후에는 어떻게 되나요? 그 자리에 남아 있나요, 리디렉션되나요, 인라인 확인이 표시되나요? 목록으로 리디렉션되는 경우 — 변경 사항이 즉시 표시되나요? 지연이 있는 경우 작업이 작동하지 않은 것처럼 보일 수 있나요?
  • 낙관적 vs 비관적: 서버 확인 전에 예상 결과를 표시할까요, 아니면 기다릴까요? 선호도를 명시하고, 구현이 불확실한 경우 명명된 미결 질문으로 표시하세요.
  • 실패 경로: 각 작업에 대해 — 유효성 검사 실패, 서버 오류, 네트워크 연결 끊김, 시간 초과, 동시 편집. 사용자는 어디로 가나요? 어떻게 복구하나요? 이는 필수 브레드보드 단계입니다.
  • 취소 경로: 사용자가 중간에 중단하려면 어디로 가나요?
  • 대체 진입점: 흐름이 항상 참이 아닐 수 있는 이전 상태를 가정하고 있나요?

각각의 간격은 결정되지 않은 설계 결정입니다. 명시적으로 이름을 지정하세요.

5단계 — 흐름 검증

  • 사용자가 포기할 가능성이 높은 단계가 있나요? 왜 그 단계가 있나요? 필요한가요?
  • 사용자가 기대하지만 흐름이 제공하지 않는 작업이 있나요?
  • 흐름의 용어가 개념 모델의 보편적 언어와 일치하나요?
  • 동일한 작업을 수행하는 더 간단한 버전이 있나요?

분리된 객체 확인: 이 흐름에 나타나는 개념 모델의 각 객체에 대해 — 해당 속성과 행동이 함께 제공되나요, 아니면 화면 간에 분산되어 상호 연결이 없나요? 분산된 경우 통합하거나, 객체의 부분이 나타나는 장소 간에 명시적 연결을 추가하세요.

고립된 객체 확인: 개념 모델에 정의된 각 관계에 대해 — 흐름이 해당 관계를 시각적으로 표시하고 탐색 가능하게 하나요? 모델에 관계가 있지만 흐름에서 보이지 않는다면, 표시하거나 이 흐름에서 탐색할 필요가 없다는 의도적인 결정을 내리세요.

6단계 — 브레드보드 생성

완전한 브레드보드를 생성합니다: 모든 장소, 모든 행동 및 도착 장소, 각 장소의 콘텐츠, 주요 조건부 상태를 기록합니다.

왼쪽에서 오른쪽 방향의 흐름 다이어그램을 생성합니다 — 시간에 따른 흐름은 왼쪽에서 오른쪽으로 읽습니다. Mermaid: graph LR.

참고: 다이어그램은 방향 참고용입니다 — 텍스트 브레드보드가 기본 문서입니다. 다이어그램은 콘텐츠와 조건부 세부 정보를 잃습니다.


완료

다음 항목을 생성합니다:

  1. 작업 스토리 — 이 흐름이 제공하는 사용자 니즈
  2. 브레드보드 — 완전한 텍스트 표기법
  3. 흐름 다이어그램 — Mermaid graph LR
  4. 미결 결정 사항 — 아직 해결되지 않은 간격, 엣지 케이스, 조건부 상태
  5. 위험 요소 — 불안정한 개념 모델 결정 또는 표면 가정에 대한 의존성

다음과 같이 마무리: "이 브레드보드는 시각적 형태를 결정하지 않고 인터랙션 로직을 정의합니다. 다음 단계(코드 작업, 실제 매체 구축, 상세한 시각적 디자인)로 넘어가기 전에 이 흐름의 기반이 되는 개념 모델이 먼저 안정적인지 확인하세요."

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

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

관련 스킬