[workshop-sim] Repair: Strengthen checkpoints and lock-file prerequisite in Agentic intro (Step 5)

Ouverte Adaptée aux débutants
#5,973 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
68/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
github-actions, markdown, yaml
Domaine
documentation

Piste de recherche

Commence par lire 05-agentic-workflows-intro.md, en particulier l’activité 1 aux lignes 53–58 et les références aux fichiers de verrouillage à l’étape 7. Remplace l’activité 1 par un extrait d’exemple .lock.yml lié ou intégré, afin qu’elle fonctionne sans état préalable, puis ajoute un checkpoint après les trois termes clés et une indication « bloqué ? » pour la prédiction à deux fichiers. Vérifie que l’évaluation partagée du cursus overall_score et le KPI d’apprentissage restent stables ou s’améliorent, et confirme que l’activité 1 ne nécessite aucun fichier de workflow créé au préalable.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

feedback simulation workshop
Problem

05-agentic-workflows-intro.md has 18.6% conditional dropout (6,864/36,948): 4,671 agentic-concept-gap, 2,193 deployment-capability-gap. Activity 1 (lines 53–58) tells learners to open "any .lock.yml file in your repo", but no lock file exists before Step 7. The page has no recovery help (troubleshootingSupport 0.06) and a long concept load (trigger, task brief, safe outputs, sandbox, two files).

Proposed change

Replace Activity 1 with a linked sample lock file excerpt (or an inline snippet) so the activity works with no prior state. Add a short intermediate checkpoint after the three key terms and a "stuck?" hint for the two-file prediction.

Failure mode

Learning barrier (with a small state-assumption component).

Quantitative guardrail

Current: overall 5.39, cognitive_load 8.4, active_learning 2.3 (weakest learning dimension), checkpoint_quality 0.0, scaffolding 5.0 (KPI ≈ 2.3). Adding a working hands-on activity and mid-page checkpoint increases active_learning and checkpoint_quality without cutting content.

Acceptance criteria
  • Shared curriculum assessment overall_score for this step stays flat or improves
  • 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
  • Activity 1 can be completed without any previously created workflow files
Suggested owner

copilot coding agent

Generated by 🔬 Workshop Student Simulator · copilot · auto · ~38 AIC · ⌖ ~1 AIC · ⊞ 15.4K · ◷

  • expires on Nov 22, 2026, 11:03 AM UTC
Langage dominant
JavaScript
Étoiles
61
Forks
43
Merge moyen
10 h 38 min
PR mergées (30 j)
12

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

  • Aucun Dockerfile ni fichier Docker Compose
  • Aucun modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de githubnext/gh-aw-workshop

Toutes les issues de githubnext/gh-aw-workshop

Issues similaires

Plus d'issues JavaScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.