Skip to content

Commit 497230d

Browse files
authored
Revamp and rename some of the agentics (#329)
* rename to rmove daily- prefixes and add cutoffs * rename to rmove daily- prefixes and add cutoffs * update workflows
1 parent 14a596a commit 497230d

88 files changed

Lines changed: 3487 additions & 3727 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/aw/actions-lock.json

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,11 @@
2525
"version": "v9",
2626
"sha": "373c709c69115d41ff229c7e5df9f8788daa9553"
2727
},
28+
"actions/github-script@v9.0.0": {
29+
"repo": "actions/github-script",
30+
"version": "v9.0.0",
31+
"sha": "3a2844b7e9c422d3c10d287c895573f7108da1b3"
32+
},
2833
"actions/upload-artifact@v7": {
2934
"repo": "actions/upload-artifact",
3035
"version": "v7",
@@ -35,10 +40,10 @@
3540
"version": "v7.0.0",
3641
"sha": "bbbca2ddaa5d8feaa63e36b76fdaad77386f024f"
3742
},
38-
"github/gh-aw-actions/setup@v0.71.3": {
43+
"github/gh-aw-actions/setup@v0.71.5": {
3944
"repo": "github/gh-aw-actions/setup",
40-
"version": "v0.71.3",
41-
"sha": "07c7335cd76c4d4d9f00dd7874f85ff55ed71f24"
45+
"version": "v0.71.5",
46+
"sha": "b8068426813005612b960b5ab0b8bd2c27142323"
4247
},
4348
"github/gh-aw/actions/setup@v0.66.1": {
4449
"repo": "github/gh-aw/actions/setup",

.github/workflows/daily-repo-goals.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,6 @@ The workflows in the blog series are:
102102
* "copilot-session-insights.md",
103103
* "daily-compiler-quality.md",
104104
* "daily-doc-updater.md",
105-
* "daily-file-diet.md",
106105
* "daily-malicious-code-scan.md",
107106
* "daily-multi-device-docs-tester.md",
108107
* "daily-news.md",

README.md

Lines changed: 35 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -31,11 +31,11 @@ Investigate faults proactively and improve CI.
3131

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

48-
### Command-Triggered Agentic Workflows
49-
50-
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.
51-
52-
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.
48+
### Documentation Workflows
5349

54-
- [📊 Archie](docs/archie.md) - Generate Mermaid diagrams to visualize issue and pull request relationships with /archie command
55-
- [📋 Plan Command](docs/plan.md) - Break down issues into actionable sub-tasks with /plan command
56-
- [🏥 PR Fix](docs/pr-fix.md) - Analyze failing CI checks and implement fixes for pull requests
57-
- [🔍 Repo Ask](docs/repo-ask.md) - Intelligent research assistant for repository questions and analysis
50+
- [📖 Documentation Update on Push to Main](docs/update-docs.md) - Update documentation automatically on every push to main
51+
- [📖 Daily Documentation Updater](docs/doc-updater.md) - Automatically update documentation based on recent code changes and merged PRs
52+
- [📝 Agentic Wiki Writer](docs/agentic-wiki-writer.md) - Automatically generate and maintain GitHub wiki pages from source code
53+
- [🔧 Agentic Wiki Coder](docs/agentic-wiki-coder.md) - Implement code changes described in GitHub wiki edits
54+
- [📖 Glossary Maintainer](docs/glossary-maintainer.md) - Automatically maintain project glossary based on codebase changes
55+
- [🎙️ 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
56+
- [🔗 Link Checker](docs/link-checker.md) - Daily automated link checker that finds and fixes broken links in documentation
57+
- [🗜️ Documentation Unbloat](docs/unbloat-docs.md) - Automatically simplify documentation by reducing verbosity while maintaining clarity
58+
- [📝 Markdown Linter](docs/markdown-linter.md) - Run Markdown quality checks on all documentation files and get a prioritized issue report of violations
59+
- [📱 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
5860

5961
### Code Improvement Workflows (by analysis, producing report)
6062

6163
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.
6264

63-
- [🔍 Daily Accessibility Review](docs/daily-accessibility-review.md) - Review application accessibility by automatically running and using the application
64-
- [📱 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
65-
- [🔎 Daily Adhoc QA](docs/daily-qa.md) - Perform adhoc explorative quality assurance tasks
65+
- [🔍 Daily Accessibility Review](docs/accessibility-review.md) - Review application accessibility by automatically running and using the application
66+
- [🔎 Daily Adhoc QA](docs/adhoc-qa.md) - Perform adhoc explorative quality assurance tasks
6667
- [🗂️ Large File Simplifier](docs/large-file-simplifier.md) - Identify the largest source file and create a detailed refactoring plan as an issue
6768

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

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

87-
## Formal Verification Workflows
78+
### Command-Triggered Agentic Workflows
8879

89-
- [🔬 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
80+
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.
81+
82+
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.
83+
84+
- [📊 Archie](docs/archie.md) - Generate Mermaid diagrams to visualize issue and pull request relationships with /archie command
85+
- [📋 Plan Command](docs/plan.md) - Break down issues into actionable sub-tasks with /plan command
86+
- [🏥 PR Fix](docs/pr-fix.md) - Analyze failing CI checks and implement fixes for pull requests
87+
- [🔍 Repo Ask](docs/repo-ask.md) - Intelligent research assistant for repository questions and analysis
9088

9189
## Security Workflows
9290

93-
- [🔍 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
91+
- [🔍 Daily Malicious Code Scan](docs/malicious-code-scan.md) - Scan recent code changes for suspicious patterns indicating malicious activity or supply chain attacks
9492
- [🔒 VEX Generator](docs/vex-generator.md) - Auto-generate OpenVEX statements for dismissed Dependabot alerts, capturing security assessments in a machine-readable format
9593

94+
## Formal Verification Workflows
95+
96+
- [🔬 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
97+
9698
## Meta-Workflows
9799

98100
- [🔧 Q - Workflow Optimizer](docs/q.md) - Expert system that analyzes and optimizes agentic workflows

docs/accessibility-review.md

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# 🔍 Daily Accessibility Review
2+
3+
> For an overview of all available workflows, see the [main README](../README.md).
4+
5+
**Perform accessibility reviews checking for WCAG 2.2 compliance and documenting problems found**
6+
7+
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.
8+
9+
## Installation
10+
11+
```bash
12+
# Install the 'gh aw' extension
13+
gh extension install github/gh-aw
14+
15+
# Add the workflow to your repository
16+
gh aw add-wizard githubnext/agentics/accessibility-review
17+
```
18+
19+
This walks you through adding the workflow to your repository.
20+
21+
## How It Works
22+
23+
```mermaid
24+
graph LR
25+
A[Scan Repository] --> B[Analyze Accessibility]
26+
B --> C[Check WCAG 2.2]
27+
C --> D{Issues Found?}
28+
D -->|Yes| E[Create Issue Report]
29+
D -->|No| F[Report: All Accessible]
30+
```
31+
32+
## Usage
33+
34+
### Configuration
35+
36+
This workflow requires no configuration and works out of the box.
37+
38+
After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
39+
40+
### Commands
41+
42+
You can start a run of this workflow immediately by running:
43+
44+
```bash
45+
gh aw run accessibility-review
46+
```

docs/adhoc-qa.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
# 🔍 Daily Ad hoc QA
2+
3+
> For an overview of all available workflows, see the [main README](../README.md).
4+
5+
**Perform ad hoc quality assurance by following README instructions, tutorials, and walkthroughs**
6+
7+
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.
8+
9+
## Installation
10+
11+
```bash
12+
# Install the 'gh aw' extension
13+
gh extension install github/gh-aw
14+
15+
# Add the workflow to your repository
16+
gh aw add-wizard githubnext/agentics/adhoc-qa
17+
```
18+
19+
This walks you through adding the workflow to your repository.
20+
21+
## How It Works
22+
23+
```mermaid
24+
graph LR
25+
A[Read README/Tutorials] --> B[Follow Instructions]
26+
B --> C[Test Build/Run]
27+
C --> D{Issues Found?}
28+
D -->|Yes| E[Create QA Issue]
29+
D -->|No| F[Report: QA Passed]
30+
```
31+
32+
For scheduled runs, the workflow is skipped if there are already 8 or more open PRs with its title prefix, to avoid overwhelming maintainers.
33+
34+
## Usage
35+
36+
This workflow requires no configuration and works out of the box. You can customize QA tasks, testing scenarios, reporting format, and frequency.
37+
38+
After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
39+
40+
### Commands
41+
42+
You can start a run of this workflow immediately by running:
43+
44+
```bash
45+
gh aw run qa
46+
```
47+
48+
### Triggering CI on Pull Requests
49+
50+
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.

docs/ci-coach.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
55
**Automated CI/CD optimization expert that analyzes your GitHub Actions workflows and proposes efficiency improvements**
66

7-
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.
7+
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.
88

99
## Installation
1010

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

42+
For scheduled runs, the workflow is skipped if there are already 8 or more open PRs with its title prefix, to avoid overwhelming maintainers.
43+
4244
## Examples
4345

4446
From Peli's Agent Factory:

docs/code-simplifier.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44
55
**Automatically analyze recently modified code and create pull requests with simplifications that improve clarity and maintainability**
66

7-
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.
7+
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.
88

99
## Installation
1010

docs/daily-accessibility-review.md

Lines changed: 2 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,46 +1,2 @@
1-
# 🔍 Daily Accessibility Review
2-
3-
> For an overview of all available workflows, see the [main README](../README.md).
4-
5-
**Perform accessibility reviews checking for WCAG 2.2 compliance and documenting problems found**
6-
7-
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.
8-
9-
## Installation
10-
11-
```bash
12-
# Install the 'gh aw' extension
13-
gh extension install github/gh-aw
14-
15-
# Add the workflow to your repository
16-
gh aw add-wizard githubnext/agentics/daily-accessibility-review
17-
```
18-
19-
This walks you through adding the workflow to your repository.
20-
21-
## How It Works
22-
23-
```mermaid
24-
graph LR
25-
A[Scan Repository] --> B[Analyze Accessibility]
26-
B --> C[Check WCAG 2.2]
27-
C --> D{Issues Found?}
28-
D -->|Yes| E[Create Issue Report]
29-
D -->|No| F[Report: All Accessible]
30-
```
31-
32-
## Usage
33-
34-
### Configuration
35-
36-
This workflow requires no configuration and works out of the box.
37-
38-
After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
39-
40-
### Commands
41-
42-
You can start a run of this workflow immediately by running:
43-
44-
```bash
45-
gh aw run daily-accessibility-review
46-
```
1+
---
2+
This workflow has been renamed. See [accessibility-review](accessibility-review.md).

docs/daily-doc-updater.md

Lines changed: 2 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,2 @@
1-
# 📖 Daily Documentation Updater
2-
3-
> For an overview of all available workflows, see the [main README](../README.md).
4-
5-
**Automatically review and update documentation based on recent code changes and merged pull requests**
6-
7-
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.
8-
9-
## Installation
10-
11-
```bash
12-
# Install the 'gh aw' extension
13-
gh extension install github/gh-aw
14-
15-
# Add the workflow to your repository
16-
gh aw add-wizard githubnext/agentics/daily-doc-updater
17-
```
18-
19-
This walks you through adding the workflow to your repository.
20-
21-
## How It Works
22-
23-
```mermaid
24-
graph LR
25-
A[Scan Recent PRs] --> B[Find Code Changes]
26-
B --> C[Identify Doc Gaps]
27-
C --> D{Updates Needed?}
28-
D -->|Yes| E[Update Documentation]
29-
E --> F[Create PR]
30-
D -->|No| G[Report: Docs Current]
31-
```
32-
33-
The workflow follows your repository's existing documentation structure and style.
34-
35-
## Usage
36-
37-
### Configuration
38-
39-
This workflow requires no configuration and works out of the box. You can customize the time range, change types to document, and PR settings.
40-
41-
After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
42-
43-
### Commands
44-
45-
You can start a run of this workflow immediately by running:
46-
47-
```bash
48-
gh aw run daily-doc-updater
49-
```
50-
51-
### Triggering CI on Pull Requests
52-
53-
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.
1+
---
2+
This workflow has been renamed. See [doc-updater](doc-updater.md).

0 commit comments

Comments
 (0)