Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 8 additions & 3 deletions .github/aw/actions-lock.json
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,11 @@
"version": "v9",
"sha": "373c709c69115d41ff229c7e5df9f8788daa9553"
},
"actions/github-script@v9.0.0": {
"repo": "actions/github-script",
"version": "v9.0.0",
"sha": "3a2844b7e9c422d3c10d287c895573f7108da1b3"
},
"actions/upload-artifact@v7": {
"repo": "actions/upload-artifact",
"version": "v7",
Expand All @@ -35,10 +40,10 @@
"version": "v7.0.0",
"sha": "bbbca2ddaa5d8feaa63e36b76fdaad77386f024f"
},
"github/gh-aw-actions/setup@v0.71.3": {
"github/gh-aw-actions/setup@v0.71.5": {
"repo": "github/gh-aw-actions/setup",
"version": "v0.71.3",
"sha": "07c7335cd76c4d4d9f00dd7874f85ff55ed71f24"
"version": "v0.71.5",
"sha": "b8068426813005612b960b5ab0b8bd2c27142323"
},
"github/gh-aw/actions/setup@v0.66.1": {
"repo": "github/gh-aw/actions/setup",
Expand Down
1 change: 0 additions & 1 deletion .github/workflows/daily-repo-goals.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,6 @@ The workflows in the blog series are:
* "copilot-session-insights.md",
* "daily-compiler-quality.md",
* "daily-doc-updater.md",
* "daily-file-diet.md",
* "daily-malicious-code-scan.md",
* "daily-multi-device-docs-tester.md",
* "daily-news.md",
Expand Down
68 changes: 35 additions & 33 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,11 @@ Investigate faults proactively and improve CI.

- [🔄 Autoloop](https://github.com/githubnext/autoloop) - Loop anything in your repo to continuously research, develop and maintain
- [📚 Weekly Research](docs/weekly-research.md) - Collect research updates and industry trends
- [📊 Weekly Issue Summary](docs/weekly-issue-summary.md) - Weekly issue activity report with trend charts and recommendations
- [👥 Daily Repo Status](docs/daily-repo-status.md) - Assess repository activity and create status reports
- [👥 Daily Team Status](docs/daily-team-status.md) - Create upbeat daily team activity summaries with productivity insights
- [📰 Daily Repository Chronicle](docs/daily-repo-chronicle.md) - Transform daily repository activity into an engaging newspaper-style narrative with trend charts
- [📋 Daily Plan](docs/daily-plan.md) - Update planning issues for team coordination
- [📊 Weekly Issue Activity](docs/weekly-issue-activity.md) - Weekly issue activity report with trend charts and recommendations
- [👥 Daily Repo Status](docs/repo-status.md) - Assess repository activity and create status reports
- [👥 Daily Team Status](docs/team-status.md) - Create upbeat team activity summaries with productivity insights
- [📰 Daily Repository Chronicle](docs/repo-chronicle.md) - Transform repository activity into an engaging newspaper-style narrative with trend charts
- [📋 Daily Plan](docs/plan.md) - Update planning issues for team coordination
- [🔍 Discussion Task Miner](docs/discussion-task-miner.md) - Extract actionable improvement tasks from GitHub Discussions and create tracked issues
- [🗺️ Weekly Repository Map](docs/weekly-repo-map.md) - Visualize repository file structure and size distribution with a weekly ASCII tree map
- [📰 Tech Content Editorial Board](docs/tech-content-editorial-board.md) - Daily tech content editorial-board review of technical rigor, wording, structure, and editorial quality
Expand All @@ -45,54 +45,56 @@ Investigate faults proactively and improve CI.
- [📦 Dependabot PR Bundler](docs/dependabot-pr-bundler.md) - Create pull requests to bundle together as many dependabot updates as possible
- [📦 Dependabot Issue Bundler](docs/dependabot-issue-bundler.md) - 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.
### Documentation Workflows

- [📊 Archie](docs/archie.md) - Generate Mermaid diagrams to visualize issue and pull request relationships with /archie command
- [📋 Plan Command](docs/plan.md) - Break down issues into actionable sub-tasks with /plan command
- [🏥 PR Fix](docs/pr-fix.md) - Analyze failing CI checks and implement fixes for pull requests
- [🔍 Repo Ask](docs/repo-ask.md) - Intelligent research assistant for repository questions and analysis
- [📖 Documentation Update on Push to Main](docs/update-docs.md) - Update documentation automatically on every push to main
- [📖 Daily Documentation Updater](docs/doc-updater.md) - Automatically update documentation based on recent code changes and merged PRs
- [📝 Agentic Wiki Writer](docs/agentic-wiki-writer.md) - Automatically generate and maintain GitHub wiki pages from source code
- [🔧 Agentic Wiki Coder](docs/agentic-wiki-coder.md) - Implement code changes described in GitHub wiki edits
- [📖 Glossary Maintainer](docs/glossary-maintainer.md) - Automatically maintain project glossary based on codebase changes
- [🎙️ Dictation Prompt Generator](docs/dictation-prompt.md) - Generate and maintain a project-specific `DICTATION.md` file with speech-to-text vocabulary and error-correction guidance
- [🔗 Link Checker](docs/link-checker.md) - Daily automated link checker that finds and fixes broken links in documentation
- [🗜️ Documentation Unbloat](docs/unbloat-docs.md) - Automatically simplify documentation by reducing verbosity while maintaining clarity
- [📝 Markdown Linter](docs/markdown-linter.md) - Run Markdown quality checks on all documentation files and get a prioritized issue report of violations
- [📱 Daily Multi-Device Docs Tester](docs/multi-device-docs-tester.md) - 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](docs/daily-accessibility-review.md) - Review application accessibility by automatically running and using the application
- [📱 Multi-Device Docs Tester](docs/daily-multi-device-docs-tester.md) - Test documentation sites across mobile, tablet, and desktop viewports for responsive layout and interaction issues
- [🔎 Daily Adhoc QA](docs/daily-qa.md) - Perform adhoc explorative quality assurance tasks
- [🔍 Daily Accessibility Review](docs/accessibility-review.md) - Review application accessibility by automatically running and using the application
- [🔎 Daily Adhoc QA](docs/adhoc-qa.md) - Perform adhoc explorative quality assurance tasks
- [🗂️ Large File Simplifier](docs/large-file-simplifier.md) - Identify the largest source file and create a detailed refactoring plan as an issue

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

- [📖 Regular Documentation Update](docs/update-docs.md) - Update documentation automatically
- [📖 Daily Documentation Updater](docs/daily-doc-updater.md) - Automatically update documentation based on recent code changes and merged PRs
- [📝 Agentic Wiki Writer](docs/agentic-wiki-writer.md) - Automatically generate and maintain GitHub wiki pages from source code
- [🔧 Agentic Wiki Coder](docs/agentic-wiki-coder.md) - Implement code changes described in GitHub wiki edits
- [📖 Glossary Maintainer](docs/glossary-maintainer.md) - Automatically maintain project glossary based on codebase changes
- [🎙️ Dictation Prompt Generator](docs/dictation-prompt.md) - Generate and maintain a project-specific `DICTATION.md` file with speech-to-text vocabulary and error-correction guidance
- [🔗 Link Checker](docs/link-checker.md) - Daily automated link checker that finds and fixes broken links in documentation
- [🗜️ Documentation Unbloat](docs/unbloat-docs.md) - Automatically simplify documentation by reducing verbosity while maintaining clarity
- [✨ Code Simplifier](docs/code-simplifier.md) - Automatically simplify recently modified code for improved clarity and maintainability
- [🔍 Duplicate Code Detector](docs/duplicate-code-detector.md) - Identify duplicate code patterns and suggest refactoring opportunities
- [🏋️ Daily File Diet](docs/daily-file-diet.md) - Monitor for oversized source files and create targeted refactoring issues
- [🧪 Daily Test Improver](docs/daily-test-improver.md) - Improve test coverage by adding meaningful tests to under-tested areas
- [⚡ Daily Perf Improver](docs/daily-perf-improver.md) - Analyze and improve code performance through benchmarking and optimization
- [🌱 Daily Efficiency Improver](docs/daily-efficiency-improver.md) - Improve energy efficiency and computational footprint across code, data, network, and UI
- [🧪 Daily Test Improver](docs/test-improver.md) - Improve test coverage by adding meaningful tests to under-tested areas
- [⚡ Daily Perf Improver](docs/perf-improver.md) - Analyze and improve code performance through benchmarking and optimization
- [🌱 Daily Efficiency Improver](docs/efficiency-improver.md) - Improve energy efficiency and computational footprint across code, data, network, and UI
- [📊 Repository Quality Improver](docs/repository-quality-improver.md) - Daily rotating analysis of repository quality across code, documentation, testing, security, and custom dimensions
- [📝 Markdown Linter](docs/markdown-linter.md) - Run Markdown quality checks on all documentation files and get a prioritized issue report of violations

## Formal Verification Workflows
### Command-Triggered Agentic Workflows

- [🔬 Lean Squad](docs/lean-squad.md) - 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
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](docs/archie.md) - Generate Mermaid diagrams to visualize issue and pull request relationships with /archie command
- [📋 Plan Command](docs/plan.md) - Break down issues into actionable sub-tasks with /plan command
- [🏥 PR Fix](docs/pr-fix.md) - Analyze failing CI checks and implement fixes for pull requests
- [🔍 Repo Ask](docs/repo-ask.md) - Intelligent research assistant for repository questions and analysis

## Security Workflows

- [🔍 Daily Malicious Code Scan](docs/daily-malicious-code-scan.md) - Daily scan of recent code changes for suspicious patterns indicating malicious activity or supply chain attacks
- [🔍 Daily Malicious Code Scan](docs/malicious-code-scan.md) - Scan recent code changes for suspicious patterns indicating malicious activity or supply chain attacks
- [🔒 VEX Generator](docs/vex-generator.md) - Auto-generate OpenVEX statements for dismissed Dependabot alerts, capturing security assessments in a machine-readable format

## Formal Verification Workflows

- [🔬 Lean Squad](docs/lean-squad.md) - 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](docs/q.md) - Expert system that analyzes and optimizes agentic workflows
Expand Down
46 changes: 46 additions & 0 deletions docs/accessibility-review.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# 🔍 Daily Accessibility Review

> For an overview of all available workflows, see the [main README](../README.md).

**Perform accessibility reviews checking for WCAG 2.2 compliance and documenting problems found**

The [Daily Accessibility Review workflow](../workflows/accessibility-review.md?plain=1) scans your repository, analyzes accessibility against WCAG 2.2 guidelines, and creates issues documenting any accessibility problems found.

## Installation

```bash
# Install the 'gh aw' extension
gh extension install github/gh-aw

# Add the workflow to your repository
gh aw add-wizard githubnext/agentics/accessibility-review
```

This walks you through adding the workflow to your repository.

## How It Works

```mermaid
graph LR
A[Scan Repository] --> B[Analyze Accessibility]
B --> C[Check WCAG 2.2]
C --> D{Issues Found?}
D -->|Yes| E[Create Issue Report]
D -->|No| F[Report: All Accessible]
```

## Usage

### Configuration

This workflow requires no configuration and works out of the box.

After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.

### Commands

You can start a run of this workflow immediately by running:

```bash
gh aw run accessibility-review
```
50 changes: 50 additions & 0 deletions docs/adhoc-qa.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# 🔍 Daily Ad hoc QA

> For an overview of all available workflows, see the [main README](../README.md).

**Perform ad hoc quality assurance by following README instructions, tutorials, and walkthroughs**

The [Daily Ad hoc QA workflow](../workflows/adhoc-qa.md?plain=1) reads your documentation, follows instructions, tests build and run processes, and creates issues for problems found.

## Installation

```bash
# Install the 'gh aw' extension
gh extension install github/gh-aw

# Add the workflow to your repository
gh aw add-wizard githubnext/agentics/adhoc-qa
```

This walks you through adding the workflow to your repository.

## How It Works

```mermaid
graph LR
A[Read README/Tutorials] --> B[Follow Instructions]
B --> C[Test Build/Run]
C --> D{Issues Found?}
D -->|Yes| E[Create QA Issue]
D -->|No| F[Report: QA Passed]
```

For scheduled runs, the workflow is skipped if there are already 8 or more open PRs with its title prefix, to avoid overwhelming maintainers.

## Usage

This workflow requires no configuration and works out of the box. You can customize QA tasks, testing scenarios, reporting format, and frequency.

After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.

### Commands

You can start a run of this workflow immediately by running:

```bash
gh aw run qa
```

### Triggering CI on Pull Requests

To automatically trigger CI checks on PRs created by this workflow, configure an additional repository secret `GH_AW_CI_TRIGGER_TOKEN`. See the [triggering CI documentation](https://github.github.com/gh-aw/reference/triggering-ci/) for setup instructions.
4 changes: 3 additions & 1 deletion docs/ci-coach.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

**Automated CI/CD optimization expert that analyzes your GitHub Actions workflows and proposes efficiency improvements**

The [CI Coach workflow](../workflows/ci-coach.md?plain=1) is your personal CI/CD optimization consultant. It runs daily to analyze workflows, collect performance metrics, identify optimization opportunities, and propose concrete improvements through pull requests.
The [CI Coach workflow](../workflows/ci-coach.md?plain=1) is your personal CI/CD optimization consultant. It runs regularly (daily by default) to analyze workflows, collect performance metrics, identify optimization opportunities, and propose concrete improvements through pull requests.

## Installation

Expand Down Expand Up @@ -39,6 +39,8 @@ The workflow analyzes job parallelization, caching strategy, test distribution,
- ❌ Never breaks test integrity
- ❌ Never sacrifices correctness for speed

For scheduled runs, the workflow is skipped if there are already 8 or more open PRs with its title prefix, to avoid overwhelming maintainers.

## Examples

From Peli's Agent Factory:
Expand Down
2 changes: 1 addition & 1 deletion docs/code-simplifier.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

**Automatically analyze recently modified code and create pull requests with simplifications that improve clarity and maintainability**

The [Code Simplifier workflow](../workflows/code-simplifier.md?plain=1) runs daily to review code modified in the last 24 hours and apply targeted improvements that enhance clarity, reduce complexity, and follow project conventions—all while preserving functionality.
The [Code Simplifier workflow](../workflows/code-simplifier.md?plain=1) runs regularly (daily by default) to review code modified in the last 24 hours and apply targeted improvements that enhance clarity, reduce complexity, and follow project conventions—all while preserving functionality.

## Installation

Expand Down
48 changes: 2 additions & 46 deletions docs/daily-accessibility-review.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,2 @@
# 🔍 Daily Accessibility Review

> For an overview of all available workflows, see the [main README](../README.md).

**Perform accessibility reviews checking for WCAG 2.2 compliance and documenting problems found**

The [Daily Accessibility Review workflow](../workflows/daily-accessibility-review.md?plain=1) scans your repository, analyzes accessibility against WCAG 2.2 guidelines, and creates issues documenting any accessibility problems found.

## Installation

```bash
# Install the 'gh aw' extension
gh extension install github/gh-aw

# Add the workflow to your repository
gh aw add-wizard githubnext/agentics/daily-accessibility-review
```

This walks you through adding the workflow to your repository.

## How It Works

```mermaid
graph LR
A[Scan Repository] --> B[Analyze Accessibility]
B --> C[Check WCAG 2.2]
C --> D{Issues Found?}
D -->|Yes| E[Create Issue Report]
D -->|No| F[Report: All Accessible]
```

## Usage

### Configuration

This workflow requires no configuration and works out of the box.

After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.

### Commands

You can start a run of this workflow immediately by running:

```bash
gh aw run daily-accessibility-review
```
---
This workflow has been renamed. See [accessibility-review](accessibility-review.md).
55 changes: 2 additions & 53 deletions docs/daily-doc-updater.md
Original file line number Diff line number Diff line change
@@ -1,53 +1,2 @@
# 📖 Daily Documentation Updater

> For an overview of all available workflows, see the [main README](../README.md).

**Automatically review and update documentation based on recent code changes and merged pull requests**

The [Daily Documentation Updater workflow](../workflows/daily-doc-updater.md?plain=1) scans changes from the last 24 hours, identifies documentation gaps, and creates pull requests with updates to reflect new features, modifications, or deprecations.

## Installation

```bash
# Install the 'gh aw' extension
gh extension install github/gh-aw

# Add the workflow to your repository
gh aw add-wizard githubnext/agentics/daily-doc-updater
```

This walks you through adding the workflow to your repository.

## How It Works

```mermaid
graph LR
A[Scan Recent PRs] --> B[Find Code Changes]
B --> C[Identify Doc Gaps]
C --> D{Updates Needed?}
D -->|Yes| E[Update Documentation]
E --> F[Create PR]
D -->|No| G[Report: Docs Current]
```

The workflow follows your repository's existing documentation structure and style.

## Usage

### Configuration

This workflow requires no configuration and works out of the box. You can customize the time range, change types to document, and PR settings.

After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.

### Commands

You can start a run of this workflow immediately by running:

```bash
gh aw run daily-doc-updater
```

### Triggering CI on Pull Requests

To automatically trigger CI checks on PRs created by this workflow, configure an additional repository secret `GH_AW_CI_TRIGGER_TOKEN`. See the [triggering CI documentation](https://github.github.com/gh-aw/reference/triggering-ci/) for setup instructions.
---
This workflow has been renamed. See [doc-updater](doc-updater.md).
Loading
Loading