Problem statement
07-your-first-workflow.md is the highest-dropout step in the current simulation: 21.4% conditional dropout among 22,360 at-risk runs (95% CI 20.8%–21.9%). aggregate.failureCategoriesByStep attributes 3,906 of 4,781 total failures at this step to copilot-access-missing — the learner's account lacks a usable Copilot license/session and fails the pre-flight verification. The pre-flight check ("Verify Copilot access before you begin") currently appears after the "Before You Start" prerequisites list but the actual license/enrollment troubleshooting path is buried one hop away in 07d-confirm-model-access.md, so learners without access don't discover the real fix until they've already tried and failed the in-page test prompt.
Proposed change
Move the Copilot-access pre-flight check to the very top of the page (before the "Before You Start" checklist), and add a one-line direct link to github.com/settings/copilot plus a short "no license yet?" branch pointing to the relevant side quest, so learners self-diagnose access problems before investing time in the rest of the page. This is a re-sequencing and link-clarity fix; it does not remove any existing instructional content, exercises, or checklist items.
Failure mode classification
Access barrier — the dominant failure category (copilot-access-missing) is an environment/licensing gap, not a conceptual or scaffolding gap. This fix should not be expected to move active_learning, checkpoint_quality, or scaffolding scores, and must not be used to justify removing the authoring exercise or compile/commit practice.
Quantitative guardrail
Current scores for 07-your-first-workflow.md:
overall_score: 6.25/10
- Weakest rubric dimension:
checkpoint_quality 0.0/10 (shared across all steps due to a rubric-detection quirk, not specific to this page)
- Learning KPI index components:
active_learning 6.3, checkpoint_quality 0.0, scaffolding 5.0 → index = (2.0×6.3 + 2.0×0.0 + 1.5×5.0) / 5.5 = 3.65/10
Because this is purely a re-sequencing/link-clarity change (moving an existing check earlier, adding a direct link), it should not reduce word_count-driven cognitive_load, active_learning (the hands-on authoring prompt is untouched), or scaffolding (the prerequisite section remains). overall_score and the learning KPI index should stay flat or improve.
Acceptance criteria
Suggested owner profile
workshop maintainer (requires judgment on page flow and cross-links to the billing/access side quests)
Related to #3607
Generated by 🔬 Workshop Student Simulator · copilot · auto · 248.6 AIC · ⌖ 25.8 AIC · ⊞ 14.8K · ◷
Problem statement
07-your-first-workflow.mdis the highest-dropout step in the current simulation: 21.4% conditional dropout among 22,360 at-risk runs (95% CI 20.8%–21.9%).aggregate.failureCategoriesByStepattributes 3,906 of 4,781 total failures at this step tocopilot-access-missing— the learner's account lacks a usable Copilot license/session and fails the pre-flight verification. The pre-flight check ("Verify Copilot access before you begin") currently appears after the "Before You Start" prerequisites list but the actual license/enrollment troubleshooting path is buried one hop away in07d-confirm-model-access.md, so learners without access don't discover the real fix until they've already tried and failed the in-page test prompt.Proposed change
Move the Copilot-access pre-flight check to the very top of the page (before the "Before You Start" checklist), and add a one-line direct link to
github.com/settings/copilotplus a short "no license yet?" branch pointing to the relevant side quest, so learners self-diagnose access problems before investing time in the rest of the page. This is a re-sequencing and link-clarity fix; it does not remove any existing instructional content, exercises, or checklist items.Failure mode classification
Access barrier — the dominant failure category (
copilot-access-missing) is an environment/licensing gap, not a conceptual or scaffolding gap. This fix should not be expected to moveactive_learning,checkpoint_quality, orscaffoldingscores, and must not be used to justify removing the authoring exercise or compile/commit practice.Quantitative guardrail
Current scores for
07-your-first-workflow.md:overall_score: 6.25/10checkpoint_quality0.0/10 (shared across all steps due to a rubric-detection quirk, not specific to this page)active_learning6.3,checkpoint_quality0.0,scaffolding5.0 → index = (2.0×6.3 + 2.0×0.0 + 1.5×5.0) / 5.5 = 3.65/10Because this is purely a re-sequencing/link-clarity change (moving an existing check earlier, adding a direct link), it should not reduce
word_count-drivencognitive_load,active_learning(the hands-on authoring prompt is untouched), orscaffolding(the prerequisite section remains).overall_scoreand the learning KPI index should stay flat or improve.Acceptance criteria
overall_scorefor07-your-first-workflow.mdstays flat or improves after the change(2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5stays flat or improves versus the current 3.65/10 baselineSuggested owner profile
workshop maintainer(requires judgment on page flow and cross-links to the billing/access side quests)Related to #3607