[workshop-sim] Repair: Strengthen checkpoints and lock-file prerequisite in Agentic intro (Step 5)

Open Beginner friendly
#5,973 0 comments 0 reactions 0 assignees View on GitHub

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

feedback simulation workshop
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_score for this step stays flat or improves
  • Learning KPI index (2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5 stays 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

Open in Codespaces

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

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.