Skip to content

Commit cd04c84

Browse files
authored
Merge branch 'main' into add-foundry-hosted-agent-copilotkit-skill
2 parents 8ea048a + a4aebcd commit cd04c84

165 files changed

Lines changed: 19118 additions & 3627 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.codespellrc

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,11 @@
5656

5757
# ans - bash and powershell variable short for answer
5858

59-
ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB,TE,FillIn,alle,vai,LOD,InOut,pixelX,aNULL,Wee,Sherif,queston,Vertexes,nin,FO,CAF,Parth,ans
59+
# GUD - "Guideline" identifier prefix in the create-implementation-plan skill spec (alongside REQ, SEC, CON, PAT, etc.)
60+
61+
# Vally/vally - Name of product
62+
63+
ignore-words-list = numer,wit,aks,edn,ser,ois,gir,rouge,categor,aline,ative,afterall,deques,dateA,dateB,TE,FillIn,alle,vai,LOD,InOut,pixelX,aNULL,Wee,Sherif,queston,Vertexes,nin,FO,CAF,Parth,ans,gud,Vally,vally
6064

6165
# Skip certain files and directories
6266

Lines changed: 48 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
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.
34
disable-model-invocation: true
45
---
56

@@ -13,13 +14,16 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
1314

1415
- **Creating new workflows**: Routes to `create` prompt
1516
- **Updating existing workflows**: Routes to `update` prompt
16-
- **Debugging workflows**: Routes to `debug` prompt
17+
- **Debugging workflows**: Routes to `debug` prompt
1718
- **Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
1819
- **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
1920
- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
2021
- **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
2122
- **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
2224
- **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
2327

2428
Workflows may optionally include:
2529

@@ -31,7 +35,7 @@ Workflows may optionally include:
3135
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
3236
- Workflow lock files: `.github/workflows/*.lock.yml`
3337
- Shared components: `.github/workflows/shared/*.md`
34-
- Configuration: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/github-agentic-workflows.md
38+
- Configuration: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md`
3539

3640
## Problems This Solves
3741

@@ -50,30 +54,32 @@ When you interact with this agent, it will:
5054

5155
## Available Prompts
5256

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+
5359
### Create New Workflow
5460
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
5561

56-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/create-agentic-workflow.md
62+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/create-agentic-workflow.md`
5763

5864
**Use cases**:
5965
- "Create a workflow that triages issues"
6066
- "I need a workflow to label pull requests"
6167
- "Design a weekly research automation"
6268

63-
### Update Existing Workflow
69+
### Update Existing Workflow
6470
**Load when**: User wants to modify, improve, or refactor an existing workflow
6571

66-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/update-agentic-workflow.md
72+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/update-agentic-workflow.md`
6773

6874
**Use cases**:
6975
- "Add web-fetch tool to the issue-classifier workflow"
7076
- "Update the PR reviewer to use discussions instead of issues"
7177
- "Improve the prompt for the weekly-research workflow"
7278

73-
### Debug Workflow
79+
### Debug Workflow
7480
**Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors
7581

76-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/debug-agentic-workflow.md
82+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/debug-agentic-workflow.md`
7783

7884
**Use cases**:
7985
- "Why is this workflow failing?"
@@ -83,7 +89,7 @@ When you interact with this agent, it will:
8389
### Upgrade Agentic Workflows
8490
**Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations
8591

86-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/upgrade-agentic-workflows.md
92+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/upgrade-agentic-workflows.md`
8793

8894
**Use cases**:
8995
- "Upgrade all workflows to the latest version"
@@ -93,7 +99,7 @@ When you interact with this agent, it will:
9399
### Create a Report-Generating Workflow
94100
**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
95101

96-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/report.md
102+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/report.md`
97103

98104
**Use cases**:
99105
- "Create a weekly CI health report"
@@ -103,7 +109,7 @@ When you interact with this agent, it will:
103109
### Create Shared Agentic Workflow
104110
**Load when**: User wants to create a reusable workflow component or wrap an MCP server
105111

106-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/create-shared-agentic-workflow.md
112+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/create-shared-agentic-workflow.md`
107113

108114
**Use cases**:
109115
- "Create a shared component for Notion integration"
@@ -113,7 +119,7 @@ When you interact with this agent, it will:
113119
### Fix Dependabot PRs
114120
**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`)
115121

116-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/dependabot.md
122+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/dependabot.md`
117123

118124
**Use cases**:
119125
- "Fix the open Dependabot PRs for npm dependencies"
@@ -123,7 +129,7 @@ When you interact with this agent, it will:
123129
### Analyze Test Coverage
124130
**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.
125131

126-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/test-coverage.md
132+
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/test-coverage.md`
127133

128134
**Use cases**:
129135
- "Create a workflow that comments coverage on PRs"
@@ -133,20 +139,44 @@ When you interact with this agent, it will:
133139
### CLI Commands Reference
134140
**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.
135141

136-
**Reference file**: https://github.com/github/gh-aw/blob/v0.71.5/.github/aw/cli-commands.md
142+
**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/cli-commands.md`
137143

138144
**Use cases**:
139145
- "How do I trigger workflow X on the main branch?"
140146
- "What's the MCP equivalent of `gh aw logs`?"
141147
- "I'm in Copilot Cloud — how do I compile a workflow?"
142148
- "Show me all available gh aw commands"
143149

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.
152+
153+
**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/token-optimization.md`
154+
155+
**Use cases**:
156+
- "How do I reduce the token cost of this workflow?"
157+
- "My workflow is too expensive — how do I optimize it?"
158+
- "How do I compare token usage between two runs?"
159+
- "Should I use gh-proxy or the MCP server?"
160+
- "How do I use sub-agents to reduce costs?"
161+
- "How do I measure the impact of a prompt change?"
162+
163+
### Workflow Pattern Selection
164+
**Load when**: The user asks for architecture, strategy, operating model selection, or pattern recommendations for building agentic workflows.
165+
166+
**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/patterns.md`
167+
168+
**Use cases**:
169+
- "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+
144174
## Instructions
145175

146176
When a user interacts with you:
147177

148178
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
150180
3. **Follow the loaded prompt's instructions** exactly
151181
4. **If uncertain**, ask clarifying questions to determine the right prompt
152182

@@ -185,12 +215,12 @@ gh aw compile --validate
185215

186216
## Important Notes
187217

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
189219
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
190220
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
191221
- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
192222
- 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.
194224
- **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.
195225
- **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`

.github/aw/actions-lock.json

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
{
22
"entries": {
3-
"actions/checkout@v6.0.2": {
3+
"actions/checkout@v7.0.0": {
44
"repo": "actions/checkout",
5-
"version": "v6.0.2",
6-
"sha": "de0fac2e4500dabe0009e67214ff5f5447ce83dd"
5+
"version": "v7.0.0",
6+
"sha": "9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0"
77
},
88
"actions/download-artifact@v8.0.1": {
99
"repo": "actions/download-artifact",
@@ -20,15 +20,15 @@
2020
"version": "v7.0.1",
2121
"sha": "043fb46d1a93c77aae656e7c1c64a875d1fc6a0a"
2222
},
23-
"github/gh-aw-actions/setup@v0.72.1": {
23+
"github/gh-aw-actions/setup@v0.80.9": {
2424
"repo": "github/gh-aw-actions/setup",
25-
"version": "v0.72.1",
26-
"sha": "bc56a0cad2f450c562810785ef38649c04db812a"
25+
"version": "v0.80.9",
26+
"sha": "8c7d04ebf1ece56cd381446125da3e0f6896294a"
2727
},
28-
"github/gh-aw/actions/setup@v0.72.1": {
28+
"github/gh-aw/actions/setup@v0.80.9": {
2929
"repo": "github/gh-aw/actions/setup",
30-
"version": "v0.72.1",
31-
"sha": "489dbab88cc78e35506b5ccbf08a4037166824ac"
30+
"version": "v0.80.9",
31+
"sha": "a3624368c4e7d877586ff2784b61de73405e2cdd"
3232
}
3333
}
3434
}

.github/plugin/marketplace.json

Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,33 @@
1616
"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.",
1717
"version": "1.0.0"
1818
},
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.",
22+
"version": "0.1.3",
23+
"author": {
24+
"name": "Parth Sangani",
25+
"url": "https://github.com/Avyayalaya"
26+
},
27+
"repository": "https://github.com/Avyayalaya/agent-council",
28+
"license": "MIT",
29+
"keywords": [
30+
"quality-gate",
31+
"multi-agent",
32+
"adjudication",
33+
"council",
34+
"llm-as-judge",
35+
"agent-orchestration",
36+
"review",
37+
"claude-code",
38+
"mcp"
39+
],
40+
"source": {
41+
"source": "github",
42+
"repo": "Avyayalaya/agent-council",
43+
"ref": "v0.1.3"
44+
}
45+
},
1946
{
2047
"name": "ai-ready",
2148
"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 @@
202229
"description": "Database administration, SQL optimization, and data management tools for PostgreSQL, SQL Server, and general database development best practices.",
203230
"version": "1.0.0"
204231
},
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.",
235+
"version": "0.7.15",
236+
"author": {
237+
"name": "Datadog",
238+
"url": "https://www.datadoghq.com/"
239+
},
240+
"repository": "https://github.com/datadog-labs/vscode-plugin",
241+
"license": "Apache-2.0",
242+
"keywords": [
243+
"agent",
244+
"copilot",
245+
"datadog",
246+
"monitoring",
247+
"observability",
248+
"vscode"
249+
],
250+
"source": {
251+
"source": "github",
252+
"repo": "datadog-labs/vscode-plugin",
253+
"sha": "b003fcad48c3a935ffe04b6218f5cf58fe2b6760"
254+
}
255+
},
205256
{
206257
"name": "dataverse",
207258
"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 @@
418469
"description": "Self-Learning Multi-agent orchestration framework for spec-driven development and automated verification.",
419470
"version": "1.66.0"
420471
},
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",
475+
"version": "1.0.1",
476+
"author": {
477+
"name": "Ari LiVigni",
478+
"url": "https://github.com/arilivigni"
479+
},
480+
"repository": "https://github.com/arilivigni/gh-skills-builder",
481+
"license": "MIT",
482+
"keywords": [
483+
"github-learn",
484+
"github-skills",
485+
"github-skills-exercises",
486+
"education",
487+
"exercise-creation",
488+
"agent-skills",
489+
"custom-agents"
490+
],
491+
"source": {
492+
"source": "github",
493+
"repo": "arilivigni/gh-skills-builder",
494+
"ref": "v1.0.1",
495+
"sha": "198dadd8c1a8a9fd2820e121b4baad80b0729e75"
496+
}
497+
},
421498
{
422499
"name": "git-ape",
423500
"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 @@
9251002
"sha": "80f2d93287054f9d30dd990e842e15bcfca581c9"
9261003
}
9271004
},
1005+
{
1006+
"name": "ui5-modernization",
1007+
"description": "Complete UI5 modernization toolkit with workflow and specialized fix patterns for modernizing SAPUI5/OpenUI5 applications",
1008+
"version": "0.1.6",
1009+
"author": {
1010+
"name": "SAP SE",
1011+
"url": "https://www.sap.com"
1012+
},
1013+
"repository": "https://github.com/UI5/plugins-coding-agents",
1014+
"homepage": "https://github.com/UI5/plugins-coding-agents",
1015+
"license": "Apache-2.0",
1016+
"keywords": [
1017+
"ui5",
1018+
"sapui5",
1019+
"openui5",
1020+
"modernization",
1021+
"linter",
1022+
"upgrade"
1023+
],
1024+
"source": {
1025+
"source": "github",
1026+
"repo": "UI5/plugins-coding-agents",
1027+
"path": "plugins/ui5-modernization",
1028+
"ref": "v0.1.6"
1029+
}
1030+
},
9281031
{
9291032
"name": "ui5-typescript-conversion",
9301033
"description": "SAPUI5 / OpenUI5 plugin for GitHub CoPilot. Convert JavaScript based UI5 projects to TypeScript.",

.github/pull_request_template.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
- [ ] The content is clearly structured and follows the example format.
88
- [ ] I have tested my instructions, prompt, agent, skill, workflow, or canvas extension with GitHub Copilot.
99
- [ ] I have run `npm start` and verified that `README.md` is up to date.
10-
- [ ] I am targeting the `staged` branch for this pull request.
10+
- [ ] I am targeting the `main` branch for this pull request.
1111

1212
---
1313

0 commit comments

Comments
 (0)