debug-workflow
/debug-workflow
Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.
- Author
- githubnext ↗
- Repository
- ado-aw ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 1
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- SKILL.md zawiera komentarze HTML (1). Nie widać ich w podglądzie Markdown, a model je czyta.
What it does and when to use it
Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.
Original author description
Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.
How it works
SKILL.md has no level-two headings · 29 lines, 151 words
SKILL.md preview
---
name: debug-workflow
description: Diagnose a failing ado-aw agentic Azure DevOps pipeline. Use when the user reports a pipeline failing, an agent unable to reach an MCP/network host, safe outputs not being applied, or wants to understand why a build behaved a certain way.
allowed-tools: Bash, Read, Write, Edit, Glob, Grep, mcp__ado-aw__trace_failure, mcp__ado-aw__audit_build, mcp__ado-aw__whatif, mcp__ado-aw__inspect_workflow, mcp__ado-aw__graph_summary, mcp__ado-aw__lint_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`).
2. 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.
3. 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 -->
4. For Stage 3 (SafeOutputs) 401/403 failures, consult
`docs/safe-output-permissions.md` and surface the auth/permission error
verbatim with the doc pointer.
5. If a fix requires a source change, validate it with `ado-aw compile` +
`lint_workflow` before proposing it.
The user's request: $ARGUMENTS
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · githubnext/ado-aw | 86 | MIT |
| synaptiai/agent-capability-standard | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version 64f25a1248bb (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 86compile-and-validate
Compile an ado-aw agent file to Azure DevOps pipeline YAML and validate it. Use when the user asks to compile a workflow, check whether it is valid, verify a pipeline matches its source, or understand the compiled IR / dependency graph. - 100azure-devops-workflow
Use Azure DevOps Services to triage Azure Boards work items or sprint backlogs, inspect and review Azure Repos pull requests, or diagnose Azure Pipelines builds and runs. Also use when the user supplies a dev.azure.com link for one of those resources. - 100azure-devops
Set up Azure Pipelines for CI/CD, configure build and release pipelines, manage Azure DevOps projects, and integrate with Azure services. Use when working with Azure DevOps Services or Server for enterprise DevOps workflows. - 100azure-devops-pipelines
Best practices for Azure DevOps Pipeline YAML files Triggers on: **/azure-pipelines.yml, **/azure-pipelines*.yml, **/*.pipeline.yml - 90manage-lifecycle
Operate compiled ado-aw pipelines in Azure DevOps. Use when the user wants to register/enable/disable/remove build definitions, queue runs, set pipeline secrets, or report pipeline status. - 90azure-devops
Use when user references Azure DevOps / ADO, dev.azure.com or an on-prem TFS URL, work items, bugs, PBIs, pull requests, or the project wiki. Goes through the azure-devops MCP server.