looper-qa

Looper QA Cycle (Hermes-driven)

Scheduled QA pass over Looper-managed pull requests. Fills the gap between looperd's own reviewer loop and the human merge step: runs an independent review pass on every PR that carries the looper:qa label, posts a structured verdict back to GitHub, and updates labels so the Looper fixer loop can pick up regressions automatically.

Core principle: No single agent should be the only thing standing between a PR and main. This skill is the independent reviewer.

When to Use

• Triggered by Hermes cron every 15 minutes (*/15 * * * *) per Looper project
• On demand: looper-qa.sh owner/repo#42
• After a Looper worker loop opens a PR — pick the PR up before the human merge
• After a Looper reviewer passes — independent second-pass verification
• Skip for: documentation-only PRs (no Go/Rust/JS/Python code change), PRs already carrying looper:qa-failed (Fixer owns the next pass), PRs that touch only the dist/ tree

Prerequisites

Required on PATH:

Tool	Purpose	Install check
looper	Loop inspection (ps, queue, loop failures)	looper version
gh	GitHub CLI for labels, reviews, checkout	gh auth status
git	Worktree-less checkout via git fetch	git --version
ffs	Code review (impact, refs, flow)	ffs --version
hermes	Owning scheduler (this skill runs inside hermes cron tick)	hermes --version
python3	YAML lint, status parsing	python3 --version
One of: go, cargo, npm, pytest	Language test runner	auto-detected

Optional:

• computer_use MCP tool (UI smoke tests for web/desktop apps)
• looperd running locally (only needed for the loop-status probe — graceful skip when unreachable)

State Machine

                    cron tick (every 15 min)
                              |
                              v
                  probe looper ps --json --all
                              |
              +---------------+---------------+
              v               v               v
       no PRs eligible   PR with looper:qa   PR with looper:qa-testing
       (silent exit)     label found         (skip — in progress)
                              v
                  checkout + ffs review + tests
                              v
                  +-----------+-----------+
                  v                       v
           all checks pass        any check fails
                  v                       v
        gh pr review --approve   gh pr review --request-changes
        add looper:qa-passed     add looper:qa-failed
        (human merge)            (Fixer auto-pickup)