[workshop-sim] Improve: Provide a concrete example and activity checks in agentic intro (step 5)

Open Beginner friendly
  • Is something wrong?
#5,715 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
Mostly clear
Activity status
Active
Tech stack
github-actions, markdown, yaml
Domain
documentation

Research direction

The problem is in 05-agentic-workflows-intro.md, where Activity 1 (around line 53) asks learners to open an existing .lock.yml they may not have. Read Activities 1–3 and the three key terms, then decide where a short sample .md and its compiled .lock.yml excerpt showing on: should go. Done when Activity 1 can be completed in a repo with no workflow file, and each of Activities 1–3 has a check-yourself answer that links back to a key term.

Written by the indexing model from the issue text.

Description

feedback simulation workshop
Problem statement

05-agentic-intro has 19.4% conditional dropout among 36,805 at-risk runs (4,971 agentic-concept-gap, 2,181 deployment-capability-gap). Activity 1 (05-agentic-workflows-intro.md:53) tells learners to open "any .lock.yml" in their repo, but they have not created one yet; checkpoint quality is 0.0 and active learning is 2.3.

Proposed change

Embed a short sample .md plus its compiled .lock.yml excerpt so learners can find on: without prior state, and add a check-yourself answer for Activities 1–3 that maps back to the three key terms. Keep the prediction-first exercises.

Failure mode classification

Learning barrier.

Quantitative guardrail
  • 05-agentic-workflows-intro.md: overall_score 5.39; weakest checkpoint_quality 0.0 and active_learning 2.3.
  • Learning KPI inputs: active_learning 2.3, checkpoint_quality 0.0, scaffolding 5.0 → KPI 2.20.
  • The sample artifact adds scaffolding and verified activities, so all three should hold or rise; no complexity is removed.
Acceptance criteria
  • Shared curriculum overall_score for step 5 stays flat or improves
  • Learning KPI index stays flat or improves
  • Hands-on practice, checkpoints, and scaffolding are preserved or strengthened
  • Activity 1 can be completed without any prior workflow file in the learner's repo
Suggested owner

workshop maintainer

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

  • expires on Nov 15, 2026, 11:04 AM UTC
Dominant language
JavaScript
Stars
62
Forks
43
Avg merge
12h 23m
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.