Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions .github/agents/agentic-workflows.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,7 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
- **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
- **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
- **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
- **Git-backed work queues**: Routes to `work-queue` instructions for producers, dispatchers, workers, observers, deployment and recovery

Workflows may optionally include:

Expand Down Expand Up @@ -184,6 +185,15 @@ loops using explicit live gates and includes existing-run evidence triage.

## Instructions

### Work Queue

For queue design, deployment, inspection or recovery, load
`https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/work-queue.md`.
Also load it after the primary create/update/debug/upgrade prompt whenever a
workflow uses `tools.work-queue`. Load linked developer docs and specifications
only when needed; do not substitute lightweight WorkQueueOps backlog guidance
for the Git-backed protocol.

When a user interacts with you:

1. **Identify the task type** from the user's request
Expand Down
52 changes: 31 additions & 21 deletions .github/aw/actions-lock.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,20 +5,20 @@
"version": "v6.0.0",
"sha": "a98b56852c35b8e3190ac28c8c2271da59106c68"
},
"actions/setup-node@v7.0.0": {
"actions/setup-node@v7.1.0": {
"repo": "actions/setup-node",
"version": "v7.0.0",
"sha": "820762786026740c76f36085b0efc47a31fe5020"
"version": "v7.1.0",
"sha": "949feb2413d6458794dcd2491c4babbbce0c15c1"
},
"github/gh-aw-actions/setup-cli@v0.91.4": {
"github/gh-aw-actions/setup-cli@v0.92.0": {
"repo": "github/gh-aw-actions/setup-cli",
"version": "v0.91.4",
"sha": "a63fe074b43ff5f66bcf1af0dc77f7bfc85b9d93"
"version": "v0.92.0",
"sha": "458b269006dcf88e3b5496b6fbecabe4b9a0f954"
},
"github/gh-aw-actions/setup@v0.91.4": {
"github/gh-aw-actions/setup@v0.92.0": {
"repo": "github/gh-aw-actions/setup",
"version": "v0.91.4",
"sha": "a63fe074b43ff5f66bcf1af0dc77f7bfc85b9d93"
"version": "v0.92.0",
"sha": "458b269006dcf88e3b5496b6fbecabe4b9a0f954"
}
},
"containers": {
Expand All @@ -37,6 +37,11 @@
"digest": "sha256:346b3ef93202fc8c486ddc51d37671a8e33fd1b4cb2288872cc7101f1855a637",
"pinned_image": "ghcr.io/github/gh-aw-firewall/agent:0.28.31@sha256:346b3ef93202fc8c486ddc51d37671a8e33fd1b4cb2288872cc7101f1855a637"
},
"ghcr.io/github/gh-aw-firewall/agent:0.28.57": {
"image": "ghcr.io/github/gh-aw-firewall/agent:0.28.57",
"digest": "sha256:3d1eb3c210881cf6702d4718aae18d954b7c243bd0aa560e49eadddd9765e0dd",
"pinned_image": "ghcr.io/github/gh-aw-firewall/agent:0.28.57@sha256:3d1eb3c210881cf6702d4718aae18d954b7c243bd0aa560e49eadddd9765e0dd"
},
"ghcr.io/github/gh-aw-firewall/api-proxy:0.28.14": {
"image": "ghcr.io/github/gh-aw-firewall/api-proxy:0.28.14",
"digest": "sha256:3a541fc7004c9ba9f15cca0b00fdfc4962bf396bf6e751e53ad5c2672886ba33",
Expand All @@ -52,6 +57,11 @@
"digest": "sha256:4054ccf268c3088668806507d02fa2e42dc0e4dcfa2e1744b8453eeef6e14782",
"pinned_image": "ghcr.io/github/gh-aw-firewall/api-proxy:0.28.31@sha256:4054ccf268c3088668806507d02fa2e42dc0e4dcfa2e1744b8453eeef6e14782"
},
"ghcr.io/github/gh-aw-firewall/api-proxy:0.28.57": {
"image": "ghcr.io/github/gh-aw-firewall/api-proxy:0.28.57",
"digest": "sha256:226e8996ed17d6f04ce9649daedabfb2501cdfa46cbe9416f5f32745ace23afa",
"pinned_image": "ghcr.io/github/gh-aw-firewall/api-proxy:0.28.57@sha256:226e8996ed17d6f04ce9649daedabfb2501cdfa46cbe9416f5f32745ace23afa"
},
"ghcr.io/github/gh-aw-firewall/squid:0.28.14": {
"image": "ghcr.io/github/gh-aw-firewall/squid:0.28.14",
"digest": "sha256:2ce8df3abf3e9b76e9c0cf5863da41f1ab3f89b20ad14b988806ab89e7bf2cd5",
Expand All @@ -67,25 +77,25 @@
"digest": "sha256:34ff99163907ab2e1ef333a3480ff20cb3e2c8becef05f1e09fc323a0e9057f4",
"pinned_image": "ghcr.io/github/gh-aw-firewall/squid:0.28.31@sha256:34ff99163907ab2e1ef333a3480ff20cb3e2c8becef05f1e09fc323a0e9057f4"
},
"ghcr.io/github/gh-aw-mcpg:v0.4.25": {
"image": "ghcr.io/github/gh-aw-mcpg:v0.4.25",
"digest": "sha256:9be0a86220e807a0ecc89e53d7453468f7a53fbc6b3d1efd2299025ffe01d086",
"pinned_image": "ghcr.io/github/gh-aw-mcpg:v0.4.25@sha256:9be0a86220e807a0ecc89e53d7453468f7a53fbc6b3d1efd2299025ffe01d086"
"ghcr.io/github/gh-aw-firewall/squid:0.28.57": {
"image": "ghcr.io/github/gh-aw-firewall/squid:0.28.57",
"digest": "sha256:1eb4d309b531078ec188842c18e2ac13e0c00b37d017ef001d50ff9def796691",
"pinned_image": "ghcr.io/github/gh-aw-firewall/squid:0.28.57@sha256:1eb4d309b531078ec188842c18e2ac13e0c00b37d017ef001d50ff9def796691"
},
"ghcr.io/github/gh-aw-mcpg:v0.4.29": {
"image": "ghcr.io/github/gh-aw-mcpg:v0.4.29",
"digest": "sha256:c1f128104b2d1485027c4aa046bd11a71f2aa18fba0f21640d1fa42106ca8a6e",
"pinned_image": "ghcr.io/github/gh-aw-mcpg:v0.4.29@sha256:c1f128104b2d1485027c4aa046bd11a71f2aa18fba0f21640d1fa42106ca8a6e"
"ghcr.io/github/gh-aw-mcpg:v0.4.31": {
"image": "ghcr.io/github/gh-aw-mcpg:v0.4.31",
"digest": "sha256:998a33644495f5a77ff0cde21a41031719617adb97fad50a0d7c12b97c46e1e7",
"pinned_image": "ghcr.io/github/gh-aw-mcpg:v0.4.31@sha256:998a33644495f5a77ff0cde21a41031719617adb97fad50a0d7c12b97c46e1e7"
},
"ghcr.io/github/gh-aw-node": {
"image": "ghcr.io/github/gh-aw-node",
"digest": "sha256:11c2c544876cdbaffefe0f7f1283b74838c209654b4934a78e23ed11f750490f",
"pinned_image": "ghcr.io/github/gh-aw-node@sha256:11c2c544876cdbaffefe0f7f1283b74838c209654b4934a78e23ed11f750490f"
},
"ghcr.io/github/github-mcp-server:v1.12.2": {
"image": "ghcr.io/github/github-mcp-server:v1.12.2",
"digest": "sha256:508a0857ec762b1ab1cece29193345b501fab1dd9d1228a7b617062954cecac6",
"pinned_image": "ghcr.io/github/github-mcp-server:v1.12.2@sha256:508a0857ec762b1ab1cece29193345b501fab1dd9d1228a7b617062954cecac6"
"ghcr.io/github/github-mcp-server:v2.0.2": {
"image": "ghcr.io/github/github-mcp-server:v2.0.2",
"digest": "sha256:9ae429f44efa33edd49dc429eb2cbab911da8447ba27b2b0431273a4b5dca114",
"pinned_image": "ghcr.io/github/github-mcp-server:v2.0.2@sha256:9ae429f44efa33edd49dc429eb2cbab911da8447ba27b2b0431273a4b5dca114"
}
}
}
11 changes: 10 additions & 1 deletion .github/skills/agentic-workflows/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ Load these files from `github/gh-aw` (they are not available locally).
- `.github/aw/agent-runtime-instructions.md`
- `.github/aw/agentic-chat.md`
- `.github/aw/agentic-workflows-mcp.md`
- `.github/aw/analyzing-runs.md`
- `.github/aw/asciicharts.md`
- `.github/aw/campaign.md`
- `.github/aw/charts-trending.md`
Expand All @@ -31,6 +32,9 @@ Load these files from `github/gh-aw` (they are not available locally).
- `.github/aw/create-agentic-workflow.md`
- `.github/aw/create-shared-agentic-workflow.md`
- `.github/aw/debug-agentic-workflow.md`
- `.github/aw/debug-model-engine-misconfiguration.md`
- `.github/aw/debug-playbook.md`
- `.github/aw/debug-security-review.md`
- `.github/aw/dependabot.md`
- `.github/aw/deployment-status.md`
- `.github/aw/designer-mappings.md`
Expand All @@ -46,6 +50,7 @@ Load these files from `github/gh-aw` (they are not available locally).
- `.github/aw/instructions.md`
- `.github/aw/intent.md`
- `.github/aw/jobs.md`
- `.github/aw/ledger.md`
- `.github/aw/linter-workflows.md`
- `.github/aw/llms.md`
- `.github/aw/loop.md`
Expand Down Expand Up @@ -74,6 +79,7 @@ Load these files from `github/gh-aw` (they are not available locally).
- `.github/aw/skills.md`
- `.github/aw/subagents.md`
- `.github/aw/syntax-agentic.md`
- `.github/aw/syntax-checkout.md`
- `.github/aw/syntax-core.md`
- `.github/aw/syntax-engine.md`
- `.github/aw/syntax-tools-imports.md`
Expand All @@ -98,6 +104,7 @@ After loading the matching workflow prompt or skill, follow it directly:
- Configure or add declarative engines: `.github/aw/configure-agentic-engine.md`
- Update existing workflows: `.github/aw/update-agentic-workflow.md`
- Diagnose, patch, audit, or actively debug workflows: `.github/aw/debug-agentic-workflow.md` (local-first strategy, evidence triage and live gates)
- AWF model/endpoint 400s, silent cross-family sub-agent failures, `model: auto` failures, install-step 404s after a version pin, or questions about version fields: go directly to [Model and engine misconfiguration](../../aw/debug-agentic-workflow.md#model-and-engine-misconfiguration) before suggesting model changes.
- Upgrade workflows and fix deprecations: `.github/aw/upgrade-agentic-workflows.md`
- Create shared components or MCP wrappers: `.github/aw/create-shared-agentic-workflow.md`
- Create report-generating workflows: `.github/aw/report.md`
Expand All @@ -106,9 +113,11 @@ After loading the matching workflow prompt or skill, follow it directly:
- Render compact markdown charts: `.github/aw/asciicharts.md`
- Map CLI commands to MCP usage: `.github/aw/cli-commands.md`
- Choose workflow architecture and patterns: `.github/aw/patterns.md`
- Orchestrate durable work with a work queue (dispatcher/worker roles or queue inspection): `.github/aw/work-queue.md`
- Design, deploy, inspect or recover a Git-backed work queue: `.github/aw/work-queue.md`
- Optimize token usage and cost: `.github/aw/token-optimization.md`
- Design long-running multi-agent research workflows: `.github/aw/multi-agent-research.md`
- Add skills or agent plugins requested by the user (`skills:` / `plugins:` frontmatter, never on-the-fly installs): `.github/aw/skills.md`

When the task involves OTEL, OTLP, traces, observability backends, or telemetry-driven analysis, also read and follow `skills/otel-queries/SKILL.md` after loading the matching workflow prompt or skill.

When creating, updating, diagnosing or upgrading a workflow that uses `tools.work-queue`, also load `.github/aw/work-queue.md` after the primary prompt. Load deployment docs, operator reference or specification only when that task needs them.
Loading
Loading