Predictive Cue Wayfinding Design¶
Make local cues honestly predict what lies down each path so agents can choose, continue, or recover without needing a complete map.
Essence¶
Predictive-Cue Wayfinding Design turns the target prime information_scent into a reusable solution pattern: make the cues visible at each branch point honestly predict what an agent will find if they continue. The archetype is about cue-destination correlation, not simply adding more navigation, louder signs, or more attractive labels.
The core move is to treat every local cue as a promise. A link label, search snippet, icon, heading, route marker, product card, workflow stage, badge, preview, or landmark tells the agent something about what lies ahead. If that promise is clear and true, the agent can move through a partially known space without inspecting everything. If the promise is weak or false, the agent wastes effort and loses trust.
Compression statement¶
Predictive-Cue Wayfinding Design applies when an agent must move through a partly known information, physical, social, or procedural space by judging local cues at branch points. It defines decision points, cue surfaces, expected destination value, cue-destination correlation, scent-strength thresholds, traversal costs, feedback traces, misleading-scent guardrails, recovery paths, and freshness rules. The archetype turns information scent into a design pattern: strengthen cues that truthfully predict downstream value, weaken or relabel cues that misdirect, and preserve recovery when exploration fails.
Canonical formula: At each decision point d, expose cue c whose perceived scent S(c, intent) tracks expected destination value V(destination | intent) minus traversal cost C; revise, demote, relabel, or guardrail c when observed traversal shows weak or misleading correlation.
When to use it¶
Use this archetype when users, learners, operators, customers, patients, visitors, readers, or AI-mediated agents must choose among paths before they can inspect the destinations. It is especially useful when wrong turns are visible through backtracking, abandoned tasks, repeated help-seeking, low successful-arrival rates, or high clickthrough followed by disappointment.
Do not use it as a justification for clickbait. High scent is only valuable when it predicts real downstream value for the agent. A cue that raises attention while hiding cost, risk, eligibility, or low relevance is false scent and should be treated as a failure mode.
When This Archetype Applies¶
Partial catalog groundingSome structural conditions are represented by existing abstractions, but no sufficient condition set is fully represented.
Diagnostic problem
Agents must find, evaluate, or traverse a target without full knowledge of the space. They rely on local cues, but those cues may be too weak, too generic, stale, overloaded, manipulative, or poorly correlated with destination value. The result is inefficient search, wrong turns, abandonment, false confidence, and degraded trust.
Applicability expression4 distinct conditions
groundedpartly groundedopen
4 conditions, all required.
4Required in every casenumbered 1–4
These hold no matter which pattern applies.
Multiple navigation options · open
A space offers multiple paths, categories, links, routes, screens, procedures, or next actions.
The source archetype describes the situation as follows: The space has multiple paths, categories, links, routes, options, documents, screens, procedures, or next actions. The normalized requirement above isolates the load-bearing portion used in this condition set.
Cue-based destination inference · grounded
Agents cannot inspect all destinations before choosing and infer value from local cues.
The source archetype describes the situation as follows: Agents cannot inspect all destinations before choosing and must infer value from local cues. The normalized requirement above isolates the load-bearing portion used in this condition set.
primeInformation Scent— An agent navigates a partially-known space by reading local cues at decision points that predict the value of going further, with cue-destination correlation governing traversal efficiency.
Predictive local cue · grounded
Success depends on whether a local cue predicts destination relevance, payoff, effort, risk, or next state.
The source archetype describes the situation as follows: Success depends on whether the cue accurately predicts destination relevance, payoff, effort, risk, or next state. The normalized requirement above isolates the load-bearing portion used in this condition set.
primeInformation Scent— An agent navigates a partially-known space by reading local cues at decision points that predict the value of going further, with cue-destination correlation governing traversal efficiency.
Stale route cues · grounded · any one of 2
Environmental change makes inherited labels, route promises, or previews unreliable.
The source archetype describes the situation as follows: The environment changes, making old labels, route promises, or previews unreliable. The normalized requirement above isolates the load-bearing portion used in this condition set.
primeCue Outcome Decoupling— A cue that once reliably tracked an outcome has its coupling broken, while the cue-following behavior persists and grows more harmful the better it tracks the now-decoupled cue.
primeEvolutionary Trap— An agent follows a once-reliable cue more eagerly the stronger it is, straight into harm, because the environment changed and the cue-value coupling broke while the cue-response did not.
Other requirements and context (3)
Why these sit outside the expression
Supporting context — it may accompany or help interpret the situation, but it is not a load-bearing condition in a sufficient diagnostic set.
Application gate — it governs whether applying the archetype is appropriate or material, rather than defining the structural problem itself.
Supporting contextLabels, previews, landmarks, thumbnails, social signals, snippets, headings, or affordances influence traversal.
Supporting contextUsers abandon, pogo-stick, loop, ask for help, choose attractive wrong paths, or miss valuable paths.
Application gateThe cost of a wrong turn is nontrivial in time, attention, risk, safety, trust, or opportunity.
The result is inefficient search, wrong turns, abandonment, false confidence, and degraded trust. In this archetype, the relevant application gate is: The cost of a wrong turn is nontrivial in time, attention, risk, safety, trust, or opportunity. It narrows when choosing or applying the archetype is warranted or decision-relevant.
Coverage
3 of 4 conditions grounded · 1 open.
Core components¶
| Component | Description |
|---|---|
| Decision Point Inventory ↗ | The first component is a map of the places where the agent must choose. These may be menus, search results, hallway junctions, onboarding steps, decision gates, documentation categories, recommendation cards, or support triage options. |
| Local Cue Surface ↗ | The cue surface contains the signs available at the decision point: labels, icons, snippets, thumbnails, landmarks, examples, counts, badges, social traces, previews, or visible affordances. The design task is not merely to make these cues salient; it is to make them predictive. |
| Destination-Value Hypothesis ↗ | Each cue must be tied to a hypothesis about what value it predicts. Does it promise relevance, safety, speed, eligibility, support, compatibility, authority, novelty, or completion? A cue cannot be evaluated unless its promise is explicit. |
| Cue-Destination Correlation Model ↗ | This is the structural heart of the archetype. The design checks whether the cue actually predicts the value agents find after traversal. Good scent means the cue is both legible and well-correlated with destination value. Bad scent can be weak, stale, ambiguous, overloaded, expert-only, or actively misleading. |
| Recovery and Freshness Rules ↗ | Because exploration sometimes fails, the archetype needs orientation recovery paths: breadcrumbs, backtracking, landmarks, recently visited paths, comparison views, or safe undo. Because destinations change, it also needs cue freshness rules so labels and previews do not keep promising old reality. |
Common mechanisms¶
Common mechanisms include link-label scent audits, destination-preview cards, task-based wayfinding tests, clickthrough/backtracking dashboards, breadcrumb and landmark trails, misleading-cue red teams, cue-destination alignment matrices, progressive-disclosure previews, and route-recovery workflows. These are mechanisms; the archetype is the broader pattern of honest local cue calibration.
Neighbor distinctions¶
index_based_retrieval builds retrieval structures. knowledge_map_navigation supplies a map. visual_flow_guidance directs attention through a sequence. search_space_pruning removes candidates. progressive_narrowing stages downselection. hidden_path_discovery finds non-obvious routes. associative_cue_redesign changes automatic cue-response patterns. Predictive-Cue Wayfinding Design is distinct when the central issue is whether local cues at decision points truthfully predict downstream route value.
Ethical boundary¶
This archetype is trust-sensitive. Its misuse risks include dark patterns, manipulative previews, engagement traps, hidden costs, discriminatory routing, and personalization that cannot be audited. Valid use preserves informed choice: agents should understand what a cue promises, what it costs to follow, and how to recover if it is wrong.
Extended example¶
A developer portal notices that users frequently click “Integrations,” immediately return, then search for “webhook setup.” The label is a high-traffic cue but low-scent for the task. A cue-destination audit separates three intents: API credentials, webhook configuration, and partner-app browsing. The redesign creates more predictive local cues, adds snippets and compatibility badges, and instruments successful arrival rather than clicks alone. The portal becomes easier to navigate because the local promises now match destination reality.
Quality note¶
This draft is intended as a zero-coverage gap-fill archetype for information_scent. It should be reviewed mainly at its merge boundaries with index_based_retrieval, knowledge_map_navigation, visual_flow_guidance, and focal_emphasis_design, and at its ethical boundary against false-scent or dark-pattern optimization.
Common Mechanisms¶
9 documented mechanisms across 6 implementation forms.
The grouping reflects forms represented among the mechanisms currently documented for this archetype; an absent form is not necessarily an impossible implementation.
Assessment, Review & Assurance · 1 mechanism
- Link-Label Scent Audit — A recurring review pass that walks every label, heading, button, and link and checks it against what an agent actually finds after clicking, flagging weak, ambiguous, or mismatched cues.
Experiment, Test & Rehearsal · 2 mechanisms
- Misleading-Cue Red Team — An adversarial exercise that hunts for cues which attract traversal while concealing low relevance, hidden cost, or risk — approaching the interface as an attacker exploiting the gap between attention and truth.
- Task-Based Wayfinding Test — A facilitated study in which representative agents attempt realistic tasks and are observed choosing routes from local cues alone, measuring whether honest navigation actually succeeds for real intents.
Interface, Display & Cue · 3 mechanisms
- Breadcrumb and Landmark Trail — Keeps an agent oriented with a persistent layer of fixed landmarks and a visible trail of where they have been, so a wrong turn is recoverable without a separate rescue step.
- Destination Preview Card — A compact on-demand snapshot of what sits at the end of one specific path — summary, example, current status, and cost to get there — shown at the branch so the agent can judge that destination before committing.
- Progressive Disclosure Preview — Reveals just enough downstream structure at a branch point to sharpen an agent's prediction, holding the rest back so the choice gains scent without cognitive overload.
Monitoring, Sensing & Alerting · 1 mechanism
- Scent Clickthrough Trace Dashboard — A live instrument that aggregates traversal telemetry — clickthrough, backtracking, abandonment, refinement, successful arrival — and watches it over time for decaying or below-threshold scent.
Protocol, Workflow & Routine · 1 mechanism
- Route Recovery Pattern — A defined procedure an agent follows after a wrong turn — backtrack, regain context, compare alternatives, and report the bad scent — turning a dead end into a recoverable step.
Record, Log & Register · 1 mechanism
- Cue-Destination Alignment Matrix — A living register with one row per cue, recording the destination value it promises, the evidence the promise holds, the owner accountable for it, and the trigger that forces a re-check.
Related Abstractions¶
Abstractions this archetype builds on — directly (a source ingredient) or as a related pattern. Links follow the typed catalog namespace.
Built directly on (10)
- Affordance: An action possibility offered by the fit between an agent and its environment.
- Attention: The selective allocation of a fixed processing capacity to some inputs while the rest are filtered out, surfacing scarcity upstream of every decision.
- Feedback: Outputs influence inputs.
- Heuristic: Mental shortcuts.
- Information Scent: An agent navigates a partially-known space by reading local cues at decision points that predict the value of going further, with cue-destination correlation governing traversal efficiency.
- Navigation: A positioned agent moves through a structured space toward a goal using an incomplete map, staying oriented at each step.
- Observability: Infer internal state externally.
- Salience: A bottom-up, relational score by which items stand out from their surround before deliberate attention is allocated.
- Search and Retrieval: Locate and extract information.
- Signaling: Revealing hidden information.
Also references 19 related abstractions
- Absence as Information: The non-occurrence of an expected event is itself a positive signal.
- Access Friction: An entry-asymmetric cost paid only by those crossing a membership boundary, shaping who is present rather than who is qualified.
- Bayesian Cue Integration: Multiple noisy cues to one quantity combine by inverse-variance weighting into a lower-variance estimate.
- Cognitive Load: Mental effort.
- Cue Outcome Decoupling: A cue that once reliably tracked an outcome has its coupling broken, while the cue-following behavior persists and grows more harmful the better it tracks the now-decoupled cue.
- Deception Blowback: A misleading signal injected into a shared channel to deceive an adversary returns through an unintended path to confuse the deceiver's own decision loop, allies, downstream systems, or future selves, at a cost the original calculation never scored.
- Desire Path: An involuntary trace worn into a designed environment's substrate by repeated use, recording revealed preference where the design fails to accommodate it.
- Deterrence: Preventing an action not by blocking it but by arranging consequences so the target's own cost-benefit calculation makes the action unattractive.
- Hidden Path and Barrier Crossing: Non-obvious transitions.
- Identification: One party aligns belief or action with another because it recognizes itself — its values, memberships, identity — in the other, with persuasion proceeding via self-concept rather than argument.
Variants¶
Narrower or domain-specific specializations that share this archetype's core structure. Recognized variants are established; candidate variants are provisional.
Link-Label Scent Calibration · implementation variant · recognized
A digital-navigation variant that aligns link text, headings, buttons, and snippets with the value users will actually find after clicking.
- Distinct from parent: The parent covers any local cue-route system; this variant specializes web, app, documentation, and search-result labels.
- Use when: Users choose among links, menus, search results, cards, or calls to action; Traffic, pogo-sticking, abandonment, or confusion indicates that visible labels do not match destination value; The team can change labels, previews, or information architecture.
- Typical domains: web navigation, documentation, search results, product onboarding
- Common mechanisms: link label scent audit, destination preview card, task based wayfinding test, scent clickthrough trace dashboard
Landmark-Scented Route Design · domain variant · recognized
A physical, spatial, or procedural variant that uses landmarks, signs, stages, and local affordances to help agents infer the right route before they see the destination.
- Distinct from parent: The parent includes digital and conceptual spaces; this variant specializes embodied route choice and place-based orientation.
- Use when: Agents navigate a physical campus, facility, service journey, workflow, or multi-step procedure; Route decisions happen before destination visibility; Wrong turns cause delay, anxiety, safety risk, or support burden.
- Typical domains: hospitals, museums, campuses, service journeys, operations procedures
- Common mechanisms: breadcrumb and landmark trail, task based wayfinding test, route recovery pattern
False-Scent Suppression · risk or failure variant · recognized
A corrective variant focused on finding and removing cues that attract traversal while failing to deliver the promised value.
- Distinct from parent: The parent includes positive scent creation; this variant starts from the failure mode of misleading scent.
- Use when: Cues are optimized for attention, clicks, conversion, or compliance rather than fulfilled intent; Users express disappointment, mistrust, confusion, or repeated wrong-turn behavior; There are incentives to overpromise, hide friction, or steer agents to low-value destinations.
- Typical domains: consumer interfaces, public benefits navigation, risk communication, search marketing, compliance portals
- Common mechanisms: misleading cue red team, scent clickthrough trace dashboard, cue destination alignment matrix
Near names: Information Scent Design, Information Scent Calibration, Cue-Destination Alignment, Scent-Based Navigation Design, Findability Scenting, Predictive Link Labeling.
Editorial Notes¶
Problem Classification¶
Classification: Information Overload, Search & Attention Failure → Knowledge Retrieval, Pattern & Wayfinding
Problem kernel: local cues poorly predict destination value
Rationale: Earliest causal condition: Agents must find, evaluate, or traverse a target without full knowledge of the space. They rely on local cues, but those cues may be too weak, too generic, stale, overloaded, manipulative, or poorly correlated with destination value. The result is inefficient search, wrong turns, abandonment, false confidence, and degraded trust.
Independent corroboration: The earliest necessary condition in the frozen evidence is: Agents must find, evaluate, or traverse a target without full knowledge of the space. That is a knowledge retrieval pattern and wayfinding problem because Relevant information or structural analogies exist but cannot be found, recognized, sequenced, or navigated from current local cues.
Review outcome: Independent reviewer agreement; high confidence.