For an overview of all available workflows, see the main README.
Automated CI failure investigator that analyzes root causes and provides actionable recommendations
The CI Doctor workflow monitors your GitHub Actions workflows and automatically investigates CI failures. When a monitored workflow fails, it conducts deep analysis to identify root causes, patterns, and provides recommendations for fixing issues.
# Install the 'gh aw' extension
gh extension install github/gh-aw
# Add the workflow to your repository
gh aw add-wizard githubnext/agentics/ci-doctorThis walks you through adding the workflow to your repository.
graph LR
A[CI Failure Detected] --> B[Collect Logs]
B --> C[Analyze Root Cause]
C --> D[Search for Patterns]
D --> E{Solution Found?}
E -->|Yes| F[Create Investigation Issue]
E -->|No| G[Report: Needs Human Review]
The workflow collects failed workflow logs, analyzes root causes, searches for patterns in historical issues, and creates detailed investigation issues with recommendations.
You can specify which workflows to monitor by editing the workflow directly.
After editing run gh aw compile to update the workflow and commit all changes to the default branch.