Communitygithub.com

ulasalyesil/personal-website-v2

Mapeia conceitos de domínio, conflitos terminológicos e contextos delimitados — produz uma colheita de substantivos para a camada de modelo conceitual.

O que é personal-website-v2?

Esta skill é projetada para mapear sistematicamente um domínio de negócios ou problema real, independentemente de qualquer produto específico. Ela guia o usuário através de fases como estruturação do domínio, levantamento de conceitos, mapeamento conceitual, auditoria de terminologia, identificação de contextos delimitados e colheita de substantivos. O objetivo principal é capturar a linguagem natural, contradições e relacionamentos do domínio sem tentar resolvê-los ou filtrá-los precocemente, servindo como matéria-prima para a construção de um modelo conceitual coerente. Suporta ambientes de desenvolvimento de IA, como Claude Code ou Cursor, e utiliza métodos como mapas conceituais em Mermaid, event storming e entrevistas com especialistas. A skill garante que contradições sejam documentadas como dados valiosos, sinônimos e polissemias sejam registrados, e que contextos delimitados sejam nomeados, preparando o terreno para decisões de design informadas na camada de modelo conceitual.

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

Perguntar na sua IA favorita

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

Documentação

/layers-domain

Pressupõe que /layers-intro foi carregado para contexto do framework.

A camada de domínio mapeia o que existe no mundo real, independentemente de qualquer produto: os conceitos, terminologia, processos, relacionamentos e modelos mentais que os usuários trazem consigo. Isto é observação, não design.

Distinção crítica: Não resolva contradições nesta camada. A linguagem de domínio contraditória, confusa e inconsistente são dados — eles sinalizam onde diferentes comunidades de usuários divergiram e onde o produto precisará fazer escolhas deliberadas. A resolução acontece na camada de modelo conceitual.

Decisões que esta camada precisa tomar:

  • Quais são os conceitos-chave neste domínio e como eles se relacionam?
  • Que linguagem as pessoas usam — e onde essa linguagem conflita ou diverge?
  • Onde estão as costuras naturais onde diferentes comunidades usam as mesmas palavras de forma diferente?
  • Que eventos e processos estruturam a atividade do domínio ao longo do tempo?

Métodos:

MétodoQuando
Mapas conceituais / diagramas de bolhasO domínio é complexo e mal compreendido. Nós e linhas informais mostram como os conceitos se relacionam sem forçar uma estrutura prematura.
Event storming de domínio (Brandolini)O domínio é intensivo em processos. Comece por coisas significativas que acontecem (passado) — eventos revelam costuras naturais.
Entrevistas com especialistasO conhecimento do domínio vive em pessoas, não em documentos. Conversas revelam conhecimento tácito e terminologia contestada.
Análise de documentos e artefatosO domínio produz artefatos (contratos, formulários, faturas) que revelam estrutura e vocabulário naturais.
Análise competitivaEntrando em um domínio estabelecido. Produtos existentes revelam como outros o modelaram — e onde discordam.
Observação (shadowing)O domínio envolve fluxos de trabalho difíceis de articular. Observar pessoas trabalhando revela o que elas realmente fazem.

Padrão: mapeamento conceitual e auditoria de terminologia.

Sinais de qualidade — como é o bom resultado:

  • Contradições são documentadas, não resolvidas
  • Sinônimos são registrados (mesma coisa, nomes diferentes)
  • Polissemia é sinalizada (mesmo nome, coisas diferentes em contextos diferentes)
  • Contextos delimitados são nomeados onde comunidades usam a linguagem de forma coerente dentro do seu grupo, mas inconsistente entre grupos
  • A colheita de substantivos é uma lista bruta completa de candidatos — não filtrada, não pré-organizada em objetos e atributos

Sessão guiada

Diga-me qual domínio você está mapeando e o que sabe sobre ele, ou diga "guia-me" para iniciar uma sessão estruturada.

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

Pergunte: "Você está trabalhando a partir de pesquisa e conhecimento de domínio, ou a partir do que a equipe atualmente acredita sobre o domínio?" Se estiver mapeando crenças, sinalize durante todo o processo que o que está sendo capturado é o modelo da equipe, não necessariamente como os usuários vivenciam o domínio.


Fase 1 — Enquadrar o domínio

  1. Qual domínio estamos mapeando? (O contexto do mundo real — não o produto.)
  2. Quem são as pessoas que operam neste domínio? (Papéis, tipos de usuário, stakeholders.)
  3. O que elas estão tentando realizar, antes do seu produto entrar em cena?

Continue redirecionando para o mundo real se as respostas tenderem para decisões de produto.

Fase 2 — Superficiar os conceitos

"Explique como [domínio] funciona. Quais são as principais coisas, como elas se relacionam, o que acontece?"

Ouça por substantivos (conceitos), verbos (processos) e vocabulário natural. Tome notas de tudo — bruto, sem filtro. Depois, provoque:

  • "Como as pessoas realmente chamam essas coisas? Múltiplos nomes para a mesma coisa?"
  • "Que regras existem — políticas explícitas ou convenções compreendidas?"
  • "O que muda ao longo do tempo? O que tem um ciclo de vida?"

Fase 3 — Mapa conceitual

Construa um mapa conceitual: nós conectados por relacionamentos rotulados. Informal — sem hierarquia ou orientação obrigatória; siga o que parece natural para o domínio. Em Mermaid: graph TD ou graph LR.

Pergunte: "Isso parece com o domínio, ou com um diagrama de banco de dados? O que está faltando ou errado?"

Fase 4 — Auditoria de terminologia

Para cada conceito: todos neste domínio usam esta palavra da mesma forma? Existem outras palavras para a mesma coisa? Esta palavra significa algo diferente em outro contexto?

Documente:

Conceito: [coisa]
Nomes usados: [todas as variantes]
Contexto: [quem usa qual e quando]
Tipo de conflito: sinônimos (mesma coisa, nomes diferentes) / polissemia (mesmo nome, coisas diferentes)

Não escolha um vencedor.

Fase 5 — Contextos delimitados

Observe os conflitos de terminologia: existem comunidades de pessoas que compartilham vocabulário internamente, mas divergem de outros grupos? Nomeie e descreva cada um. Essas costuras importarão quando o modelo conceitual for definido — o produto precisará decidir como navegar ou fazer a ponte entre elas.

Fase 6 — Eventos de domínio (opcional)

Se o domínio for intensivo em processos: "Quais são as coisas significativas que acontecem neste domínio? Nomeie-as no passado."

Liste eventos em uma linha do tempo. Pergunte o que desencadeia cada um e o que acontece como resultado. Objetos com eventos significativos ao redor deles provavelmente precisarão de diagramas de transição de estado na camada de modelo conceitual.

Fase 7 — Colheita de substantivos

Compile todos os substantivos superficiados na sessão. Marque cada um:

  • Objeto potencial — significativo independentemente, pode ter atributos e relacionamentos
  • Atributo potencial — uma propriedade de outra coisa
  • Incerto — precisa de mais reflexão

Não filtre agressivamente. A camada de modelo conceitual faz a triagem.


Conclusão

Produza:

  1. Mapa conceitual — Mermaid graph TD
  2. Conflitos de terminologia — variantes de nomes documentadas e contextos delimitados
  3. Eventos de domínio — se explorados, linha do tempo de eventos-chave
  4. Colheita de substantivos — lista completa de candidatos

Encerre com: "Este mapa de domínio é matéria-prima para o seu modelo conceitual. Execute /layers-conceptual-model para definir objetos, relacionamentos e vocabulário — a colheita de substantivos é o seu ponto de partida."

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

Habilidades Relacionadas