Skip to content

evanca/flutter-ai-rules / skills/inclusive-design

inclusive-design

Verified

Use when working on inclusion, i18n/localization, global name/address forms, low-end devices, slow/metered networks, affordability, or first-time/low-confidence users; not WCAG/screen readers (see accessibility).

references/cognitive-load-and-wellbeing.md

View on GitHub
# Cognitive Load & Wellbeing

This is the *human-state* dimension of inclusion: the person using your product may be stressed, distracted, exhausted, anxious, grieving, new to the task, or simply low on mental energy today. None of that is a disability — it's the normal range of being human — and it changes from hour to hour. Designing for it is about respecting confidence, attention, and emotional state.

> Scope note: the *disability*-focused, pattern-level version of this material (for diagnosed cognitive and learning disabilities) lives in the **accessibility** skill's `cognitive-accessibility.md` (W3C COGA). This file is the inclusion-side framing: everyday cognitive load, motivation, and wellbeing for everyone.

## Mental state is in constant flux — for all of us

Source: [Inclusive Design for Cognition Guidebook — Microsoft](https://inclusive.microsoft.design/articles/inclusive-design-for-cognition-guidebook)

Microsoft defines cognition as "a range of mental processes that acquire, store, manipulate, and retrieve information," and stresses that everyone's cognitive capacity shifts with context: a task that is "entirely doable and even easy at a less stressful time" can feel impossible under stress. Cognitive diversity therefore "includes everyone, from people with diagnosed medical conditions to those in temporary situations."

The governing principle (attributed to Dr. Bruce Baker):

> "For any task to be successful, motivation must equal or surpass cognitive load."

So you have two levers on every screen: **lower the cognitive load**, and **protect the user's motivation**. The guidebook breaks cognitive demand into five types worth designing for:

- **Learning** — offer guidance *in each step*; don't make people leave the task to find help; don't assume prior knowledge.
- **Focus** — help people tune in and out as needed; respect the cost of interruption; support task-switching and sustained attention.
- **Decision-making** — make the critical factors and consequences of each choice clear (e.g., flag data loss or cost before it happens).
- **Recall** — don't assume people remember a task after doing it once; support the systems people use to place, remember, and find things; keep step-sequences short.
- **Communication** — adapt tone, frequency, and format over time (real-time tips for newcomers, fewer for experts) and offer multiple formats (visual *and* written).

## Protecting motivation and agency

Source: [Mental Health Guidebook — Microsoft](https://inclusive.microsoft.design/articles/mental-health-guidebook)

The emotional stakes are real:

> "When we fail to help people feel successful and in control, they frequently blame themselves. This emotional state can reduce motivation, focus, and interest."

And capacity genuinely fluctuates: "a task may feel impossible at the moment, but it is doable once the stress has passed." The design job is to meet people on their lowest-capacity day, not their best. Concrete moves, grouped as Microsoft does:

**Preserve** (protect attention and motivation)
- "Ensure notifications are controllable, actionable, succinct, and relevant to the task." Unregulated notification disruption is "detrimental to cognition and mental health."
- "Celebrate small wins!" — helping people feel good about themselves and the product maintains motivation.
- Support clear navigation, minimal interruptions, and reduced complexity.

**Direct** (lower the path's difficulty)
- "Track progress and make next steps easy to identify and complete."
- "Surface settings within the flow" so people don't have to hunt.
- "Provide predictable ways for people to find additional support."

**Customize** (give control back to the user)
- "Allow people to retain preferences across sessions."
- "Provide options for readability and appearance."
- "Introduce new features contextually" rather than dumping everything at once.

## How to apply this in a review

1. **Find the highest-load moment** in the flow (a long form, a multi-step decision, a setup wizard) and cut steps, defer non-essential choices, and remove anything the user must hold in memory between screens.
2. **Audit interruptions.** Is every notification, modal, and tooltip earning its place? Can the user control them?
3. **Check the failure path.** When something goes wrong, does the design blame the user or help them recover calmly? Replace dead-ends and scolding copy with a clear, reassuring way forward.
4. **Give control.** Can people save progress, change their mind, adjust appearance, and keep those preferences? Agency is what turns a stressful tool into a usable one.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall