Skip to content

Add Step 12 compile-first iteration guidance to reduce workflow-not-compiled dropoff#1651

Merged
pelikhan merged 7 commits into
mainfrom
copilot/fix-12-test-iterate-dropout
Jul 20, 2026
Merged

Add Step 12 compile-first iteration guidance to reduce workflow-not-compiled dropoff#1651
pelikhan merged 7 commits into
mainfrom
copilot/fix-12-test-iterate-dropout

Conversation

Copilot AI commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

Step 12 is the workshop’s largest dropout point, and the dominant failure mode is workflow-not-compiled. The simulator currently maps no workshop content to that step, so learners get no in-flow reminder that workflow edits must be recompiled before the next test run.

  • Add the missing Step 12 node

    • Introduces workshop/12-test-and-iterate.md as the canonical iteration step.
    • Centers the learner loop on one change at a time: observe, edit, compile, re-run, compare.
  • Make compile-before-test explicit

    • Adds a hard reminder that GitHub Actions executes the compiled .lock.yml, not the source .md.
    • Places gh aw compile in the critical path before every validation run, targeting the exact failure category driving attrition.
  • Repair workshop flow and discoverability

    • Routes Step 9 forward to Step 12 instead of skipping directly to “Next steps”.
    • Adds Step 12 to workshop/README.md so curriculum and simulator-visible structure stay aligned.
    • Updates workshop/00-welcome.md to reflect the compile → test → iterate loop learners actually need.

Example of the new guidance added to the workshop:

> [!IMPORTANT]
> Compile after every workflow edit before you test it. GitHub Actions runs the
> compiled `.lock.yml` file, not the source `.md` file, so skipping `gh aw compile`
> means you are testing stale workflow logic.

```bash
gh aw compile

Copilot AI and others added 7 commits July 20, 2026 16:46
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title Add Step 12 compile-first workflow iteration guidance Add Step 12 compile-first iteration guidance to reduce workflow-not-compiled dropoff Jul 20, 2026
Copilot AI requested a review from pelikhan July 20, 2026 16:51
@pelikhan
pelikhan marked this pull request as ready for review July 20, 2026 16:53
@pelikhan
pelikhan merged commit 0ec5697 into main Jul 20, 2026
@pelikhan
pelikhan deleted the copilot/fix-12-test-iterate-dropout branch July 20, 2026 16:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants