Onboarding UX: 3-phase roadmap, celebration card, file-write previews, env-aware URLs#62
Open
DhruvLD wants to merge 1 commit into
Open
Onboarding UX: 3-phase roadmap, celebration card, file-write previews, env-aware URLs#62DhruvLD wants to merge 1 commit into
DhruvLD wants to merge 1 commit into
Conversation
…rd, env-aware URLs Reworks the onboarding skill's user-facing surface based on dogfooding feedback. Changes: - Roadmap shown to the user collapses from 7 internal steps to 3 phases (Connect / Install / Ship). Internal step structure stays for agent bookkeeping; user-facing task list uses 3 tasks instead of 7. - New "preview before user-visible file writes" rule. Agent must surface a 2-4 line summary before writing files that land in version control (LAUNCHDARKLY.md, .mcp.json, editor rules, code changes). The internal working log is exempt so it stays low-ceremony. - Step 6 (first flag) gets a new Step 7: scannable ASCII card + platform-aware browser auto-open (open/xdg-open/Start-Process/start). Replaces the bullet-list "Congratulations" with a real moment. Scarcity enforced: this is the only place decorative ASCII is allowed. - Both the ASCII card link and the auto-open URL use the env-scoped flag URL pattern (/targeting?env=&selected-env=) so the dashboard lands on the environment the flag was just toggled in, not the default. - Companion-skill install wrapped in a redirect-to-log + one-line echo so spinner noise from the npx skills CLI no longer dominates the chat. Bumps onboarding to 0.3.0 and first-flag to 0.2.0.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Polish pass on the
onboardingskill, driven by running through it end-to-end on a real LaunchDarkly-internal repo and noting the friction points. The goal: make the experience feel like a polished productAll changes are user-facing UX improvements — the internal Step 0–6 machinery is unchanged.
What changed
1. Collapse the user-facing roadmap to 3 phases
The user now sees Connect → Install → Ship, not 7 numbered steps. Internal Step 0–6 structure stays for agent bookkeeping (and stays in the
LAUNCHDARKLY_ONBOARDING.mdworking log), but they never bleed into chat.### The three phases the user seessection maps each internal step to a phase.roadmap render templateso agents have a working example instead of free-form instructions.Connect,Install,Ship) instead of 7. The internal log keeps the Step 0–6 detail.Step 4 done/Steps 0-3 donepatterns; substitutes phase language.2. Preview before user-visible file writes
The skill writes
LAUNCHDARKLY.md,.mcp.json, and editor rules. Previously these landed ingit statuswith no warning. New subsection inStep Execution Rulesrequires a 2–4 line summary before writing user-visible files. Working log (LAUNCHDARKLY_ONBOARDING.md) is exempt so we don't add ceremony where there's none warranted. Includes good/avoid examples.3. Step 7 in
first-flag: ASCII celebration + auto-open browserReplaces the bullet-list "Congratulations" with a single scannable moment:
┌ ─ ┐ │ └ ┘),●/○for flag state, one line per environment,← toggled heremarker on the env you just acted in.open/xdg-open/Start-Process/start) using the env-scoped URL so the LD dashboard opens and lands on the right environment. Agent announces before opening; falls back to printing the link on headless environments.5. Quieter companion-skill install
npx skills addproduces a long animated spinner that floods chat when piped. Wrapped the install in a redirect-to-log + one-line success echo, with a fallback that dumps the log only on failure. Noted as a workaround pending a--quietflag upstream in theskillsCLI.Version bumps
skills/onboarding:0.2.0→0.3.0skills/onboarding/first-flag:0.1.0→0.2.0Test plan
npx skills add /path/to/ai-tooling --skill onboarding -y)onboard me to LaunchDarklyend-to-end — roadmap rendered as 3 phases, no internal step numbers leaked into chat.mcp.jsonandLAUNCHDARKLY.mdgot a preview summary before being written