Communitygithub.com

ulasalyesil/personal-website-v2

インターフェースから独立した、プロダクトのオブジェクト、関係、状態、語彙を定義する最荷重レイヤーです。

personal-website-v2 とは?

このスキルは、概念モデル(Conceptual Model)の設計を支援するガイドです。概念モデルは、プロダクトが認識するオブジェクト、その関係、取り得る状態、そして使用する語彙を定義する、最も重要でありながら軽視されがちなレイヤーです。これはユーザーの既存のメンタルモデルを取り込むドメインレイヤーとは異なり、プロダクトがどのようにドメインをモデル化するかという意図的な設計判断です。データベーススキーマやワイヤーフレームとは異なり、エンジニアリングの実装とは独立して存在しますが、このモデルと実装の乖離はUX負債や技術負債の原因となります。/layers-intro のフレームワークを前提としており、名詞採取(Noun foraging)やOOUX、セマンティックIxD、イベントストーミングなどの手法を用いて、オブジェクトの発見、定義、状態遷移の決定、ユビキタス言語(普遍言語)の確立を段階的に行います。最終的には、オブジェクト定義、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): [ユーザーがこのオブジェクトに対してまたはそれを使ってできること]

4つの規律チェック:

  1. 関係の役割: 関係が複数の役割を果たせるオブジェクト(例:紹介者と紹介された人の両方であるユーザー)に接続する場合、役割を明示的に命名します:「一人のユーザーに属する(紹介者として)」ではなく「一人のユーザーに属する」。

  2. 実際には関係である属性: 属性がモデル内の別のオブジェクトの名前やIDに過ぎない場合、それは関係です — モデル化し、属性として複製しないでください。

  3. 投機的な追加をしない: 明示されたユーザーニーズに基づいていない属性、関係、アクションを追加しないでください。概念モデルレイヤーでのスコープクリープは、上のすべてのレイヤーに波及します。

  4. 実装と設計判断の区別: 会話が何かがどのように生成されるか、保存されるか、計算されるかに流れた場合 — 方向転換します:「それがどのように生成されるかはエンジニアリングの問題です。ここで重要なのは:ユーザーはこれを変更できますか?すでにそれを参照しているものはどうなりますか?」

  5. 動詞の正確性: 各アクションについて、その動詞がユーザーに最終的に何が得られるか、または実行している現実世界の操作は何かを伝えているかどうかを問います。「PINを入力する」は、PINがすでに存在することを示唆するため失敗します — 「作成する」が正確です。より重要なのは、汎用動詞(編集、削除、更新)が、意味論的に異なる現実世界の結果を持つ操作を隠していないかチェックすることです。「住所を編集する」は、誤字の修正と引っ越しの記録という2つの操作を混同しています — 一方は履歴を保持する必要がなく、もう一方は保持する必要があります。これらは異なるシステム動作と異なるユーザー意図を必要とします。演繹的なインターフェースは汎用動詞を使用し、ユーザーに自分の意図をマッピングするよう求めます。帰納的なインターフェースは現実世界の操作に名前を付け(「住所変更を登録する」)、その意味を保持します。汎用動詞がユーザーが実際にやろうとしていることに応じて異なる意味を持ちうる場合、操作を個別に命名してください。

フェーズ 4 — オブジェクトマップ

リレーショナルオブジェクトマップを生成します:エンティティをノードとして、関係をカーディナリティマーカー付きのラベル線として。固定の向きはなく、関係が最も読みやすくなるように従います。Mermaidでは:erDiagram。

提示する際、カーディナリティを説明します:|| = 正確に1つ、o{ = 0以上、|{ = 1以上。カラスの足は常に「多」側にあります。関係ラベルは宣言された方向(最初のエンティティ → 2番目のエンティティ)で読みます。

質問:「これはこれらのものについてのあなたの考え方を反映していますか?欠けている関係、逆の方向、あるべきでない接続はありませんか?」

フェーズ 5 — 状態遷移と時間に関する判断

ライフサイクルやステータスが重要な各オブジェクトについて:「[オブジェクト]はどのような状態になりえますか?何がそれを状態間で移動させますか?各状態では何が不可能になりますか?」

状態図を生成します:状態をノードとして、遷移をラベル付き矢印として、明確な開始状態を持ちます。状態の数に応じて上から下へ、または左から右へ。Mermaidでは:stateDiagram-v2。

また、時間に関する判断(/layers-introから)を探ります:中間アクション状態、リードモデルの遅延、関係の時間性、削除セマンティクス、履歴。実装に関連する質問については、時期尚早な回答を強制せず、ユーザーエクスペリエンス要件を明確に述べ、エンジニアリングの会話のための名前付き未解決質問としてフラグします。

フェーズ 6 — ユビキタス言語

ユビキタス言語は名詞(オブジェクト、属性)と動詞(アクション)の両方をカバーします。同じ原則が両方に適用されます:コンセプトごとに一つの単語、単語ごとに一つのコンセプト。

名詞: 選択されたすべてのオブジェクトと属性名をリストします。同義語や命名の競合がある名詞については:

用語: [選択された名前]
却下された代替案: [現れた他の名前]
決定: [この用語が選ばれた理由]

動詞 — アクション語彙: すべてのオブジェクトにわたるすべてのアクション動詞をコンパイルします。2つのテストを適用します:

同義語チェック: 同じ操作に複数の動詞が使用されていませんか?同じアクションタイプに対して「作成」と「追加」は統合されるべきです。動詞語彙を最小化することは、ユーザーが学ばなければならないことを減らします — 同じ動詞がすべてのオブジェクトで同一に機能する(切り取り/コピー/貼り付けのように)ことは、ユーザーが一度学べばどこにでも転移できることを意味します。すべての同義語は新しい記憶事項です。

平坦化チェック: 逆のリスク — 一つの動詞が真に異なる操作をカバーしていること。「住所を編集する」は、単純に見えますが、実際には2つのことを混同しています:誤字の修正(上書きで問題ない)と引っ越しの記録(新しいレコードを作成し、古いものを保持する必要がある)。ドメインはこれらを異なるものとして扱います;インターフェースはそれを隠すべきではありません。各汎用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

関連スキル