[workshop-sim] Improve: Add a Step 4 vocabulary recap and scored checkpoint to Step 5
Maintainers usually reply within 1 day
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 74/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- markdown
- Domain
- documentation
Research direction
Start by reading workshop/05-agentic-workflows-intro.md end to end, then workshop/04-github-actions-intro.md to collect the five Actions vocabulary terms the recap must reference. Add a short recap callout at the top of Step 5 introducing those terms before the three agentic terms, then convert one of the reveal-answer activities in the block at workshop/05-agentic-workflows-intro.md:47-108 into a checklist-scored checkpoint while preserving all three activities and the existing checklist verbatim. Check the shared curriculum rubric (the scoring script or workflow referenced in the issue) to confirm checkpoint_quality and active_learning rise and no other metric drops.
Written by the indexing model from the issue text.
Description
Problem statement
05-agentic-workflows-intro.md is the second-lowest-scoring curriculum step (overall_score 5.43/10, the lowest active_learning score in the corpus at 2.4/10) and the third-highest dropout step (18.0% conditional dropout across 35,780 at-risk runs, 95% CI 17.6%–18.4%), with failures split between agentic-concept-gap (4,331) and deployment-capability-gap (2,103). This step lands immediately after 04-github-actions-intro.md, so two consecutive concept-dense pages stack cognitive load before any hands-on workflow authoring occurs in Step 7. The page already has three embedded activities (two-file-structure prediction, Activity 2 classification, Activity 3 task-brief drafting at workshop/05-agentic-workflows-intro.md:47-108), but checkpoint_quality still scores 0.0/10 under the shared rubric.
Proposed change
Add a short "Recap: what you already learned" callout at the top of 05-agentic-workflows-intro.md that briefly reconnects the five Actions vocabulary terms from Step 4 (one line per term, not a full re-explanation) before introducing the three new agentic-specific terms (trigger/task brief/safe outputs). This reduces the perceived concept jump between steps without removing any content, and converts one of the existing "reveal answer" activities into a checklist-scored checkpoint item to raise checkpoint_quality.
Failure mode classification: Learning barrier
Quantitative guardrail
Current 05-agentic-workflows-intro.md scores: overall_score 5.43/10, active_learning 2.4/10, checkpoint_quality 0.0/10, scaffolding 5.0/10 (learning KPI index 2.51/10, the lowest in the corpus). Adding a recap callout increases has_prereq_section-style scaffolding signal and converts an existing activity into a scored checklist item, which should raise checkpoint_quality and active_learning under the shared rubric without adding new concepts (new_concepts count stays the same, so cognitive_load should not worsen).
Acceptance criteria
- The shared curriculum quantitative assessment
overall_scorefor05-agentic-workflows-intro.mdstays flat or improves after the change - The learning KPI index
(2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5for this step stays flat or improves, withactive_learningandcheckpoint_qualityspecifically increasing - All three existing activities (two-file-structure prediction, Activity 2, Activity 3 task-brief drafting) and the existing checkpoint checklist are preserved in full, not condensed or removed
- The simulated
agentic-concept-gapanddeployment-capability-gapdropout rates at05-agentic-introdecrease in a follow-up simulation run
Suggested owner: workshop maintainer
Related to #4288
Generated by 🔬 Workshop Student Simulator · copilot · auto · 173.8 AIC · ⌖ 6.28 AIC · ⊞ 15.1K · ◷
- expires on Oct 8, 2026, 7:09 AM UTC
- Dominant language
- JavaScript
- Stars
- 52
- Forks
- 26
- Avg merge
- 11h 32m
- Merged PRs (30d)
- 22
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
-
[workshop-sim] Repair: Add a fallback sample .lock.yml to the Agentic Workflows Intro Activity 1Openfeedback simulation workshop
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
githubnext/gh-aw-workshop#4328 ·
Maintainers usually reply within 1 day
-
documentation guidelines
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
githubnext/gh-aw-workshop#4314 ·
Maintainers usually reply within 1 day
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#4311 ·
Maintainers usually reply within 1 day
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
githubnext/gh-aw-workshop#4309 ·
Maintainers usually reply within 1 day
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
githubnext/gh-aw-workshop#4310 ·
Maintainers usually reply within 1 day
All issues in githubnext/gh-aw-workshop
Similar issues
-
Engineering
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
techmatters/terraso-web-client#3095 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
Service process inherits the caller's cwd at first use, holding that folder open on Windows (EBUSY)Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
nextcloud/viewer#3424 · 1 comment ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
Maintainers usually reply within 1 day