Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[workshop-sim] Improve: Add per-activity checkpoints to agentic workflows intro (05-agentic-workflows-intro.md)

Chiusa Adatta ai principianti
  • Qualcosa non va?
#4,369 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
64/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
markdown
Ambito
documentation

Direzione di ricerca

Inizia da 05-agentic-workflows-intro.md e individua i tre titoli delle attività e i relativi blocchi <details> con la risposta da mostrare. Aggiungi un breve checkpoint di 1-2 elementi subito dopo ciascun blocco, lasciando invariati le attività esistenti, il diagramma della struttura a due file e il link al glossario. Verifica poi il nuovo testo con la checklist di fine pagina. È completato quando ogni attività ha il proprio checkpoint e npx --yes markdownlint-cli2 "**/*.md" non segnala nuovi errori.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

feedback simulation workshop

Problem statement

05-agentic-workflows-intro.md has the single highest total failure count in the simulated cohort (7,350 failures across 1,000×46 runs) and the second-highest conditional dropout rate (19.9% among 36,952 at-risk runs), driven by agentic-concept-gap (5,204 failures) and deployment-capability-gap (2,146 failures). The step scores the lowest active_learning (2.4/10) in the entire curriculum despite stacking three distinct activities back-to-back — opening a .lock.yml to find on:, classifying Task A/B as agentic-or-standard, and writing/self-grading a task brief — with only one optional "Still uncertain?" disclosure as mid-page recovery support and no activity-level checkpoint beyond the final checklist.

Proposed change

Give each of the three activities ("Activity 1 — identify the parts", "Activity 2 — agentic or standard?", "Activity 3 — write a task brief") its own short inline checkpoint (a 1-2 item checklist or explicit "did you get this right?" prompt) immediately after its reveal-answer <details> block, instead of deferring all verification to the single end-of-page checklist. Keep all three activities, the two-file-structure diagram, and the glossary side-quest link exactly as they are — the content is appropriately dense for this concept, it just lacks incremental verification.

Failure mode classification: Learning barrier (conceptual density combined with weak intermediate checkpoints, not an access or tooling issue).

Quantitative guardrail

  • Current overall_score: 5.43/10
  • Weakest rubric dimensions: active_learning 2.4/10 (lowest in the entire 30-step corpus), checkpoint_quality 0.0/10 (shared detection gap across all 30 steps — see report)
  • Current learning KPI index for this step: (2.0×2.4 + 2.0×0.0 + 1.5×5.0) / 5.5 = 2.24/10 (active_learning 2.4, checkpoint_quality 0.0, scaffolding 5.0)
  • Adding per-activity checkpoints directly targets active_learning and checkpoint_quality without changing word count materially or removing any existing activity, so overall_score and the learning KPI index should rise, not fall.

Acceptance criteria

  • The shared curriculum quantitative assessment overall_score for 05-agentic-workflows-intro.md stays flat or improves after the change
  • The step's learning KPI index (2.0×active_learning + 2.0×checkpoint_quality + 1.5×scaffolding)/5.5 stays flat or improves
  • All three existing hands-on activities (Activity 1, 2, 3) and their reveal-answer <details> blocks are preserved, with new checkpoints added rather than content removed
  • Markdown passes npx --yes markdownlint-cli2 "**/*.md" with no new errors

Suggested owner: workshop maintainer
Related to #4367

Generated by 🔬 Workshop Student Simulator · copilot · auto · 163.7 AIC · ⌖ 12.2 AIC · ⊞ 15.1K · ◷

  • expires on Oct 10, 2026, 7:10 AM UTC
Lingua principale
JavaScript
Stelle
53
Fork
35
Merge medio
1g 6h
PR unite (30g)
15

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

  • Nessun Dockerfile né file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di githubnext/gh-aw-workshop

Tutte le issue di githubnext/gh-aw-workshop

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.