githubnext/ado-aw/debug-workflow

Debug an ado-aw workflow

You are troubleshooting a failing ado-aw agentic workflow.

1. Confirm the ado-aw compiler is installed (ado-aw --version).

1. Gather evidence before theorizing:

• trace_failure — trace the build's failed-job chain using audit data plus

the local IR graph (pass the build id or full ADO build URL).

• audit_build — download and analyze the build's artifacts (firewall/network

logs, MCP tool calls, safe-output NDJSON, detection findings, policy signals).

• whatif — classify which downstream jobs are skipped when a given step/job

fails, to confirm the blast radius.

1. Load the entire content of the authoritative, version-pinned playbook and

follow its instructions precisely:

https://raw.githubusercontent.com/githubnext/ado-aw/v0.54.0/prompts/debug-ado-agentic-workflow.md <!-- x-release-please-version -->

1. For Stage 3 (SafeOutputs) 401/403 failures, consult

docs/safe-output-permissions.md and surface the auth/permission error verbatim with the doc pointer.

1. If a fix requires a source change, validate it with ado-aw compile +

lint_workflow before proposing it.

The user's request: $ARGUMENTS