Communitygithub.com

ulasalyesil/personal-website-v2

プロダクトデザインの階層フレームワーク — 最初にロードしてください。他のすべてのスキルが依存するコンテキストを提供します。

personal-website-v2 とは?

このスキルは「プロダクトデザインの階層」フレームワークを提供し、設計セッションの開始時に読み込むことを推奨します。フレームワークは7つの階層を3つのゾーン(現実 / 問題空間 / 解答空間)に整理し、下位階層が上位階層の基盤となる論理的依存関係を持ちます。設計の本質を「意思決定」と捉え、未決定の事項を発見・評価・優先順位付けすることを支援します。さらに、時間軸(中間状態や削除セマンティクスなど)や失敗モード信号(OOUXやニールセンのヒューリスティクスに基づく)についても言及。出力の保存場所(Markdown + Mermaid図、Notion、会話内)も提案します。このスキルはClaude Code、Cursor、CodexなどのAIエージェントと連携し、設計判断の質を高めます。

対応~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-*スキルが依存するフレームワークのコンテキストを提供します。


フレームワーク

プロダクトデザインの階層は、デザイン作業を3つのゾーンにわたる7つの階層に整理します。階層には論理的依存関係があり、下位階層は上位階層の基盤となります。弱い下位階層は上位に波及するUX負債を生みます。

現実 — 複雑で矛盾し、進化し続ける。すべての学習の源泉。

問題空間 — 現実から収集した知識:

  1. 観察された行動 — ユーザーが実際に行うこと
  2. ドメイン — プロダクトとは独立して存在する概念、用語、メンタルモデル
  3. ユーザーニーズ — ユーザーが達成しようとしていることとその理由

解答空間 — 何を構築するかに関する意図的な決定: 4. プロダクト&サービス戦略 — どのニーズに応え、どのビジネス成果を目標にするか 5. 概念モデル — オブジェクト、関係、状態、語彙 — インターフェースとは独立 6. インタラクション構造とフロー — 場所、アフォーダンス、接続、フロー論理 7. 表面 — 言葉、ビジュアル、フィードバック、階層 — ユーザーが実際に遭遇するもの

階層は線形プロセスではありません。どこからでも入って構いません — ただし、下位の基盤が確かかどうかを常に確認してください。

Jesse James Garrettの『The Elements of User Experience』(2000年)に着想を得ています。


デザインとは意思決定である

デザイン = 解決策の形式について決定を下すこと(Christopher Alexander)。形式が解決策であり、コンテキストはそれが適合しなければならない要件、制約、環境です。優れたデザインとは優れた適合です。

4種類の進捗:

  1. 決定を下す — 未決定の事項を解決する
  2. 未決定の決定を発見する — まだ決定されていないことを見つける(多くの場合、1よりも価値が高い)
  3. 決定を評価する — リスクが高い、矛盾している、または誤っている既存の決定を特定する
  4. 決定に優先順位を付ける — 下位階層ほど基盤的であり、誤っていた場合のリスクが大きい

すべてのスキルの役割は、デザイナーがより良い決定を下せるよう支援することであり、代わりに決定を下すことではありません。


原則 — すべてのセッションに適用

  1. 出力ではなく決定。 アーティファクトは、それが下されたまたは表面化された決定を表す限りにおいてのみ有用です。図だけでなく、決定に名前を付けてください。
  2. 解決する前に発見する。 デザイナーが決定する必要があると気づいていなかった決定を表面化することは、彼らが認識していた決定に答えることよりも価値があることがよくあります。
  3. 一度に一つの階層で作業する。 問題空間と解答空間、または表面と概念モデルを混同すると、混乱した出力が生まれます。
  4. 構築する前に基盤を確認する。 上位階層で作業する前に、下位の階層を監査してください。不安定さにフラグを立ててください。
  5. 概念モデルは最も軽視されている耐荷重層である。 快適だと感じる以上の注意を払ってください。
  6. 欠落した決定だけでなく、悪い決定にもフラグを立てる。 すでに行われたリスクが高いまたは矛盾した決定は、回避するのではなく、名前を付ける必要があります。
  7. 操縦する、操縦されない。 基盤となる決定が行われる前に、表面出力に飛びつかないでください。
  8. デザイン原則 vs. 実装決定。 システムの制約を知らなくても述べられる決定もあります — ユーザーの視点から何が起こるべきか。他のものは実装に絡み合っています:ユーザー体験要件を明確に述べ、適切に形作られた質問を形成し、それをデザイン+エンジニアリングの会話に持ち込みます。時期尚早な回答を強要しないでください。

時間次元 — 積極的に探る

時間的な決定はしばしば見落とされます。これらは2つの階層に集まります:

概念モデル階層:

  • 中間アクション状態 — オブジェクトは解決する前に過渡的な状態(保存中、処理中、承認待ち)を経由しますか?それらはモデルの状態です。
  • リードモデルの遅延 — データが書き込まれてから表示されるまでのギャップ?ユーザーニーズを明確に述べ、エンジニアリングに対する名前付きの未解決質問としてフラグを立ててください。
  • 関係の時間性 — 「ヨーロッパの全製品」とは現在のグループを意味しますか、それともメンバーシップの変化を意味しますか?これはデザイン上の決定です。
  • 削除セマンティクス — アーカイブ、ゴミ箱、ハード削除、または規制削除?どれかを述べ、なぜかを説明してください。実装はそれに従います。
  • 履歴 — オブジェクトが過去に何であったかは重要ですか?それが重要であると述べることはデザイン上の決定です。

インタラクション構造階層:

  • アクション後の状態 — 送信後、ユーザーには何が表示されますか?リダイレクトされたリストはすぐに変更を反映しますか?
  • 楽観的 vs. 悲観的更新 — サーバーが確認する前に想定された結果を表示しますか、それとも待ちますか?好みを述べ、実装が不確かな場合は未解決質問としてフラグを立ててください。
  • 空、読み込み中、部分的な状態 — すべての場所には時間的なライフサイクルがあります。それらすべてをデザインしてください。
  • エラーと障害パス — 検証失敗、サーバーエラー、ネットワーク切断、同時編集。必須のデザインステップであり、後付けではありません。

失敗モードのシグナル

OOUXオブジェクト障害モード(Sophia Prater):

  • シェイプシフター — 同じオブジェクトがコンテキストによって大きく異なる形をとる。表面修正:一貫したオブジェクト処理。モデルがオブジェクトを明確に定義していない場合はより深い修正。
  • マスクド — 異なるオブジェクトタイプが同一に見える。表面修正:明確に異なる視覚的処理。モデルがそれらを区別していない場合はより深い修正。
  • ブロークン — オブジェクトのデータとアクションが画面全体に散らばり、相互リンクがない。インタラクション構造の問題 → /layers-interaction-flow。
  • アイソレーテッド — オブジェクトが他のオブジェクトとの目に見える関係なしに存在する。概念モデルの問題 → /layers-conceptual-model。

ニールセンのヒューリスティクス — 階層ルートマッピング: 「システムと現実世界の一致」の違反は、ほとんどの場合、表面ではなく概念モデルに根ざしています。「ユーザーのコントロールと自由度」はインタラクション構造の決定です。これらを表面で修正することは、原因ではなく症状を治療することになります。


作業の記録

各設計セッションの開始時に、出力をどこに保存するかを尋ねてください:

「このセッションの作業はどこに記録すればよいですか?推奨設定はプロジェクト内のMarkdownファイルです — 図は埋め込みMermaidとして記述され、Markdown Preview Mermaid Support拡張機能を使ってVSCodeでネイティブにレンダリングされます。代替案:

  • Notion — Notion MCPが接続されている場合
  • 会話内 — ファイル不要」

セッションのサマリーをセッション終了時に選択した保存先に保存してください。

Mermaid図を書くときは、ノードラベル内の改行に<br/>を使用してください — \nはリテラルテキストとしてレンダリングされます。


開始場所

  • どこに焦点を当てるべきかわからない場合 → /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

関連スキル