Communitygithub.com

ulasalyesil/personal-website-v2

Elicita e prioriza necessidades do usuário (necessidades, dores, desejos) como histórias de jobs — produz oportunidades prontas para a estratégia de produto.

O que é personal-website-v2?

Essa skill guia o processo de elicitação e priorização de necessidades dos usuários, transformando observações e conhecimento de domínio em oportunidades acionáveis para estratégia de produto. Utiliza o formato de Job Stories como padrão, mas também oferece suporte a User Stories, Análise de Top Tasks, Personas com Cenários e Resultados Desejados ODI. A skill cobre necessidades funcionais, emocionais e sociais, explicitamente pedindo por aquelas que normalmente são subarticuladas. Ela é útil para qualquer profissional de produto (Product Managers, Designers, Pesquisadores) que precisa garantir que as decisões de design e estratégia estejam fundamentadas em necessidades reais, validadas e priorizadas. Funciona em qualquer plataforma de IA que suporte skills, pois seu conteúdo é markdown estruturado, e o processo é iterativo: enquadrar usuários, elicitar necessidades, descobrir ocultas, desafiar/filtrar e priorizar. O resultado final inclui lista priorizada, necessidades não priorizadas, lacunas e contradições, prontas para alimentar a próxima skill de estratégia de produto.

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

Perguntar na sua IA favorita

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

Documentação

/layers-user-needs

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

Necessidades do usuário são o que achamos que os usuários estão tentando alcançar e por quê — uma interpretação baseada em comportamento observado e conhecimento de domínio, não uma captura direta da realidade. Esta camada fica entre o material bruto e confuso da observação e as decisões deliberadas do espaço da solução.

Em termos de OST, os resultados aqui são oportunidades: necessidades (o que os usuários querem alcançar), dores (o que causa atrito) e desejos (melhorias que eles valorizariam). Todos os três são entradas válidas; elicite todos os três.

Decisões que esta camada precisa tomar:

  • Quem exatamente são os usuários cujas necessidades estamos definindo — e em que situação?
  • Que jobs eles estão tentando realizar — funcionais, emocionais e sociais?
  • Quais necessidades são baseadas em evidências e quais são suposições?
  • Quais necessidades são mais importantes e por quê?

Métodos:

MétodoQuando
Job stories (JTBD)Padrão. Situação → motivação → resultado. Mantém soluções de fora; força especificidade através da cláusula "Quando".
User storiesA equipe prefere enquadramento baseado em papéis, ou integração com um fluxo Agile existente.
Análise de top tasks (Gerry McGovern)Grande base de usuários existente. Identificar quais tarefas mais importam por frequência. Estatístico, baseado em pesquisa.
Persona + cenárioComunicar a stakeholders que pensam em arquétipos. Bom para alinhamento; menos preciso para decisões de design.
Resultados desejados ODI (Ulwick)Declarações precisas e mensuráveis. Formato: "Minimizar [métrica] quando [contexto]." Mapeia diretamente para pontuação de oportunidade.

Padrão: job stories.

Três tipos de necessidade — elicite todos os três:

  • Funcional — a tarefa prática. Alimenta a estrutura de interação e o modelo conceitual diretamente.
  • Emocional — como o usuário quer se sentir ao executar o job. Alimenta a superfície (tom, texto, feedback).
  • Social — como o usuário quer ser percebido pelos outros neste contexto. Também alimenta a superfície; às vezes a estratégia.

Necessidades emocionais e sociais são cronicamente subarticuladas em briefings e relatórios de pesquisa, mesmo quando genuinamente moldam o comportamento. Perguntar por elas explicitamente é geralmente o que as traz à tona.

Sinais de qualidade — como é o bom resultado:

  • A cláusula "Quando" é específica o suficiente para imaginar o momento em que acontece
  • A motivação é um objetivo genuíno, não uma solução disfarçada
  • Dimensões funcionais, emocionais e sociais todas exploradas
  • Confiança marcada: observado / inferido / assumido
  • Workarounds revelados — uma necessidade real o suficiente para motivar improvisação é um sinal forte

Sessão guiada

Diga-me quem são seus usuários e no que você está trabalhando, ou diga "me guie" para iniciar uma sessão estruturada.

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

Pergunte: "Qual é a fonte das necessidades do usuário com as quais estamos trabalhando — pesquisa de usuário, conhecimento de domínio, suposições da equipe ou uma mistura?" Se estiver trabalhando a partir de suposições, marque-as claramente ao longo do processo e planeje validá-las.


Fase 1 — Enquadrar os usuários

  1. Quem são os usuários cujas necessidades estamos definindo? Seja específico — não "usuários", mas que tipo, em que situação.
  2. Em que contexto eles estão quando a necessidade relevante surge?
  3. Existe mais de um tipo de usuário distinto com necessidades significativamente diferentes? Trabalhe com eles separadamente.

Fase 2 — Elicitar necessidades

Trabalhe através das necessidades que o designer levanta. Formato: Quando [situação], quero [motivação], para que [resultado esperado].

A cláusula "Quando" é a parte mais importante — ela deve ser específica o suficiente para imaginar o momento. Pressione até que seja.

Para cada necessidade, pergunte: "Existe um job funcional aqui, um job emocional, um job social — ou todos os três?"

Investigue cada um:

  • Sobre "Quando": "Você consegue imaginar o momento em que isso acontece? É desencadeado por um evento, um sentimento, um ritmo ou um limite sendo ultrapassado?"
  • Sobre motivação: "Uma solução está se infiltrando? Por que isso é importante para eles? O que está em jogo se não for atendido?"
  • Sobre resultado esperado: "Como é o sucesso para o usuário — não para o produto?"

Fase 3 — Descobrir necessidades ocultas

  • "Que necessidades os usuários têm que o produto atualmente ignora?"
  • "O que os usuários fazem antes e depois do momento em que normalmente focamos?"
  • "O que os usuários precisam fazer que eles realmente gostariam de não precisar?"
  • "Que necessidade os usuários estão atualmente atendendo com um workaround — uma planilha, um e-mail — que um produto poderia servir melhor?"

Fase 4 — Desafiar e filtrar

Revise todas as necessidades juntas. Para cada uma:

  1. Necessidade ou solução? "Quando preciso de um relatório, quero exportar para CSV" é uma solução. Pressione para a necessidade subjacente.
  2. Específica o suficiente para projetar a partir dela? Uma necessidade tão ampla que qualquer recurso poderia atendê-la não é útil.
  3. Fundamentada? Marque: observado / inferido / assumido.
  4. Importante? Com que frequência esta situação surge? Quão doloroso é quando não é atendida?

Fase 5 — Priorizar

Ordenação aproximada: maior importância × pior atendida atualmente. Uma necessidade que importa muito e é mal atendida é uma oportunidade de alto valor. Uma necessidade que importa muito mas já é bem atendida não é.

Não complique demais isso. Priorização precisa é trabalho de estratégia em /layers-product-strategy. Um ranking aproximado é suficiente aqui.


Conclusão

Produza:

  1. Necessidades do usuário — lista final, em ordem de prioridade, com classificações de confiança (observado / inferido / assumido)
  2. Necessidades não priorizadas — levantadas mas não ranqueadas, para não serem perdidas
  3. Lacunas — necessidades provavelmente reais mas ainda não fundamentadas; perguntas de pesquisa a responder
  4. Contradições — se diferentes tipos de usuário têm necessidades conflitantes, nomeie-as explicitamente

Finalize com: "Estas necessidades são as oportunidades para sua estratégia de produto. Execute /layers-product-strategy para construir uma árvore de estratégia conectando-as a resultados de negócio e apostas de solução."

Se as necessidades são em sua maioria assumidas: "Várias delas estão marcadas como assumidas. Antes de construir estratégia com base nelas, considere executar /layers-observed-behaviour para coletar 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

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

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

Habilidades Relacionadas