Problem statement
04-github-actions-intro.md is the lowest-scoring curriculum step overall (overall_score: 5.39/10) and has a 17.6% conditional dropout rate driven entirely by the concept-overload failure category. It introduces 28 new concepts in only 756 words (trigger, job, step, runner, YAML structure, workflow file location, etc.), presented in a single dense annotated example block, with checkpoint_quality: 0.0 and no intermediate comprehension check between introducing each term.
Proposed change
- Split the single annotated example block into two smaller passes: introduce
trigger/on first with a one-line self-check question, then introduce jobs/steps/runner with a second one-line self-check, before combining them in the full example.
- Add a proper
## ✅ Checkpoint heading (the existing checkpoint section uses non-matching heading text/emoji per the shared rubric's CHECKPOINT_RE pattern) so the step is correctly recognized as having a checkpoint, and add 2-3 checklist items tied to the newly split concept checks.
Failure mode classification
Learning barrier (conceptual density and insufficient scaffolding/checkpoints, not environment or tooling friction).
Quantitative guardrail
Current 04-github-actions-intro.md scores: overall_score: 5.39/10, cognitive_load: 6.8, active_learning: 3.9, checkpoint_quality: 0.0, scaffolding: 5.0, readability: 10.0, style_compliance: 10.0. Learning KPI index for this step: (2.0×3.9 + 2.0×0.0 + 1.5×5.0) / 5.5 = 2.77/10.
Splitting the dense example into scaffolded increments raises active_learning (more self-checks) and fixing the checkpoint heading directly raises checkpoint_quality from 0.0, so both overall_score and the learning KPI index should improve. This is a genuine instructional gap (both active_learning and checkpoint_quality are the weakest dimensions for this step), not a case of removing appropriate challenge — the total concept count and technical depth stay the same, only the pacing and verification improve.
Acceptance criteria
Suggested owner
workshop maintainer
Related to #3195
Generated by 🔬 Workshop Student Simulator · copilot · auto · 186.5 AIC · ⌖ 20.1 AIC · ⊞ 15.2K · ◷
Problem statement
04-github-actions-intro.mdis the lowest-scoring curriculum step overall (overall_score: 5.39/10) and has a 17.6% conditional dropout rate driven entirely by theconcept-overloadfailure category. It introduces 28 new concepts in only 756 words (trigger, job, step, runner, YAML structure, workflow file location, etc.), presented in a single dense annotated example block, withcheckpoint_quality: 0.0and no intermediate comprehension check between introducing each term.Proposed change
trigger/onfirst with a one-line self-check question, then introducejobs/steps/runnerwith a second one-line self-check, before combining them in the full example.## ✅ Checkpointheading (the existing checkpoint section uses non-matching heading text/emoji per the shared rubric'sCHECKPOINT_REpattern) so the step is correctly recognized as having a checkpoint, and add 2-3 checklist items tied to the newly split concept checks.Failure mode classification
Learning barrier (conceptual density and insufficient scaffolding/checkpoints, not environment or tooling friction).
Quantitative guardrail
Current
04-github-actions-intro.mdscores:overall_score: 5.39/10,cognitive_load: 6.8,active_learning: 3.9,checkpoint_quality: 0.0,scaffolding: 5.0,readability: 10.0,style_compliance: 10.0. Learning KPI index for this step:(2.0×3.9 + 2.0×0.0 + 1.5×5.0) / 5.5 = 2.77/10.Splitting the dense example into scaffolded increments raises
active_learning(more self-checks) and fixing the checkpoint heading directly raisescheckpoint_qualityfrom 0.0, so bothoverall_scoreand the learning KPI index should improve. This is a genuine instructional gap (bothactive_learningandcheckpoint_qualityare the weakest dimensions for this step), not a case of removing appropriate challenge — the total concept count and technical depth stay the same, only the pacing and verification improve.Acceptance criteria
overall_scorefor04-github-actions-intro.mdstays flat or improves after the change(2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5stays flat or improves## ✅ Checkpointheading with at least as many checklist items as the current versionSuggested owner
workshop maintainerRelated to #3195