/adversarial-review

description: Run an agy adversarial review that challenges the implementation approach and design choices
argument-hint: '[--wait|--background] [--dry-run] [--base <ref>] [--scope auto|working-tree|branch] [--model <name>] [--effort <low|medium|high>] [focus ...]'
disable-model-invocation: true
allowed-tools: Read, Glob, Grep, Bash(node:*), Bash(git:*), AskUserQuestion

Run an adversarial agy review. Position it as a challenge review that questions the chosen implementation, design choices, tradeoffs, and assumptions — not just a stricter pass over defects.

Raw slash-command arguments: `$ARGUMENTS`

Core constraint:

• This command is review-only.
• Do not fix issues, apply patches, or suggest that you are about to make changes.
• Your only job is to run the review and return agy's output verbatim to the user.
• Keep the framing focused on whether the current approach is the right one, what assumptions it depends on, and where the design could fail under real-world conditions.

Execution mode rules:

• If the raw arguments include `--dry-run`, do not ask. Run in the foreground — it only prints the resolved options and available models, no review is performed.
• If the raw arguments include `--wait`, do not ask. Run in the foreground.
• If the raw arguments include `--background`, do not ask. Run in a Claude background task.
• Otherwise, estimate the review size before asking:
• For working-tree review, run `git status --short --untracked-files=all`.
• Also inspect `git diff --shortstat --cached` and `git diff --shortstat`.
• For base-branch review, use `git diff --shortstat <base>...HEAD`.
• Treat untracked files as reviewable work even when `git diff --shortstat` is empty.
• Only conclude there is nothing to review when the relevant scope is actually empty.
• Recommend waiting only when the review is clearly tiny (roughly 1–2 files).
• In every other case, recommend background.
• Then use `AskUserQuestion` exactly once with two options, putting the recommended option first and suffixing its label with `(Recommended)`:
• `Wait for results`
• `Run in background`

Argument handling:

• Preserve the user's arguments exactly.
• Do not strip `--wait` or `--background` yourself.
• Do not weaken the adversarial framing or rewrite the user's focus text.

Foreground flow:

• Run:

node "${CLAUDE_PLUGIN_ROOT}/scripts/agy-companion.mjs" adversarial-review "$ARGUMENTS"

• Return the command stdout verbatim, exactly as-is.
• Do not paraphrase, summarize, or add commentary before or after it.
• Do not fix any issues mentioned in the review output.

Background flow:

• Launch the review with `Bash` in the background:

Bash({
  command: `node "${CLAUDE_PLUGIN_ROOT}/scripts/agy-companion.mjs" adversarial-review "$ARGUMENTS"`,
  description: "agy adversarial review",
  run_in_background: true
})

• Do not wait for completion in this turn.
• After launching the command, tell the user: "agy adversarial review started in the background. Check `/agy:status` for progress."