← Explore all agents

DIAGNOSTICS / GitHub Next

AWF diagnosis

Fingerprints an Agentic Workflow Firewall failure, matches one finding, and reports the symptom, the finding id, and one next probe before naming a fix.

“Diagnose AWF failures from symptoms, workflow runs, or errors using the canonical diagnostics registry.”

01 / THE REASONING

Why this made the selection.

  • The procedure records unknown rather than guessing, classifies one failing boundary, and matches the narrowest finding before it names a remedy.
  • The safety rules refuse tokens, JWTs, Authorization headers, and full environment dumps, and they refuse disabling isolation or widening the allowlist as the default fix.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • .github/agents/diagnose-awf.md (at a204c21, and its diff from 8c67001, the previous review)
  • LICENSE (byte-identical at 8c67001 and a204c21)

Our findings

  • LICENSE is the MIT Licence with Copyright (c) 2025 GitHub Next.
  • The playbook above the generated marker is authored. The finding catalog is generated. A suspected isolation or credential regression goes to SEC-001 rather than a bypass. If nothing matches, the procedure says to stop.
  • Between 8c67001 and a204c21 the only change is a new generated finding, B36: setup-uv cache and Python-install paths under RUNNER_TEMP are unwritable when AWF runs with --env-all. Its action is to upgrade AWF to include github/gh-aw-firewall#9705.

Not established by this review

  • No probe was run.
  • The v0.28.31 tag was not fetched.
  • Sibling diagnostic docs were not opened.
  • The B36 pull request and issue it cites were not opened.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Use the role in your project.

Upstream setup instructions ↗
  1. Copy the agent file at the reviewed commit into the location your host uses for custom agents.
  2. No install command is published. Do not run a probe that prints a token, and do not treat a missing match as a reason to disable isolation.

Before you start

  • A symptom, a workflow run, or an error string
  • Permission to run only the read-oriented probe the matched finding names

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. AWF diagnosis agent ↗Checked

    https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/.github/agents/diagnose-awf.md

    Supports: summary, whySelected, limitations

  2. MIT licence ↗Checked

    https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/LICENSE

    Supports: Redistribution terms

Evidence & Ask