Skip to content

Commit 1a12f32

Browse files
dsymedsyme
committed
update agentics
1 parent e283e76 commit 1a12f32

28 files changed

Lines changed: 300 additions & 294 deletions

‎.github/agents/agentic-workflows.agent.md‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ Workflows may optionally include:
2727
- Workflow files: `.github/workflows/*.md` and `.github/workflows/**/*.md`
2828
- Workflow lock files: `.github/workflows/*.lock.yml`
2929
- Shared components: `.github/workflows/shared/*.md`
30-
- Configuration: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/github-agentic-workflows.md
30+
- Configuration: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/github-agentic-workflows.md
3131

3232
## Problems This Solves
3333

@@ -49,7 +49,7 @@ When you interact with this agent, it will:
4949
### Create New Workflow
5050
**Load when**: User wants to create a new workflow from scratch, add automation, or design a workflow that doesn't exist yet
5151

52-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/create-agentic-workflow.md
52+
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/create-agentic-workflow.md
5353

5454
**Use cases**:
5555
- "Create a workflow that triages issues"
@@ -59,7 +59,7 @@ When you interact with this agent, it will:
5959
### Update Existing Workflow
6060
**Load when**: User wants to modify, improve, or refactor an existing workflow
6161

62-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/update-agentic-workflow.md
62+
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/update-agentic-workflow.md
6363

6464
**Use cases**:
6565
- "Add web-fetch tool to the issue-classifier workflow"
@@ -69,7 +69,7 @@ When you interact with this agent, it will:
6969
### Debug Workflow
7070
**Load when**: User needs to investigate, audit, debug, or understand a workflow, troubleshoot issues, analyze logs, or fix errors
7171

72-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/debug-agentic-workflow.md
72+
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/debug-agentic-workflow.md
7373

7474
**Use cases**:
7575
- "Why is this workflow failing?"
@@ -79,7 +79,7 @@ When you interact with this agent, it will:
7979
### Upgrade Agentic Workflows
8080
**Load when**: User wants to upgrade workflows to a new gh-aw version or fix deprecations
8181

82-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/upgrade-agentic-workflows.md
82+
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/upgrade-agentic-workflows.md
8383

8484
**Use cases**:
8585
- "Upgrade all workflows to the latest version"
@@ -89,7 +89,7 @@ When you interact with this agent, it will:
8989
### Create Shared Agentic Workflow
9090
**Load when**: User wants to create a reusable workflow component or wrap an MCP server
9191

92-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/create-shared-agentic-workflow.md
92+
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/create-shared-agentic-workflow.md
9393

9494
**Use cases**:
9595
- "Create a shared component for Notion integration"
@@ -100,7 +100,7 @@ When you interact with this agent, it will:
100100

101101
**Load when**: Creating or updating workflows that coordinate multiple agents or dispatch work to other workflows
102102

103-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/orchestration.md
103+
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/orchestration.md
104104

105105
**Use cases**:
106106
- Assigning work to AI coding agents
@@ -112,7 +112,7 @@ When you interact with this agent, it will:
112112

113113
**Load when**: Creating or updating workflows that manage GitHub Projects v2
114114

115-
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/projects.md
115+
**Prompt file**: https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/projects.md
116116

117117
**Use cases**:
118118
- Tracking items and fields with update-project
@@ -160,7 +160,7 @@ gh aw compile --validate
160160

161161
## Important Notes
162162

163-
- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.43.2/.github/aw/github-agentic-workflows.md for complete documentation
163+
- Always reference the instructions file at https://github.com/github/gh-aw/blob/v0.43.7/.github/aw/github-agentic-workflows.md for complete documentation
164164
- Use the MCP tool `agentic-workflows` when running in GitHub Copilot Cloud
165165
- Workflows must be compiled to `.lock.yml` files before running in GitHub Actions
166166
- **Bash tools are enabled by default** - Don't restrict bash commands unnecessarily since workflows are sandboxed by the AWF

‎.github/workflows/migrate-workflow.md‎

Lines changed: 0 additions & 93 deletions
This file was deleted.

‎.vscode/extensions.json‎

Lines changed: 0 additions & 6 deletions
This file was deleted.

‎README.md‎

Lines changed: 37 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -4,38 +4,62 @@ A sample family of reusable [GitHub Agentic Workflows](https://github.github.com
44

55
## 📂 Available Workflows
66

7-
### Depth Triage & Analysis Workflows
7+
### Triage Workflows
88

99
- [🏷️ Issue Triage](docs/issue-triage.md) - Triage issues and pull requests
10+
11+
## Fault Analysis Workflows
12+
1013
- [🏥 CI Doctor](docs/ci-doctor.md) - Monitor CI workflows and investigate failures automatically
11-
- [🔍 Repo Ask](docs/repo-ask.md) - Intelligent research assistant for repository questions and analysis
12-
- [🔍 Daily Accessibility Review](docs/daily-accessibility-review.md) - Review application accessibility by automatically running and using the application
13-
- [🔧 Q - Workflow Optimizer](docs/q.md) - Expert system that analyzes and optimizes agentic workflows
14+
15+
## Code Review Workflows
16+
17+
- [✅ Contribution Guidelines Checker](docs/contribution-guidelines-checker.md) - Review pull requests for compliance with contribution guidelines
1418

1519
### Research, Status & Planning Workflows
1620

1721
- [📚 Weekly Research](docs/weekly-research.md) - Collect research updates and industry trends
1822
- [👥 Daily Repo Status](docs/daily-repo-status.md) - Assess repository activity and create status reports
23+
- [� Daily Team Status](docs/daily-team-status.md) - Create upbeat daily team activity summaries with productivity insights
1924
- [📋 Daily Plan](docs/daily-plan.md) - Update planning issues for team coordination
20-
- [📋 Plan Command](docs/plan.md) - Break down issues into actionable sub-tasks with /plan command
2125

22-
### Coding & Development Workflows
26+
### Dependency Management Workflows
2327

24-
- [⚡ Daily Progress](docs/daily-progress.md) - Automated daily feature development following a structured roadmap
25-
- [📦 Daily Dependency Updater](docs/daily-dependency-updates.md) - Update dependencies and create pull requests
26-
- [📖 Regular Documentation Update](docs/update-docs.md) - Update documentation automatically
28+
- [📦 Dependabot PR Bundler](docs/dependabot-pr-bundler.md) - Create pull requests to bundle together as many dependabot updates as possible
29+
- [📦 Dependabot Issue Bundler](docs/dependabot-issue-bundler.md) - Create issues that group together dependabot updates related to the same ecosystem
30+
31+
### Command-Triggered Agentic Workflows
32+
33+
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.
34+
35+
- [📋 Plan Command](docs/plan.md) - Break down issues into actionable sub-tasks with /plan command
2736
- [🏥 PR Fix](docs/pr-fix.md) - Analyze failing CI checks and implement fixes for pull requests
37+
- [🔍 Repo Ask](docs/repo-ask.md) - Intelligent research assistant for repository questions and analysis
38+
39+
### Code Improvement Workflows (by analysis, producing report)
40+
41+
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.
42+
43+
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.
44+
45+
- [🔍 Daily Accessibility Review](docs/daily-accessibility-review.md) - Review application accessibility by automatically running and using the application
2846
- [🔎 Daily Adhoc QA](docs/daily-qa.md) - Perform adhoc explorative quality assurance tasks
47+
48+
### Code Improvement Workflows (by making changes, producing pull requests)
49+
50+
- [📖 Regular Documentation Update](docs/update-docs.md) - Update documentation automatically
51+
- [⚡ Daily Progress](docs/daily-progress.md) - Automated daily feature development following a structured roadmap
2952
- [🧪 Daily Test Coverage Improver](docs/daily-test-improver.md) - Improve test coverage by adding meaningful tests to under-tested areas
3053
- [⚡ Daily Performance Improver](docs/daily-perf-improver.md) - Analyze and improve code performance through benchmarking and optimization
54+
- [🔥 Daily Backlog Burner](docs/daily-backlog-burner.md) - Systematically manage and reduce backlog through strategic cleanup
3155

32-
## 🔄 Updating Workflows
56+
## Meta-Workflows
3357

34-
Keep your agentic workflows up to date with the latest features and improvements:
58+
- [🔧 Q - Workflow Optimizer](docs/q.md) - Expert system that analyzes and optimizes agentic workflows
3559

36-
### Using the CLI
60+
## 🔄 Updating Workflows
3761

38-
Upgrade the AW engine version and update your workflows:
62+
Keep your agentic workflows up to date with the latest features and improvements:
3963

4064
```bash
4165
gh extensions upgrade github/gh-aw # Update cli extension
@@ -45,20 +69,6 @@ gh aw update # Update added workflows
4569

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

48-
### Using the Agentic Workflows Agent
49-
50-
Alternatively, you can prompt the agentic-workflows agent to update your workflows:
51-
52-
```
53-
/agent agentic-workflows upgrade all workflows to the latest version
54-
```
55-
56-
Or update individual workflows:
57-
58-
```
59-
/agent agentic-workflows update the issue-triage workflow
60-
```
61-
6272
📖 [Learn more about GitHub Agentic Workflows](https://github.github.io/gh-aw/)
6373

6474
## 💬 Share Feedback

‎TODO.md‎

Lines changed: 0 additions & 50 deletions
This file was deleted.

‎docs/ci-doctor.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The [CI Doctor workflow](../workflows/ci-doctor.md?plain=1) monitors your GitHub
1010
# Install the 'gh aw' extension
1111
gh extension install github/gh-aw
1212

13-
# Add the CI Doctor workflow to your repository
13+
# Add the workflow to your repository
1414
gh aw add-wizard githubnext/agentics/ci-doctor
1515
```
1616

‎docs/contribution-guidelines-checker.md‎

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# ✅ Contribution Guidelines Checker
2+
3+
> For an overview of all available workflows, see the [main README](../README.md).
4+
5+
The [contribution guidelines checker workflow](../workflows/contribution-guidelines-checker.md?plain=1) reviews incoming pull requests to verify they comply with the repository's contribution guidelines. It checks CONTRIBUTING.md and similar documentation, then either labels the PR as ready or provides constructive feedback on what needs to be improved to meet the guidelines.
6+
7+
## Installation
8+
9+
```bash
10+
# Install the 'gh aw' extension
11+
gh extension install github/gh-aw
12+
13+
# Add the workflow to your repository
14+
gh aw add-wizard githubnext/agentics/contribution-guidelines-checker
15+
```
16+
17+
This walks you through adding the workflow to your repository.
18+
19+
The workflow automatically runs on pull requests. You can also trigger it with a 👀 (eyes) reaction on any pull request.
20+
21+
## Configuration
22+
23+
This workflow requires no configuration and works out of the box. It will automatically review contribution guidelines documents in your repository and check PRs against them.
24+
25+
After editing run `gh aw compile` to update the workflow and commit all changes to the default branch.
26+
27+
## What it reads from GitHub
28+
29+
- Pull request content and metadata
30+
- CONTRIBUTING.md and contribution guidelines documents
31+
- Repository policies and documentation
32+
- Previous PR comments and feedback
33+
34+
## What it creates
35+
36+
- Adds the `contribution-ready` label to compliant PRs
37+
- Adds comments with constructive feedback on what needs improvement
38+
- Requires `pull-requests: write` permission
39+
40+
## Human in the loop
41+
42+
- Review feedback provided by the workflow to validate accuracy
43+
- Follow up on PRs that need improvements with additional guidance
44+
- Update contribution guidelines based on common patterns
45+
- Manually apply the label if the workflow's assessment needs adjustment
46+
- Disable or uninstall the workflow if automated checks are not helpful

‎docs/daily-accessibility-review.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The [daily accessibility review workflow](../workflows/daily-accessibility-revie
1010
# Install the 'gh aw' extension
1111
gh extension install github/gh-aw
1212

13-
# Add the Daily Accessibility Review workflow to your repository
13+
# Add the Review workflow to your repository
1414
gh aw add-wizard githubnext/agentics/daily-accessibility-review
1515
```
1616

0 commit comments

Comments
 (0)