[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6JW7C7W5APAHE7RZQE23MB5":3,"skill-same:01M6JW7C7W5APAHE7RZQE23MB5":80},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":45,"linkOnly":46,"markdownContent":47,"markdownBody":48,"frontMatter":49,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":55,"ownerHtmlUrl":56,"ownerBlogUrl":57,"ownerDescription":58,"updatedAt":59,"install":60,"resources":73},"01M6JW7C7W5APAHE7RZQE23MB5","feedback-loop",null,"Use this skill whenever a user takes an action and the system must communicate that the action was received, is in progress, succeeded, or failed. Trigger when designing button states, form submission, file uploads, payment flows, real-time UI updates, loading states, error states, success confirmations, or any moment when the user is waiting for the system to do something. Trigger when the user mentions \"feels broken,\" \"doesn't seem to work,\" \"users keep clicking again,\" or any symptom of feedback gaps. Feedback Loop is one of the foundational principles in 'Universal Principles of Design' (Lidwell, Holden, Butler 2003) — and one of the principles whose absence most reliably damages a product's perceived quality.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FHDeibler\u002Funiversal-design-principles\u002Fplugins\u002Finteraction-and-control-principles\u002Fskills\u002Ffeedback-loop\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000032","设计师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44],"feedback loop","loop","feedback","butler","when","updates","action","flows","loading","states","error","form","progress","design","time","do","broken","work","file uploads","ui","product","2026-11-10 10:12:30",false,"---\nname: feedback-loop\ndescription: 'Use this skill whenever a user takes an action and the system must communicate that the action was received, is in progress, succeeded, or failed. Trigger when designing button states, form submission, file uploads, payment flows, real-time UI updates, loading states, error states, success confirmations, or any moment when the user is waiting for the system to do something. Trigger when the user mentions \"feels broken,\" \"doesn''t seem to work,\" \"users keep clicking again,\" or any symptom of feedback gaps. Feedback Loop is one of the foundational principles in ''Universal Principles of Design'' (Lidwell, Holden, Butler 2003) — and one of the principles whose absence most reliably damages a product''s perceived quality.'\n---\n\n# Feedback Loop\n\nA feedback loop is the relationship between an action and the visible response that confirms the action happened. Every system in nature is composed of interacting feedback loops; every interface is too. When users press a button, type a character, drag an item, or commit a transaction, the system must respond — promptly, visibly, and unambiguously — to close the loop. Without that response, the user doesn't know whether the action registered, whether the system is working, or whether to try again. The cumulative effect of weak feedback is a product that feels broken even when it isn't.\n\n## Definition (in our own words)\n\nA feedback loop in interaction design is the mechanism by which the system tells the user \"I received your action and here's what's happening.\" Loops can be *positive* (amplifying — repeated actions create accelerating change, like clicking a \"+1\" button that animates and grows the count) or *negative* (dampening — bringing the system back to a stable state, like a thermostat or a Segway maintaining balance). The most important loops in product UI are usually negative: the user acts; the system confirms; equilibrium is restored. When loops are missing or delayed, users repeat actions, doubt the system, or assume failure.\n\n## Origins and research lineage\n\n- **Cybernetics** (Norbert Wiener, 1948 onward). The mathematical theory of feedback in systems — biological, mechanical, and social. The intellectual foundation for everything that follows in HCI feedback design.\n- **Jay W. Forrester**, *Industrial Dynamics* (MIT Press, 1961) and *Urban Dynamics* (1969). Applied feedback-loop thinking to organizational and urban systems. Introduced the diagrams (causal loop diagrams, stock-and-flow diagrams) still used in systems analysis.\n- **Donald Norman**, *The Design of Everyday Things* (1988). Made feedback one of the central UI principles. Norman's gulf of evaluation — the gap between the user's intent and the system's perceptible state — is essentially the absence of good feedback.\n- **Lidwell, Holden & Butler** (2003) compactly distinguished positive feedback loops (amplifying — useful for change but risky if unmoderated) from negative feedback loops (stabilizing — useful for equilibrium). The book's central case: 1950s football helmets that created a positive feedback loop (more padding → more risk-taking → more injuries → more padding).\n- **Modern HCI heuristics** (Nielsen's 10 heuristics, 1994 onward). \"Visibility of system status\" — the first of Nielsen's 10 — is essentially the feedback principle named for usability practice.\n- **Doherty Threshold** (Doherty & Thadani, IBM, 1982). Empirical research showing that response times under 400ms keep users in flow; longer delays break engagement.\n\n## Why feedback matters\n\nEvery interaction is a tacit contract: the user gives an input expecting some response. Without the response, the user is left in ambiguity. They may:\n\n- **Repeat the action** (clicking again, typing again, refreshing). Often produces unintended duplicate effects.\n- **Doubt their input** (\"did I press it hard enough?\", \"did it register?\").\n- **Assume system failure** and abandon.\n- **Develop ritualistic habits** (always pressing twice, always checking twice).\n- **Stop trusting the system**.\n\nThe cost compounds: each weak feedback moment is a small tax; thousands of moments across a product become a perception of unreliability that no individual feature can repair.\n\nThe reverse is also true: tight, unambiguous feedback creates confidence. The user acts, sees the system respond, and feels in command. This is what well-engineered software feels like — at the perceptual level, before the user evaluates any specific feature.\n\n## Positive vs. negative feedback loops\n\nThe book's distinction matters in practice:\n\n### Positive feedback loops (amplifying)\n\nThe system's response to an action makes future similar actions more likely or more impactful. Examples:\n\n- **Recommendation engines**: a user clicks a recommendation; the system learns and shows more like it; the user clicks more; the system learns more. Eventually homogeneous content; \"filter bubble\" risk.\n- **Streak counters**: each consecutive day of use makes the user more invested in not missing a day. Engagement amplifies.\n- **Viral product growth**: each new user invites others; each invitation creates more new users. Exponential growth — when it works.\n\nPositive loops produce change, sometimes dramatic. Without moderation by a counter-loop, they run away (the football-helmet example: more padding → more risk-taking → more injuries → more padding).\n\n### Negative feedback loops (stabilizing)\n\nThe system's response brings things back toward an equilibrium. Examples:\n\n- **Form validation**: the user enters invalid input; the system flags it; the user corrects; equilibrium restored.\n- **Auto-save indicator**: \"Saving...\" → \"Saved.\" Each save resets the system to a known-good state.\n- **Undo systems**: the user takes an action; if it's wrong, undo restores prior state.\n- **Real-time spell-check**: a typo creates instability; correcting restores it.\n\nMost product UI feedback is negative — the system absorbs user actions and returns to stability. Designs that lean too heavily on positive loops (gamification, streak anxiety, dopamine engineering) cross into manipulation.\n\n## When to apply\n\n- **Always**, on every interactive element. Every button, link, input, drag handle, toggle needs feedback.\n- **Especially** on actions whose result isn't immediately visible (background operations, server requests, multi-step flows).\n- **Critically** on destructive or irreversible actions where the user must know the action committed.\n- **Real-time** on continuous operations (drag, resize, scroll).\n- **Asynchronously** when the action's effect is delivered later (notifications, scheduled tasks).\n\n## Latency thresholds\n\nHow fast feedback must appear depends on what's responding. The widely-cited thresholds (Miller 1968; Card, Robertson, Mackinlay 1991):\n\n- **\u003C 100ms**: feels instant. No spinner needed; the user perceives immediate response.\n- **\u003C 1 second**: feels responsive. No spinner needed unless something visible is taking time. The user maintains flow.\n- **1–10 seconds**: needs a visible indicator. Spinner, progress bar, status text. The user notices the wait.\n- **> 10 seconds**: needs progress information (estimated time remaining, percentage complete). The user is likely to abandon if the wait isn't justified.\n\nThe Doherty threshold (Doherty & Thadani, 1982) refined the \u003C 400ms range as the boundary at which response time stops feeling natural.\n\n## When NOT to over-apply\n\n- **Trivial confirmations.** Don't show \"Loading...\" for a 50ms response. The flicker is worse than no indicator.\n- **Continuous indicators that fight content.** A spinner that animates over the user's reading content is distracting. Place indicators in the periphery.\n- **Feedback for actions the user didn't take.** Auto-save indicators that appear without user input clutter the UI.\n- **Excessive haptic \u002F sound feedback.** Each tap doesn't need to vibrate. Reserve haptics for moments that matter.\n\n## The four states of action feedback\n\nMost interactive actions have four states the system must communicate:\n\n### 1. Idle (resting)\n\nThe element is interactive and ready. Affordance says \"you can do this.\" Static styling.\n\n### 2. Pending (in progress)\n\nThe action was triggered; the system is working. Common patterns:\n\n- **Disable the trigger** to prevent double-submission.\n- **Spinner or loading indicator** if the wait is > ~500ms.\n- **Button text changes** to \"Saving...\", \"Sending...\", \"Loading...\"\n- **Skeleton placeholder** for content that will fill in.\n\n```html\n\u003Cbutton id=\"save\" type=\"submit\">\n  \u003Cspan class=\"label\">Save\u003C\u002Fspan>\n  \u003Cspan class=\"spinner\" hidden>\u003C\u002Fspan>\n\u003C\u002Fbutton>\n\n\u003Cscript>\nconst btn = document.getElementById('save');\nbtn.addEventListener('click', async () => {\n  btn.disabled = true;\n  btn.querySelector('.label').textContent = 'Saving...';\n  btn.querySelector('.spinner').hidden = false;\n  try {\n    await save();\n    showSuccess();\n  } catch (err) {\n    showError(err);\n  } finally {\n    btn.disabled = false;\n    btn.querySelector('.label').textContent = 'Save';\n    btn.querySelector('.spinner').hidden = true;\n  }\n});\n\u003C\u002Fscript>\n```\n\n### 3. Success\n\nThe action succeeded. The result should be visible — preferably in-place (the row appears, the value updates) rather than via a generic \"Saved!\" toast that the user must trust.\n\nWhen in-place feedback isn't possible (the action's effect is on another page or in a backend), use a toast or banner with specific content (\"Invoice #1284 sent to maria@acme.com\").\n\n### 4. Error\n\nThe action failed. Feedback must be:\n- **In-context** with the field or element that caused the error (not a generic top-of-page banner the user might miss).\n- **Specific** about what went wrong.\n- **Actionable** — what can the user do to recover.\n\n```html\n\u003Cdiv class=\"field\" data-state=\"error\">\n  \u003Clabel for=\"email\">Email\u003C\u002Flabel>\n  \u003Cinput id=\"email\" type=\"email\" aria-invalid=\"true\" aria-describedby=\"email-error\" \u002F>\n  \u003Cp id=\"email-error\" class=\"error-message\">\n    We couldn't find an account with this email. \u003Ca href=\"\u002Fsignup\">Sign up?\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n```\n\n## Worked examples\n\n### Example 1: a form-submit button with all four states\n\n```html\n\u003Cform id=\"signup-form\">\n  \u003Cinput name=\"email\" type=\"email\" required \u002F>\n  \u003Cinput name=\"password\" type=\"password\" required \u002F>\n  \u003Cbutton id=\"submit\">Create account\u003C\u002Fbutton>\n  \u003Cp id=\"status\" aria-live=\"polite\">\u003C\u002Fp>\n\u003C\u002Fform>\n\n\u003Cscript>\nconst form = document.getElementById('signup-form');\nconst btn = document.getElementById('submit');\nconst status = document.getElementById('status');\n\nform.addEventListener('submit', async (e) => {\n  e.preventDefault();\n  \u002F\u002F Pending state\n  btn.disabled = true;\n  btn.textContent = 'Creating account...';\n  status.textContent = '';\n  try {\n    await createAccount(new FormData(form));\n    \u002F\u002F Success state\n    status.textContent = 'Account created! Redirecting...';\n    setTimeout(() => location.href = '\u002Fwelcome', 1500);\n  } catch (err) {\n    \u002F\u002F Error state\n    btn.disabled = false;\n    btn.textContent = 'Create account';\n    status.textContent = `Couldn't create account: ${err.message}`;\n  }\n});\n\u003C\u002Fscript>\n```\n\nFour states; user is never left wondering what happened.\n\n### Example 2: optimistic UI update with rollback on failure\n\n```js\nasync function archive(item) {\n  \u002F\u002F Optimistic: update UI immediately\n  const previous = items.slice();\n  items = items.filter(i => i.id !== item.id);\n  render();\n\n  try {\n    await api.archive(item.id);\n    \u002F\u002F Implicit success — UI already reflects new state\n  } catch (err) {\n    \u002F\u002F Rollback + error feedback\n    items = previous;\n    render();\n    showToast(`Archive failed: ${err.message}`);\n  }\n}\n```\n\nThe UI feels instant; failure rolls back visibly with explicit feedback.\n\n### Example 3: long-running task with progress\n\n```html\n\u003Cdiv class=\"upload\">\n  \u003Cp>Uploading \u003Cstrong>vacation-photos.zip\u003C\u002Fstrong>\u003C\u002Fp>\n  \u003Cprogress max=\"100\" value=\"0\" id=\"upload-progress\">0%\u003C\u002Fprogress>\n  \u003Cp id=\"upload-status\">Preparing upload...\u003C\u002Fp>\n  \u003Cbutton id=\"cancel\">Cancel\u003C\u002Fbutton>\n\u003C\u002Fdiv>\n\n\u003Cscript>\nasync function uploadWithProgress(file) {\n  const progress = document.getElementById('upload-progress');\n  const status = document.getElementById('upload-status');\n  const startTime = Date.now();\n\n  await uploadFile(file, {\n    onProgress: ({ loaded, total }) => {\n      const pct = Math.round(loaded \u002F total * 100);\n      progress.value = pct;\n      const elapsed = (Date.now() - startTime) \u002F 1000;\n      const rate = loaded \u002F elapsed; \u002F\u002F bytes\u002Fsec\n      const remaining = (total - loaded) \u002F rate;\n      status.textContent = `${pct}% — ${formatTime(remaining)} remaining`;\n    }\n  });\n  status.textContent = 'Upload complete.';\n}\n\u003C\u002Fscript>\n```\n\nLong-running task gets full progress feedback, including estimated time.\n\n### Example 4: real-time editing feedback\n\n```html\n\u003Ctextarea id=\"post-body\" oninput=\"autoSave()\">\u003C\u002Ftextarea>\n\u003Cp id=\"save-status\" aria-live=\"polite\">All changes saved\u003C\u002Fp>\n\n\u003Cscript>\nlet saveTimeout;\nlet lastSaved = new Date();\n\nfunction autoSave() {\n  const status = document.getElementById('save-status');\n  status.textContent = 'Editing...';\n\n  clearTimeout(saveTimeout);\n  saveTimeout = setTimeout(async () => {\n    status.textContent = 'Saving...';\n    await api.savePost({ body: document.getElementById('post-body').value });\n    lastSaved = new Date();\n    status.textContent = `Saved at ${formatTime(lastSaved)}`;\n  }, 800);\n}\n\u003C\u002Fscript>\n```\n\nThree states (editing, saving, saved) all visible. User knows the system is tracking their work.\n\n## Cross-domain examples\n\n### Industrial control: the Segway\n\nLidwell, Holden, and Butler use the Segway as the example of a tightly-tuned negative feedback loop: the rider leans forward; the gyroscope detects the angle change; the motor adjusts wheel speed to maintain balance. This loop runs ~100 times per second. Coarser loops would produce visible oscillation; finer would be wasteful.\n\nThe lesson for software: feedback frequency matches the dynamics of the user's actions. Real-time interactions need real-time feedback; slower actions can have slower feedback.\n\n### Aviation: stall warning systems\n\nA pilot pulling back on the yoke too aggressively gets immediate negative feedback: a stall warning horn, a stick-shaker, a yoke pusher. Each progressively forceful — early warnings let the pilot self-correct; late ones force correction. The graduated feedback gives the pilot agency at every level of urgency.\n\nSoftware analog: progressive validation. Soft inline hint → warning → block on submit → confirmation dialog for destructive.\n\n### Football helmets (the book's case)\n\nThe classic positive-feedback-loop failure: in the 1950s, plastic-with-padding helmets replaced leather. Players felt safer; tackled more aggressively; head\u002Fneck injuries rose. Designers responded by adding more padding; players became even more aggressive; injuries rose further. The loop wasn't moderated by rules against helmet-first tackling until decades later.\n\nThe lesson for software: positive loops without counter-mechanisms produce unintended consequences. A feature that drives engagement may drive it past the user's actual welfare; metrics that look good at first may create harms over time.\n\n### Thermostats\n\nThe canonical example of a negative feedback loop. Too warm → cooling activates → temperature drops → cooling deactivates → temperature drifts up → cycle. The system maintains equilibrium without continuous user input.\n\nUI analog: any system that absorbs user actions and returns to a stable state — auto-save, undo, drift-corrected forms.\n\n## Anti-patterns\n\n- **Silent commits.** A button that submits a form with no visible response. Users click again; double-submission.\n- **Blink-and-miss feedback.** A success message that appears for 100ms before vanishing. Users miss it; doubt the action.\n- **Generic error messages.** \"Something went wrong.\" User doesn't know what or how to fix.\n- **Wrong-channel feedback.** Errors as toasts that vanish; success as banners that linger. Mismatched persistence.\n- **No pending state.** Clicking save and seeing nothing for 3 seconds before the page refreshes. User clicks again.\n- **Spam confirmations.** Every routine action gets a \"Done!\" toast. User dismisses everything on autopilot.\n- **Decorative spinners.** A spinner that's not actually waiting on anything (purely visual). User loses trust when they realize.\n- **Hover-only feedback.** A button that only responds visually on hover. Touch users see no response on tap.\n\n## Heuristics\n\n1. **The \"did it work?\" test.** After any interaction, ask: can the user tell whether the action succeeded? If they have to guess, feedback is missing.\n2. **The double-click audit.** Watch users. Each unintended double-click is feedback that pending state was invisible.\n3. **The error-message audit.** Every error message in the app should answer: what happened, why, what to do next.\n4. **The latency-threshold check.** For each action, time it. Actions over 1s need a pending indicator; over 10s need progress info.\n5. **The accessibility check.** Visual feedback alone fails screen-reader users. Pair with `aria-live` regions for status changes.\n\n## Related principles\n\n- **`affordance`** — feedback completes the loop affordance starts.\n- **`forgiveness`** — feedback enables the recovery forgiveness depends on.\n- **`errors`** — error feedback is the most consequential feedback type.\n- **`mapping`** — feedback should map to the action that caused it.\n- **`expectation-effect`** — feedback that violates expectation creates surprise; align it.\n- **`accessibility-perceivable`** (process) — feedback must be perceivable across abilities.\n\n## Sub-aspect skills\n\n- **`feedback-loop-states-and-latency`** — designing the four states (idle, pending, success, error) and matching feedback to time thresholds.\n- **`feedback-loop-positive-vs-negative`** — choosing between amplifying and stabilizing loop architectures.\n\n## Closing\n\nFeedback is the principle that decides whether your product *feels* responsive. Every interaction that lacks visible response erodes trust at a perceptual level no specific feature can repair. Build feedback into every interactive element from the start; audit every \"is this working?\" complaint as a feedback gap; treat the four states as non-negotiable for any consequential action.\n","# Feedback Loop\n\nA feedback loop is the relationship between an action and the visible response that confirms the action happened. Every system in nature is composed of interacting feedback loops; every interface is too. When users press a button, type a character, drag an item, or commit a transaction, the system must respond — promptly, visibly, and unambiguously — to close the loop. Without that response, the user doesn't know whether the action registered, whether the system is working, or whether to try again. The cumulative effect of weak feedback is a product that feels broken even when it isn't.\n\n## Definition (in our own words)\n\nA feedback loop in interaction design is the mechanism by which the system tells the user \"I received your action and here's what's happening.\" Loops can be *positive* (amplifying — repeated actions create accelerating change, like clicking a \"+1\" button that animates and grows the count) or *negative* (dampening — bringing the system back to a stable state, like a thermostat or a Segway maintaining balance). The most important loops in product UI are usually negative: the user acts; the system confirms; equilibrium is restored. When loops are missing or delayed, users repeat actions, doubt the system, or assume failure.\n\n## Origins and research lineage\n\n- **Cybernetics** (Norbert Wiener, 1948 onward). The mathematical theory of feedback in systems — biological, mechanical, and social. The intellectual foundation for everything that follows in HCI feedback design.\n- **Jay W. Forrester**, *Industrial Dynamics* (MIT Press, 1961) and *Urban Dynamics* (1969). Applied feedback-loop thinking to organizational and urban systems. Introduced the diagrams (causal loop diagrams, stock-and-flow diagrams) still used in systems analysis.\n- **Donald Norman**, *The Design of Everyday Things* (1988). Made feedback one of the central UI principles. Norman's gulf of evaluation — the gap between the user's intent and the system's perceptible state — is essentially the absence of good feedback.\n- **Lidwell, Holden & Butler** (2003) compactly distinguished positive feedback loops (amplifying — useful for change but risky if unmoderated) from negative feedback loops (stabilizing — useful for equilibrium). The book's central case: 1950s football helmets that created a positive feedback loop (more padding → more risk-taking → more injuries → more padding).\n- **Modern HCI heuristics** (Nielsen's 10 heuristics, 1994 onward). \"Visibility of system status\" — the first of Nielsen's 10 — is essentially the feedback principle named for usability practice.\n- **Doherty Threshold** (Doherty & Thadani, IBM, 1982). Empirical research showing that response times under 400ms keep users in flow; longer delays break engagement.\n\n## Why feedback matters\n\nEvery interaction is a tacit contract: the user gives an input expecting some response. Without the response, the user is left in ambiguity. They may:\n\n- **Repeat the action** (clicking again, typing again, refreshing). Often produces unintended duplicate effects.\n- **Doubt their input** (\"did I press it hard enough?\", \"did it register?\").\n- **Assume system failure** and abandon.\n- **Develop ritualistic habits** (always pressing twice, always checking twice).\n- **Stop trusting the system**.\n\nThe cost compounds: each weak feedback moment is a small tax; thousands of moments across a product become a perception of unreliability that no individual feature can repair.\n\nThe reverse is also true: tight, unambiguous feedback creates confidence. The user acts, sees the system respond, and feels in command. This is what well-engineered software feels like — at the perceptual level, before the user evaluates any specific feature.\n\n## Positive vs. negative feedback loops\n\nThe book's distinction matters in practice:\n\n### Positive feedback loops (amplifying)\n\nThe system's response to an action makes future similar actions more likely or more impactful. Examples:\n\n- **Recommendation engines**: a user clicks a recommendation; the system learns and shows more like it; the user clicks more; the system learns more. Eventually homogeneous content; \"filter bubble\" risk.\n- **Streak counters**: each consecutive day of use makes the user more invested in not missing a day. Engagement amplifies.\n- **Viral product growth**: each new user invites others; each invitation creates more new users. Exponential growth — when it works.\n\nPositive loops produce change, sometimes dramatic. Without moderation by a counter-loop, they run away (the football-helmet example: more padding → more risk-taking → more injuries → more padding).\n\n### Negative feedback loops (stabilizing)\n\nThe system's response brings things back toward an equilibrium. Examples:\n\n- **Form validation**: the user enters invalid input; the system flags it; the user corrects; equilibrium restored.\n- **Auto-save indicator**: \"Saving...\" → \"Saved.\" Each save resets the system to a known-good state.\n- **Undo systems**: the user takes an action; if it's wrong, undo restores prior state.\n- **Real-time spell-check**: a typo creates instability; correcting restores it.\n\nMost product UI feedback is negative — the system absorbs user actions and returns to stability. Designs that lean too heavily on positive loops (gamification, streak anxiety, dopamine engineering) cross into manipulation.\n\n## When to apply\n\n- **Always**, on every interactive element. Every button, link, input, drag handle, toggle needs feedback.\n- **Especially** on actions whose result isn't immediately visible (background operations, server requests, multi-step flows).\n- **Critically** on destructive or irreversible actions where the user must know the action committed.\n- **Real-time** on continuous operations (drag, resize, scroll).\n- **Asynchronously** when the action's effect is delivered later (notifications, scheduled tasks).\n\n## Latency thresholds\n\nHow fast feedback must appear depends on what's responding. The widely-cited thresholds (Miller 1968; Card, Robertson, Mackinlay 1991):\n\n- **\u003C 100ms**: feels instant. No spinner needed; the user perceives immediate response.\n- **\u003C 1 second**: feels responsive. No spinner needed unless something visible is taking time. The user maintains flow.\n- **1–10 seconds**: needs a visible indicator. Spinner, progress bar, status text. The user notices the wait.\n- **> 10 seconds**: needs progress information (estimated time remaining, percentage complete). The user is likely to abandon if the wait isn't justified.\n\nThe Doherty threshold (Doherty & Thadani, 1982) refined the \u003C 400ms range as the boundary at which response time stops feeling natural.\n\n## When NOT to over-apply\n\n- **Trivial confirmations.** Don't show \"Loading...\" for a 50ms response. The flicker is worse than no indicator.\n- **Continuous indicators that fight content.** A spinner that animates over the user's reading content is distracting. Place indicators in the periphery.\n- **Feedback for actions the user didn't take.** Auto-save indicators that appear without user input clutter the UI.\n- **Excessive haptic \u002F sound feedback.** Each tap doesn't need to vibrate. Reserve haptics for moments that matter.\n\n## The four states of action feedback\n\nMost interactive actions have four states the system must communicate:\n\n### 1. Idle (resting)\n\nThe element is interactive and ready. Affordance says \"you can do this.\" Static styling.\n\n### 2. Pending (in progress)\n\nThe action was triggered; the system is working. Common patterns:\n\n- **Disable the trigger** to prevent double-submission.\n- **Spinner or loading indicator** if the wait is > ~500ms.\n- **Button text changes** to \"Saving...\", \"Sending...\", \"Loading...\"\n- **Skeleton placeholder** for content that will fill in.\n\n```html\n\u003Cbutton id=\"save\" type=\"submit\">\n  \u003Cspan class=\"label\">Save\u003C\u002Fspan>\n  \u003Cspan class=\"spinner\" hidden>\u003C\u002Fspan>\n\u003C\u002Fbutton>\n\n\u003Cscript>\nconst btn = document.getElementById('save');\nbtn.addEventListener('click', async () => {\n  btn.disabled = true;\n  btn.querySelector('.label').textContent = 'Saving...';\n  btn.querySelector('.spinner').hidden = false;\n  try {\n    await save();\n    showSuccess();\n  } catch (err) {\n    showError(err);\n  } finally {\n    btn.disabled = false;\n    btn.querySelector('.label').textContent = 'Save';\n    btn.querySelector('.spinner').hidden = true;\n  }\n});\n\u003C\u002Fscript>\n```\n\n### 3. Success\n\nThe action succeeded. The result should be visible — preferably in-place (the row appears, the value updates) rather than via a generic \"Saved!\" toast that the user must trust.\n\nWhen in-place feedback isn't possible (the action's effect is on another page or in a backend), use a toast or banner with specific content (\"Invoice #1284 sent to maria@acme.com\").\n\n### 4. Error\n\nThe action failed. Feedback must be:\n- **In-context** with the field or element that caused the error (not a generic top-of-page banner the user might miss).\n- **Specific** about what went wrong.\n- **Actionable** — what can the user do to recover.\n\n```html\n\u003Cdiv class=\"field\" data-state=\"error\">\n  \u003Clabel for=\"email\">Email\u003C\u002Flabel>\n  \u003Cinput id=\"email\" type=\"email\" aria-invalid=\"true\" aria-describedby=\"email-error\" \u002F>\n  \u003Cp id=\"email-error\" class=\"error-message\">\n    We couldn't find an account with this email. \u003Ca href=\"\u002Fsignup\">Sign up?\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n```\n\n## Worked examples\n\n### Example 1: a form-submit button with all four states\n\n```html\n\u003Cform id=\"signup-form\">\n  \u003Cinput name=\"email\" type=\"email\" required \u002F>\n  \u003Cinput name=\"password\" type=\"password\" required \u002F>\n  \u003Cbutton id=\"submit\">Create account\u003C\u002Fbutton>\n  \u003Cp id=\"status\" aria-live=\"polite\">\u003C\u002Fp>\n\u003C\u002Fform>\n\n\u003Cscript>\nconst form = document.getElementById('signup-form');\nconst btn = document.getElementById('submit');\nconst status = document.getElementById('status');\n\nform.addEventListener('submit', async (e) => {\n  e.preventDefault();\n  \u002F\u002F Pending state\n  btn.disabled = true;\n  btn.textContent = 'Creating account...';\n  status.textContent = '';\n  try {\n    await createAccount(new FormData(form));\n    \u002F\u002F Success state\n    status.textContent = 'Account created! Redirecting...';\n    setTimeout(() => location.href = '\u002Fwelcome', 1500);\n  } catch (err) {\n    \u002F\u002F Error state\n    btn.disabled = false;\n    btn.textContent = 'Create account';\n    status.textContent = `Couldn't create account: ${err.message}`;\n  }\n});\n\u003C\u002Fscript>\n```\n\nFour states; user is never left wondering what happened.\n\n### Example 2: optimistic UI update with rollback on failure\n\n```js\nasync function archive(item) {\n  \u002F\u002F Optimistic: update UI immediately\n  const previous = items.slice();\n  items = items.filter(i => i.id !== item.id);\n  render();\n\n  try {\n    await api.archive(item.id);\n    \u002F\u002F Implicit success — UI already reflects new state\n  } catch (err) {\n    \u002F\u002F Rollback + error feedback\n    items = previous;\n    render();\n    showToast(`Archive failed: ${err.message}`);\n  }\n}\n```\n\nThe UI feels instant; failure rolls back visibly with explicit feedback.\n\n### Example 3: long-running task with progress\n\n```html\n\u003Cdiv class=\"upload\">\n  \u003Cp>Uploading \u003Cstrong>vacation-photos.zip\u003C\u002Fstrong>\u003C\u002Fp>\n  \u003Cprogress max=\"100\" value=\"0\" id=\"upload-progress\">0%\u003C\u002Fprogress>\n  \u003Cp id=\"upload-status\">Preparing upload...\u003C\u002Fp>\n  \u003Cbutton id=\"cancel\">Cancel\u003C\u002Fbutton>\n\u003C\u002Fdiv>\n\n\u003Cscript>\nasync function uploadWithProgress(file) {\n  const progress = document.getElementById('upload-progress');\n  const status = document.getElementById('upload-status');\n  const startTime = Date.now();\n\n  await uploadFile(file, {\n    onProgress: ({ loaded, total }) => {\n      const pct = Math.round(loaded \u002F total * 100);\n      progress.value = pct;\n      const elapsed = (Date.now() - startTime) \u002F 1000;\n      const rate = loaded \u002F elapsed; \u002F\u002F bytes\u002Fsec\n      const remaining = (total - loaded) \u002F rate;\n      status.textContent = `${pct}% — ${formatTime(remaining)} remaining`;\n    }\n  });\n  status.textContent = 'Upload complete.';\n}\n\u003C\u002Fscript>\n```\n\nLong-running task gets full progress feedback, including estimated time.\n\n### Example 4: real-time editing feedback\n\n```html\n\u003Ctextarea id=\"post-body\" oninput=\"autoSave()\">\u003C\u002Ftextarea>\n\u003Cp id=\"save-status\" aria-live=\"polite\">All changes saved\u003C\u002Fp>\n\n\u003Cscript>\nlet saveTimeout;\nlet lastSaved = new Date();\n\nfunction autoSave() {\n  const status = document.getElementById('save-status');\n  status.textContent = 'Editing...';\n\n  clearTimeout(saveTimeout);\n  saveTimeout = setTimeout(async () => {\n    status.textContent = 'Saving...';\n    await api.savePost({ body: document.getElementById('post-body').value });\n    lastSaved = new Date();\n    status.textContent = `Saved at ${formatTime(lastSaved)}`;\n  }, 800);\n}\n\u003C\u002Fscript>\n```\n\nThree states (editing, saving, saved) all visible. User knows the system is tracking their work.\n\n## Cross-domain examples\n\n### Industrial control: the Segway\n\nLidwell, Holden, and Butler use the Segway as the example of a tightly-tuned negative feedback loop: the rider leans forward; the gyroscope detects the angle change; the motor adjusts wheel speed to maintain balance. This loop runs ~100 times per second. Coarser loops would produce visible oscillation; finer would be wasteful.\n\nThe lesson for software: feedback frequency matches the dynamics of the user's actions. Real-time interactions need real-time feedback; slower actions can have slower feedback.\n\n### Aviation: stall warning systems\n\nA pilot pulling back on the yoke too aggressively gets immediate negative feedback: a stall warning horn, a stick-shaker, a yoke pusher. Each progressively forceful — early warnings let the pilot self-correct; late ones force correction. The graduated feedback gives the pilot agency at every level of urgency.\n\nSoftware analog: progressive validation. Soft inline hint → warning → block on submit → confirmation dialog for destructive.\n\n### Football helmets (the book's case)\n\nThe classic positive-feedback-loop failure: in the 1950s, plastic-with-padding helmets replaced leather. Players felt safer; tackled more aggressively; head\u002Fneck injuries rose. Designers responded by adding more padding; players became even more aggressive; injuries rose further. The loop wasn't moderated by rules against helmet-first tackling until decades later.\n\nThe lesson for software: positive loops without counter-mechanisms produce unintended consequences. A feature that drives engagement may drive it past the user's actual welfare; metrics that look good at first may create harms over time.\n\n### Thermostats\n\nThe canonical example of a negative feedback loop. Too warm → cooling activates → temperature drops → cooling deactivates → temperature drifts up → cycle. The system maintains equilibrium without continuous user input.\n\nUI analog: any system that absorbs user actions and returns to a stable state — auto-save, undo, drift-corrected forms.\n\n## Anti-patterns\n\n- **Silent commits.** A button that submits a form with no visible response. Users click again; double-submission.\n- **Blink-and-miss feedback.** A success message that appears for 100ms before vanishing. Users miss it; doubt the action.\n- **Generic error messages.** \"Something went wrong.\" User doesn't know what or how to fix.\n- **Wrong-channel feedback.** Errors as toasts that vanish; success as banners that linger. Mismatched persistence.\n- **No pending state.** Clicking save and seeing nothing for 3 seconds before the page refreshes. User clicks again.\n- **Spam confirmations.** Every routine action gets a \"Done!\" toast. User dismisses everything on autopilot.\n- **Decorative spinners.** A spinner that's not actually waiting on anything (purely visual). User loses trust when they realize.\n- **Hover-only feedback.** A button that only responds visually on hover. Touch users see no response on tap.\n\n## Heuristics\n\n1. **The \"did it work?\" test.** After any interaction, ask: can the user tell whether the action succeeded? If they have to guess, feedback is missing.\n2. **The double-click audit.** Watch users. Each unintended double-click is feedback that pending state was invisible.\n3. **The error-message audit.** Every error message in the app should answer: what happened, why, what to do next.\n4. **The latency-threshold check.** For each action, time it. Actions over 1s need a pending indicator; over 10s need progress info.\n5. **The accessibility check.** Visual feedback alone fails screen-reader users. Pair with `aria-live` regions for status changes.\n\n## Related principles\n\n- **`affordance`** — feedback completes the loop affordance starts.\n- **`forgiveness`** — feedback enables the recovery forgiveness depends on.\n- **`errors`** — error feedback is the most consequential feedback type.\n- **`mapping`** — feedback should map to the action that caused it.\n- **`expectation-effect`** — feedback that violates expectation creates surprise; align it.\n- **`accessibility-perceivable`** (process) — feedback must be perceivable across abilities.\n\n## Sub-aspect skills\n\n- **`feedback-loop-states-and-latency`** — designing the four states (idle, pending, success, error) and matching feedback to time thresholds.\n- **`feedback-loop-positive-vs-negative`** — choosing between amplifying and stabilizing loop architectures.\n\n## Closing\n\nFeedback is the principle that decides whether your product *feels* responsive. Every interaction that lacks visible response erodes trust at a perceptual level no specific feature can repair. Build feedback into every interactive element from the start; audit every \"is this working?\" complaint as a feedback gap; treat the four states as non-negotiable for any consequential action.\n",{"name":5,"description":7},"main","b0f0a87593c578a7898eccaf1b363f7f87c1f99b","plugins\u002FHDeibler\u002Funiversal-design-principles\u002Fplugins\u002Finteraction-and-control-principles\u002Fskills\u002Ffeedback-loop",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":72},[62,65,68],{"tool":63,"command":64},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill feedback-loop",{"tool":66,"command":67},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill feedback-loop",{"tool":69,"command":70},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill feedback-loop","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FHDeibler\u002Funiversal-design-principles\u002Fplugins\u002Finteraction-and-control-principles\u002Fskills\u002Ffeedback-loop\u002FSKILL.md",true,[74],{"path":75,"resourceType":76,"resourceTypeDesc":77,"sizeBytes":78,"sourceHtmlUrl":79},"references\u002Fcybernetics-and-research.md","REFERENCE","参考文档",5827,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FHDeibler\u002Funiversal-design-principles\u002Fplugins\u002Finteraction-and-control-principles\u002Fskills\u002Ffeedback-loop\u002Freferences\u002Fcybernetics-and-research.md",[81,91,99,107,115,123],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":86,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":90},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":95,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":90},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":103,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":90},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":111,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":90},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":119,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":90},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":85,"licenseFileUrl":127,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":90},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]