[workshop-sim] Improve: Add recovery guidance and worked answers to GitHub Actions intro self-checks

[github-actions]

Problem statement

04-github-actions-intro.md is the lowest curriculum-quality-scored file in the workshop (overall score 5.39/10) and is simultaneously the third-highest-dropout step (15.5% conditional dropout among 44,227 at-risk simulated runs, 95% CI 15.1%–15.8%). The dominant failure category is concept-overload (6,846 failures) — five new Actions primitives (trigger, job, runner, step, action) are introduced in one page, and the self-check exercise ("label each highlighted part") has no troubleshooting path, no callout, and no worked-answer guidance if a learner mislabels the sample workflow or cannot find the described UI elements. The only "reveal" support is a collapsed answer key for the syntactic labeling exercise — the separate "explore a real workflow" browser activity has no fallback at all.

Proposed change

Add a short recovery/troubleshooting callout after both self-check activities (the labeling exercise and the "explore a real workflow" exercise) that gives learners a concrete next step if they get stuck (for example: a worked example screenshot, a link to a glossary entry for the term they missed, or a pointer to ask their AI agent to explain the specific YAML key). This targets checkpoint_quality and active_learning directly without removing any of the five Actions concepts currently taught.

Failure mode classification

Learning barrier — this step has genuine conceptual density (five new terms), but the primary gap is insufficient scaffolding and checkpoint support, not excessive difficulty. The fix must add support, not remove content.

Quantitative guardrail

• Current overall_score for 04-github-actions-intro.md: 5.39/10 (lowest in the corpus)
• Weakest rubric dimensions: checkpoint_quality (0.0/10) and active_learning (3.9/10)
• Current learning KPI index for this step: active_learning 3.9, checkpoint_quality 0.0, scaffolding 5.0 → KPI = 2.78/10
• Rationale: adding recovery guidance and a worked-answer path to the existing self-check exercises is a scaffolding addition, not a simplification — it should raise checkpoint_quality and potentially active_learning (more interactive engagement with the material) while overall_score should rise or stay flat. Do not remove any of the five terms or shorten the "why this matters for agentic workflows" comparison table to chase completion — that would lower the cognitive bar rather than close a genuine scaffolding gap.

Acceptance criteria

• The shared curriculum quantitative assessment overall_score for 04-github-actions-intro.md stays flat or improves after the change
• The step's learning KPI index (2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5 stays flat or improves for 04-github-actions-intro.md
• All five Actions concepts (trigger, job, runner, step, action) and both existing self-check activities remain in the page — no content is cut to reduce cognitive load
• A concrete recovery path (worked example, glossary link, or "ask your agent" prompt) is added for learners who cannot complete the labeling or real-workflow-exploration exercise unassisted

Suggested owner

copilot coding agent
Related to #3409

Generated by 🔬 Workshop Student Simulator · copilot · auto · 166.2 AIC · ⌖ 7.33 AIC · ⊞ 15.2K · ◷

• expires on Sep 16, 2026, 5:44 PM UTC

[github-actions]

This issue is being closed as outdated. A newer issue has been created: #3418

View newer issue

---

This action was performed automatically by the Workshop Student Simulator workflow.

[github-actions]

This issue is being closed as outdated. A newer issue has been created: #3419

View newer issue

---

This action was performed automatically by the Workshop Student Simulator workflow.