Skip to content
Code Review
Command

/critique

Run a Grok Build critique that challenges the implementation approach and design choices

BOOST
From plugin
grok-build-plugin-cc
2638 skills1 agent8 commands
Install
> /plugin marketplace add xai-org/grok-build-plugin-cc
> /plugin install grok-build@xai-grok-build

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/critique

Context preview

What this command does when you run it.

Run a Grok Build critique that challenges the implementation approach and design choices

Command definition

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

Run a Grok Build critique through the plugin bridge. Position it as a challenge pass that questions the chosen implementation, design choices, tradeoffs, and assumptions. It is not just a stricter pass over implementation 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 critique and return Grok'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 `--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, start with `git status --short --untracked-files=all`.
  • For working-tree review, also inspect both `git diff --shortstat --cached` and `git diff --shortstat`.
  • For base-branch review, use `git diff --shortstat <base>...HEAD`.
  • Treat untracked files or directories as reviewable work for auto or working-tree review 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 scoped review is clearly tiny, roughly 1-2 files total and no sign of a broader directory-sized change.
  • In every other case, including unclear size, recommend background.
  • When in doubt, run the critique instead of declaring that there is nothing to review.
  • 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 critique framing or rewrite the user's focus text.
  • `--model` and `--effort` are runtime-selection flags. Preserve them for the bridge call; do not treat them as focus text.
  • Leave `--model` and `--effort` unset unless the user explicitly asks for them. Accepted effort values: `low`, `medium`, `high`.
  • The bridge script parses `--wait` and `--background`. Bridge `--background` owns the long-running process group (detached `run-worker` + grok agent). Claude Code's `Bash(..., run_in_background: true)` is only for the short enqueue call, not the long critique process.
  • `/grok-build:critique` uses the same review target selection as `/grok-build:review`.
  • Unlike `/grok-build:review`, `/grok-build:critique` can still take extra focus text after the flags.

Foreground flow:

  • Run:
node "${CLAUDE_PLUGIN_ROOT}/scripts/grok-bridge.mjs" critique "$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 critique output.

Background flow:

  • Prefer the bridge's own detached worker so stop owns a stable process group. Ensure the forwarded arguments include `--background` (add it if the user chose background and did not already pass the flag).
  • Launch with `Bash` (Claude may still use `run_in_background: true` for the short enqueue call; the long-running work is the bridge `run-worker`):
Bash({
  command: `node "${CLAUDE_PLUGIN_ROOT}/scripts/grok-bridge.mjs" critique --background "$ARGUMENTS"`,
  description: "Grok Build critique",
  run_in_background: true
})
  • Do not call `BashOutput` or wait for completion in this turn.
  • After launching the command, tell the user: "Grok Build critique started in the background. Check `/grok-build:runs` for progress. Stop with `/grok-build:stop`."
Read more
Ships withgrok-build-plugin-cc

Bridge Grok Build into Claude Code for review, critique, delegation, and session import. This repository is a Claude Code marketplace plugin that shells out to the real grok CLI. Run status, results, and stop are owned by the plugin (PID + log files).

Get the whole plugin
Stats
263
Stars
67
Forks
Maintained
Maintenance
JavaScript
Language
Apache-2.0
License
2mo ago
Last commit
3mo ago
Created
3h ago
Added

Repo: xai-org/grok-build-plugin-cc

Other commands on grok-build-plugin-cc.