Optimizing the CDGC Secure Agent Onboarding Flow
Overview
Enterprise users configuring CDGC Secure Agent services faced high drop-off risks due to a fragmented setup experience that forced them to jump across disconnected UI tabs while parsing dense external documentation.
To solve this, I architected an in-app interactive walkthrough leveraging progressive disclosure (revealing complex information gradually only when the user needs it) to teach users the workflow in real time. By replacing front-loaded manuals with contextual tooltips, targeted micro-animations, and precise UI anchoring, I transformed a complex administrative chore into a self-paced onboarding flow that lowers cognitive load.
Problem
The legacy CDGC setup flow suffered from high user drop-off during early onboarding. A heuristic evaluation of the technical journey uncovered three primary friction points:
Split-attention effect: Forcing users to parse external documentation while navigating disconnected UI tabs spiked cognitive load and introduced frequent context-switching errors.
Broken mental models: Because background services took time to transition to an "Up and Running" state without real-time, in-app validation, users assumed system failure and prematurely abandoned the setup flow.
Business risk: This configuration friction directly delayed customer Time-to-Value (TTV).
Goals
To mitigate the identified onboarding risks before launch, I established three core design objectives bounded by technical and architectural constraints:
Seamless navigation: Guide users across distinct product ecosystems, such as the Administrator and CDGC interfaces, without losing context or inducing disorientation during the jump.
Precise visual anchoring: Implement an element-targeting strategy within Pendo to ensure guide steps and popup boxes remained properly placed within the interface during runtime, even when accounting for varied user configurations.
Strategic visual clarity: Use multimedia assets thoughtfully to orient users without obscuring active form fields or violating spatial accessibility standards.
Solution
I synthesized complex technical requirements from Digital Customer Experience and Program Management into a structured, content-led journey map.
Sequential user paths: Extracted precise service prerequisites, such as Amazon S3 and Oracle, alongside required connector licenses, transforming an overwhelming technical matrix into a bite-sized guide that teaches users the workflow step by step.
Contextual micro-animations: Integrated looping micro-animations, such as GIFs, to demonstrate hidden interface paths like dropdown menus, providing immediate visual clarity at potentially confusing interaction points.
Popup and guide placement: Audited caret positioning and page locations to ensure guide popups and tooltips remained properly placed and visible within the interface during runtime, maintaining visual persistence without obscuring critical input fields or active user tasks.
Feedback & Iteration
I audited the guide against live deployment scenarios and iterated to resolve critical technical and usability bugs:
User interactions with live form fields caused the guide to close prematurely. I shifted the step-trigger logic from passive clicks to state-based validations, ensuring the guide advances only when a service saves successfully, matching the user's natural mental model.
Live scrolling caused tooltips to drift or detach. I stabilized the UI anchoring within Pendo to keep tooltips locked to their target elements, preventing jarring layout shifts.
I audited all instructional copy to enforce active voice, optimized line lengths for F-pattern scanning, and maximized white space so users can quickly process steps without high cognitive load.
Outcome & Next Steps
To ensure the guide remains a permanent, measurable asset within the CDGC ecosystem, I drove the following actions:
Finalized the integration of the "Enabling Services" walkthrough into the global CDGC Onboarding Assistant menu to ensure users could activate the guide.
Conducted a final walkthrough for the Digital Customer Experience team, empowering stakeholders to easily update service requirements as the underlying product architecture evolves.
Because I built this experience natively within Pendo, the teams and I established the foundation to track quantitative UX metrics, such as completion rates, drop-off coordinates, and time-on-task, allowing the team to continuously optimize content based on real user behavior post-launch.
