review ยท diff

git:20260716.eae94de to git:20260718.2e5dcfa

2 added, 1 removed. Audit B to A.

---
- description: Run an adversarial Grok review against local git state
+ name: review
+ description: Runs an adversarial Grok review of local git state. Use for a fast mechanical review sweep before merge, complementing deeper Codex review.
argument-hint: '[--base <ref>] [--focus <text>] [--cwd <dir>] [--json]'
allowed-tools: Read, Glob, Grep, Bash(git:*), Agent
---
Run a Grok code review through the companion runtime.
Core constraints:
- Never ask the user how to run the review or which findings to fix. The only question that may reach the user is a finding that forces a genuine product or design decision, such as a scope change or a public API break.
- The review never runs in the main loop. It rides in a tracked background subagent, and that runner launches the companion foreground, reads the detached review job id, and chains `result --wait` until a terminal output arrives.
- The review run is read only consult mode and never edits files. Acting on a confirmed finding is a separate orchestrator decision after the review returns.
- The companion requires `--json-schema`, requests the review schema through one headless call, and consumes `structuredOutput`. A structured output error or explicit null result is a failed review. Compatibility parsing of text is allowed only when the response completely omits the structured output field and never launches a corrective resume call.
Launch:
- Treat the complete raw slash command request as opaque data. Do not parse, strip, quote, escape, normalize, or place any part of it in Bash.
- Dispatch one background subagent of type `grok:grok-review-runner` via the `Agent` tool. Tell the runner that the raw request begins after a fixed delimiter and continues to the end of the Agent prompt. The runner stages it through the private one time transport, launches the managed review with a fixed command, and owns result collection.
- Tell the user the review is running and end the turn. Do not poll; the runner's completion notification delivers the collected terminal result.
Presenting results:
- Return the runner's output verbatim, exactly as-is. Do not paraphrase, summarize, or add commentary before or after it.
- Untracked files reach the review as a name list only, not content; say so when findings depend on new files.
After presenting findings:
- Triage by verification, not by asking. After the review returns, the orchestrator separately decides whether to act on each confirmed finding; when it does, it dispatches a fix by the orchestration routing rules without prompting. Drop false positives with a stated reason.
- Close with one report: what was fixed, what was dropped, and why. Only a finding that forces a whitelisted product or design decision goes to the user as a question; everything else proceeds on defaults.
The opaque raw review request begins after the next newline and continues to the end of this command prompt:
$ARGUMENTS