Communitygithub.com

ulasalyesil/personal-website-v2

ドメインの概念、用語の衝突、境界付けられたコンテキストをマッピングし、概念モデル層向けの名詞収穫リストを生成します。

personal-website-v2 とは?

このスキルは、製品設計に先立って実世界のドメイン(概念、用語、プロセス、関係性)を観察し、マッピングするための構造化されたセッションを提供します。矛盾や用語の不一致を解決するのではなく、データとして記録し、異なるユーザーコミュニティ間の乖離や製品が対応すべき境界を示します。主な対応プラットフォームはClaude CodeなどのAIエージェントで、会話型のガイドセッションを通じて、概念マップ(Mermaidグラフ)、用語監査、ドメインイベントのタイムライン、名詞収穫リストを出力します。この出力は、後続の概念モデル層(`/layers-conceptual-model`)の入力として利用されることを想定しています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/layers-domain

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

/layers-domain

フレームワークコンテキストを読み込むには、/layers-introがロードされていることを前提とします。

ドメイン層は、製品とは無関係に現実世界に存在するものをマッピングします。つまり、ユーザーが持つ概念、用語、プロセス、関係性、メンタルモデルです。これは観察であって、設計ではありません。

重要な区別: この層では矛盾を解決しないでください。矛盾していて、乱雑で、一貫性のないドメイン言語はデータです。それは、異なるユーザーコミュニティがどこで分岐しているか、そして製品がどこで意図的な選択を必要とするかを示しています。解決は概念モデル層で行われます。

この層が下すべき判断:

  • このドメインにおける主要な概念は何か、そしてそれらはどのように関連しているか?
  • 人々はどのような言語を使用しているか、そしてその言語はどこで衝突または分岐しているか?
  • 異なるコミュニティが同じ言葉を異なる意味で使用する、自然な境界線はどこか?
  • 時間の経過とともにドメインの活動を構造化するイベントとプロセスは何か?

手法:

手法いつ使うか
概念マップ / バブルダイアグラムドメインが複雑で理解が不十分な場合。非公式なノードと線で、概念間の関係を早期の構造化を強制せずに示します。
ドメインイベントストーミング (Brandolini)ドメインがプロセス中心の場合。発生する重要な事柄(過去形)から始めます。イベントは自然な境界線を明らかにします。
エキスパートインタビュードメイン知識が人の中にあり、文書にない場合。会話は暗黙知と議論のある用語を明らかにします。
文書・成果物分析ドメインが成果物(契約書、フォーム、請求書)を生成する場合。それらは自然な構造と語彙を明らかにします。
競合分析確立されたドメインに参入する場合。既存の製品は、他の企業がどのようにモデル化したか、そしてどこで意見が異なるかを明らかにします。
シャドーイングドメインに言葉にしにくいワークフローが含まれる場合。人々の作業を観察することで、彼らが実際に何をしているかが明らかになります。

デフォルト: 概念マッピングと用語監査。

品質シグナル — 良好な状態の兆候:

  • 矛盾が文書化されており、解決されていない
  • 同義語が記録されている(同じもの、異なる名前)
  • 多義語がフラグされている(同じ名前、異なる文脈で異なるもの)
  • コミュニティがグループ内では一貫して言語を使用しているが、グループ間では一貫していない場合に、境界付けられたコンテキストが命名されている
  • 名詞収穫リストは完全な生の候補リストである — フィルタリングされておらず、オブジェクトと属性にあらかじめ整理されていない

ガイドセッション

マッピングするドメインとそれについて知っていることを教えてください。または「ガイドしてください」と言って構造化セッションを開始してください。

質問: 「このセッションの成果はどこに保存しますか?」(オプションについては /layers-intro を参照)

質問: 「調査とドメインエキスパートの知見に基づいて作業していますか?それとも、チームが現在ドメインについて信じていることに基づいていますか?」 信念をマッピングする場合は、キャプチャされているものがチームのモデルであり、必ずしもユーザーがドメインを経験する方法ではないことを全体を通してフラグを立ててください。


フェーズ 1 — ドメインを枠組みする

  1. どのドメインをマッピングしていますか?(現実世界のコンテキスト — 製品ではありません。)
  2. このドメインで活動している人は誰ですか?(役割、ユーザータイプ、ステークホルダー。)
  3. 彼らは、あなたの製品が登場する前に、何を達成しようとしていますか?

答えが製品の決定に向かって漂っている場合は、常に現実世界に引き戻してください。

フェーズ 2 — 概念を浮き彫りにする

「[ドメイン]がどのように機能するか教えてください。主要なものは何ですか、それらはどのように関連し、何が起こりますか?」

名詞(概念)、動詞(プロセス)、自然な語彙に耳を傾けてください。すべてをメモしてください — 生の、フィルタリングしないで。次に、促します:

  • 「人々は実際にこれらのものを何と呼んでいますか?同じものに複数の名前がありますか?」
  • 「どのようなルールが存在しますか — 明示的なポリシーまたは理解されている慣習?」
  • 「時間の経過とともに何が変わりますか?ライフサイクルを持つものはありますか?」

フェーズ 3 — 概念マップ

概念マップを構築します: ラベル付きの関係で接続されたノード。非公式 — 必須の階層や方向はありません。ドメインに自然に感じられるものに従ってください。Mermaidでは: graph TD または graph LR。

質問: 「これはドメインのように感じますか、それともデータベース図のように感じますか?何が欠けている、または間違っていますか?」

フェーズ 4 — 用語監査

各概念について: このドメインの全員がこの単語を同じように使用していますか?同じものに対して別の言葉はありますか?この単語は別のコンテキストで異なる意味を持ちますか?

文書化:

概念: [もの]
使用されている名前: [すべてのバリエーション]
コンテキスト: [誰がどれをいつ使用するか]
競合タイプ: 同義語(同じもの、異なる名前)/ 多義語(同じ名前、異なるもの)

勝者を選ばないでください。

フェーズ 5 — 境界付けられたコンテキスト

用語の競合を見てください: 内部的には語彙を共有しているが、他のグループとは異なる人々のコミュニティはありますか?それぞれに名前を付け、説明してください。これらの境界線は、概念モデルが定義されるときに重要になります — 製品はそれらをどのようにナビゲートするか、または橋渡しするかを決定する必要があります。

フェーズ 6 — ドメインイベント(オプション)

ドメインがプロセス中心の場合: 「このドメインで発生する重要な事柄は何ですか?過去形で名前を付けてください。」

イベントをタイムラインにリストしてください。それぞれのトリガーは何か、そしてその結果として何が起こるかを尋ねてください。その周りに重要なイベントがあるオブジェクトは、概念モデル層で状態遷移図が必要になる可能性があります。

フェーズ 7 — 名詞収穫リスト

セッションで浮上したすべての名詞をまとめてください。それぞれにマークを付けてください:

  • 潜在的なオブジェクト — 独立して意味があり、属性と関係を持つ可能性がある
  • 潜在的な属性 — 他の何かのプロパティ
  • 不明瞭 — さらに検討が必要

積極的にフィルタリングしないでください。概念モデル層が分類を行います。


完了

以下を生成してください:

  1. 概念マップ — Mermaid graph TD
  2. 用語の競合 — 文書化された名前のバリエーションと境界付けられたコンテキスト
  3. ドメインイベント — 調査した場合、主要なイベントのタイムライン
  4. 名詞収穫リスト — 完全な候補リスト

次のように締めくくります: 「このドメインマップは、あなたの概念モデルのための原材料です。/layers-conceptual-model を実行して、オブジェクト、関係性、語彙を定義してください — 名詞収穫リストがあなたの出発点です。」

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 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

関連スキル