bi-agents/_bmad/wds/workflows/7-design-system/steps-c/step-05-identify-risks.md

name, description, nextStepFile

name	description	nextStepFile
step-05-identify-risks	Identify potential risks and problems with each design system decision option	./step-06-present-decision.md

Step 5: Identify Risks

STEP GOAL:

Identify potential risks and problems with each design system decision option. Assess severity, identify deal-breakers, and consider mitigation strategies.

MANDATORY EXECUTION RULES (READ FIRST):

Universal Rules:

• 🛑 NEVER generate content without user input
• 📖 CRITICAL: Read the complete step file before taking any action
• 🔄 CRITICAL: When loading next step with 'C', ensure entire file is read
• 📋 YOU ARE A FACILITATOR, not a content generator
• ✅ YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config {communication_language}

Role Reinforcement:

• ✅ You are the Design System Architect guiding design system creation and maintenance
• ✅ If you already have been given a name, communication_style and persona, continue to use those while playing this new role
• ✅ We engage in collaborative dialogue, not command-response
• ✅ You bring design system expertise and component analysis, user brings design knowledge and project context
• ✅ Maintain systematic and analytical tone throughout

Step-Specific Rules:

• 🎯 Focus ONLY on this step's specific goal — do not skip ahead
• 🚫 FORBIDDEN to jump to later steps before this step is complete
• 💬 Approach: Systematic execution with clear reporting
• 📋 All outputs must be documented and presented to user

EXECUTION PROTOCOLS:

• 🎯 Execute each instruction in the sequence below
• 💾 Document all findings and decisions
• 📖 Present results to user before proceeding
• 🚫 FORBIDDEN to skip instructions or optimize the sequence

CONTEXT BOUNDARIES:

• Available context: Previous step outputs and project configuration
• Focus: This step's specific goal only
• Limits: Do not perform actions belonging to subsequent steps
• Dependencies: Requires all previous steps to be completed

Sequence of Instructions (Do not deviate, skip, or optimize)

Risk Analysis Framework

For Option 1: Reuse Existing

Potential Risks:

Loss of Distinction

• ❌ Different purposes look identical
• ❌ Users can't distinguish actions
• ❌ Semantic meaning lost
• ❌ Accessibility issues (same label, different action)

Constraint

• ❌ Forced to use existing styling
• ❌ Can't optimize for specific use case
• ❌ Future changes constrained
• ❌ Design evolution limited

Confusion

• ❌ Developers confused about usage
• ❌ Same component, different behaviors
• ❌ Unclear when to use
• ❌ Documentation complexity

Technical Debt

• ❌ Component becomes overloaded
• ❌ Too many conditional behaviors
• ❌ Hard to maintain
• ❌ Performance issues

---

For Option 2: Add Variant

Potential Risks:

Complexity

• ❌ Component becomes complex
• ❌ Many variants to manage
• ❌ Harder to understand
• ❌ More documentation needed

Maintenance Burden

• ❌ Changes affect all variants
• ❌ Testing becomes complex
• ❌ More edge cases to handle
• ❌ Harder to refactor

Variant Explosion

• ❌ Too many variants over time
• ❌ Unclear which variant to use
• ❌ Variants become too specific
• ❌ Component loses coherence

Coupling

• ❌ Variants tightly coupled
• ❌ Can't change one without affecting others
• ❌ Shared code creates dependencies
• ❌ Harder to deprecate

---

For Option 3: Create New

Potential Risks:

Inconsistency

• ❌ Visual inconsistency across pages
• ❌ Different styling for similar components
• ❌ User confusion
• ❌ Brand fragmentation

Duplication

• ❌ Duplicate code
• ❌ Duplicate maintenance
• ❌ Duplicate testing
• ❌ Duplicate documentation

Proliferation

• ❌ Too many components in design system
• ❌ Hard to find right component
• ❌ Developers create more duplicates
• ❌ Design system becomes unwieldy

Divergence

• ❌ Components drift over time
• ❌ Accidental inconsistencies
• ❌ Harder to maintain coherence
• ❌ More work to keep aligned

---

Step 1: Analyze Current Situation for Risks

Based on similarity level and comparison, identify which risks apply

Example (72% similarity, different purposes):

Current Situation:
- High visual similarity (90%)
- Different functional purpose (navigation vs submission)
- Some behavioral differences (loading state, icon)

Risk Indicators:
- Reuse: High risk of semantic confusion
- Variant: Medium risk of complexity
- New: Medium risk of visual inconsistency

---

Step 2: Generate Risk Lists

**Option 1: Reuse Button [btn-001]**

Risks: ❌ Semantic Confusion: Navigation and submission look identical ❌ Accessibility: Screen readers can't distinguish actions ❌ Developer Confusion: Same component, different behaviors ❌ Future Constraint: Can't optimize for navigation use case

Highest Risk: Semantic confusion - users won't understand the difference

**Option 2: Add "Navigation" Variant to Button [btn-001]**

Risks: ❌ Complexity: Button component now handles 2 different purposes ❌ Maintenance: Changes to button affect both submission and navigation ❌ Variant Explosion: What about other button types? (delete, cancel, etc.) ❌ Documentation: Need to explain when to use each variant

Highest Risk: Variant explosion - could lead to 10+ button variants

**Option 3: Create New "Navigation Button" Component**

Risks: ❌ Visual Inconsistency: Two similar-looking buttons with different names ❌ Duplication: Similar code in two components ❌ Proliferation: More components in design system ❌ Developer Choice: Which button should I use?

Highest Risk: Visual inconsistency - buttons might drift apart over time

---

Step 3: Assess Risk Severity

Rate each risk as Low/Medium/High severity based on: - Impact if it occurs - Likelihood of occurring - Difficulty to fix later

Example:

Risk Severity Assessment:

**Reuse Option:**
- Semantic confusion: HIGH (impacts UX, hard to fix)
- Accessibility: HIGH (compliance issue)
- Developer confusion: MEDIUM (documentation can help)
- Future constraint: MEDIUM (can refactor later)

**Variant Option:**
- Complexity: MEDIUM (manageable with good structure)
- Maintenance: MEDIUM (testing helps)
- Variant explosion: HIGH (hard to reverse)
- Documentation: LOW (just needs writing)

**New Option:**
- Visual inconsistency: MEDIUM (can be monitored)
- Duplication: LOW (acceptable trade-off)
- Proliferation: MEDIUM (can be managed)
- Developer choice: LOW (documentation helps)

---

Step 4: Identify Deal-Breaker Risks

Highlight risks that would make an option unsuitable

Example:

🚨 Deal-Breaker Risks:

**Reuse:**
- Semantic confusion is HIGH risk
- Accessibility issue is HIGH risk
→ This option might not be viable

**Variant:**
- Variant explosion is HIGH risk
- But can be mitigated with clear guidelines
→ This option is risky but manageable

**New:**
- No HIGH severity risks identified
- All risks are manageable
→ This option is safest

---

Step 5: Consider Mitigation Strategies

For each risk, identify if/how it can be mitigated

Example:

Risk Mitigation:

**Reuse - Semantic Confusion:**
- Mitigation: Use different labels/icons
- Effectiveness: LOW (still same component)
- Verdict: Hard to mitigate

**Variant - Variant Explosion:**
- Mitigation: Strict variant guidelines
- Effectiveness: MEDIUM (requires discipline)
- Verdict: Can be managed

**New - Visual Inconsistency:**
- Mitigation: Shared design tokens
- Effectiveness: HIGH (tokens ensure consistency)
- Verdict: Easily mitigated

---

Step 6: Pass to Next Step

Pass risk analysis to decision presentation: - Risks for each option - Severity ratings - Deal-breaker risks - Mitigation strategies

Next: step-06-present-decision.md

---

Edge Cases

All options have high risks:

⚠️ All Options Have Significant Risks

This is a tough decision:
- Reuse: Semantic confusion
- Variant: Complexity explosion
- New: Inconsistency

I'll present all trade-offs clearly so you can make an informed choice.

No significant risks:

✅ Low Risk Situation

All options have manageable risks:
- Reuse: Minor constraint
- Variant: Slight complexity
- New: Minimal duplication

Focus on opportunities to decide.

One option has deal-breaker risk:

🚨 One Option Not Recommended

Reuse has HIGH accessibility risk that's hard to mitigate.

I'll present Variant vs New as the viable options.

---

Output Format

For next step:

{
  "risks": {
    "reuse": {
      "semantic_confusion": "high",
      "accessibility": "high",
      "developer_confusion": "medium",
      "deal_breaker": true
    },
    "variant": {
      "complexity": "medium",
      "variant_explosion": "high",
      "maintenance": "medium",
      "deal_breaker": false,
      "mitigation": "strict_guidelines"
    },
    "new": {
      "visual_inconsistency": "medium",
      "duplication": "low",
      "proliferation": "medium",
      "deal_breaker": false,
      "mitigation": "shared_tokens"
    }
  }
}

7. Present MENU OPTIONS

Display: "Select an Option: [C] Continue to Present Decision"

Menu Handling Logic:

• IF C: Update design log, then load, read entire file, then execute {nextStepFile}
• IF Any other comments or queries: help user respond then Redisplay Menu Options

EXECUTION RULES:

• ALWAYS halt and wait for user input after presenting menu
• ONLY proceed to next step when user selects the appropriate option
• User can chat or ask questions — always respond and then redisplay menu options

CRITICAL STEP COMPLETION NOTE

ONLY WHEN [C continue option is selected and risks identified with severity ratings for all options], will you then load and read fully {nextStepFile} to execute the next step.

---

🚨 SYSTEM SUCCESS/FAILURE METRICS

✅ SUCCESS:

• Step goal achieved completely
• All instructions executed in sequence
• Results documented and presented to user
• User confirmed before proceeding
• Design log updated

❌ SYSTEM FAILURE:

• Skipping any instruction in the sequence
• Generating content without user input
• Jumping ahead to later steps
• Not presenting results to user
• Proceeding without user confirmation

Master Rule: Skipping steps, optimizing sequences, or not following exact instructions is FORBIDDEN and constitutes SYSTEM FAILURE.