Skip to content

[training-plan] Add research-backed training node: Preview Safe Outputs Before They Run: Staged Mode - #3825

Closed
github-actions[bot] wants to merge 1 commit into
mainfrom
add-staged-mode-training-node-b11bc4af08151954
Closed

github-actions[bot] wants to merge 1 commit into
mainfrom
add-staged-mode-training-node-b11bc4af08151954

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Caution

Protected files were modified in this change.
This pull request is in request_review mode and requires explicit human scrutiny before merge.

Protected files: README.md

Research focus

Staged mode (staged: true) for previewing safe outputs before they execute, applied to the iterative prompt-editing workflow learners already practice in Step 9.

Gap identified

Cross-referencing the github/gh-aw LLMs.txt agent-prompt index against the safe-outputs and staged-mode reference docs showed a documented, current gh-aw capability with zero coverage anywhere in this workshop. Learners repeatedly iterate on prompts that trigger real create-issue/add-comment safe-output writes (Steps 7, 9, and 14b) with no way to preview a change before it creates a real GitHub resource — this makes rapid iteration noisy (test issues pile up) and harder to compare across prompt versions.

What was filled

Added a new node, Preview Safe Outputs Before They Run: Staged Mode, placed immediately after Step 9 (the edit/debug/optimize loop) since it directly extends that iteration workflow. It walks learners through:

  • enabling staged: true globally in safe-outputs:
  • reading the 🎭 preview in the Actions step summary
  • scoping staged: true to a single output type
  • turning staged mode off once satisfied

Files updated

  • workshop/09b-preview-with-staged-mode.md (new node)
  • workshop/README.md (added curriculum row after Step 9)
  • workshop/09-agentic-editing.md (updated Next: link to point to the new node)

workshop/00-welcome.md needed no changes — it does not reference step counts.

Research metadata

Stored as an XML comment block (<research-node-metadata>) at the bottom of workshop/09b-preview-with-staged-mode.md, capturing the research focus, source URLs (including the LLMs.txt download source), and a one-paragraph reasoning summary.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • registry.npmjs.org

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "registry.npmjs.org"

See Network Configuration for more information.

Generated by 🧠 Training Plan Researcher · copilot · auto · 76.4 AIC · ⌖ 18.8 AIC · ⊞ 6.9K · ◷

  • expires on Sep 26, 2026, 4:07 PM UTC

- New workshop/09b-preview-with-staged-mode.md teaches staged: true for
  previewing safe outputs during iterative prompt editing, filling a gap
  identified from gh-aw LLMs.txt and the staged-mode reference doc.
- Links the node into the curriculum after Step 9 and updates 09's Next link.
- Captures research focus, sources, and rationale in an XML comment block
  at the bottom of the new node file.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added documentation Improvements or additions to documentation training-plan workshop labels Sep 25, 2026

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Protected files were modified in this pull request and require manual scrutiny before merge.

Please verify that each protected-file change is intentional, policy-compliant, and safe:

  • Protected files: README.md

@github-actions

Copy link
Copy Markdown
Contributor Author

This pull request was automatically closed because it expired on 2026-09-26T16:07:07.047Z.

Closed by Workflow

@github-actions github-actions Bot closed this Sep 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation training-plan workshop

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants