Meet the Workflows: Fault Investigation

Jan 13, 2026

Ah, splendid! Welcome back to Peli’s Agent Factory! Come, let me show you the chamber where vigilant caretakers investigate faults before they escalate!

In our previous post, we explored issue and PR management workflows.

Now let’s shift from collaboration ceremony to fault investigation.

While issue workflows help us handle what comes in, fault investigation workflows act as vigilant caretakers - spotting problems before they escalate and keeping our codebase healthy. These are the agents that investigate failed CI runs, detect schema drift, and catch breaking changes before users do.

Fault Investigation Workflows

These are our diligent caretakers - the agents that spot problems before they become bigger problems:

CI Doctor - Investigates failed workflows and opens diagnostic issues (it’s like having a DevOps specialist on call 24/7)
Schema Consistency Checker - Detects when schemas, code, and docs drift apart
Breaking Change Checker - Watches for changes that might break things for users

The CI Doctor was one of our most important workflows. Instead of drowning in CI failure notifications, we now get timely, investigated failures with actual diagnostic insights. The agent doesn’t just tell us something broke - it analyzes logs, identifies patterns, searches for similar past issues, and even suggests fixes - even before the human has read the failure notification. We learned that agents excel at the tedious investigation work that humans find draining.

The Schema Consistency Checker caught drift that would have taken us days to notice manually.

These “hygiene” workflows became our first line of defense, catching issues before they reached users.

The CI Doctor has inspired a growing range of similar workflows inside GitHub, where agents proactively do depth investigations of site incidents and failures. This is the future of operational excellence: AI agents kicking in immediately to do depth investigation, for faster organizational response.

Using These Workflows

You can add these workflows to your own repository and remix them. Get going with our Quick Start, then run one of the following:

CI Doctor:

gh aw add https://github.com/github/gh-aw/blob/v0.37.7/.github/workflows/ci-doctor.md

Schema Consistency Checker:

gh aw add https://github.com/github/gh-aw/blob/v0.37.7/.github/workflows/schema-consistency-checker.md

Breaking Change Checker:

gh aw add https://github.com/github/gh-aw/blob/v0.37.7/.github/workflows/breaking-change-checker.md

Then edit and remix the workflow specifications to meet your needs, recompile using gh aw compile, and push to your repository. See our Quick Start for further installation and setup instructions.

Learn More

GitHub Agentic Workflows - The technology behind the workflows
Quick Start - How to write and compile workflows

Next Up: Metrics & Analytics Workflows

Next up, we look at workflows which help us understand if the agent collection as a whole is working well That’s where metrics and analytics workflows come in.

Continue reading: Metrics & Analytics Workflows →

This is part 8 of a 19-part series exploring the workflows in Peli’s Agent Factory.