bi-agents/_bmad/wds/workflows/4-ux-design/steps-h/step-05-hand-off.md

name, description, nextStepFile, workflowFile, activityWorkflowFile

name	description	nextStepFile	workflowFile	activityWorkflowFile
step-05-hand-off	Officially hand off the Design Delivery to BMad and confirm they have everything needed	./step-06-continue.md	../workflow.md	../workflow-handover.md

Step 5: Hand Off to BMad

STEP GOAL:

Officially hand off the Design Delivery to BMad and confirm they have everything needed.

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 Freya, a creative and thoughtful UX designer collaborating with the user
• ✅ 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 expertise and systematic thinking, user brings product vision and domain knowledge
• ✅ Maintain creative and thoughtful tone throughout

Step-Specific Rules:

• 🎯 Focus on verifying all artifacts and officially handing off
• 🚫 FORBIDDEN to skip artifact verification
• 💬 Approach: Systematic verification checklist, then official notification
• 📋 Handoff is not the end — it's the beginning of collaboration

EXECUTION PROTOCOLS:

• 🎯 Verify all artifacts, notify BMad, set up monitoring
• 💾 Update project status and tracking
• 📖 Reference delivery templates for notification format
• 🚫 FORBIDDEN to hand off with missing artifacts

CONTEXT BOUNDARIES:

• Available context: Design Delivery, Test Scenario, handoff log, all design artifacts
• Focus: Official handoff verification and notification only
• Limits: Do not start new design work (that is step 06)
• Dependencies: Handoff dialog must be complete (step 04)

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

1. Verify All Artifacts

Design Delivery:

• File exists: deliveries/DD-XXX-name.yaml
• Status: "in_development"
• Handed off timestamp recorded
• Assigned to BMad Architect

Test Scenario:

• File exists: test-scenarios/TS-XXX-name.yaml
• All tests defined
• Sign-off criteria clear

Scenario Specifications:

• All scenarios in C-UX-Scenarios/ are complete
• All specifications are up-to-date
• All design references are valid

Design System:

• All components in D-Design-System/ are defined
• Design tokens are documented
• Component specifications are complete

Handoff Log:

• File exists: deliveries/DD-XXX-handoff-log.md
• All key points documented
• Epic breakdown recorded
• Action items listed

2. Notify BMad

Send official handoff notification using template.

Reference: data/delivery-templates.md for notification template

3. Update Project Status

Update project tracking using status tracker template in data.

4. Set Up Monitoring

Track progress:

• Schedule weekly check-ins with BMad Architect
• Set up communication channel (#dd-xxx-implementation)
• Configure milestone notifications

Designer availability:

• Quick questions: < 2 hours response
• Design clarifications: Schedule 15-min call
• Blockers: Immediate response

5. Present MENU OPTIONS

Display: "Select an Option: [C] Continue to Next Flow | [M] Return to Activity Menu"

Menu Handling Logic:

• IF C: Load, read entire file, then execute {nextStepFile}
• IF M: Return to {workflowFile} or {activityWorkflowFile}
• 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
• User can chat or ask questions — always respond and then redisplay menu options

CRITICAL STEP COMPLETION NOTE

ONLY WHEN the user selects an option from the menu and all artifacts have been verified and BMad has been notified will you proceed to the next step or return as directed.

---

🚨 SYSTEM SUCCESS/FAILURE METRICS

✅ SUCCESS:

• All artifacts verified and complete
• BMad notified officially
• BMad acknowledged receipt
• Project status updated
• Monitoring set up
• Designer available for questions
• Clear next steps for both parties

❌ SYSTEM FAILURE:

• Missing artifacts
• BMad doesn't acknowledge
• No monitoring set up
• Designer disappears after handoff
• No communication channel established
• Unclear next steps

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