Skip to contents

Document User Behavior Anticipation Stage in BID Framework

bid_anticipate.Rd

This function documents the anticipated user behavior by listing bias mitigation strategies related to anchoring, framing, confirmation bias, etc. It also supports adding interaction hints and visual feedback elements.

Usage

bid_anticipate(
  previous_stage,
  bias_mitigations = NULL,
  include_accessibility = TRUE,
  quiet = NULL,
  ...
)

Arguments

previous_stage

A tibble or list output from an earlier BID stage function.

bias_mitigations

A named list of bias mitigation strategies. If NULL, the function will suggest bias mitigations based on information from previous stages.

include_accessibility

Logical indicating whether to include accessibility mitigations. Default is TRUE.

quiet

Logical indicating whether to suppress informational messages. If NULL, uses getOption("bidux.quiet", FALSE).

...

Additional parameters. If 'interaction_principles' is provided, it will be ignored with a warning.

Value

A tibble containing the documented information for the "Anticipate" stage.

Examples

interpret_stage <- bid_interpret(
  central_question = "How can we improve selection efficiency?",
  data_story = list(
    hook = "Too many options",
    context = "Excessive choices",
    tension = "User frustration",
    resolution = "Simplify menu"
  )
)
#> Warning: ! Using deprecated list format for data_story parameter
#> ℹ Please use new_data_story() constructor for new code
#> ℹ Legacy format will be automatically migrated
#> Warning: ! Using deprecated nested format for data_story
#> ℹ The flat API is now recommended: new_data_story(hook, context, tension,
#>   resolution)
#> ℹ Nested format (variables, relationships) will be removed in bidux 0.4.0
#> Stage 1 (Interpret) completed.
#>   - Central question: How can we improve selection efficiency?
#>   - Your data story is incomplete (25%). Consider adding these missing elements: hook, tension, resolution.
#>   - Your central question is appropriately scoped.
#>   - No user personas defined 

notice_stage <- bid_notice(
  previous_stage = interpret_stage,
  problem = "Issue with dropdown menus",
  evidence = "User testing indicated delays"
)
#> Auto-suggested theory: Hick's Law (confidence: 90%)
#> Stage 2 (Notice) completed. (40% complete)
#>   - Problem: Issue with dropdown menus
#>   - Theory: Hick's Law (auto-suggested)
#>   - Evidence: User testing indicated delays
#>   - Theory confidence: 90%
#>   - Next: Use bid_anticipate() for Stage 3 

structure_info <- bid_structure(previous_stage = notice_stage)
#> ℹ Auto-selected layout: breathable
#> ℹ Selected 'breathable' as safe default to ensure clean, uncluttered layout.
#> Warning: Layout auto-selection is deprecated and will be removed in bidux 0.4.0. The BID framework will focus on concept-based suggestions instead. Existing code will continue to work until 0.4.0.
#> ℹ Tip: Learn more about any concept via bid_concept("<concept>").
#> ℹ Stage numbering has been corrected in bidux 0.3.1:
#>   Anticipate is now Stage 3, Structure is now Stage 4
#>   This change improves logical workflow progression
#>   All existing code remains backward compatible
#> Stage 4 (Structure) completed.
#>   - Auto-selected layout: breathable
#>   - Concept groups generated: 4
#>   - Total concepts: 4 

# Let the function suggest bias mitigations based on previous stages
bid_anticipate(previous_stage = structure_info)
#> Warning: Layout-specific bias mitigations are deprecated and will be removed in bidux 0.4.0. Consider using concept-based bias mitigations instead.
#> Automatically suggested bias mitigations: attention bias, belief perseverance, cognitive load, accessibility.
#> Concept 'attention bias' not found
#> Found partial match: Cognitive Load Theory
#> Found partial match: Accessibility Contrast
#> Stage 3 (Anticipate) completed.
#>   - Bias mitigations: 4 defined
#>   - Accessibility considerations included
#>   - Key suggestions: Attention Bias mitigation: Consider how this bias affects user decisions, Belief Perseverance mitigation: Proactively show content that might disprove initial assumptions, Cognitive Load mitigation: Use tabs or collapsible sections to organize complex information 
#> BID Framework - Anticipate Stage
#> Generated: 2025-10-29 17:17:35 
#> Progress: 60 % (3/5) 
#> 
#> Bias Mitigations: 3 strategies defined 
#> 
#>  Suggestions: Attention Bias mitigation: Consider how this bias affects user decisions Belief Perseverance mitigation: Proactively show content that might disprove initial assumptions Cognitive Load mitigation: Use tabs or collapsible sections to organize complex information Accessibility mitigation: Test color combinations with WebAIM's contrast checker to meet WCAG standards Consider also addressing these common biases: anchoring, framing, confirmation accessibility considerations have been included in bias mitigations. 
#> 
#>  Use summary() for detailed information 

# with accessibility included (default) and custom bias mitigations
anticipate_result <- bid_anticipate(
  previous_stage = structure_info,
  bias_mitigations = list(
    anchoring = "Use context-aware references",
    framing = "Toggle between positive and negative framing"
  ),
  include_accessibility = TRUE
)
#> Warning: ! Using deprecated list format for bias_mitigations parameter
#> ℹ Please use new_bias_mitigations() constructor for new code
#> ℹ Legacy format will be automatically migrated
#> Added accessibility mitigation based on layout context.
#> Concept 'bias_type' not found
#> Concept 'mitigation_strategy' not found
#> Concept 'confidence_level' not found
#> Found partial match: Accessibility Contrast
#> Stage 3 (Anticipate) completed.
#>   - Bias mitigations: 4 defined
#>   - Accessibility considerations included
#>   - Key suggestions: Bias_type mitigation: Consider how this bias affects user decisions, Mitigation_strategy mitigation: Consider how this bias affects user decisions, Confidence_level mitigation: Consider how this bias affects user decisions 

summary(anticipate_result)
#> === BID Framework: Anticipate Stage Summary ===
#> 
#> Metadata:
#>    stage_number : 3 
#>    total_stages : 5 
#>    validation_status : completed 
#>    bias_count : 4 
#>    include_accessibility : Yes 
#>    layout : breathable 
#>    concepts_count : 4 
#>    auto_generated_biases : No 
#>    stage_number_previous : 4 
#> 
#> Stage Data:
#>    stage : Anticipate 
#>    bias_mitigations : anchoring: Use context-aware references; framing: Toggle between positive and... 
#>    accessibility : accessibility mitigation not specified 
#>    previous_layout : breathable 
#>    previous_concepts : Cognitive Load Theory, Visual Hierarchy, Progressive Disclosure, Hick's Law 
#>    suggestions : Bias_type mitigation: Consider how this bias affects user decisions Mitigatio... 
#> 
#> Generated: 2025-10-29 17:17:35