✨ FEATURE — Developer Onboarding Golden Path (Environment-Aware)

[Evilazaro]

Parent: #811

✨ FEATURE — Developer Onboarding Golden Path (Environment-Aware)

Parent Epic

🎯 EPIC 1 — Dev Box Adoption & Deployment (Multi-Environment, Multi-Dev Center)

Milestone

M3 — Developer Onboarding Proven

📝 Feature Description

Provide a clear, environment-aware onboarding experience that guides developers to the correct Dev Center and project,
enabling successful Dev Box creation without support intervention.

❓ Problem Statement

Developers struggle to onboard due to unclear environment selection, fragmented steps, and missing validation checks,
leading to support tickets and low adoption.

💡 Proposed Solution

Create an end-to-end onboarding guide with:

• Environment intent and selection guidance
• Step-by-step Dev Box creation instructions
• Validation checklist and common troubleshooting pointers

🔀 Alternative Solutions

• Generic onboarding docs without environment context
• Manual troubleshooting

🔧 Dev Box Component

• Dev Box
• Documentation

👤 Use Case

A new developer can self-serve a Dev Box in the correct environment and project on the first attempt.

✨ Expected Benefits

• Reduced onboarding time
• Higher adoption success
• Fewer support tickets

Acceptance Criteria

• Onboarding works in prod and non-prod
• Developer can create a Dev Box without helpdesk intervention
• Validation checklist included

Dependencies

• FEATURE — Identity & Access Readiness (adoption gate)
• FEATURE — Dev Center & Dev Box Platform Baseline

Definition of Done

• Onboarding validated end-to-end
• Documentation published