메뉴
Watch one feature's PR in the background and auto-clean its agent, worktree, and branch once it merges. Use after a feature's PR is open to wire hands-off cleanup on merge (typically called by /hv:build-feature as its final step). It polls GitHub with exponential backoff and only triggers cleanup — the actual removal is done by /hv:clean-agents.
| name | watch-merges |
| description | Watch one feature's PR in the background and auto-clean its agent, worktree, and branch once it merges. Use after a feature's PR is open to wire hands-off cleanup on merge (typically called by /hv:build-feature as its final step). It polls GitHub with exponential backoff and only triggers cleanup — the actual removal is done by /hv:clean-agents. |
| argument-hint | <pr-number | branch> [--initial S] [--factor N] [--cap S] [--max H] |
| model | opus |
| disable-model-invocation | true |
| allowed-tools | Read, Bash, Grep, Glob |
A thin watcher. It polls one PR until it merges, then runs
/hv:clean-agents, which delegates the actual removal to the janitor
subagent. All cleanup guardrails live there — this skill never deletes anything
itself.
$ARGUMENTS
<pr|branch> — the feature PR to watch (typically passed by /hv:build-feature
as its final step, right after opening the PR). Optional tuning:
--initial S (first poll gap, default 30s), --factor N (backoff multiplier,
default 2), --cap S (max gap, default 600s), --max H (give up after H hours,
default 24).
Poll the PR in the background so no live session is tied to the wait. The
bundled script backs off exponentially — quick polls right after the PR opens,
when a merge is most likely imminent, widening to --cap for the long tail —
and stops on merge, close, or the --max deadline:
bash "${CLAUDE_PLUGIN_ROOT}/scripts/watch-merge.sh" <pr|branch>
Run it with Bash's background mode so it keeps polling across turns and re-invokes you when it exits. Its final stdout line is one of:
MERGED <branch> → go to Step 2 and clean.CLOSED_UNMERGED <branch> → the PR was closed without merging; clean
nothing (never destroy unmerged work) — just report it.TIMEOUT <branch> → still open after --max; report that it's still
open and suggest re-running /hv:watch-merges <pr> (or cleaning manually once
it lands).ERROR <message> → bad target or gh not authenticated; surface it.When (and only when) the watcher reports MERGED, run:
/hv:clean-agents <branch>
Cleanup only ever runs through /hv:clean-agents → janitor, which re-checks
that the agent is not still running and the PR is merged before removing
anything. This skill watches and triggers; it never deletes resources itself.
result: watched <pr|branch> → <merged: cleaned | closed-unmerged: skipped | timeout: still open>.
Autonomously drives ONE feature end-to-end — understand, implement, review-and-fix, and open a right-sized PR — inside its own worktree. Runs as the main loop of a background feature agent (launched by /hv:launch-agents, or directly via `claude --bg "/hv:build-feature ..."` for a single feature). Accepts a spec-file path, inline JSON, a plain-text task, or `<spec> <featurename>`.
Turn a GitHub issue, spec file, or free-text request into a design and the right-sized plan to build it. Judges the epic's total weight and decides whether to keep it as a single PR (small/cohesive work) or decompose it into independent, parallel-executable features for a fleet of agents (large work or separable risky cores) — it does not split by default. Use this first, before launching any work. Free to propose a better architecture than the current code; sizes by risk and independence. Outputs a feature manifest (one or more features) that /hv:launch-agents consumes.
Prepare a parallel launch from a /hv:plan-features manifest — validate it, write a self-contained spec file per feature, and emit ready-to-paste `claude --bg` commands grouped into dependency waves for the human to run. Use after design when you're ready to run features in parallel. Does not spawn sessions itself (a session launching sessions is unsupported); it produces the exact launch commands. Each launched agent auto-isolates in its own git worktree.
Code quality standards for reviewing code changes. Activated when reviewing PRs, implementing features, or discussing code quality. Triggers on requests to "review code", "check quality", "improve code", or "refactor".
Reviews PR changes against the broader codebase to find inconsistencies, missed propagation, and stale references beyond the diff. Replicates senior reviewer codebase knowledge. Activates when reviewing PRs, checking consistency, or when changes touch shared entities across multiple files.
Security review checklist for code changes. Automatically activates when reviewing security-sensitive code, authentication, authorization, or data handling. Use when user asks to "check security", "review for vulnerabilities", "audit code", or when changes touch auth, crypto, user input, or API endpoints.