✨ 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
• 💰 Cost Tracker - Post per-run agent spend summaries on pull requests using token-usage.jsonl from gh-aw's firewall
• 🔍 Log Watcher - Diagnose agent run failures by scanning logs for errors, retry loops, rate limits, and token anomalies, then posting a health report on the associated PR or issue (community - maintained in AgentMeter/agentmeter-action)

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

Loop Engineering

• 🔄 Autoloop - Loop anything in your repo to continuously research, develop and maintain
• 🎯 Goal - Loop Engineering on top of Agentic Workflows
• 🏗️ Crane - Build and operate repository loops with composable loop infrastructure

Research, Status & Planning

• 📚 Weekly Research - Collect research updates and industry trends
• 📊 Weekly Issue Activity - Weekly issue activity report with trend charts and recommendations
• 👥 Daily Repo Status - Assess repository activity and create status reports
• 👥 Daily Team Status - Create upbeat team activity summaries with productivity insights
• 📰 Daily Repository Chronicle - Transform 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

Documentation Workflows

• 📖 Documentation Update on Push to Main - Update documentation automatically on every push to main
• 📖 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
• 🎙️ Dictation Prompt Generator - Generate and maintain a project-specific DICTATION.md file with speech-to-text vocabulary and error-correction guidance
• 🔗 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
• 📝 Markdown Linter - Run Markdown quality checks on all documentation files and get a prioritized issue report of violations
• 📱 Daily Multi-Device Docs Tester - Test documentation sites across mobile, tablet, and desktop viewports for responsive layout and interaction issues

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
• 🔎 Daily Adhoc QA - Perform adhoc explorative quality assurance tasks
• 🗂️ Large File Simplifier - Identify the largest source file and create a detailed refactoring plan as an issue

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

• ✨ Code Simplifier - Automatically simplify recently modified code for improved clarity and maintainability
• 🔍 Duplicate Code Detector - Identify duplicate code patterns and suggest refactoring opportunities
• 🧪 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
• 🌱 Daily Efficiency Improver - Improve energy efficiency and computational footprint across code, data, network, and UI
• 📊 Repository Quality Improver - Daily rotating analysis of repository quality across code, documentation, testing, security, and custom dimensions

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

Security Workflows

• 🔍 Daily Malicious Code Scan - Scan recent code changes for suspicious patterns indicating malicious activity or supply chain attacks
• 🔒 VEX Generator - Auto-generate OpenVEX statements for dismissed Dependabot alerts, capturing security assessments in a machine-readable format

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

Meta-Workflows

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

Issue Farming Workflows

• 👾 Issue Monster - Automatically assign issues labeled cookie to the Copilot coding agent every 30 minutes
• 🔒 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

🚀 Non-Coding Use Cases

While The Agentics focuses on engineering workflows, agentic workflows are equally powerful for product, operations, compliance, and leadership teams. Agentics Beyond Code is a companion collection built for non-engineering roles — no coding required. A few highlights:

• Launch Readiness Checker — Monday morning readiness report across all launches: completeness, risk, blockers, and sign-offs
• Compliance Review — automated evaluation against Security, Privacy, Accessibility, and Responsible AI rubrics, with per-team status reports
• Weekly Status — Friday rollup of What Shipped, What We Learned, FYIs, and SOSes across all initiatives, ready for leadership
• Leadership Briefs — personalized Monday briefings per leader, with Give Kudos, Give Feedback, and Get Involved sections tailored to each person's domain and management style
• Process Analyzer — weekly retro that detects process drift between transcripts and how-we-work docs, surfaces automation gaps, and proposes update PRs
• Adversarial PM — weekly grumpy challenge of the team's most consequential decisions, arguing against them using pre-mortem, reversibility, and opportunity cost lenses
• Decision Log — scans issue comments and meeting transcripts to create structured decision records
• GTM Content — generate and refresh changelog drafts and public roadmap items following org voice & tone guidelines

🔄 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 #agentic-workflows channel in the GitHub Next Discord.