From Markdown to Guarded Automation: Build Your First GitHub Agentic Workflow
GitHub Agentic Workflows bring natural-language reasoning into GitHub Actions without asking us to abandon the controls that make automation dependable. We describe the task in Markdown, declare the tools and boundaries in front matter, then compile that source into an ordinary GitHub Actions workflow.
In this tutorial, we will build a small CI failure triage workflow, compile its Markdown source into a standard GitHub Actions workflow, and examine the guardrails that keep its access bounded. The finished workflow reads a failed run, analyses its jobs and logs, and proposes one diagnostic issue in staged mode for a maintainer to inspect.
Current status: GitHub Agentic Workflows are in public preview and subject to change. This sample passed strict validation with gh-aw v0.86.2 on 25 August 2026.
What We Will Build
