Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
3a19863
Upgrade age-qualified frontend dependencies with compatibility holds
IEvangelist Sep 18, 2026
ec0c8cb
Align repository tooling with age-qualified LTS releases
IEvangelist Sep 18, 2026
33a3da2
Add an isolated API incremental-build qualification pilot
IEvangelist Sep 18, 2026
c49b4f1
Retain enterprise-approved pnpm setup and compatible pnpm11
IEvangelist Sep 18, 2026
f36074e
Generate portable locks against the same registry as CI
IEvangelist Sep 18, 2026
058097d
Preserve responsive UI behavior with Starlight native menus
IEvangelist Sep 18, 2026
237ce2f
Make looping media markup deterministic for full-output comparisons
IEvangelist Sep 18, 2026
8b0c421
Make incremental qualification use deterministic build inputs
IEvangelist Sep 18, 2026
af53832
Share the qualification clock with CI cache partitioning
IEvangelist Sep 18, 2026
74b8243
Keep the uncached RSS clock out of API compatibility keys
IEvangelist Sep 18, 2026
4ec15a1
Make syntax colors and search manifest generation deterministic
IEvangelist Sep 19, 2026
0a58e32
Pass a native filesystem cache path to Astro configuration
IEvangelist Sep 19, 2026
28fba90
Finalize cached page identity before search indexing with a streaming…
IEvangelist Sep 19, 2026
8faf317
Require a genuinely different identity in pull-request qualification
IEvangelist Sep 19, 2026
6c0faf1
Merge latest upstream main into incremental qualification
IEvangelist Sep 19, 2026
8d55fd5
Document measured incremental costs and retain full production builds
IEvangelist Sep 19, 2026
6a57f98
Use exact URL origins in capture fixtures and record identity qualifi…
IEvangelist Sep 19, 2026
4d6f52a
Memoize validated identity ranges and measure isolated cache transport
IEvangelist Sep 20, 2026
a8fed65
Stamp validated UTF-8 byte slots with bounded file I/O
IEvangelist Sep 20, 2026
937c1a8
perf: scope incremental metadata to cacheable components
IEvangelist Sep 20, 2026
63ed489
docs: record measured API incremental build improvements
IEvangelist Sep 20, 2026
c0a896b
Expand incremental pilot to OG images and unchanged search
IEvangelist Sep 21, 2026
72c912e
Require successful builds for artifact uploads
IEvangelist Sep 21, 2026
0f88613
Report parity failures without uploading failed build artifacts
IEvangelist Sep 21, 2026
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
4 changes: 2 additions & 2 deletions .devcontainer/devcontainer.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
{
"name": "aspire.dev - Codespaces Dev Container",
"image": "mcr.microsoft.com/devcontainers/javascript-node:1-22-bookworm",
"image": "mcr.microsoft.com/devcontainers/javascript-node:5.2.1-24-bookworm@sha256:ef380643327dafe138722179c1ac86477a4b1f643c3a2c83d3baa1b8ea226166",
"features": {
"ghcr.io/devcontainers-extra/features/pnpm:2": {
"version": "10.28.0"
"version": "11.26.0"
}
},
"containerEnv": {
Expand Down
Original file line number Diff line number Diff line change
@@ -1,19 +1,27 @@
---
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing
name: Agentic Workflows
description: GitHub Agentic Workflows (gh-aw) - Create, debug, and upgrade AI-powered workflows with intelligent prompt routing.
disable-model-invocation: true
---

# GitHub Agentic Workflows Agent

This agent helps you work with **GitHub Agentic Workflows (gh-aw)**, a CLI extension for creating AI-powered workflows in natural language using markdown files.

## Repository Instructions Overlay

If `.github/aw/instructions.md` exists, load it with:
@.github/aw/instructions.md

Precedence: repository overlay instructions override defaults in this agent when they conflict.

## What This Agent Does

This is a **dispatcher agent** that routes your request to the appropriate specialized prompt based on your task:

- **Creating new workflows**: Routes to `create` prompt
- **Updating existing workflows**: Routes to `update` prompt
- **Debugging workflows**: Routes to `debug` prompt
- **Debugging workflows**: Routes to `debug` prompt
- **Upgrading workflows**: Routes to `upgrade-agentic-workflows` prompt
- **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
- **Creating shared components**: Routes to `create-shared-agentic-workflow` prompt
Expand All @@ -24,9 +32,6 @@ This is a **dispatcher agent** that routes your request to the appropriate speci
- **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

> [!IMPORTANT]
> For architecture/pattern-selection requests, load `https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/patterns.md` first.

Workflows may optionally include:

- **Project tracking / monitoring** (GitHub Projects updates, status reporting)
Expand All @@ -37,7 +42,7 @@ Workflows may optionally include:
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
- Workflow lock files: `.github/workflows/*.lock.yml`
- Shared components: `.github/workflows/shared/*.md`
- Configuration: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/github-agentic-workflows.md
- Configuration: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md`

## Problems This Solves

Expand All @@ -56,30 +61,32 @@ When you interact with this agent, it will:

## Available Prompts

> **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.

### Create New Workflow
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/create-agentic-workflow.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/create-agentic-workflow.md`

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

### Update Existing Workflow
### Update Existing Workflow
**Load when**: User wants to modify, improve, or refactor an existing workflow

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/update-agentic-workflow.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/update-agentic-workflow.md`

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

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

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/debug-agentic-workflow.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/debug-agentic-workflow.md`

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

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/upgrade-agentic-workflows.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/upgrade-agentic-workflows.md`

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

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/report.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/report.md`

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

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/create-shared-agentic-workflow.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/create-shared-agentic-workflow.md`

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

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/dependabot.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/dependabot.md`

**Use cases**:
- "Fix the open Dependabot PRs for npm dependencies"
Expand All @@ -129,27 +136,17 @@ When you interact with this agent, it will:
### Analyze Test Coverage
**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.

**Prompt file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/test-coverage.md
**Prompt file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/test-coverage.md`

**Use cases**:
- "Create a workflow that comments coverage on PRs"
- "Analyze coverage trends over time"
- "Add a coverage gate that blocks PRs below a threshold"

### Render ASCII Charts in Markdown
**Load when**: The workflow needs in-markdown charts (sparklines, bars, table+trend views) that must align cleanly and render reliably across GitHub surfaces, including mobile.

**Reference file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/asciicharts.md

**Use cases**:
- "Show a compact trend chart in an issue comment"
- "Render a dashboard table with sparkline trends"
- "Generate aligned ASCII bars for service metrics"

### CLI Commands Reference
**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.

**Reference file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/cli-commands.md
**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/cli-commands.md`

**Use cases**:
- "How do I trigger workflow X on the main branch?"
Expand All @@ -160,7 +157,7 @@ When you interact with this agent, it will:
### Token Consumption Optimization
**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.

**Reference file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/token-optimization.md
**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/token-optimization.md`

**Use cases**:
- "How do I reduce the token cost of this workflow?"
Expand All @@ -173,7 +170,7 @@ When you interact with this agent, it will:
### Workflow Pattern Selection
**Load when**: The user asks for architecture, strategy, operating model selection, or pattern recommendations for building agentic workflows.

**Reference file**: https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/patterns.md
**Reference file**: `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/patterns.md`

**Use cases**:
- "Which pattern should I use for multi-repo rollout?"
Expand All @@ -186,7 +183,7 @@ When you interact with this agent, it will:
When a user interacts with you:

1. **Identify the task type** from the user's request
2. **Load the appropriate prompt** from the GitHub repository URLs listed above
2. **Load the appropriate prompt** from the URLs listed above
3. **Follow the loaded prompt's instructions** exactly
4. **If uncertain**, ask clarifying questions to determine the right prompt

Expand Down Expand Up @@ -225,12 +222,12 @@ gh aw compile --validate

## Important Notes

- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.81.6/.github/aw/github-agentic-workflows.md for complete documentation
- Always reference the instructions file at `https://raw.githubusercontent.com/github/gh-aw/main/.github/aw/github-agentic-workflows.md` for complete documentation
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF
- Follow security best practices: minimal permissions, explicit network access, no template injection
- **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.81.6/.github/aw/network.md for the full list of valid ecosystem identifiers and domain patterns.
- **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.
- **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.
- **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.
- **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.81.6/.github/aw/cli-commands.md
- **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`
30 changes: 15 additions & 15 deletions .github/aw/actions-lock.json
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
{
"entries": {
"actions/checkout@v6.0.2": {
"actions/checkout@v7.0.1": {
"repo": "actions/checkout",
"version": "v6.0.2",
"sha": "de0fac2e4500dabe0009e67214ff5f5447ce83dd"
"version": "v7.0.1",
"sha": "3d3c42e5aac5ba805825da76410c181273ba90b1"
},
"actions/create-github-app-token@v3.2.0": {
"repo": "actions/create-github-app-token",
Expand All @@ -20,30 +20,30 @@
"version": "v9.0.0",
"sha": "3a2844b7e9c422d3c10d287c895573f7108da1b3"
},
"actions/setup-dotnet@v5.2.0": {
"actions/setup-dotnet@v6.0.0": {
"repo": "actions/setup-dotnet",
"version": "v5.2.0",
"sha": "c2fa09f4bde5ebb9d1777cf28262a3eb3db3ced7"
"version": "v6.0.0",
"sha": "a98b56852c35b8e3190ac28c8c2271da59106c68"
},
"actions/setup-node@v6.4.0": {
"actions/setup-node@v7.0.0": {
"repo": "actions/setup-node",
"version": "v6.4.0",
"sha": "48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e"
"version": "v7.0.0",
"sha": "820762786026740c76f36085b0efc47a31fe5020"
},
"actions/upload-artifact@v7.0.1": {
"repo": "actions/upload-artifact",
"version": "v7.0.1",
"sha": "043fb46d1a93c77aae656e7c1c64a875d1fc6a0a"
},
"github/gh-aw-actions/setup-cli@v0.81.6": {
"github/gh-aw-actions/setup-cli@v0.88.7": {
"repo": "github/gh-aw-actions/setup-cli",
"version": "v0.81.6",
"sha": "ba6380cc6e5be5d21677bebe04d52fb48e3abec7"
"version": "v0.88.7",
"sha": "5e508589e03a7757a7e05b26e834292f5445bfb6"
},
"github/gh-aw-actions/setup@v0.81.6": {
"github/gh-aw-actions/setup@v0.88.7": {
"repo": "github/gh-aw-actions/setup",
"version": "v0.81.6",
"sha": "ba6380cc6e5be5d21677bebe04d52fb48e3abec7"
"version": "v0.88.7",
"sha": "5e508589e03a7757a7e05b26e834292f5445bfb6"
}
},
"containers": {
Expand Down
23 changes: 4 additions & 19 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,31 +12,16 @@ updates:
- "*"
cooldown:
default-days: 7
# NuGet updates are limited to third-party dependencies and selected test
# and tool packages. Other Microsoft-owned packages use dependency flow or
# require manual testing.
# Cover all actual project dependencies, including Aspire and Azure packages.
# Generated documentation catalogs are not NuGet dependency manifests.
- package-ecosystem: "nuget"
directory: "/"
schedule:
interval: "weekly"
allow:
- dependency-name: "Microsoft.AspNetCore.TestHost"
- dependency-name: "Microsoft.CodeAnalysis.CSharp.Workspaces"
- dependency-name: "Microsoft.NET.Test.Sdk"
- dependency-name: "OpenTelemetry.*"
- dependency-name: "System.CommandLine"
- dependency-name: "xunit"
- dependency-name: "xunit.*"
groups:
nuget-selected:
nuget-all:
patterns:
- "Microsoft.AspNetCore.TestHost"
- "Microsoft.CodeAnalysis.CSharp.Workspaces"
- "Microsoft.NET.Test.Sdk"
- "OpenTelemetry.*"
- "System.CommandLine"
- "xunit"
- "xunit.*"
- "*"
cooldown:
default-days: 7
- package-ecosystem: "github-actions"
Expand Down
Loading
Loading