[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — 1,107 words with density 0.72

Open Beginner friendly
  • Is something wrong?
#5,361 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
82/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
bash, github-actions, markdown
Domain
content, documentation

Research direction

Start with workshop/05-agentic-workflows-intro.md and review its three activities, prediction prompt, two-file diagram, and Checkpoint. Trim about 200 words while retaining the three key terms and required elements, then add a short hands-on activity. Run the specified markdownlint command; done when it passes and the page meets the stated content and formatting constraints.

Written by the indexing model from the issue text.

Description

curriculum documentation quality

File: workshop/05-agentic-workflows-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
active_learning 2.4 (density 0.72) ≥ 3 density (score 10) −7.6
cognitive_load 8.5 (1,107 words, 15 concepts) ≤ 800 words −1.5

(missing_checkpoint dismissed: the page has a 6-item Checkpoint; scorer false positive.)

Root Cause (≤ 2 sentences):
This is the first conceptual step for agentic workflows and is ~40% over the word benchmark, with only two code blocks and six checklist items. Three activities exist, but explanatory text between them dilutes activity density.

Evidence (quoted from the file):

"Before studying the diagram, write your prediction: what two files are involved, and which one does GitHub Actions actually run?"

Learning Science Rationale:
Active-learning research (Freeman et al.) and Bloom's Understand level call for learners to generate explanations, not just read them. The prediction prompt above is a good generative activity; the page needs more of them and fewer paragraphs, as Mayer's coherence principle suggests trimming content that does not support the learning goal.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md: trim prose by ~200 words (target ≤ 900) without removing the three key terms, the two-file diagram, or the three activities. Add one short hands-on element, for example a bash block that lists `.github/workflows/` and a prompt to identify the `.md` vs `.lock.yml` file. Keep the existing prediction prompt, the :clipboard: Before You Start and the Checkpoint with ≥ 4 items; keep ≤ 3 callouts and no numbered headings. Run `npx --yes markdownlint-cli2 "workshop/05-agentic-workflows-intro.md"`.

Expected Score After Fix: 5.9 / 10.0 with current scorer (≈ 8.4 after the scorer fix)

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · ~45 AIC · ⌖ ~1 AIC · ⊞ 5K · ◷

  • expires on Nov 6, 2026, 3:32 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.