| name | solo-maintainer-inbox |
| description | Triage issues and pull requests for a solo maintainer. Detect suspicious changes, validate safe PRs, label and comment when needed, and merge or close normal work automatically. |
| argument-hint | [optional focus, e.g. prs|issues|all] |
Solo Maintainer Inbox
Required Context
Read the shared policy first:
PR Workflow
- Snapshot the queue with
gh pr list --state open.
- For each PR, gather metadata with
gh pr view --json and inspect changed files with gh pr diff --name-only.
- Detect stacked PRs before merging. Merge ancestors first or mark superseded PRs clearly.
- Apply the suspicious-change policy. If triggered, stop merge/release actions for that PR.
- For safe PRs, run path-appropriate verification:
- docs-only: formatting or docs checks relevant to the changed files
- runtime, infra, or workflow changes:
npm run build, npm run lint, npm run test, npm run test:e2e
- Merge safe, green, mergeable PRs with a linear-history-friendly method such as
gh pr merge --squash --delete-branch.
Issue Workflow
- Snapshot the issue queue with
gh issue list --state open.
- Label and classify issues quickly: bug, docs, security, cost, ops, release blocker, or duplicate.
- Request missing reproduction data only when the repository cannot infer it from context.
- Close duplicates, obsolete reports, or already-fixed issues when evidence is clear.
Output Discipline
- Leave short evidence for each merge, close, or stop decision.
- When stopping for suspicious work, preserve changed files, failed checks, and the exact trigger from the shared policy.
