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.
- Copy the agent file at the reviewed commit into the location your host uses for custom agents.
- 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.
- AWF diagnosis agent ↗Checked
https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/.github/agents/diagnose-awf.md
Supports: summary, whySelected, limitations
- MIT licence ↗Checked
https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/LICENSE
Supports: Redistribution terms