You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Make the in-process E2E matrix use the FFI runtime, restore the native host environment between tests, and align same-client session resume with the other SDKs while preserving routing after failed resumes.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: c71188a1-1445-46aa-9faf-3b73cf6a6dd9
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing.
2
+
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing
4
3
disable-model-invocation: true
5
4
---
6
5
7
6
# GitHub Agentic Workflows Agent
8
7
9
8
This agent helps you work with **GitHub Agentic Workflows (gh-aw)**, a CLI extension for creating AI-powered workflows in natural language using markdown files.
10
9
11
-
## Repository Instructions Overlay
12
-
13
-
If `.github/aw/instructions.md` exists, load it with:
14
-
@.github/aw/instructions.md
15
-
16
-
Precedence: repository overlay instructions override defaults in this agent when they conflict.
17
-
18
10
## What This Agent Does
19
11
20
12
This is a **dispatcher agent** that routes your request to the appropriate specialized prompt based on your task:
21
13
22
14
-**Creating new workflows**: Routes to `create` prompt
23
15
-**Updating existing workflows**: Routes to `update` prompt
24
-
-**Debugging workflows**: Routes to `debug` prompt
16
+
-**Debugging workflows**: Routes to `debug` prompt
25
17
-**Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
26
18
-**Creating report-generating workflows**: Routes to `report` prompt — consult this whenever the workflow posts status updates, audits, analyses, or any structured output as issues, discussions, or comments
27
19
-**Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
28
20
-**Fixing Dependabot PRs**: Routes to `dependabot` prompt — use this when Dependabot opens PRs that modify generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`). Never merge those PRs directly; instead update the source `.md` files and rerun `gh aw compile --dependabot` to bundle all fixes
29
21
-**Analyzing test coverage**: Routes to `test-coverage` prompt — consult this whenever the workflow reads, analyzes, or reports on test coverage data from PRs or CI runs
30
-
-**Rendering ASCII charts in markdown**: Routes to `asciicharts` guide — consult this whenever the workflow needs compact charts that render reliably in GitHub issues, comments, or discussions
31
-
-**CLI commands and triggering workflows**: Routes to `cli-commands` guide — consult this whenever the user asks how to run, compile, debug, or manage workflows from the command line, or when they need the MCP tool equivalent of a `gh aw` command
32
-
-**Reducing token consumption / cost optimization**: Routes to `token-optimization` guide — consult this whenever the user asks how to reduce token usage, lower costs, speed up workflows, or measure the impact of prompt changes with experiments
33
-
-**Choosing workflow architectures and design patterns**: Routes to `patterns` guide — consult this whenever the user asks for strategy, architecture, operating models, or pattern selection for agentic workflows
34
22
35
23
Workflows may optionally include:
36
24
@@ -42,7 +30,7 @@ Workflows may optionally include:
42
30
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
@@ -61,32 +49,30 @@ When you interact with this agent, it will:
61
49
62
50
## Available Prompts
63
51
64
-
> **Note**: The prompt and reference files listed below are located in the [`github/gh-aw`](https://github.com/github/gh-aw) repository and are **not available locally** in this repository. Load them from their public URLs.
65
-
66
52
### Create New Workflow
67
53
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
@@ -106,7 +92,7 @@ When you interact with this agent, it will:
106
92
### Create a Report-Generating Workflow
107
93
**Load when**: The workflow being created or updated produces reports — recurring status updates, audit summaries, analyses, or any structured output posted as a GitHub issue, discussion, or comment
- "Create a shared component for Notion integration"
@@ -126,7 +112,7 @@ When you interact with this agent, it will:
126
112
### Fix Dependabot PRs
127
113
**Load when**: User needs to close or fix open Dependabot PRs that update dependencies in generated manifest files (`.github/workflows/package.json`, `.github/workflows/requirements.txt`, `.github/workflows/go.mod`)
- "Fix the open Dependabot PRs for npm dependencies"
@@ -136,54 +122,19 @@ When you interact with this agent, it will:
136
122
### Analyze Test Coverage
137
123
**Load when**: The workflow reads, analyzes, or reports test coverage — whether triggered by a PR, a schedule, or a slash command. Always consult this prompt before designing the coverage data strategy.
- "Create a workflow that comments coverage on PRs"
143
129
- "Analyze coverage trends over time"
144
130
- "Add a coverage gate that blocks PRs below a threshold"
145
131
146
-
### CLI Commands Reference
147
-
**Load when**: The user asks how to run, compile, debug, or manage workflows from the command line; needs the MCP tool equivalent of a `gh aw` command; or is in a restricted environment (e.g., Copilot Cloud) without direct CLI access.
- "How do I trigger workflow X on the main branch?"
153
-
- "What's the MCP equivalent of `gh aw logs`?"
154
-
- "I'm in Copilot Cloud — how do I compile a workflow?"
155
-
- "Show me all available gh aw commands"
156
-
157
-
### Token Consumption Optimization
158
-
**Load when**: The user asks how to reduce token usage, lower workflow costs, make a workflow faster or cheaper, or measure the impact of prompt or configuration changes.
- "Which pattern should I use for multi-repo rollout?"
177
-
- "How should I structure this workflow architecture?"
178
-
- "What pattern fits slash-command triage?"
179
-
- "Should this be DispatchOps or DailyOps?"
180
-
181
132
## Instructions
182
133
183
134
When a user interacts with you:
184
135
185
136
1.**Identify the task type** from the user's request
186
-
2.**Load the appropriate prompt** from the URLs listed above
137
+
2.**Load the appropriate prompt** from the GitHub repository URLs listed above
187
138
3.**Follow the loaded prompt's instructions** exactly
188
139
4.**If uncertain**, ask clarifying questions to determine the right prompt
189
140
@@ -196,10 +147,6 @@ gh aw init
196
147
# Generate the lock file for a workflow
197
148
gh aw compile [workflow-name]
198
149
199
-
# Trigger a workflow on demand (preferred over gh workflow run)
200
-
gh aw run <workflow-name># interactive input collection
201
-
gh aw run <workflow-name> --ref main # run on a specific branch
202
-
203
150
# Debug workflow runs
204
151
gh aw logs [workflow-name]
205
152
gh aw audit <run-id>
@@ -222,12 +169,10 @@ gh aw compile --validate
222
169
223
170
## Important Notes
224
171
225
-
- Always reference the instructions file at `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md` for complete documentation
172
+
- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.64.2/.github/aw/github-agentic-workflows.md for complete documentation
226
173
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
227
174
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
228
175
-**Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
229
176
- Follow security best practices: minimal permissions, explicit network access, no template injection
230
-
-**Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/network.md` for the full list of valid ecosystem identifiers and domain patterns.
177
+
-**Network configuration**: Use ecosystem identifiers (`node`, `python`, `go`, etc.) or explicit FQDNs in `network.allowed`. Bare shorthands like `npm` or `pypi` are **not** valid. See https://github.com/github/gh-aw/blob/v0.64.2/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns.
231
178
-**Single-file output**: When creating a workflow, produce exactly **one** workflow `.md` file. Do not create separate documentation files (architecture docs, runbooks, usage guides, etc.). If documentation is needed, add a brief `## Usage` section inside the workflow file itself.
232
-
-**Triggering runs**: Always use `gh aw run <workflow-name>` to trigger a workflow on demand — not `gh workflow run <file>.lock.yml`. `gh aw run` handles workflow resolution by short name, input parsing and validation, and correct run-tracking for agentic workflows. Use `--ref <branch>` to run on a specific branch.
233
-
-**CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/cli-commands.md`
0 commit comments