Communitygithub.com

ulasalyesil/personal-website-v2

インタラクション構造とフローをマッピングし、エッジケース、失敗パス、未決定事項を含むブレッドボード記法を生成します。

personal-website-v2 とは?

このスキル(/layers-interaction-flow)は、プロダクトのインタラクション構造とフローを定義・設計するためのものです。ユーザーが移動する場所、利用可能なアクション、表示されるコンテンツ、そして状態間の遷移を体系的に捉えます。特に「ブレッドボード(Breadboarding)」と呼ばれるテキストベースの記法をデフォルトの手法として採用し、視覚デザインの前にインタラクションロジックを評価することを重視します。このスキルは、新規フローの設計から既存フローのリデザイン、エッジケースや失敗パスの洗い出しまで幅広いユースケースに対応しています。また、未決定の設計判断を明示的に「未解決の決定事項」としてリストアップすることで、チーム間の認識齟齬を防ぎます。最終的には、ジョブストーリー、完全なブレッドボードテキスト、Mermaidを用いたフロー図、未解決の決定事項、リスクを成果物として生成します。このスキルは、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)複雑なプロダクト、多数のユーザータイプ、段階的な計画。アクティビティ → タスク → ストーリーをタイムラインに沿ってマッピングする。
タスク分析既存フローのリデザイン。現在のタスクを分解し、摩擦、エラー、回避策が集中する場所を見つける。
サービスブループリンティングフローが複数のチャネルにまたがる、またはユーザーエクスペリエンスに影響を与えるバックステージ業務(スタッフ、システム、サードパーティ)を含む場合。
クリティカルユーザージャーニー (CUJ)どのフローに取り組むかを決定する。CUJはコアプロダクトバリューを実現するための最小パス。タイプ: 高トラフィック、高収益、またはメトリクス上重要。

デフォルト: ブレッドボーディング。

ブレッドボード記法:

場所名
- アフォーダンス → 移動先の場所
- アフォーダンス → 移動先の場所
[ この場所に表示されるコンテンツ ]

品質シグナル — 良い状態の指標:

  • すべてのアフォーダンスに名前付きの移動先がある
  • 失敗パスがブレッドボードに記載されている(後回しにされていない)
  • 空の状態、ローディング状態、アクション後の状態が定義されている
  • 壊れたオブジェクトがない — オブジェクトの属性とアクションが、相互リンクなしに画面間で分散されていない
  • 孤立したオブジェクトがない — 概念モデルからの関係性がフローの中で可視化され、ナビゲート可能である
  • フローは最小限である: 単一のジョブストーリーに対して5〜6箇所以上の場所は、何を統合できるか検討すべきシグナルである

ガイド付きセッション

どのユーザージャーニーのために設計しているか教えてください。または「ガイドして」と言ってブレッドボーディングセッションを開始してください。

質問: 「このセッションの成果物はどこに記録すべきですか?」 (オプションについては /layers-intro を参照)

下位レイヤーを確認: 「概念モデル(定義されたオブジェクト、関係性、語彙)はありますか?それとも、モデルが確定しないままフローを設計していますか?」 概念モデルが安定する前に構築されたフローは、しばしば見直しが必要になります。

質問: 「どのユーザージャーニーまたはジョブストーリーのために設計していますか?」 ブレッドボードは常に、特定の状況で特定のジョブを実行する特定のユーザーのためのものです。


フェーズ 1 — フローを枠組みする

  1. このフローが対応するジョブストーリーは何か?
  2. ユーザーはどこから始まるか?どのような状況にいるか?
  3. 成功はどのような状態か?フロー完了時にユーザーは何を達成しているか?
  4. 新規フローか、リデザインか、既存フローの拡張か?

リデザインの場合: まず現在のフローを説明してください。たとえ大まかでも構いません。既存のフローは、過去に行われた決定(意図的なものも、そうでないものも)を明らかにします。

フェーズ 2 — 場所を特定する

「このフローが通過する明確な場所(画面または状態)は何ですか?レイアウトはまだ考えないでください。単に場所に名前を付けてください。」

質問: これらの場所の中に、異なる状態にある同じ場所はありますか?それらは別々の場所ですか、それとも状態を持つ1つの場所ですか?このフローがプロダクト内の他の場所と接続する場所はありますか?

場所に名前を付けること自体が設計上の意思決定です。記述的でユーザーにとって意味のある名前(例:「紹介ダッシュボード」であり「ページ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

関連スキル