[workshop-sim] Improve: Add intermediate checkpoints to What Are Agentic Workflows? to close the agentic-concept-gap
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 84/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Domain
- documentation
Research direction
Open 05-agentic-workflows-intro.md and review the three existing activities and the current end-of-page checklist. Add one short scored self-check after each activity, covering file roles, task classification, and task-brief criteria, while retaining the existing content. Confirm the shared curriculum scores and learning KPI stay flat or improve.
Written by the indexing model from the issue text.
Description
Problem statement
05-agentic-workflows-intro.md has the lowest active_learning score in the curriculum (2.4/10) and zero checkpoint_quality, and it is the third-highest-dropout step at 18.71% conditional dropout (37,149 at-risk runs), with agentic-concept-gap as the dominant failure category. The page has three good activities (file labeling, task classification, brief-writing) but only a single end-of-page checklist — a learner who stumbles on Activity 1 (the two-file structure) gets no signal until the final checkpoint, by which point they may already be lost on the core trigger/task-brief/safe-outputs concept.
Proposed change
Add a short scored self-check immediately after each of the three existing activities (not just at the end of the page), so a learner gets immediate feedback on whether they correctly identified the .md/.lock.yml roles, classified Task A/B correctly, and met the three task-brief criteria — before moving to the next activity. This adds checkpoints; it does not remove any existing content or activity.
Failure mode classification
Learning barrier — low active_learning and zero checkpoint_quality indicate a scaffolding gap, not an access/environment problem.
Quantitative guardrail
Current scores for 05-agentic-workflows-intro.md: overall_score 5.43/10 (lowest in Part 1 alongside 04-github-actions-intro.md), active_learning 2.4, checkpoint_quality 0.0, scaffolding 5.0 → learning KPI index 2.00/10 (lowest of the three steps prioritized in this simulation). Because the proposed change adds intermediate checkpoints and keeps existing activities intact, it should raise checkpoint_quality and active_learning directly while not lowering scaffolding, overall_score, or the KPI index. Do not resolve this by simplifying or removing the three-key-terms table or activities — the dropout here is a scaffolding gap, not excess difficulty.
Acceptance criteria
- The shared curriculum quantitative assessment
overall_scorefor05-agentic-workflows-intro.mdstays flat or improves after the change - The step's 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 (not removed or weakened to chase completion numbers)
- Each of the three existing activities (file-identification, task classification, brief-writing) has its own intermediate check, in addition to the existing end-of-page checklist
Suggested owner
copilot coding agent
Related to #4087
Generated by 🔬 Workshop Student Simulator · copilot · auto · 197.6 AIC · ⌖ 7.17 AIC · ⊞ 15.1K · ◷
- expires on Oct 3, 2026, 9:02 AM UTC
- Dominant language
- JavaScript
- Stars
- 52
- Forks
- 26
- Avg merge
- 12h 25m
- Merged PRs (30d)
- 18
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
-
feedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
githubnext/gh-aw-workshop#4370 ·
Maintainers usually reply within 1 day
-
feedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 64/100
githubnext/gh-aw-workshop#4369 ·
Maintainers usually reply within 1 day
-
feedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
githubnext/gh-aw-workshop#4368 ·
Maintainers usually reply within 1 day
-
documentation
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#4366 ·
Maintainers usually reply within 1 day
-
documentation
Difficulty 1/5 Under an hour Newbie friendliness 88/100
githubnext/gh-aw-workshop#4365 ·
Maintainers usually reply within 1 day
All issues in githubnext/gh-aw-workshop
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
NaturalIntelligence/fast-xml-parser#888 · 1 comment ·
Maintainers usually reply within 2 days
-
bug callouts regression revealjs
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
quarto-dev/quarto-cli#15014 ·
Maintainers usually reply within 1 day
-
check:passed feeds:remove
Difficulty 1/5 Under an hour Newbie friendliness 65/100
iptv-org/database#37176 · 1 comment · 1 reaction ·
Maintainers usually reply within 9 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
hawk-digital-environments/HAWKI#443 ·
Maintainers usually reply within 1 day
-
documentation v2
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
modelcontextprotocol/python-sdk#3662 ·
Maintainers usually reply within 1 day