[workshop-sim] Repair: Fix Step 5 lock-file state gap and add retrieval practice

Closed Beginner friendly
  • Is something wrong?
#5,264 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 3 days

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
60/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
github-actions
Domain
documentation

Research direction

Start with Activity 1 in 05-agentic-workflows-intro.md, around line 53, where the page asks learners to open any .lock.yml file in their repo. Replace that step with a self-contained annotated snippet, add a prediction-then-check exercise, a short knowledge check on the two-file structure, and a recovery note for learners without a lock file. Done when Activity 1 no longer depends on a file the learner has not created, and the page keeps its existing practice and checkpoints.

Written by the indexing model from the issue text.

Description

feedback simulation workshop
Problem

05-agentic-intro has 18.9% conditional dropout (36,945 at-risk runs). The failures are agentic-concept-gap (4,772) and deployment-capability-gap (2,194). 05-agentic-workflows-intro.md:53 asks learners to open "any .lock.yml file in your repo" before any workflow exists, so the activity may have nothing to open. The page's active_learning score is 2.4.

Proposed change

Replace Activity 1 with a self-contained annotated .lock.yml snippet to inspect, plus a prediction-then-check exercise. Add one short knowledge check on the two-file structure that is revealed after the learner answers. Add a recovery note for learners who have no .lock.yml yet.

Failure mode

Learning barrier. Fix it with scaffolding and practice, not by removing concepts.

Quantitative guardrail
  • Current overall_score: 5.43. Weakest dimensions: active_learning 2.4 and checkpoint_quality 0.0.
  • Learning KPI inputs: active_learning 2.4, checkpoint_quality 0.0, scaffolding 5.0 (index 2.22).
  • Adding an inspectable artifact and a retrieval check increases practice and scaffolding, so all three should hold or rise.
Acceptance criteria
  • Shared curriculum quantitative assessment overall_score for 05-agentic-workflows-intro.md 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, not removed.
  • Activity 1 no longer depends on a file the learner has not yet created.
Suggested owner

copilot coding agent

Generated by 🔬 Workshop Student Simulator · copilot · auto · ~42 AIC · ⌖ ~1 AIC · ⊞ 15.4K · ◷

  • expires on Nov 3, 2026, 7:07 AM UTC
Dominant language
JavaScript
Stars
58
Forks
40
Avg merge
4d 4h
Merged PRs (30d)
8

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.