Skip to content

Commit 0b75ae2

Browse files
committed
fix: sync agent file with upstream, use uv, enable auto-merge
- Sync agentic-workflows.agent.md with upstream gh-aw main: - Replace 'infer: false' with 'disable-model-invocation: true' - Update all prompt URLs from v0.42.2 to main - Add missing prompt routes: report, dependabot, test-coverage - Add single-file output note - Replace pip install with uv sync in cli-consistency-checker.md - Add auto-merge: true and reviewers: [copilot] to daily-doc-updater.md - Recompile lock files
1 parent 3d33142 commit 0b75ae2

File tree

5 files changed

+43
-31
lines changed

5 files changed

+43
-31
lines changed

.github/agents/agentic-workflows.agent.md

Lines changed: 35 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing
3-
infer: false
3+
disable-model-invocation: true
44
---
55

66
# GitHub Agentic Workflows Agent
@@ -15,7 +15,10 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
1515
- **Updating existing workflows**: Routes to `update` prompt
1616
- **Debugging workflows**: Routes to `debug` prompt
1717
- **Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
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
1819
- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
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
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
1922

2023
Workflows may optionally include:
2124

@@ -27,7 +30,7 @@ Workflows may optionally include:
2730
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
2831
- Workflow lock files: `.github/workflows/*.lock.yml`
2932
- Shared components: `.github/workflows/shared/*.md`
30-
- Configuration: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/github-agentic-workflows.md
33+
- Configuration: https://github.com/github/gh-aw/blob/main/.github/aw/github-agentic-workflows.md
3134

3235
## Problems This Solves
3336

@@ -49,7 +52,7 @@ When you interact with this agent, it will:
4952
### Create New Workflow
5053
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
5154

52-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/create-agentic-workflow.md
55+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/create-agentic-workflow.md
5356

5457
**Use cases**:
5558
- "Create a workflow that triages issues"
@@ -59,7 +62,7 @@ When you interact with this agent, it will:
5962
### Update Existing Workflow
6063
**Load when**: User wants to modify, improve, or refactor an existing workflow
6164

62-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/update-agentic-workflow.md
65+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/update-agentic-workflow.md
6366

6467
**Use cases**:
6568
- "Add web-fetch tool to the issue-classifier workflow"
@@ -69,7 +72,7 @@ When you interact with this agent, it will:
6972
### Debug Workflow
7073
**Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors
7174

72-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/debug-agentic-workflow.md
75+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/debug-agentic-workflow.md
7376

7477
**Use cases**:
7578
- "Why is this workflow failing?"
@@ -79,46 +82,52 @@ When you interact with this agent, it will:
7982
### Upgrade Agentic Workflows
8083
**Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations
8184

82-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/upgrade-agentic-workflows.md
85+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/upgrade-agentic-workflows.md
8386

8487
**Use cases**:
8588
- "Upgrade all workflows to the latest version"
8689
- "Fix deprecated fields in workflows"
8790
- "Apply breaking changes from the new release"
8891

92+
### Create a Report-Generating Workflow
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
94+
95+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/report.md
96+
97+
**Use cases**:
98+
- "Create a weekly CI health report"
99+
- "Post a daily security audit to Discussions"
100+
- "Add a status update comment to open PRs"
101+
89102
### Create Shared Agentic Workflow
90103
**Load when**: User wants to create a reusable workflow component or wrap an MCP server
91104

92-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/create-shared-agentic-workflow.md
105+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/create-shared-agentic-workflow.md
93106

94107
**Use cases**:
95108
- "Create a shared component for Notion integration"
96109
- "Wrap the Slack MCP server as a reusable component"
97110
- "Design a shared workflow for database queries"
98111

99-
### Orchestration and Delegation
100-
101-
**Load when**: Creating or updating workflows that coordinate multiple agents or dispatch work to other workflows
112+
### Fix Dependabot PRs
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`)
102114

103-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/orchestration.md
115+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/dependabot.md
104116

105117
**Use cases**:
106-
- Assigning work to AI coding agents
107-
- Dispatching specialized worker workflows
108-
- Using correlation IDs for tracking
109-
- Orchestration design patterns
110-
111-
### GitHub Projects Integration
118+
- "Fix the open Dependabot PRs for npm dependencies"
119+
- "Bundle and close the Dependabot PRs for workflow dependencies"
120+
- "Update @playwright/test to fix the Dependabot PR"
112121

113-
**Load when**: Creating or updating workflows that manage GitHub Projects v2
122+
### Analyze Test Coverage
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.
114124

115-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/projects.md
125+
**Prompt file**: https://github.com/github/gh-aw/blob/main/.github/aw/test-coverage.md
116126

117127
**Use cases**:
118-
- Tracking items and fields with update-project
119-
- Posting periodic run summaries
120-
- Creating new projects
121-
- Projects v2 authentication and configuration
128+
- "Create a workflow that comments coverage on PRs"
129+
- "Analyze coverage trends over time"
130+
- "Add a coverage gate that blocks PRs below a threshold"
122131

123132
## Instructions
124133

@@ -135,7 +144,7 @@ When a user interacts with you:
135144
# Initialize repository for agentic workflows
136145
gh aw init
137146

138-
# Compile workflows
147+
# Generate the lock file for a workflow
139148
gh aw compile [workflow-name]
140149

141150
# Debug workflow runs
@@ -160,8 +169,9 @@ gh aw compile --validate
160169

161170
## Important Notes
162171

163-
- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.42.2/.github/aw/github-agentic-workflows.md for complete documentation
172+
- Always reference the instructions file at https://github.com/github/gh-aw/blob/main/.github/aw/github-agentic-workflows.md for complete documentation
164173
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
165174
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
166175
- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
167176
- Follow security best practices: minimal permissions, explicit network access, no template injection
177+
- **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.

.github/workflows/agentics-maintenance.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ permissions: {}
4040

4141
jobs:
4242
close-expired-entities:
43-
runs-on: ubuntu-latest
43+
runs-on: ubuntu-slim
4444
permissions:
4545
discussions: write
4646
issues: write

.github/workflows/cli-consistency-checker.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ You are a meticulous CLI quality inspector for **APM (Agent Package Manager)**,
4444
Install APM from source and confirm it works:
4545

4646
```
47-
cd $GITHUB_WORKSPACE && pip install -e .
47+
cd $GITHUB_WORKSPACE && curl -LsSf https://astral.sh/uv/install.sh | sh && uv sync && source .venv/bin/activate
4848
```
4949

5050
Then verify the installation:

.github/workflows/daily-doc-updater.lock.yml

Lines changed: 4 additions & 4 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

.github/workflows/daily-doc-updater.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,8 @@ safe-outputs:
3535
title-prefix: "[docs] "
3636
labels: [documentation, automation]
3737
draft: false
38+
auto-merge: true
39+
reviewers: [copilot]
3840

3941
source: githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295
4042
---

0 commit comments

Comments
 (0)