[curriculum-eval] 05-agentic-workflows-intro.md: cognitive_load — 1107-word core step with low activity density
Maintainers usually reply within 3 days
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 88/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript, markdown
- Domain
- content, documentation
Research direction
Edit workshop/05-agentic-workflows-intro.md, following the improvement prompt: reduce the page to 800 words or fewer, shorten the skip-ahead block, keep the named sections concise, and retain Activities 2 and 3 and the existing checkpoint. Run npx --yes markdownlint-cli2 "**/*.md"; the work is done when the page meets the word limit and the lint command passes.
Written by the indexing model from the issue text.
Description
File: workshop/05-agentic-workflows-intro.md
Overall Score: 5.4 / 10.0 (corpus mean: 6.1)
Flagged Dimensions:
| Dimension | Score | Benchmark | Delta |
|---|---|---|---|
| cognitive_load | reduced (1107 words) | ≤ 800 words | −3 pts approx. |
| active_learning | low (flagged) | density ≥ 3 | below |
| checkpoint_quality | 0.0 reported; a checkpoint exists at line 120 (regex false positive, see rubric issue) | ≥ 4 items | n/a |
Root Cause (≤ 2 sentences):
A core-path page combines three terms, the two-file structure, and three activities, exceeding the word ceiling for a conceptual step. A skip-ahead block at the top also adds text before the first concept.
Evidence (quoted from the file):
"Before skipping, confirm you already know both of these: You can describe what an Actions workflow trigger does; You have worked with AI agent execution environments in a production or CI/CD context"
Learning Science Rationale:
Mayer's segmenting and Sweller's CLT predict that early conceptual steps benefit from shorter chunks. Core path step 05 is the learner's first exposure to agentic concepts, so extraneous load here has outsized effect on later steps.
Improvement Prompt (for an agent):
Edit workshop/05-agentic-workflows-intro.md to ≤ 800 words: shorten the skip-ahead block to a single sentence, keep "Three key terms" and "The two-file structure" concise, and keep Activity 2 and Activity 3 but tighten surrounding prose. Preserve the existing "## :white_check_mark: Checkpoint". Run `npx --yes markdownlint-cli2 "**/*.md"`.
Expected Score After Fix: 6.3 / 10.0
Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · ~36 AIC · ⌖ ~1 AIC · ⊞ 5K · ◷
- expires on Nov 7, 2026, 7:04 AM UTC
- Dominant language
- JavaScript
- Stars
- 58
- Forks
- 40
- Avg merge
- 4d 4h
- Merged PRs (30d)
- 8
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
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#5401 ·
Maintainers usually reply within 3 days
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
githubnext/gh-aw-workshop#5392 ·
Maintainers usually reply within 3 days
-
documentation
Difficulty 1/5 1-3 hours Newbie friendliness 88/100
githubnext/gh-aw-workshop#5379 ·
Maintainers usually reply within 3 days
-
[workshop-sync] workshop/side-quest-11-02-yaml-frontmatter.md: `emoji: :bar_chart:` is invalid YAMLOpendocumentation
Difficulty 1/5 Under an hour Newbie friendliness 88/100
githubnext/gh-aw-workshop#5368 ·
Maintainers usually reply within 3 days
-
curriculum documentation quality
Difficulty 2/5 1-3 hours Newbie friendliness 77/100
githubnext/gh-aw-workshop#5367 · 1 comment ·
Maintainers usually reply within 3 days
All issues in githubnext/gh-aw-workshop
Similar issues
-
Windows flake: withFileLock throws EPERM when the previous holder's lock file is still being deletedOpen
Difficulty 2/5 1-3 hours Newbie friendliness 79/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
-
area: agent area: integration lane: strong-agent priority: P2 roadmap size: S type: integration type: task
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
arminazimi/seaworthy#688 ·
Maintainers usually reply within 1 day
-
idea-scout idea:245
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
jeanibarz/agent-notebook#245 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
obsidianmd/obsidian-developer-docs#281 ·
Maintainers usually reply within 4 days