Skip to content

Reduce cognitive load in the sub-agent syntax side quest#995

Merged
pelikhan merged 10 commits into
mainfrom
copilot/curriculum-eval-fix-cognitive-load-yet-again
Jul 14, 2026
Merged

Reduce cognitive load in the sub-agent syntax side quest#995
pelikhan merged 10 commits into
mainfrom
copilot/curriculum-eval-fix-cognitive-load-yet-again

Conversation

Copilot AI commented Jul 14, 2026

Copy link
Copy Markdown
Contributor

The sub-agent syntax side quest had drifted into a dense reference page: too many rules, too much exposition, and too little learner action. This change refactors it into a short repair exercise that teaches the same core constraints through one concrete workflow edit.

  • What changed

    • Replaced the rule-heavy reference structure with a single broken-to-correct sub-agent example
    • Reduced scope to the three constraints learners actually need to internalize first:
      • valid sub-agent naming
      • supported sub-agent frontmatter
      • block placement at the bottom of the workflow
  • Learning flow

    • Learners now fix one intentionally broken block in sequence instead of paging through multiple rule sections
    • The exercise ends by applying the pattern to their own Step 21 workflow, keeping the side quest anchored to a real artifact
  • Content cleanup

    • Tightened explanations around compiler behavior for unsupported sub-agent fields
    • Clarified why ## headings terminate sub-agent blocks
    • Simplified the checkpoint to match the concrete edits the learner makes
  • Example

    Write a daily issue digest.
    
    ## How to use this workflow
    
    Run it from GitHub Actions.
    
    ## agent: `issue-summarizer`
    ---
    description: Summarizes one issue in one sentence
    model: small
    ---
    
    Read one issue and return exactly one sentence.

Copilot AI and others added 9 commits July 14, 2026 10:54
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>
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 [WIP] Fix cognitive load issues in sub-agent syntax document Reduce cognitive load in the sub-agent syntax side quest Jul 14, 2026
Copilot AI requested a review from pelikhan July 14, 2026 11:00
@pelikhan pelikhan marked this pull request as ready for review July 14, 2026 11:04
@pelikhan pelikhan merged commit 22e3602 into main Jul 14, 2026
@pelikhan pelikhan deleted the copilot/curriculum-eval-fix-cognitive-load-yet-again branch July 14, 2026 11:05
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.

[curriculum-eval] side-quest-21-01-sub-agent-syntax.md: cognitive_load — 45 new concepts in 1147 words, actively declining

2 participants