---
title: "AWF diagnosis: review, role & definition · Undominated.ai"
canonical: https://undominated.ai/agents/github-awf-diagnose/
description: "Fingerprints an Agentic Workflow Firewall failure, matches one finding, and reports the symptom, the finding id, and one next probe before naming a fix."
---

# AWF diagnosis: review, role & definition · Undominated.ai

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

[← Explore all agents](/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.

 [Use this definition ↓](#setup)[Original source ↗](https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/.github/agents/diagnose-awf.md)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 2 linked sources
 Publisher GitHub Next
 Licence [MIT ↗](https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/LICENSE)
 Revision a204c21365ac
 [Read what was—and wasn’t—checked ↓](#review)

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

 [GitHub Next · upstream description ↗](https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/.github/agents/diagnose-awf.md) Our analysis follows below.

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.

### A good fit for

 - A first pass on one AWF failure when the symptom, the runner, and the version can be named
- Stopping a diagnosis that does not match a finding instead of inventing a bypass

### Weigh up before choosing

 - The frontmatter has no tool allowlist. A host that grants write tools is not stopped by this file. Probes named in the catalog include docker exec, awf --version, findmnt, grep of a lock file, and gh aw logs. This review did not run them.
- AUTH-001 is status fixed and also fixed=unknown. A29 says upgrade AWF to v0.28.31 or newer and also says the end-to-end fix remains unresolved. The catalog below the generated marker says not to edit it by hand. Sibling docs and skills named in the playbook were not opened. The v0.28.31 tag was not checked.

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 ↗](https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/.github/agents/diagnose-awf.md)
 - 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

### Compatibility

Hosts that can load a Markdown agent file

### Implementation

Markdown

### Diagnostic prompt. The file does not set a tool allowlist.

 - Read version, topology, and the finding catalog in this file
- The listed probes are read-oriented. The file does not grant them.

### Cost model

MIT instructions at no charge. Copyright (c) 2025 GitHub Next.

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 ↗](https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/.github/agents/diagnose-awf.md) Checked 2026-10-13 https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/.github/agents/diagnose-awf.md Supports: summary, whySelected, limitations
- [MIT licence ↗](https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/LICENSE) Checked 2026-10-13 https://github.com/github/gh-aw-firewall/blob/a204c21365ac2a719f7dd4a0a3af57e195efb904/LICENSE Supports: Redistribution terms

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### C++ build error resolver ↗ Diagnoses compilation, CMake, linking and template errors through a small-edit, rebuild and test loop.](/agents/ecc-cpp-build-resolver/)[### Dart/Flutter build error resolver ↗ Diagnoses analyzer, platform build, package-resolution and generated-code failures with bounded changes.](/agents/ecc-dart-build-resolver/)[### Github Actions Expert ↗ Designs and reviews GitHub Actions workflows around minimal token permissions, immutable action references, OIDC, deployment concurrency and validation.](/agents/github-github-actions-expert/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Find reusable instructions](/skills/)
- [Inspect connections](/mcp-servers/)
- [Build a toolkit](/tools/)
- [Choose the model](/compare/)
