Skip to content

Commit bc19a43

Browse files
workshop docs: add gh-aw doc links (round 6) (#2718)
- side-quest-09-01f: link 'safe-output' → safe-outputs reference - side-quest-10-02: link 'sandbox' → sandbox configuration reference - side-quest-11-01: link 'agentic workflow' → introduction/overview - side-quest-11-02: link 'agentic workflow' → introduction/overview - side-quest-11-05: link 'schedule' → triggers/#scheduled-triggers-schedule - side-quest-11-06: link 'agentic workflow' → introduction/overview Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 57121fe commit bc19a43

6 files changed

Lines changed: 6 additions & 6 deletions

workshop/side-quest-09-01f-debugging-checklist.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ You will apply a repeatable seven-step triage flow whenever a run produces unexp
2424
## ✅ Checkpoint
2525

2626
- [ ] I can run this checklist in order without skipping steps
27-
- [ ] I know where to find both live logs and safe-output records
27+
- [ ] I know where to find both live logs and [safe-output](https://github.github.com/gh-aw/reference/safe-outputs/) records
2828
- [ ] I can decide whether the root cause is prompt, data, [permissions](https://github.github.com/gh-aw/reference/permissions/), or output limits
2929
- [ ] I can gather a minimal log snippet to share for deeper diagnosis
3030

workshop/side-quest-10-02-jailbreak-brief.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ gh-aw can combine five [defence layers](https://github.github.com/gh-aw/introduc
4040

4141
- **[Compiled task brief](https://github.github.com/gh-aw/reference/compilation-process/#overview)** — The task brief is baked in before any data arrives. Issue bodies and PR descriptions reach the agent as structured tool call results, competing with an authoritative baseline rather than replacing it.
4242
- **Minimal `permissions:` + `safe-outputs`** — The `GITHUB_TOKEN` enforces declared permission boundaries; `safe-outputs` removes write tool paths that were never declared, so a jailbreak instruction to push a commit has no execution path.
43-
- **`network.allowed` + optional [agentic threat detection](https://github.github.com/gh-aw/reference/threat-detection/)** — The [network layer](https://github.github.com/gh-aw/reference/network/#configuration) blocks data exfiltration to unlisted endpoints; if you enable `threat-detection` under `safe-outputs:`, a separate detection job reviews agent output in an isolated sandbox before any declared write lands.
43+
- **`network.allowed` + optional [agentic threat detection](https://github.github.com/gh-aw/reference/threat-detection/)** — The [network layer](https://github.github.com/gh-aw/reference/network/#configuration) blocks data exfiltration to unlisted endpoints; if you enable `threat-detection` under `safe-outputs:`, a separate detection job reviews agent output in an isolated [sandbox](https://github.github.com/gh-aw/reference/sandbox/) before any declared write lands.
4444

4545
<details>
4646
<summary>Detailed breakdown of each layer</summary>

workshop/side-quest-11-01-frontmatter-deep-dive.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<!-- page-adventure: side-quest -->
33
# Side Quest: Frontmatter Deep Dive — Part A
44

5-
> _Optional: configure each of the opening three frontmatter sections of an agentic workflow file — metadata, triggers, and permissions. Work through this before building Step 11, then continue to [Part B: Tools, Outputs, and the Agent Body](side-quest-11-08-frontmatter-tools-outputs.md) or return to the main path._
5+
> _Optional: configure each of the opening three frontmatter sections of an [agentic workflow](https://github.github.com/gh-aw/introduction/overview/) file — metadata, triggers, and permissions. Work through this before building Step 11, then continue to [Part B: Tools, Outputs, and the Agent Body](side-quest-11-08-frontmatter-tools-outputs.md) or return to the main path._
66
77
## :clipboard: Before You Start
88

workshop/side-quest-11-02-yaml-frontmatter.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
> _Optional: work through these common YAML mistakes if you hit a [compile error](https://github.github.com/gh-aw/reference/compilation-process/) in Step 11, then return to the main path._
66
7-
YAML is unforgiving. Here are the five errors learners hit most often when building agentic workflow [frontmatter](https://github.github.com/gh-aw/reference/frontmatter/), each with a broken :x: and correct :white_check_mark: example.
7+
YAML is unforgiving. Here are the five errors learners hit most often when building [agentic workflow](https://github.github.com/gh-aw/introduction/overview/) [frontmatter](https://github.github.com/gh-aw/reference/frontmatter/), each with a broken :x: and correct :white_check_mark: example.
88

99
---
1010

workshop/side-quest-11-05-event-triggers.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ A **scheduled** workflow runs because the clock says it is time. An **event-driv
2222
| Scheduled | Time passes | Daily summaries, reminders, audits |
2323
| Event-driven | A GitHub event happens | PR review, issue triage, post-push follow-up |
2424

25-
If you want the workflow to react to a specific repository action, use an event trigger. If you want it to run even when nobody touched the repo, use a schedule.
25+
If you want the workflow to react to a specific repository action, use an event trigger. If you want it to run even when nobody touched the repo, use a [schedule](https://github.github.com/gh-aw/reference/triggers/#scheduled-triggers-schedule).
2626

2727
## Four common trigger patterns
2828

workshop/side-quest-11-06-anthropic-key.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
<!-- page-adventure: side-quest -->
33
# Side Quest: Configure an Anthropic API Key
44

5-
> _Optional: work through this guide when you want to use [Claude](side-quest-01-02-environment-reference.md#claude) (Anthropic's model family) as the AI engine for your agentic workflow, then return to your main path._
5+
> _Optional: work through this guide when you want to use [Claude](side-quest-01-02-environment-reference.md#claude) (Anthropic's model family) as the AI engine for your [agentic workflow](https://github.github.com/gh-aw/introduction/overview/), then return to your main path._
66
77
By default, [agentic workflows](https://github.github.com/gh-aw/introduction/overview/) run on the [GitHub Copilot engine](https://github.github.com/gh-aw/reference/engines/). If you prefer to use **[Claude](https://github.github.com/gh-aw/reference/auth/#claude)**, you'll need an Anthropic API key stored as a repository secret and a one-line change to your [workflow frontmatter](https://github.github.com/gh-aw/reference/frontmatter/).
88

0 commit comments

Comments
 (0)