Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[workshop-sim] Improve: Add verifiable checkpoints and practice to Step 5 intro

Closed Beginner friendly
  • Is something wrong?
#4,755 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
72/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github, markdown
Domain
documentation

Research direction

Find 05-agentic-workflows-intro.md in the shared curriculum and review its current skip gate, checkpoint, and explanations of the two-file model. Add a hands-on question about a real .md/.lock.yml pair, a fill-in-the-blank checkpoint with answers in a <details> block, and a two-question skip check with answers. Check the shared curriculum scores and learning KPI against the stated guardrails, then run Markdown lint.

Written by the indexing model from the issue text.

Description

feedback simulation workshop
Problem

05-agentic-workflows-intro.md loses 18.9% of 36,909 at-risk runs, or 6,983 dropouts. The categories are agentic-concept-gap (4,919) and deployment-capability-gap (2,064). The page introduces trigger, task brief, safe outputs, the two-file model, and agentic-vs-standard classification. The checkpoint is self-assessed ("You can describe...") and the skip gate at the top is ambiguous.

Proposed change
  • Add one hands-on activity that has the learner open or view a real .md/.lock.yml pair and answer a concrete question, such as which key lists safe outputs.
  • Add a concrete fill-in-the-blank checkpoint item, with answers in a <details> block.
  • Tighten the skip gate to a 2-question check with answers.
Failure mode

Learning barrier. The fix is better scaffolding and checkpoints, not less content.

Quantitative guardrail
  • Current overall_score is 5.43.
  • active_learning is 2.4, checkpoint_quality 0.0, scaffolding 5.0, giving an index of about 2.2.
  • Adding activities and checkpoints targets the two weakest dimensions without removing concepts.
Acceptance criteria
  • The shared curriculum overall_score for the affected step stays flat or improves.
  • The step's 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.
  • Markdown lint passes.
Suggested owner

workshop maintainer

Generated by 🔬 Workshop Student Simulator · copilot · auto · 45.1 AIC · ⌖ 0.822 AIC · ⊞ 15.2K · ◷

  • expires on Oct 20, 2026, 9:50 AM UTC
Dominant language
JavaScript
Stars
55
Forks
36
Avg merge
1d 6h
Merged PRs (30d)
15

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.