[workshop-sim] Repair: Strengthen checkpoints and lock-file prerequisite in Agentic intro (Step 5)
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 68/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- github-actions, markdown, yaml
- Domain
- documentation
Research direction
Start by reading 05-agentic-workflows-intro.md, especially Activity 1 on lines 53–58 and the Step 7 references to lock files. Replace Activity 1 with a linked or inline sample .lock.yml excerpt so it works without prior state, then add a checkpoint after the three key terms and a “stuck?” hint for the two-file prediction. Verify the shared curriculum assessment overall_score and the learning KPI remain flat or improve, and confirm Activity 1 needs no previously created workflow files.
Written by the indexing model from the issue text.
Description
Problem
05-agentic-workflows-intro.md has 18.6% conditional dropout (6,864/36,948): 4,671 agentic-concept-gap, 2,193 deployment-capability-gap. Activity 1 (lines 53–58) tells learners to open "any .lock.yml file in your repo", but no lock file exists before Step 7. The page has no recovery help (troubleshootingSupport 0.06) and a long concept load (trigger, task brief, safe outputs, sandbox, two files).
Proposed change
Replace Activity 1 with a linked sample lock file excerpt (or an inline snippet) so the activity works with no prior state. Add a short intermediate checkpoint after the three key terms and a "stuck?" hint for the two-file prediction.
Failure mode
Learning barrier (with a small state-assumption component).
Quantitative guardrail
Current: overall 5.39, cognitive_load 8.4, active_learning 2.3 (weakest learning dimension), checkpoint_quality 0.0, scaffolding 5.0 (KPI ≈ 2.3). Adding a working hands-on activity and mid-page checkpoint increases active_learning and checkpoint_quality without cutting content.
Acceptance criteria
- Shared curriculum assessment
overall_scorefor this step stays flat or improves - Learning KPI index
(2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5stays flat or improves - Hands-on practice, checkpoints, and scaffolding are preserved or strengthened
- Activity 1 can be completed without any previously created workflow files
Suggested owner
copilot coding agent
Generated by 🔬 Workshop Student Simulator · copilot · auto · ~38 AIC · ⌖ ~1 AIC · ⊞ 15.4K · ◷
- expires on Nov 22, 2026, 11:03 AM UTC
- Dominant language
- JavaScript
- Stars
- 61
- Forks
- 43
- Avg merge
- 10h 38m
- Merged PRs (30d)
- 12
Getting set up
Starts the project's dev container in your browser, under your own GitHub account.
- No Dockerfile or Docker Compose file
- No pull request template
- No contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from githubnext/gh-aw-workshop
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#5972 ·
Maintainers usually reply within 1 day
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
githubnext/gh-aw-workshop#5966 ·
Maintainers usually reply within 1 day
-
documentation
Difficulty 1/5 Under an hour Newbie friendliness 88/100
githubnext/gh-aw-workshop#5965 ·
Maintainers usually reply within 1 day
-
documentation
Difficulty 1/5 Under an hour Newbie friendliness 88/100
githubnext/gh-aw-workshop#5964 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
githubnext/gh-aw-workshop#5959 ·
Maintainers usually reply within 1 day
All issues in githubnext/gh-aw-workshop
Similar issues
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
swc-project/swc-ai-issues#995 ·
-
Development server fails with webpack-dev-server 6.1.0Possibly taken @utsxvrai claimed this today. Openbug
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
rabbitmq/rabbitmq-website#2733 ·
Maintainers usually reply within 1 day
-
Difficulty 1/5 Under an hour Newbie friendliness 80/100
kentcdodds/kcd-skills#32 ·
-
Edit: Cool ChannelOpenapproved channels:edit check:passed
Difficulty 1/5 Under an hour Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
area:frontend priority:normal type:enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Mystify7777/aquaveda-v2#241 ·
Maintainers usually reply within 1 day