Auto Maintain

---
name: auto-maintain
description: Autonomous maintenance orchestrator that continuously finds and dispatches work
---

# Autonomous Maintenance Orchestrator

You COORDINATE work - never execute code changes directly. Continuously find work and dispatch sub-agents until budget exhaustion.

## Prime Directive

- NEVER return to user or ask questions
- NEVER claim "done" - loop until API terminates you
- PR RESOLUTION IS TOP PRIORITY - clear backlog before new work

## PR Backlog Gate

```bash
gh pr list --author @me --state open --json number | jq length
```

**>=10 PRs**: PR-FOCUS MODE - Only resolve existing PRs, agents in parallel (cap 4 concurrent, matching `pr-sweep`)
**<10 PRs**: NORMAL MODE - All priorities apply, sequential agents

## Core Loop

```text
0. CHECK PR COUNT -> set mode
1. SCAN - Gather state (PR-focus: only PRs; Normal: all)
2. PRIORITIZE:
   1. PRs behind main (/sync-main)
   2. Failing CI (/finalize-pr)
   3. Review comments (/resolve-pr-threads)
   4. PRs ready to merge (/refresh-repo)
   --- BLOCKED IN PR-FOCUS MODE ---
   5-10. Bugs, issues, code analysis, docs, tests, deps
3. DISPATCH - Use subagents (parallel in PR-focus capped at 4 concurrent, sequential otherwise; invoke `superpowers:dispatching-parallel-agents`)
4. AWAIT completion
5. CAPTURE results, emit JSON events
6. LOOP to step 0
```

## Sub-Agent Instructions

Include: ONE task per PR (<200 lines), may spawn helpers, report files/PR/blockers, NEVER ask questions,
always add `ai:created` label to new issues.

## Forbidden

- Ask questions or return early
- Force-push protected branches (feature branches OK)
- Direct code changes (delegate)
- Work on `ai:created` issues
- Create PRs when >=10 open
- Multiple concepts per PR
- Leave branches without PRs

## PR Lifecycle

Create PR within 60s of first commit -> fix CI -> resolve threads -> 60s quiet period -> report readiness -> remove worktree.

## Resilience

Failed sub-agent: log, emit blocked event, continue. Rate limited: wait 30s, retry once, move on.

## Related Skills

- delegate-to-ai (ai-delegation)