Skip to content

Commit e53f567

Browse files
Copilotmrjf
andauthored
Refresh APM integration files
Co-authored-by: mrjf <180956+mrjf@users.noreply.github.com>
1 parent 8a4e023 commit e53f567

3 files changed

Lines changed: 18 additions & 19 deletions

File tree

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

Lines changed: 0 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,6 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
1919
- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
2020
- **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
2121
- **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
22-
- **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
2322

2423
Workflows may optionally include:
2524

@@ -130,17 +129,6 @@ When you interact with this agent, it will:
130129
- "Analyze coverage trends over time"
131130
- "Add a coverage gate that blocks PRs below a threshold"
132131

133-
### CLI Commands Reference
134-
**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.
135-
136-
**Reference file**: https://github.com/github/gh-aw/blob/main/.github/aw/cli-commands.md
137-
138-
**Use cases**:
139-
- "How do I trigger workflow X on the main branch?"
140-
- "What's the MCP equivalent of `gh aw logs`?"
141-
- "I'm in Copilot Cloud — how do I compile a workflow?"
142-
- "Show me all available gh aw commands"
143-
144132
## Instructions
145133

146134
When a user interacts with you:
@@ -159,10 +147,6 @@ gh aw init
159147
# Generate the lock file for a workflow
160148
gh aw compile [workflow-name]
161149

162-
# Trigger a workflow on demand (preferred over gh workflow run)
163-
gh aw run <workflow-name> # interactive input collection
164-
gh aw run <workflow-name> --ref main # run on a specific branch
165-
166150
# Debug workflow runs
167151
gh aw logs [workflow-name]
168152
gh aw audit <run-id>
@@ -190,7 +174,4 @@ gh aw compile --validate
190174
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
191175
- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
192176
- 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/main/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns.
194177
- **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-
- **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/main/.github/aw/cli-commands.md
Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
description: "Agentic workflow recompilation: always recompile after changing workflow files"
3+
---
4+
5+
# Agentic Workflows
6+
7+
After modifying any `.md` workflow file under `.github/workflows/`, always
8+
recompile both agentic workflows and APM integration files before committing:
9+
10+
```bash
11+
gh aw compile
12+
apm compile
13+
```
14+
15+
Commit the regenerated `.lock.yml` and integration files together with your
16+
changes. The CI `APM Self-Check` job will fail if generated files are stale.

apm.lock.yaml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@ local_deployed_files:
2424
- .github/agents/python-architect.agent.md
2525
- .github/agents/supply-chain-security-expert.agent.md
2626
- .github/agents/test-coverage-expert.agent.md
27+
- .github/instructions/agentic-workflows.instructions.md
2728
- .github/instructions/changelog.instructions.md
2829
- .github/instructions/cicd.instructions.md
2930
- .github/instructions/cli.instructions.md
@@ -46,6 +47,7 @@ local_deployed_file_hashes:
4647
.github/agents/python-architect.agent.md: sha256:7587ee7c684c61046a83dfa1b7e39d1345f2f119c3395478e3ca2dbbaaaff0e9
4748
.github/agents/supply-chain-security-expert.agent.md: sha256:8fb8cc426d6af17ba084a28b3f026c2b475b62e3ca63ed2f88b83bd823f877af
4849
.github/agents/test-coverage-expert.agent.md: sha256:bc588d89530362469502bfbea788df892a9a0b00e630cd0f3926d3dfd2c2a9e2
50+
.github/instructions/agentic-workflows.instructions.md: sha256:fc90017f6db18b7aa443668efcdf0ff8dc201fe5c42cbca36e600a5945e210c4
4951
.github/instructions/changelog.instructions.md: sha256:1e51ec4c74e847967962bd279dc4c6e582c5d3578490b3c28d5f3acd3e05f73e
5052
.github/instructions/cicd.instructions.md: sha256:9c0fafc74f743aa97e5adba2168d66c9e3a327b135065e3b804bdbb5f04cda5d
5153
.github/instructions/cli.instructions.md: sha256:8e39e8d5047ce88575cb02f87c2bcede584dfef258bd86f7466c7badf136541a

0 commit comments

Comments
 (0)