Problem
Steps 0 (Welcome, 13.2%), 1 (Prerequisites, 12.1%), and 2 (Setup, 17.2%) together eliminate 14 of 38 students before they ever reach the substantive content. The Welcome step does not immediately convey value to skeptical or impatient readers, and the Prerequisites step does not include live environment-validation commands — meaning students discover missing tools (unauthenticated gh, missing node, wrong OS) much later at step 6, causing abandonment.
Simulation pain points: "Value proposition not convincingly stated" (3 students), "No prior CLI experience — unfamiliar with terminal commands" (7 students, most failing at steps 0–2).
Proposed Change
00-welcome.md — Add a 2–3 sentence "Why this matters" paragraph in the first 10 lines with a concrete outcome statement (e.g., "By the end you'll have a scheduled AI agent that posts a daily summary of your repository's activity — automatically, no manual check required").
01-prerequisites.md — Add a self-check script block near the top:
gh auth status && gh --version && echo "✅ Ready to continue"
If the command fails, link directly to the auth fix steps. This catches the most common failure mode before step 6.
Acceptance Criteria
Suggested Owner
workshop maintainer (light copy + one code block addition)
Generated by 🔬 Workshop Student Simulator · 39 AIC · ⌖ 5.8 AIC · ⊞ 8K · ◷
Problem
Steps 0 (Welcome, 13.2%), 1 (Prerequisites, 12.1%), and 2 (Setup, 17.2%) together eliminate 14 of 38 students before they ever reach the substantive content. The
Welcomestep does not immediately convey value to skeptical or impatient readers, and thePrerequisitesstep does not include live environment-validation commands — meaning students discover missing tools (unauthenticatedgh, missingnode, wrong OS) much later at step 6, causing abandonment.Simulation pain points: "Value proposition not convincingly stated" (3 students), "No prior CLI experience — unfamiliar with terminal commands" (7 students, most failing at steps 0–2).
Proposed Change
00-welcome.md— Add a 2–3 sentence "Why this matters" paragraph in the first 10 lines with a concrete outcome statement (e.g., "By the end you'll have a scheduled AI agent that posts a daily summary of your repository's activity — automatically, no manual check required").01-prerequisites.md— Add a self-check script block near the top:Acceptance Criteria
00-welcome.mdopens with a concrete outcome statement within the first visible paragraph01-prerequisites.mdincludes a single copy-paste self-check command that validatesghauth and versiongh auth logindocumentation if the command failsnpx markdownlint-cli2 "workshop/00-welcome.md" "workshop/01-prerequisites.md"passesSuggested Owner
workshop maintainer(light copy + one code block addition)