✨ The Agentics

A sample family of reusable GitHub Agentic Workflows.

📂 Available Workflows

Maintainer Workflows

Make software maintenance enjoyable! From basic issue triage to Repo Assist - a powerful triage multi-task backlog burner, issue labeller, bug fixer and general repository assistant. Other workflows help gate your repository.

• 🏷️ Issue Triage - Triage labelling of issues and pull requests and not much more
• 🤖 Repo Assist - A regular, pervasive all-tools repository assistant that triages issues, investigates issues, replies with comments, fixes bugs, proposes engineering improvements, and maintains activity summaries
• 🛡️ AI Moderator - Automatically detect and moderate spam, link spam, and AI-generated content

Fault Analysis Workflows

Investigate faults proactively and improve CI.

• 🏥 CI Doctor - Monitor CI workflows and investigate failures automatically
• 🚀 CI Coach - Optimize CI workflows for speed and cost efficiency

Code Review Workflows

• 😤 Grumpy Reviewer - On-demand opinionated code review by a grumpy but thorough senior developer
• 🔍 PR Nitpick Reviewer - On-demand fine-grained code review focusing on style, conventions, and subtle improvements
• 🔍 Contribution Check - Regularly review batches of open PRs against contribution guidelines and create prioritized reports
• ✅ Contribution Guidelines Checker - Review pull requests for compliance with contribution guidelines

Research, Status & Planning Workflows

• 🔄 Autoloop - Iterative optimization agent that proposes changes, evaluates against a metric, and keeps only improvements
• 📚 Weekly Research - Collect research updates and industry trends
• 📊 Weekly Issue Summary - Weekly issue activity report with trend charts and recommendations
• 👥 Daily Repo Status - Assess repository activity and create status reports
• 👥 Daily Team Status - Create upbeat daily team activity summaries with productivity insights
• 📰 Daily Repository Chronicle - Transform daily repository activity into an engaging newspaper-style narrative with trend charts
• 📋 Daily Plan - Update planning issues for team coordination
• 🔍 Discussion Task Miner - Extract actionable improvement tasks from GitHub Discussions and create tracked issues
• 🗺️ Weekly Repository Map - Visualize repository file structure and size distribution with a weekly ASCII tree map
• 📰 Tech Content Editorial Board - Daily tech content editorial-board review of technical rigor, wording, structure, and editorial quality

Dependency Management Workflows

• 📦 Dependabot PR Bundler - Create pull requests to bundle together as many dependabot updates as possible
• 📦 Dependabot Issue Bundler - Create issues that group together dependabot updates related to the same ecosystem

Command-Triggered Agentic Workflows

These workflows are triggered by specific "/" commands in issue or pull request comments, allowing for on-demand agentic assistance. Only maintainers or those with write access can trigger these workflows by commenting with the appropriate command.

You can use the "/plan" agent to turn the reports into actionable issues which can then be assigned to the appropriate team members or agents.

• 📊 Archie - Generate Mermaid diagrams to visualize issue and pull request relationships with /archie command
• 📋 Plan Command - Break down issues into actionable sub-tasks with /plan command
• 🏥 PR Fix - Analyze failing CI checks and implement fixes for pull requests
• 🔍 Repo Ask - Intelligent research assistant for repository questions and analysis

Code Improvement Workflows (by analysis, producing report)

These workflows analyze the repository, code, and activity to produce reports, insights, and recommendations for improvements. They do not make any changes to the codebase directly but can be used as input for maintainers to take action.

• 🔍 Daily Accessibility Review - Review application accessibility by automatically running and using the application
• 📱 Multi-Device Docs Tester - Test documentation sites across mobile, tablet, and desktop viewports for responsive layout and interaction issues
• 🔎 Daily Adhoc QA - Perform adhoc explorative quality assurance tasks

Code Improvement Workflows (by making changes, producing pull requests)

• 📖 Regular Documentation Update - Update documentation automatically
• 📖 Daily Documentation Updater - Automatically update documentation based on recent code changes and merged PRs
• 📝 Agentic Wiki Writer - Automatically generate and maintain GitHub wiki pages from source code
• 🔧 Agentic Wiki Coder - Implement code changes described in GitHub wiki edits
• 📖 Glossary Maintainer - Automatically maintain project glossary based on codebase changes
• 🔗 Link Checker - Daily automated link checker that finds and fixes broken links in documentation
• 🗜️ Documentation Unbloat - Automatically simplify documentation by reducing verbosity while maintaining clarity
• ✨ Code Simplifier - Automatically simplify recently modified code for improved clarity and maintainability
• 🔍 Duplicate Code Detector - Identify duplicate code patterns and suggest refactoring opportunities
• 🏋️ Daily File Diet - Monitor for oversized source files and create targeted refactoring issues
• 🧪 Daily Test Improver - Improve test coverage by adding meaningful tests to under-tested areas
• ⚡ Daily Perf Improver - Analyze and improve code performance through benchmarking and optimization
• 📊 Repository Quality Improver - Daily rotating analysis of repository quality across code, documentation, testing, security, and custom dimensions
• 📝 Markdown Linter - Run Markdown quality checks on all documentation files and get a prioritized issue report of violations

Formal Verification Workflows

• 🔬 Lean Squad - Progressively apply Lean 4 formal verification to your codebase: research targets, extract specs, write Lean propositions, translate implementations, and attempt proofs — finding bugs or issuing stamps of confidence

Security Workflows

• 🔍 Daily Malicious Code Scan - Daily scan of recent code changes for suspicious patterns indicating malicious activity or supply chain attacks

Meta-Workflows

• 🔧 Q - Workflow Optimizer - Expert system that analyzes and optimizes agentic workflows

Issue Farming Workflows

• 🔒 Sub-Issue Closer - Automatically close parent issues when all their sub-issues are complete
• 🌳 Issue Arborist - Automatically organize issues by linking related issues as parent-child sub-issues

🧩 Shared Workflow Fragments

Shared workflow fragments are reusable building blocks that can be imported into other workflows using imports: [shared/name.md]. They provide pre-configured tools, MCP servers, and setup steps.

MCP Servers

• arXiv - Access arXiv research papers: search, get paper details, and retrieve PDFs
• MarkItDown - Convert PDFs, Word documents, PowerPoints, HTML, and other formats to Markdown
• Microsoft Docs - Access Microsoft's documentation via learn.microsoft.com

Tools & Setup

• FFmpeg - Install and use FFmpeg for video/audio processing (extract audio, frames, scene detection, etc.)
• sq - Install and use sq for querying structured data (CSV, Excel, JSON, SQL databases) with jq-like syntax

Formatting & Reporting

• Formatting - Standard content structure with overview and collapsible details sections
• Reporting - Guidelines for reporting workflow run information with clickable run ID links

🔄 Updating Workflows

Keep your agentic workflows up to date with the latest features and improvements:

gh extensions upgrade github/gh-aw # Update cli extension
gh aw upgrade  # Upgrade to latest gh aw engine version
gh aw update   # Update added workflows

This automatically updates agent files, applies codemods, updates actions versions, and recompiles all workflows.

📖 Learn more about GitHub Agentic Workflows

💬 Share Feedback

Is your favorite agentic workflow not here? Do you have an idea for a new one? Clone this repo and explore, create! Tell us about it! You can file bugs and feature requests as issues in this repository and share your thoughts in the #continuous-ai channel in the GitHub Next Discord.