[docs-linker] workshop docs: add gh-aw doc links - #2289
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Warning
Firewall blocked 1 domain
The following domain was blocked by the firewall during workflow execution:
awmgmcpg
To allow these domains, add them to the
network.allowedlist in your workflow frontmatter:
network:
allowed:
- defaults
- "awmgmcpg"See Network Configuration for more information.
Generated by 📋 Guidelines Enforcer for #2289 · 95.6 AIC · ⌖ 5.51 AIC · ⊞ 5.7K
Comments that could not be inline-anchored
workshop/side-quest-17-06-output-injection.md:75
Rule violated: No "For more details" footers — documentation links belong inline
Offending text:
> See [Agentic Workflow Security Architecture (Explain Like You're 5)](side-quest-17-02-security-architecture.md)
> for the full security model.
Suggested fix: Remove this trailing footer blockquote. Embed the reference inline in the nearest prose sentence instead (e.g., ...see the security architecture model). The guidelines prohi…
workshop/side-quest-17-01-mcp-concepts.md:94
Rule violated: No numbered headers inside files; also malformed nested Markdown link in heading
Offending text:
## How [toolsets](https://github.github.com/gh-aw/reference/github-tools/#github-[toolsets](https://github.github.com/gh-aw/reference/github-tools/#github-toolsets)) work
Suggested fix: Remove the nested link inside the heading. Headings should use plain text or a single simple link. Rewrite as:
## How toolsets work
The word toolsets can be linked once …
workshop/side-quest-17-07-repo-poisoning.md:118
Rule violated: Incorrect frontmatter key name
Offending text:
network:
allowed-domains:
- "api.github.com"Suggested fix: The correct key is allowed, not allowed-domains. Update to match the canonical schema used throughout the workshop and in production workflow files:
network:
allowed:
- api.github.comAlso update the inline reference on the same page (network.allowed-domains) to network.allowed.
workshop/side-quest-17-07-repo-poisoning.md:180
Rule violated: Incorrect frontmatter key name (same as the code block above)
Offending text:
- Set `network.allowed-domains` to block exfiltration to attacker-controlled destinations.
Suggested fix: Rename to network.allowed to match the actual schema:
- Set `network.allowed` to block exfiltration to attacker-controlled destinations.
Adds inline documentation links to 10 security-focused side-quest workshop files.
Changes by file
side-quest-16-03-token-exfiltration.mdfrontmatter→ Frontmatter referenceagentic workflow→ About Workflowsside-quest-16-04-deterministic-vs-agentic-data-ops.mdDeterministic→ DeterministicOps patternAgentic→ About Workflowsside-quest-16-05-long-lived-credentials.mdagentic workflow→ About Workflowsdeterministic→ DeterministicOps patternblast radius→ Threat Modelside-quest-17-01-mcp-concepts.mdModel Context Protocol→ MCP Gateway Specificationtoolsets→ GitHub Toolsetstask brief→ Markdown referenceSupply chain→ Threat ModelBlast radius→ Threat Modelside-quest-17-02-security-architecture.mdsandbox→ Sandbox Configurationfrontmatter→ Frontmatter referencetask brief→ Markdown referenceside-quest-17-03-prompt-injection.mdPrompt Injection→ Threat Modeltask brief→ Markdown referenceblast radius→ Threat Modelside-quest-17-04-permission-escalation.mdAgentic Workflows→ About Workflowstask brief→ Markdown referenceprompt injection→ Threat Modelside-quest-17-05-supply-chain-mcp.mdSupply Chain→ Threat Modelthreat model→ Threat Modeltoolset→ GitHub Toolsetsnetwork→ Network Permissionsside-quest-17-06-output-injection.mdagentic workflow→ About Workflowsside-quest-17-07-repo-poisoning.mdagentic workflow→ About Workflowsdeterministic→ DeterministicOps patternFrontmatter→ Frontmatter referenceWarning
Firewall blocked 1 domain
The following domain was blocked by the firewall during workflow execution:
awmgmcpgSee Network Configuration for more information.