Communitygithub.com

modelo-conceitual-de-camadas

Define os objetos, relacionamentos, estados e vocabulário do produto, independentemente de qualquer interface — a camada mais estrutural.

O que é modelo-conceitual-de-camadas?

Este skill guia designers e agentes de IA na criação de um modelo conceitual, a camada mais negligenciada e estrutural do design de produto. Ele define os objetos que o produto reconhece, suas relações, estados possíveis e o vocabulário usado, sem se prender a interfaces, fluxos ou implementação. O modelo conceitual é uma decisão de design deliberada que resolve o domínio caótico do usuário (que é contraditório — responsabilidade da camada de domínio) em uma estrutura coesa e opinativa. O skill oferece métodos como noun foraging, OOUX, event storming e card sorting, além de um processo guiado em seis fases para descobrir objetos, definir atributos, mapear relacionamentos, modelar transições de estado e estabelecer uma linguagem ubíqua consistente. Qualidades como precisão de verbos, ausência de especulações e tratamento de relações temporais são enfatizadas para evitar dívidas de UX e técnicas. O resultado é um conjunto de definições de objetos, diagramas ER e de estado, e um vocabulário unificado que serve como base para todas as camadas superiores do produto, podendo ser aplicado em ferramentas como Claude Code, Cursor e Codex.

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

Perguntar na sua IA favorita

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

Documentação

/modelo-conceitual-de-camadas

Assume que /camadas-intro foi carregado para contexto do framework.

O modelo conceitual é a camada estrutural mais negligenciada. Ele define os objetos que o produto reconhece, seus relacionamentos, os estados em que podem estar e o vocabulário usado para tudo. Ele vive no espaço da solução: não é uma captura dos modelos mentais existentes dos usuários (que são contraditórios e bagunçados — esse é o trabalho da camada de domínio), mas uma decisão deliberada de design sobre como o produto modelará seu domínio.

O que é — e não é:

  • Uma decisão de design que resolve o domínio bagunçado em uma estrutura coerente e opinativa
  • Não é um esquema de banco de dados — engenheiros tomam suas próprias decisões de dados, mas a lacuna entre este modelo e o que eles constroem importa. Uma lacuna grande e não examinada é tanto dívida de UX (usuários encontram um produto que contradiz o modelo) quanto dívida técnica (o sistema é mais difícil de evoluir).
  • Não é um wireframe ou fluxo — sem telas, sem navegação. Isso pertence às camadas acima.
  • Não é neutro — cada decisão de nomenclatura, cada limite de relacionamento, cada objeto incluído ou excluído reflete um ponto de vista.

Decisões que esta camada precisa tomar:

  • Quais objetos este produto reconhecerá e quais são seus limites?
  • Como esses objetos se relacionam entre si?
  • O que os usuários podem fazer com cada objeto?
  • Em quais estados cada objeto pode estar e quais transições são importantes?
  • Qual é o vocabulário do produto — um nome por conceito, escolhido e assumido?

Métodos:

MétodoQuando usar
Noun foraging + OOUX (Sophia Prater)Padrão quando você tem pesquisa ou anotações de domínio para minerar. Extrai objetos da linguagem naturalística.
Semantic IxD / gramática de ação (Daniel Rosenberg)Quando você tem muitas ações em muitos objetos e deseja auditar consistência e precisão de verbos.
Event storming — fase de comandos/políticas (Brandolini)Domínio possui processos complexos. Comece pelo que acontece, trabalhe de volta para os objetos envolvidos.
Card sortingVocabulário pouco claro ou contestado entre usuários ou equipes.
Mapeamento de contextos delimitados (DDD)Múltiplos tipos de usuários usam as mesmas palavras de forma diferente — revela onde o modelo tem costuras naturais.
Percorrer o produto existenteRedesign. A interface atual revela o modelo implícito — compare-o com como os usuários realmente pensam.

Padrão: noun foraging e definição de objetos.

Sinais de qualidade — como é o bom:

  • Cada objeto é independentemente significativo para o usuário — não um elemento de UI, não uma abstração vaga
  • Papéis de relacionamento são explicitamente nomeados quando um objeto pode desempenhar múltiplos papéis
  • Atributos que são realmente relacionamentos foram desafiados e convertidos
  • Sem adições especulativas — cada objeto, atributo e relacionamento remete a uma necessidade do usuário
  • Transições de estado são definidas para objetos cujo status altera materialmente o que os usuários podem fazer
  • Decisões temporais são abordadas: semântica de exclusão, temporalidade de relacionamentos, histórico
  • Linguagem ubíqua estabelecida: um nome por conceito, um conceito por nome

Sessão guiada

Diga-me qual produto ou funcionalidade você está definindo um modelo, ou diga "me guie" para iniciar o noun foraging e a definição de objetos.

Pergunte: "Onde devo capturar o trabalho desta sessão?" (veja /camadas-intro para opções)

Verifique o que o designer tem do espaço do problema — anotações de domínio, pesquisa, necessidades do usuário. Se não houver nada: prossiga, mas sinalize que um modelo construído sem conhecimento de domínio frequentemente reflete mais suposições do que a realidade dos usuários.

Se for redesign: "Descreva o modelo atual, mesmo informalmente — qual modelo implícito o produto existente tem?"


Fase 1 — Defina o escopo

  1. Qual produto ou funcionalidade estamos definindo um modelo conceitual?
  2. Qual é o trabalho central que os usuários estão tentando fazer com ele?
  3. Com qual material você está trabalhando?

Fase 2 — Descubra objetos

A partir de pesquisa ou anotações de domínio: Extraia todos os substantivos — coisas, pessoas, papéis, documentos, lugares, estados, conceitos, eventos. Varra amplo; não filtre ainda. Apresente a lista bruta e depois pergunte: faltam substantivos? Mesmas coisas com nomes diferentes?

A partir de um produto existente: Percorra-o juntos. "O que o usuário está vendo aqui? Como essa coisa se chama?"

A partir de primeiros princípios: "Se um usuário pudesse estender a mão e entregar algo a um colega, o que ele entregaria?"

Classifique em:

  • Objetos — coisas que persistem, têm seus próprios atributos e importam ao usuário por direito próprio
  • Atributos — propriedades que descrevem um objeto, não objetos em si
  • Colocar de lado — elementos de UI, abstrações vagas, ações disfarçadas de substantivos

Um objeto verdadeiro deve ser independentemente significativo para o usuário, não apenas uma propriedade de outra coisa.

Fase 3 — Defina cada objeto

Trabalhe cada objeto central:

Objeto: [Nome]
O que é: [uma frase da perspectiva do usuário]
Atributos: [propriedades que um usuário conhece ou se importa]
Relacionamentos: [conexões com outros objetos — cardinalidade e nomes de papéis]
Ações (CTAs): [o que um usuário pode fazer a ou com este objeto]

Cinco verificações de disciplina:

  1. Papéis de relacionamento: Quando um relacionamento conecta a um objeto que pode desempenhar múltiplos papéis (ex.: um Usuário que é tanto indicador quanto indicado), nomeie o papel explicitamente: "pertence a um Usuário (como indicador)" não "pertence a um Usuário."

  2. Atributos que são realmente relacionamentos: Se um atributo é apenas o nome ou ID de outro objeto no modelo, é um relacionamento — modele-o, não o duplique como atributo.

  3. Sem adições especulativas: Não adicione atributos, relacionamentos ou ações sem fundamento em uma necessidade declarada do usuário. O aumento de escopo na camada do modelo conceitual se propaga por todas as camadas acima.

  4. Implementação vs. decisões de design: Quando a conversa deriva para como algo é gerado, armazenado ou computado — redirecione: "Como é gerado é engenharia. O que importa aqui: o usuário pode mudar isso? O que acontece com coisas que já faziam referência a isso?"

  5. Precisão de verbos: Para cada ação, pergunte se o verbo diz ao usuário com o que ele vai ficar ou qual operação do mundo real está realizando. "Inserir PIN" falha porque implica que o PIN já existe — "Criar" é preciso. Mais criticamente: verifique se um verbo genérico (Editar, Excluir, Atualizar) está escondendo operações com consequências do mundo real significativamente diferentes. "Editar endereço" confunde corrigir um erro de digitação com registrar uma mudança de casa — duas operações onde uma preserva histórico e a outra não, exigindo comportamentos de sistema diferentes e intenções de usuário diferentes. Uma interface dedutiva usa verbos genéricos e pede aos usuários que mapeiem sua intenção neles; uma interface indutiva nomeia a operação do mundo real ("Registrar mudança de endereço") e preserva seu significado. Quando um verbo genérico pode significar coisas diferentes dependendo do que o usuário está realmente tentando fazer, nomeie as operações separadamente.

Fase 4 — Mapa de objetos

Gere um mapa relacional de objetos: entidades como nós, relacionamentos como linhas rotuladas com marcadores de cardinalidade. Sem orientação fixa — siga o que torna os relacionamentos mais legíveis. Em Mermaid: erDiagram.

Ao apresentar, explique cardinalidade: || = exatamente um, o{ = zero ou muitos, |{ = um ou muitos. O pé de galinha está sempre no lado "muitos". Os rótulos de relacionamento são lidos na direção declarada (primeira entidade → segunda entidade).

Pergunte: "Isso reflete como você pensa sobre essas coisas? Relacionamentos ausentes, direções invertidas, conexões que não deveriam estar aqui?"

Fase 5 — Transições de estado e decisões temporais

Para cada objeto onde ciclo de vida ou status importa: "Em quais estados um [Objeto] pode estar? O que o move entre estados? O que se torna impossível em cada estado?"

Gere um diagrama de estados: estados como nós, transições como setas rotuladas, com um estado inicial claro. De cima para baixo ou da esquerda para a direita, dependendo do número de estados. Em Mermaid: stateDiagram-v2.

Também explore decisões temporais (de /camadas-intro): estados intermediários de ação, lag do modelo de leitura, temporalidade de relacionamentos, semântica de exclusão, histórico. Para perguntas entrelaçadas com implementação, não force uma resposta prematura — articule o requisito de experiência do usuário e sinalize como uma questão em aberto nomeada para uma conversa com engenharia.

Fase 6 — Linguagem ubíqua

A linguagem ubíqua cobre tanto substantivos (objetos, atributos) quanto verbos (ações). O mesmo princípio se aplica a ambos: uma palavra por conceito, um conceito por palavra.

Substantivos: Liste cada nome de objeto e atributo escolhido. Para qualquer substantivo com sinônimos ou conflitos de nomenclatura:

Termo: [nome escolhido]
Alternativas rejeitadas: [outros nomes que apareceram]
Decisão: [por que este termo foi escolhido]

Verbos — vocabulário de ação: Compile todos os verbos de ação em todos os objetos. Aplique dois testes:

Verificação de sinônimo: Múltiplos verbos estão sendo usados para a mesma operação? "Criar" e "Adicionar" para o mesmo tipo de ação devem ser consolidados. Minimizar o vocabulário de verbos reduz o que os usuários precisam aprender — o mesmo verbo funcionando de forma idêntica em todos os objetos (como cortar/copiar/colar) significa que os usuários aprendem uma vez e transferem para tudo. Cada sinônimo é uma nova coisa a memorizar.

Verificação de achatamento: O risco oposto — um verbo cobrindo operações que são genuinamente diferentes. "Editar endereço" parece simples até você perceber que confunde duas coisas: corrigir um erro de digitação (sobrescrever é ok) e registrar uma mudança de casa (que deve criar um novo registro e preservar o antigo). O domínio trata estes de forma diferente; a interface não deve esconder isso. Para cada verbo CRUD genérico (Editar, Excluir, Atualizar, Criar), pergunte: poderia isso cobrir operações com consequências do mundo real diferentes — implicações de histórico diferentes, efeitos downstream diferentes, coisas diferentes que o usuário está realmente tentando realizar? Se sim, dê a eles nomes separados. "Registrar mudança de endereço" e "Corrigir endereço" não são verbosos — são precisos.

Verbo: [nome da ação escolhida]
Aplica-se a: [quais objetos]
Alternativas rejeitadas: [outros verbos considerados]
Decisão: [por que este verbo; qual operação do mundo real ele nomeia]

"Esta é a linguagem ubíqua do seu produto. Use esses termos consistentemente — na UI, no texto de ajuda, nos nomes de API, na conversa interna. Toda inconsistência entre este modelo e a superfície cria carga cognitiva para os usuários."


Conclusão

Produza:

  1. Definições de objetos — atributos, relacionamentos e ações
  2. Mapa de objetos — erDiagram
  3. Diagramas de transição de estado — para objetos com ciclos de vida significativos
  4. Linguagem ubíqua — substantivos e verbos escolhidos com conflitos e decisões resolvidos
  5. Questões em aberto — decisões adiadas, objetos que pareceram superficiais, qualquer coisa sinalizada mas não resolvida

Encerre com: "O modelo conceitual define o que existe neste produto. Em seguida: projete como os usuários interagem com esses objetos. Execute /fluxo-de-interacao-de-camadas."

Se o trabalho de domínio não foi feito: "Este modelo foi construído sem pesquisa de domínio — é uma hipótese. Planeje revisitá-lo quando tiver evidências."

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

Habilidades Relacionadas