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
Copy file name to clipboardExpand all lines: .github/agents/agentic-workflows.md
+48-18Lines changed: 48 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,6 @@
1
1
---
2
-
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing
2
+
name: Agentic Workflows
3
+
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing.
3
4
disable-model-invocation: true
4
5
---
5
6
@@ -13,13 +14,16 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
13
14
14
15
-**Creating new workflows**: Routes to `create` prompt
15
16
-**Updating existing workflows**: Routes to `update` prompt
16
-
-**Debugging workflows**: Routes to `debug` prompt
17
+
-**Debugging workflows**: Routes to `debug` prompt
17
18
-**Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
18
19
-**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
19
20
-**Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
20
21
-**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
21
22
-**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
23
+
-**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
22
24
-**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
25
+
-**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
26
+
-**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
23
27
24
28
Workflows may optionally include:
25
29
@@ -31,7 +35,7 @@ Workflows may optionally include:
31
35
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
@@ -50,30 +54,32 @@ When you interact with this agent, it will:
50
54
51
55
## Available Prompts
52
56
57
+
> **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.
58
+
53
59
### Create New Workflow
54
60
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
@@ -93,7 +99,7 @@ When you interact with this agent, it will:
93
99
### Create a Report-Generating Workflow
94
100
**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"
@@ -113,7 +119,7 @@ When you interact with this agent, it will:
113
119
### Fix Dependabot PRs
114
120
**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"
@@ -123,7 +129,7 @@ When you interact with this agent, it will:
123
129
### Analyze Test Coverage
124
130
**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"
@@ -133,20 +139,44 @@ When you interact with this agent, it will:
133
139
### CLI Commands Reference
134
140
**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?"
140
146
- "What's the MCP equivalent of `gh aw logs`?"
141
147
- "I'm in Copilot Cloud — how do I compile a workflow?"
142
148
- "Show me all available gh aw commands"
143
149
150
+
### Token Consumption Optimization
151
+
**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?"
170
+
- "How should I structure this workflow architecture?"
171
+
- "What pattern fits slash-command triage?"
172
+
- "Should this be DispatchOps or DailyOps?"
173
+
144
174
## Instructions
145
175
146
176
When a user interacts with you:
147
177
148
178
1.**Identify the task type** from the user's request
149
-
2.**Load the appropriate prompt** from the GitHub repository URLs listed above
179
+
2.**Load the appropriate prompt** from the URLs listed above
150
180
3.**Follow the loaded prompt's instructions** exactly
151
181
4.**If uncertain**, ask clarifying questions to determine the right prompt
152
182
@@ -185,12 +215,12 @@ gh aw compile --validate
185
215
186
216
## Important Notes
187
217
188
-
- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/github-agentic-workflows.md for complete documentation
218
+
- Always reference the instructions file at `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md` for complete documentation
189
219
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
190
220
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
191
221
-**Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
192
222
- Follow security best practices: minimal permissions, explicit network access, no template injection
193
-
-**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.71.5/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns.
223
+
-**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.
194
224
-**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.
195
225
-**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.
196
-
-**CLI commands reference**: For a complete guide on all `gh aw` commands and their MCP tool equivalents (for restricted environments), see https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/cli-commands.md
226
+
-**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`
Copy file name to clipboardExpand all lines: .github/plugin/marketplace.json
+103Lines changed: 103 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -16,6 +16,33 @@
16
16
"description": "Drive Microsoft AgentRC from Copilot chat: assess AI readiness, generate Copilot instructions (flat or nested with applyTo globs for monorepos), and manage policies. Produces a self-contained static HTML dashboard at reports/index.html.",
17
17
"version": "1.0.0"
18
18
},
19
+
{
20
+
"name": "agent-council",
21
+
"description": "A runtime-portable 5-agent quality gate that adjudicates text artifacts before they ship. Five role-conditioned LLM deliberators run a 2-round async protocol with cross-read rebuttal and return one verdict — SHIP, REVISE, or HOLD — plus a structured revision brief and a full audit transcript.",
"description": "Analyze any repository and generate AI-ready configuration — AGENTS.md, copilot-instructions.md, CI workflows, issue templates, and more. Mines your PR review patterns and creates files customized to your stack.",
@@ -202,6 +229,30 @@
202
229
"description": "Database administration, SQL optimization, and data management tools for PostgreSQL, SQL Server, and general database development best practices.",
203
230
"version": "1.0.0"
204
231
},
232
+
{
233
+
"name": "datadog",
234
+
"description": "Use Datadog directly in Copilot / VS Code through a preconfigured Datadog MCP server. Query logs, metrics, traces, dashboards, and more through natural conversation.",
"description": "Build and manage Microsoft Dataverse solutions using natural language. Includes table/column creation, solution lifecycle, data operations, and MCP server configuration.",
@@ -418,6 +469,32 @@
418
469
"description": "Self-Learning Multi-agent orchestration framework for spec-driven development and automated verification.",
419
470
"version": "1.66.0"
420
471
},
472
+
{
473
+
"name": "gh-skills-builder",
474
+
"description": "Repo: https://github.com/arilivigni/gh-skills-builder\nThis plugin is for people that want to create a GitHub Skills exercise which are self-paced learning GitHub within GitHub.\nhttps://learn.github.com/skills\nexamples:\nhttps://github.com/skills/agent-orchestration-build-your-ai-dream-team\nhttps://github.com/skills/agentic-workflows-that-read-the-room",
"description": "Intelligent Azure deployment agent system for GitHub Copilot with guided ARM template generation, security gates, cost analysis, and deployment workflows.",
@@ -925,6 +1002,32 @@
925
1002
"sha": "80f2d93287054f9d30dd990e842e15bcfca581c9"
926
1003
}
927
1004
},
1005
+
{
1006
+
"name": "ui5-modernization",
1007
+
"description": "Complete UI5 modernization toolkit with workflow and specialized fix patterns for modernizing SAPUI5/OpenUI5 applications",
0 commit comments