Optimizing the CDGC Secure Agent Onboarding Flow
Overview
Configuring Secure Agent services is a critical, technically complex step in the Cloud Data Governance and Catalog (CDGC) onboarding journey. Previously, users faced a fragmented experience, forcing them to manually parse dense external documentation while navigating multiple UI tabs.
I designed and implemented an interactive, in-app walkthrough that replaces front-loaded documentation with progressive disclosure. By engineering contextual tooltips, targeted micro-animations, and precise UI anchoring, I transformed a high-friction administrative chore into a streamlined, self-paced setup wizard.
Problem
Because the Secure Agent configuration requires complex, manual system orchestration, the legacy setup flow presented a high risk for user drop-off during the critical early stages of the onboarding funnel.
A basic heuristic evaluation of the technical journey revealed two primary friction points:
Predicted split-attention effect: The setup process required users to parse dense, external technical documentation while simultaneously navigating multiple disconnected UI tabs (Services, Connectors). This creates a high cognitive load, increasing the probability of context-switching errors.
Invisible system dependencies: Users must verify that specific background services transition to an "Up and Running" state only after saving highly technical configurations. Without real-time, in-app validation, users face a broken mental model—they are likely to prematurely exit the setup flow under the assumption that the system has failed.
Anticipated business risk: If left unmitigated, this configuration friction directly threatens customer Time-to-Value (TTV), creating an immediate bottleneck that spikes high-priority customer support tickets during the trial phase.
Goals
To mitigate the identified onboarding risks before launch, I established three core design objectives bounded by technical and architectural constraints:
Architect seamless cross-interface navigation: Guide users across distinct product ecosystems (the Administrator and CDGC interfaces) without losing context or inducing disorientation during the jump.
Ensure guide stability against dynamic data: Develop a robust element-targeting strategy within Pendo that reliably anchors to UI elements, even when accounting for varied user configurations and dynamic row names.
Optimize cognitive Saliency: Use multimedia assets strategically to orient users without obscuring active 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.
I extracted the precise service prerequisites (such as Amazon S3 and Oracle) and connector licenses required for activation, transforming an overwhelming technical matrix into a sequential, bite-sized user path.
Rather than relying solely on text strings, I integrated contextual, looping micro-animations (GIFs) to demonstrate hidden UI paths—such as dropdown menus—providing immediate clarity at potentially confusing interaction points.
I audited caret positioning and page locations to ensure tooltips remained visible and did not obscure critical input fields, maintaining visual persistence during active user tasks.
Feedback & Iteration
I audited the guide against live deployment scenarios and iterated to resolve critical technical and usability bugs:
Users interacting with live UI fields occasionally caused the guide to prematurely terminate. The Fix: I re-architected the step-trigger logic from passive clicks to explicit, state-based validations. The guide now advances only when a service successfully saves, matching the user's structural mental model.
To prevent the guide from breaking during live scrolling, I stabilized the UI anchoring parameters within Pendo, ensuring tooltips persisted relative to the active element without inducing layout shifts.
I audited all instructional strings to enforce active voice, adjusted line lengths to optimize F-pattern scanning, and maximized white space. This ensures users can process instructions within a 10-second cognitive window.
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 permanent, asynchronous discoverability.
Delivered a componentized handoff kit and 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.
