Skip to content

Add awf-release-integrator skill for AWF release bumps#31759

Merged
pelikhan merged 3 commits into
mainfrom
copilot/add-awf-release-integrator-skill
May 12, 2026
Merged

Add awf-release-integrator skill for AWF release bumps#31759
pelikhan merged 3 commits into
mainfrom
copilot/add-awf-release-integrator-skill

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 12, 2026

New Feature

What does this feature do?

Adds an awf-release-integrator skill under .github/skills/ for the AWF upgrade workflow in gh-aw. The skill directs agents to fetch the latest github/gh-aw-firewall release, update AWF version pins and gates, rebuild/recompile generated artifacts, and review upstream release/spec drift for follow-up changes.

Why is this feature needed?

AWF release bumps in gh-aw are more than a constant update: they can require schema syncs, version-gated flag changes, and spec-follow-up work. This skill captures that integration path in one place so release updates are handled consistently and with the right review surface.

Implementation details

  • New skill

    • adds .github/skills/awf-release-integrator/SKILL.md
    • defines the scope for integrating a newer gh-aw-firewall release into gh-aw
  • Pinned-source guidance

    • points agents at the local integration points:
      • pkg/constants/version_constants.go
      • pkg/workflow/awf_config.go
      • pkg/workflow/awf_helpers.go
      • pkg/workflow/schemas/awf-config.schema.json
      • specs/awf-config-sources-spec.md
    • calls out upstream AWF release/spec/schema files to compare during the bump
  • Upgrade workflow

    • instructs agents to:
      • check the latest AWF release
      • compare it to DefaultFirewallVersion
      • update DefaultFirewallVersion and any relevant AWF*MinVersion gates
      • add/update a patch changeset when shipped behavior changes
  • Follow-up review heuristics

    • explicitly asks for review of:
      • new schema properties not represented in gh-aw
      • new CLI flags that need version gates
      • spec/schema drift that should update specs/awf-config-sources-spec.md
      • tests/documentation that need refresh after the bump
  • Required rebuild path

    • codifies the expected regeneration sequence for AWF bumps:
make build
make recompile
make recompile

Copilot AI and others added 3 commits May 12, 2026 17:55
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title Add awf-release-integrator skill Add awf-release-integrator skill for AWF release bumps May 12, 2026
Copilot AI requested a review from pelikhan May 12, 2026 17:58
@pelikhan pelikhan marked this pull request as ready for review May 12, 2026 18:11
Copilot AI review requested due to automatic review settings May 12, 2026 18:11
@pelikhan pelikhan merged commit f3b20e0 into main May 12, 2026
@pelikhan pelikhan deleted the copilot/add-awf-release-integrator-skill branch May 12, 2026 18:11
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds guidance for reliably integrating upstream gh-aw-firewall releases into gh-aw, and updates the embedded GitHub Actions workflow JSON schema to reflect newer concurrency capabilities.

Changes:

  • Add a new .github/skills/awf-release-integrator/SKILL.md documenting the AWF bump/integration workflow (pins, gates, upstream drift review, regen steps).
  • Update pkg/workflow/schemas/github-workflow.json to include concurrency.queue and adjust concurrency descriptions accordingly.
Show a summary per file
File Description
pkg/workflow/schemas/github-workflow.json Extends embedded GitHub Actions schema with concurrency.queue and updates related descriptions.
.github/skills/awf-release-integrator/SKILL.md New skill doc capturing the standard AWF release bump + validation/regeneration procedure.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

  • Files reviewed: 2/2 changed files
  • Comments generated: 2

Comment on lines +36 to 42
"queue": {
"$comment": "https://docs.github.com/en/actions/reference/workflows-and-actions/workflow-syntax#example-queueing-multiple-pending-runs",
"description": "Controls how pending jobs or workflow runs are queued within a concurrency group. With the default `single`, at most one run can be pending — additional pending runs cancel the previous one. With `max`, up to 100 runs can be pending and are processed in FIFO order. The combination of `queue: max` and `cancel-in-progress: true` is not allowed.",
"type": "string",
"enum": ["single", "max"],
"default": "single"
}
Comment on lines 16 to 22
"concurrency": {
"type": "object",
"properties": {
"group": {
"$comment": "https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#example-using-concurrency-to-cancel-any-in-progress-job-or-run-1",
"description": "When a concurrent job or workflow is queued, if another job or workflow using the same concurrency group in the repository is in progress, the queued job or workflow will be pending. Any previously pending job or workflow in the concurrency group will be canceled.",
"description": "When a concurrent job or workflow is queued, if another job or workflow using the same concurrency group in the repository is in progress, the queued job or workflow will be pending. By default any previously pending job or workflow in the concurrency group will be canceled; this behavior can be changed with `queue`.",
"type": "string"
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants