All use cases
๐Ÿ™Engineering

GitHub Maintainer Team: 4-Agent Issue Triage, PR Review, Changelog, Docs

A 4-agent crew for solo OSS maintainers โ€” triages issues, reviews PRs, writes changelogs, keeps docs current. Built for the solo-maintainer-burnout problem.

Solo OSS maintainers burn out on triage, not code. A repo with 200 stars and one maintainer accumulates issues faster than the maintainer can read them, and PRs sit unreviewed for weeks because the cognitive load of "is this PR safe?" is worse than writing the code yourself. Most popular OSS projects either grow a maintainer team or quietly stagnate.

This 4-agent GitHub maintainer team is built for the solo-maintainer-burnout problem. Triager labels and dedupes incoming issues. Critic does first-pass PR review and leaves comments before you look, so when you do review you start from "is Critic right?" instead of "what does this PR do?". Logger writes changelogs and proposes semver bumps. Docs keeps the README in sync with what the code actually does. The crew won't replace your judgment on hard architectural calls, but it will absorb the 80% of repo work that's pattern-matching.

4
AI Agents
10 min
Setup Time
Medium
Difficulty

Best For

Solo OSS maintainersLibrary authorsSide-project repos with traction

How It Works

1

Triager watches the issues feed: labels new issues by type/priority, asks for repro steps if missing, closes obvious dupes.

2

Critic watches PRs: runs tests, comments on style and scope, flags breaking changes, requests changes before you look.

3

When a PR merges, Logger drafts a changelog entry and proposes a version bump (patch/minor/major).

4

If the PR changed public API, Docs updates the README + relevant /docs page in the same commit.

5

Weekly: Triager posts an issue digest โ€” open count by label, oldest unresolved, top requests.

6

You approve doc changes and version bumps in Telegram; everything else flows automatically.

7

Quarterly: a maintainer health check โ€” what's piling up, what could be deprecated, who's contributing.

Sample Output

Weekly maintainer digest (myrepo, 2026-04-29):
- Triager: 14 new issues. 6 labeled 'bug', 4 'feature-request', 3 'docs', 1 spam closed. Oldest unresolved: #287 (32 days). Top request: TypeScript types (5 separate issues).
- Critic: 8 PRs reviewed. 3 approved with comments, 4 changes-requested, 1 closed (out of scope). Avg review time: 12 minutes.
- Logger: 5 changelog entries drafted. Proposed v2.4.0 (one minor breaking change in #312).
- Docs: README updated for new `--watch` flag; API docs page regenerated; example snippet for migration from v2.3 โ†’ v2.4 added.
- Action items: review #312 breakage decision, decide on TypeScript types epic, acknowledge stale issue #287.

Expected Results

โœ“Issues triaged within hours, not weeks
โœ“PRs reviewed before they go stale
โœ“Changelog and docs always in sync with main
โœ“Maintainer burnout slowed

Frequently Asked Questions

Will Critic actually catch bad PRs, or just rubber-stamp?๏ผ‹

It catches the obvious things โ€” failing tests, style violations, scope creep, undocumented breaking changes. It will NOT catch subtle architectural problems or security issues that need deep context; the SOUL.md is calibrated to flag uncertainty rather than approve. In practice it raises the floor on what reaches your inbox: clean PRs get to you faster, sloppy ones get fixed before you see them.

What if Triager labels something wrong?๏ผ‹

Labels are easy to override โ€” Triager will defer to a human-applied label and won't re-label. The default config is conservative (it asks for clarification rather than guessing) so mislabels are rare. You can also tune Triager's SOUL.md with repo-specific rules: 'don't auto-close issues from contributor X', 'always tag accessibility issues as priority-high', etc.

Can it merge PRs automatically?๏ผ‹

Out of the box, no โ€” Critic only comments and requests changes. There's an opt-in `auto_merge` rule you can turn on in the SOUL.md (e.g. "auto-merge dependabot PRs that pass CI") but the default is human-merge only. We don't recommend auto-merge for non-trivial changes; the cost of a bad merge is much higher than the cost of a 1-day review delay.

How does it handle huge issue backlogs?๏ผ‹

On first run, Triager processes the backlog in batches (configurable, default 20 issues/run) to avoid overwhelming you with notifications. It dedupes against existing issues, so old duplicates get closed with a link to the canonical thread. Most maintainers see a 30-50% backlog reduction in the first week from dedup alone.

Does it work with GitLab or Gitea?๏ผ‹

GitHub is first-class. GitLab and Gitea need a small adapter for the API differences (the bundle includes a `provider.ts` you swap). The SOUL.md prompts are platform-agnostic; only the API calls change.

What does the $29 bundle include?๏ผ‹

Four SOUL.md files (Triager, Critic, Logger, Docs), an AGENTS.md coordination file, GitHub webhook + Actions workflows for the auto-triage pipeline, Dockerfile, and the setup README. All source is yours; runs on your machine, a $5/mo VPS, or as a GitHub Action.

Deploy This Team

Get 4 AI agents working together โ€” pre-configured, two Terminal commands to deploy.

$29one-time
Team Bundle ยท includes 5 agents
Save $7 vs $36 for 4 singles

7-day money-back guarantee ยท One-time payment, yours forever