https://github.com/jacobpevans/ai-workflows
Reusable AI agent workflows that run 24/7 — issue triage, code cleanup, multi-repo orchestration. Import-ready for GitHub Copilot Agentic Workflows.
https://github.com/jacobpevans/ai-workflows
agentic-workflows ai-agents ai-automation automation code-quality devops github-actions github-copilot issue-management workflow-automation
Last synced: about 1 month ago
JSON representation
Reusable AI agent workflows that run 24/7 — issue triage, code cleanup, multi-repo orchestration. Import-ready for GitHub Copilot Agentic Workflows.
- Host: GitHub
- URL: https://github.com/jacobpevans/ai-workflows
- Owner: JacobPEvans
- License: mit
- Created: 2026-02-15T05:38:33.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-15T20:23:49.000Z (4 months ago)
- Last Synced: 2026-02-16T02:14:11.658Z (4 months ago)
- Topics: agentic-workflows, ai-agents, ai-automation, automation, code-quality, devops, github-actions, github-copilot, issue-management, workflow-automation
- Size: 51.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# ai-workflows
Reusable AI agent workflows for GitHub Actions. Consumer repos call these with thin ~10-20 line callers.
[](LICENSE)
[](https://github.com/JacobPEvans/ai-workflows/stargazers)
---
## What's Inside
| Workflow | Trigger | Schedule | What It Does |
|----------|---------|----------|--------------|
| `best-practices.yml` | `workflow_call` | Wed 3am UTC | Weekly audit creating actionable best-practices recommendations |
| `ci-fix.yml` | `workflow_run` | On CI failure | Analyzes failed CI logs and pushes fixes (max 2 attempts per PR) |
| `claude-review.yml` | `pull_request` | On PR open/sync | Reviews PRs for quality, security, and best practices |
| `code-simplifier.yml` | `workflow_call` | Daily 4am UTC | DRY enforcement, dead code removal, creates draft PRs |
| `final-pr-review.yml` | `pull_request_review` | On PR review | Final review gate before merge |
| `issue-hygiene.yml` | `workflow_call` | Mon 7am UTC | Detects duplicates, links merged PRs, flags stale issues |
| `issue-resolver.yml` | `issues: [opened]` | On issue open | Creates draft PRs for simple, well-scoped issues |
| `issue-sweeper.yml` | `workflow_call` | Mon 6am UTC | Scans open issues, comments on progress, closes resolved |
| `issue-triage.yml` | `issues: [opened]` | On issue open | Categorizes, deduplicates, and labels new issues |
| `label-sync.yml` | `workflow_call` | On-demand | Syncs canonical labels from `.github` repo to all targets |
| `next-steps.yml` | `workflow_call` | Daily 5am UTC | Analyzes merge momentum, suggests next logical action |
| `notify-ai-pr.yml` | `pull_request` | On bot PR open | Posts Slack notification to a configured channel when an AI agent opens a PR |
| `post-merge-docs-review.yml` | `workflow_call` (dispatch pattern) | On merge | Reviews documentation after merges, creates fix PRs |
| `post-merge-tests.yml` | `workflow_call` (dispatch pattern) | On merge | Analyzes merged code, creates draft PRs with targeted tests |
| `pr-issue-linker.yml` | `pull_request` | On PR open/close | Auto-links PRs to referenced issues via Development sidebar |
| `project-router.yml` | `workflow_call` | On issue/PR events | Routes items to GitHub Projects with smart field assignment |
| `repo-orchestrator.yml` | `workflow_call` | On-demand | Hub-and-spoke multi-repo workflow dispatcher |
---
## Quick Start
### Prerequisites
1. [GitHub CLI](https://cli.github.com/) installed and authenticated
2. One secret configured in each consumer repo:
- `OPENROUTER_API_KEY` — [OpenRouter](https://openrouter.ai) API key (required by all workflows)
### Add a Workflow to Your Repo
Create a thin caller file in your repo. Example for issue triage:
```yaml
# .github/workflows/issue-triage.yml
name: Issue Triage
on:
issues:
types: [opened]
permissions:
contents: read
id-token: write
issues: write
jobs:
triage:
uses: JacobPEvans/ai-workflows/.github/workflows/issue-triage.yml@v0.3.0
secrets: inherit
```
For scheduled workflows:
```yaml
# .github/workflows/issue-sweeper.yml
name: Issue Sweeper
on:
schedule:
- cron: "0 6 * * 1"
workflow_dispatch:
permissions:
contents: read
id-token: write
issues: write
pull-requests: read
jobs:
sweep:
uses: JacobPEvans/ai-workflows/.github/workflows/issue-sweeper.yml@v0.3.0
secrets: inherit
```
See [docs/GETTING_STARTED.md](docs/GETTING_STARTED.md) for the full list of workflows with required permissions.
---
## Authentication
All workflows route through [OpenRouter](https://openrouter.ai) by default. Add two things to each consumer repo:
1. **Secret**: `OPENROUTER_API_KEY` — your OpenRouter API key (set a $/day spend limit)
2. **Secret**: `OPENROUTER_BASE_URL` — set to `https://openrouter.ai/api/v1`
Most workflows fall back to `openrouter/free` when no model variables are configured. Exceptions: `post-merge-docs-review` and `post-merge-tests` require `AI_MODEL_DOCS`/`AI_MODEL_CODE` or `AI_MODEL` to be set — they fail with a clear error when unconfigured. See [docs/AUTHENTICATION.md](docs/AUTHENTICATION.md) for model configuration and alternative providers.
---
## Architecture
```
.github/
prompts/ # Prompt files (one per workflow)
scripts/
render-prompt.sh # Shared: envsubst + GITHUB_OUTPUT
best-practices/ # Extracted JS scripts per workflow
ci-fail-issue/
ci-fix/
claude-review/
final-pr-review/
issue-linker/
issue-resolver/
notification/
post-merge-docs-review/
post-merge-tests/
shared/ # Shared scripts (check-daily-limit.js, constants.js)
verification/ # E2E test script
workflows/ # Reusable workflow YAML definitions
docs/ # Documentation and verification runbook
```
All workflows use `claude-code-action@v1` with OIDC auth (`id-token: write`). Prompts are rendered at runtime via `render-prompt.sh` and the cross-repo checkout pattern:
```yaml
- uses: actions/checkout@v6
with:
repository: JacobPEvans/ai-workflows
sparse-checkout: |
.github/prompts
.github/scripts
path: .ai-workflows
```
---
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on adding new workflows.
## Security
See [SECURITY.md](SECURITY.md) for vulnerability reporting.
## License
[MIT](LICENSE)