Communitygithub.com

ulasalyesil/personal-website-v2

Orientação do framework Camadas de Design de Produto — carregue primeiro; fornece o contexto do qual todas as outras habilidades dependem.

O que é personal-website-v2?

Esta habilidade (skill) estabelece o framework Camadas de Design de Produto, estruturado em sete camadas distribuídas em três zonas (realidade, espaço do problema e espaço da solução). Cada camada possui dependência lógica: camadas inferiores servem como fundação para as superiores, e fragilidades nas camadas de base geram dívidas de UX que se propagam para cima. A habilidade descreve os quatro tipos de progresso permitidos pelo framework (tomar decisões, descobrir decisões não tomadas, avaliar decisões e priorizar decisões) e fornece princípios gerais aplicáveis a todas as sessões de design. Também aborda a dimensão temporal frequentemente negligenciada em dois níveis específicos: modelo conceitual e estrutura de interação, além de sinais de modo de falha inspirados nos heurísticos de Nielsen e nos padrões de falha de objetos OOUX de Sophia Prater. É compatível com ferramentas de IA como Claude Code, Cursor e Codex, e deve ser carregada no início de qualquer sessão de design para fornecer o contexto do qual todas as demais habilidades `/layers-*` dependem.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

/layers-intro

Carregue esta habilidade no início de qualquer sessão de design. Ela fornece o contexto do framework do qual todas as outras habilidades /layers-* dependem.


O framework

Camadas de Design de Produto organiza o trabalho de design em sete camadas distribuídas em três zonas. As camadas têm dependência lógica: camadas inferiores são fundamentos para as superiores. Camadas inferiores fracas criam dívidas de UX que se propagam para cima.

Realidade — complexa, contraditória, em evolução. Fonte de todo aprendizado.

Espaço do problema — conhecimento coletado da realidade:

  1. Comportamento observado — o que os usuários realmente fazem
  2. O domínio — conceitos, terminologia e modelos mentais que existem independentemente de qualquer produto
  3. Necessidades do usuário — o que achamos que os usuários estão tentando alcançar, e por quê

Espaço da solução — decisões deliberadas sobre o que construir: 4. Estratégia de produto e serviço — quais necessidades atender e quais resultados de negócio buscar 5. Modelo conceitual — objetos, relacionamentos, estados, vocabulário — independente de qualquer interface 6. Estrutura de interação e fluxo — lugares, affordances, conexões e lógica de fluxo 7. Superfície — palavras, visuais, feedback, hierarquia — o que os usuários realmente encontram

As camadas não são um processo linear. Entre em qualquer ponto — mas sempre verifique se as fundações abaixo estão sólidas.

Inspirado por The Elements of User Experience (2000) de Jesse James Garrett.


Design é tomada de decisão

Design = tomar decisões sobre a forma de uma solução (Christopher Alexander). Forma é a solução; contexto são os requisitos, restrições e ambiente que ela deve atender. Bom design é bom ajuste.

Quatro tipos de progresso:

  1. Tomar decisões — resolver algo não decidido
  2. Descobrir decisões não tomadas — descobrir o que ainda não foi decidido (muitas vezes mais valioso que 1)
  3. Avaliar decisões — identificar decisões já tomadas que são arriscadas, inconsistentes ou erradas
  4. Priorizar decisões — camadas inferiores são mais fundamentais e carregam mais risco se estiverem erradas

O trabalho de cada habilidade é ajudar o designer a tomar melhores decisões — não tomar decisões por eles.


Princípios — aplicam-se a todas as sessões

  1. Decisões, não artefatos. Artefatos são úteis apenas na medida em que representam decisões tomadas ou reveladas. Nomeie a decisão, não apenas o diagrama.
  2. Descubra antes de resolver. Revelar decisões que o designer não sabia que precisava tomar é muitas vezes mais valioso do que responder àquelas que ele sabia.
  3. Trabalhe em uma camada de cada vez. Misturar espaço do problema e espaço da solução, ou superfície e modelo conceitual, produz artefatos confusos.
  4. Verifique as fundações antes de construir para cima. Antes de trabalhar em uma camada superior, audite a camada abaixo. Sinalize instabilidade.
  5. O modelo conceitual é a camada de suporte mais negligenciada. Dê a ele mais atenção do que parece confortável.
  6. Sinalize más decisões, não apenas as ausentes. Uma decisão já tomada que é arriscada ou inconsistente precisa ser nomeada, não contornada.
  7. Direcione, não seja direcionado. Não pule para um artefato de superfície antes que as decisões fundamentais sejam tomadas.
  8. Princípios de design vs. decisões de implementação. Algumas decisões podem ser declaradas sem conhecer as restrições do sistema — o que deve acontecer da perspectiva do usuário. Outras estão entrelaçadas com a implementação: articule o requisito de experiência do usuário, formule uma pergunta bem definida e leve-a para uma conversa de design + engenharia. Não force uma resposta prematura.

A dimensão temporal — investigue proativamente

Decisões temporais são frequentemente negligenciadas. Elas se concentram em duas camadas:

Camada do modelo conceitual:

  • Estados de ação intermediários — um objeto passa por estados transitórios (salvando, processando, aguardando aprovação) antes de resolver? Esses são estados do modelo.
  • Atraso do modelo de leitura — diferença entre quando os dados são gravados e quando ficam visíveis? Articule a necessidade do usuário; sinalize como uma questão aberta nomeada para a engenharia.
  • Temporalidade do relacionamento — "todos os produtos na Europa" significa o grupo agora, ou a associação conforme ela muda? Isso é uma decisão de design.
  • Semântica de exclusão — arquivar, lixeira, exclusão definitiva ou exclusão regulatória? Indique qual e por quê. A implementação segue.
  • Histórico — importa o que um objeto foi no passado? Declarar que importa é uma decisão de design.

Camada da estrutura de interação:

  • Estado pós-ação — após enviar, o que o usuário vê? Uma lista redirecionada reflete imediatamente a alteração?
  • Atualizações otimistas vs. pessimistas — mostrar o resultado presumido antes da confirmação do servidor, ou esperar? Declare a preferência; sinalize como uma questão em aberto se a implementação for incerta.
  • Estados vazio, carregando e parcial — todo lugar tem um ciclo de vida temporal. Projete todos eles.
  • Caminhos de erro e falha — falha de validação, erro do servidor, desconexão de rede, edição concorrente. Etapas de design obrigatórias, não reflexões posteriores.

Sinais de modo de falha

Modos de falha de objeto OOUX (Sophia Prater):

  • Metamorfo — o mesmo objeto em formas significativamente diferentes entre contextos. Correção na superfície: tratamento consistente do objeto. Correção mais profunda se o modelo não definir o objeto claramente.
  • Mascarado — tipos de objeto diferentes com aparência idêntica. Correção na superfície: tratamentos visuais distintos. Correção mais profunda se o modelo não os diferenciar.
  • Quebrado — dados e ações do objeto espalhados por telas sem vinculação cruzada. Problema de estrutura de interação → /layers-interaction-flow.
  • Isolado — objetos existem sem relacionamentos visíveis com outros objetos. Problema de modelo conceitual → /layers-conceptual-model.

Heurísticas de Nielsen — um mapeamento raiz-camada: Violações de "Correspondência entre sistema e mundo real" quase sempre têm raiz no modelo conceitual, não na superfície. "Controle e liberdade do usuário" é uma decisão de estrutura de interação. Remendar isso na superfície trata sintomas, não causas.


Capturando o trabalho

No início de qualquer sessão de design, pergunte onde salvar os artefatos:

"Onde devo capturar o trabalho desta sessão? A configuração recomendada é um arquivo Markdown no seu projeto — diagramas são escritos como Mermaid incorporado e renderizam nativamente no VSCode com a extensão Markdown Preview Mermaid Support. Alternativas:

  • Notion — se você tiver o MCP do Notion conectado
  • Apenas na conversa — nenhum arquivo necessário"

Salve o resumo da sessão no destino escolhido ao final.

Ao escrever diagramas Mermaid, use <br/> para quebras de linha dentro dos rótulos dos nós — não \n, que renderiza como texto literal.


Por onde começar

  • Não sabe onde focar? → /layers-orient — diagnóstico rápido em todas as sete camadas
  • Sabe em qual camada está? → vá diretamente para aquela habilidade

Habilidades: /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

Habilidades Relacionadas