Communitygithub.com

ulasalyesil/site-pessoal-v2

Mapeia a estrutura e o fluxo de interação — produz notação breadboard com casos extremos, caminhos de falha e decisões em aberto.

O que é site-pessoal-v2?

Esta skill, baseada no documento SKILL.md fornecido, guia o design de fluxos de interação para produtos digitais, adotando como abordagem padrão a técnica de **Breadboarding** (Ryan Singer, Shape Up). Ela define como mapear os lugares (telas/estados), as affordances (ações do usuário), o conteúdo apresentado e os caminhos de navegação, incluindo tratamento explícito de estados de falha, vazios e carregamento. A skill é útil para qualquer pessoa projetando interações (designers, PMs, desenvolvedores) e funciona em qualquer ferramenta que suporte notação de texto (como Mermaid para diagramas). O processo é dividido em fases: enquadramento do fluxo, identificação de lugares, mapeamento de affordances, simulação do fluxo (caminho feliz e bordas), desafio do fluxo e, por fim, geração da breadboard completa com diagrama e decisões em aberto. Ela enfatiza a importância de ter um modelo conceitual estável antes de definir o fluxo, evitando retrabalho.

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

Perguntar na sua IA favorita

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

Documentação

/camadas-fluxo-de-interacao

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

A camada de estrutura e fluxo de interação define como uma pessoa interage com o produto: os lugares que navega, as affordances disponíveis, o conteúdo apresentado e o fluxo entre estados. Ela fica acima do modelo conceitual (que define o que existe) e abaixo da superfície (que define como se parece).

Decisões que esta camada precisa tomar:

  • Quais são os lugares distintos por onde esse fluxo passa?
  • O que o usuário pode fazer em cada lugar e para onde cada ação o leva?
  • Qual conteúdo cada lugar precisa mostrar?
  • O que acontece em caminhos de falha, estados vazios e casos extremos?
  • O fluxo é tão simples quanto possível, ainda assim atendendo ao trabalho?

Métodos:

MétodoQuando usar
Breadboarding (Ryan Singer / Shape Up)Padrão para a maioria dos fluxos. Notação baseada em texto que força a lógica de interação a ser avaliada antes que o design visual torne as mudanças custosas.
Mapeamento de histórias de usuário (Jeff Patton)Produto complexo, muitos tipos de usuário, planejamento incremental. Mapeia atividades → tarefas → histórias em uma linha do tempo.
Análise de tarefasRedesenho de um fluxo existente. Decompor a tarefa atual para encontrar onde o atrito, erros e soluções alternativas se concentram.
Blueprint de serviçoFluxo que abrange vários canais ou envolve operações internas (equipe, sistemas, terceiros) que afetam a experiência do usuário.
Jornadas Críticas do Usuário (CUJs)Decidir em qual fluxo trabalhar. Uma CUJ é o caminho mínimo para realizar o valor central do produto — tipos: alto tráfego, alta receita ou crítico para métricas.

Padrão: breadboarding.

Notação Breadboard:

Nome do lugar
- affordance → lugar de destino
- affordance → lugar de destino
[ conteúdo mostrado neste lugar ]

Sinais de qualidade — como é o bom resultado:

  • Toda affordance tem um destino nomeado
  • Caminhos de falha são breadboardados — não deixados como reflexões tardias
  • Estados vazios, de carregamento e pós-ação estão definidos
  • Sem objetos quebrados — atributos e ações de um objeto estão disponíveis juntos, não espalhados por telas sem links entre si
  • Sem objetos isolados — relacionamentos do modelo conceitual estão visíveis e navegáveis no fluxo
  • O fluxo é mínimo: mais de 5 a 6 lugares para uma única história de trabalho é um sinal para procurar o que pode ser colapsado

Sessão guiada

Diga-me para qual jornada de usuário você está projetando, ou diga "me guie" para iniciar uma sessão de breadboarding.

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

Verifique a camada inferior: "Você tem um modelo conceitual — objetos, relacionamentos e vocabulário definidos — para trabalhar? Ou estamos projetando o fluxo sem um modelo estabelecido por baixo?" Fluxos construídos antes do modelo conceitual estar estável geralmente precisam ser revisitados.

Pergunte: "Para qual jornada de usuário ou história de trabalho estamos projetando?" Um breadboard é sempre para um usuário específico em uma situação específica realizando um trabalho específico.


Fase 1 — Enquadrar o fluxo

  1. Qual história de trabalho este fluxo atende?
  2. Onde o usuário começa? Em que situação ele está?
  3. Como é o sucesso — o que o usuário alcançou quando o fluxo é concluído?
  4. Novo fluxo, redesenho ou extensão de um fluxo existente?

Se for redesenho: descreva o fluxo atual primeiro, mesmo que superficialmente. Fluxos existentes revelam decisões já tomadas — algumas deliberadamente, muitas não.

Fase 2 — Identificar os lugares

"Quais são os lugares distintos — telas ou estados — por onde esse fluxo passa? Não pense em layout ainda. Apenas nomeie os lugares."

Pergunte: algum destes é o mesmo lugar em um estado diferente? Eles devem ser lugares separados ou um lugar com estados? Existem lugares em outras partes do produto aos quais este fluxo se conecta?

Nomear lugares é por si só uma decisão de design. Nomes descritivos e significativos para o usuário: "Painel de indicações" não "Página 3."

Fase 3 — Mapear affordances e conexões

Para cada lugar, examine o que o usuário pode fazer ali e para onde cada ação leva. Use a notação breadboard acima.

Para cada affordance: para onde exatamente isso vai? O que acontece se for bem-sucedido? Falhar? Está sempre disponível, ou apenas em certas condições?

Condições — quando as affordances estão ou não disponíveis — são frequentemente onde as reais decisões de design se escondem.

Fase 4 — Percorrer o fluxo

Narre como o usuário: "Sou um usuário que [situação da história de trabalho]. Chego em [lugar inicial]. Vejo [conteúdo]. Quero [motivação]. Então eu [affordance]..."

Percorra todo o caminho de sucesso. Em seguida, percorra as bordas:

  • Estados vazios: Como é este lugar antes de existir qualquer dado? Geralmente a primeira coisa que um novo usuário vê.
  • Estados de carregamento/assíncronos: O que o usuário vê enquanto os dados são buscados ou uma ação é processada?
  • Estado pós-ação: Após enviar, o que acontece? Ficar aqui, redirecionar, confirmação inline? Se redirecionado para uma lista — ela mostra a mudança imediatamente? Se houver atraso, pode parecer que a ação não funcionou?
  • Otimista vs. pessimista: Mostrar resultado assumido antes de o servidor confirmar, ou esperar? Declare a preferência; sinalize como uma questão em aberto nomeada se a implementação for incerta.
  • Caminhos de falha: Para cada ação — falha de validação, erro de servidor, desconexão de rede, timeout, edição concorrente. Para onde o usuário vai? Como ele se recupera? Estes são passos obrigatórios do breadboard.
  • Caminho de cancelamento: Se o usuário quiser parar no meio do caminho, para onde ele vai?
  • Pontos de entrada alternativos: O fluxo pressupõe um estado anterior que pode nem sempre ser verdadeiro?

Cada lacuna é uma decisão de design não tomada. Nomeie-a explicitamente.

Fase 5 — Desafiar o fluxo

  • Há uma etapa que os usuários provavelmente abandonarão? Por que ela está ali — é necessária?
  • Existem ações que os usuários esperariam e que o fluxo não oferece?
  • O vocabulário no fluxo corresponde à linguagem ubíqua do modelo conceitual?
  • Existe uma versão mais simples que atende ao mesmo trabalho?

Verificar objetos quebrados: Para cada objeto do modelo conceitual que aparece neste fluxo — seus atributos e ações estão disponíveis juntos, ou divididos entre telas sem links entre si? Se divididos, consolide ou adicione conexões explícitas entre os lugares onde suas partes aparecem.

Verificar objetos isolados: Para cada relacionamento definido no modelo conceitual — o fluxo torna esse relacionamento visível e navegável? Se um relacionamento existe no modelo, mas está invisível no fluxo, torne-o visível ou tome uma decisão deliberada de que ele não precisa ser navegável a partir deste fluxo.

Fase 6 — Gerar o breadboard

Produza o breadboard completo: todos os lugares, todas as affordances e destinos, conteúdo para cada lugar, principais estados condicionais anotados.

Gere um diagrama de fluxo na orientação da esquerda para a direita — o fluxo ao longo do tempo é lido da esquerda para a direita. Em Mermaid: graph LR.

Nota: o diagrama é para orientação — o breadboard em texto é o documento principal. O diagrama perde detalhes de conteúdo e condicionais.


Conclusão

Produza:

  1. História de trabalho — a necessidade do usuário que este fluxo atende
  2. Breadboard — notação de texto completa
  3. Diagrama de fluxo — Mermaid graph LR
  4. Decisões em aberto — lacunas, casos extremos, estados condicionais ainda não resolvidos
  5. Riscos — dependências de decisões não resolvidas do modelo conceitual ou suposições de superfície

Finalize com: "Este breadboard define a lógica de interação sem se comprometer com a forma visual. O que vier a seguir — trabalhar em código, construir no meio real ou design visual detalhado — certifique-se primeiro de que o modelo conceitual subjacente a este fluxo está estável."

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

Habilidades Relacionadas