review-crucible
High-signal pull request review for Claude Code, Codex, and Amp.
This plugin packages a serious review workflow that ports the behavior of
Anthropic's Code Review, Code Simplifier, and PR Review Toolkit plugins using
original prompt text released under Apache-2.0. It is designed to
find merge-blocking bugs, missed edge cases, weak tests, silent failures,
security boundary mistakes, type invariant problems, misleading comments, and
unnecessary complexity.
What It Provides
| Component | Purpose |
|---|
/review-crucible:code-review | Claude-style strict PR review with high-confidence filtering |
/review-crucible:review-pr | Claude Code slash command for a full PR or diff review |
/review-crucible:simplify | Claude Code command for conservative behavior-preserving simplification |
review-crucible skill | Source-neutral Codex/Claude skill for orchestrating review |
| Review agents | Focused Claude Code subagents for different failure modes |
| Codex custom agents | .codex/agents/*.toml reviewers for Codex subagent fan-out |
| Amp checks | .agents/checks/*.md criteria for Amp code review |
| Install snippets | Codex and Amp setup instructions |
Single Source of Behavior
Canonical review content lives under skills/review-crucible/references/.
Host files are thin wrappers or synced host copies:
reviewer-roles.md: reviewer roles and preserved source-plugin concepts.review-orchestration.md: preflight, pass selection, targeted activation,
host routing, and validation ownership.review-rubric.md: severity, confidence, validation, false-positive filters,
and output format.github-commenting.md: inline review comment discipline.model-policy.md: strongest verified model and highest effort policy.
Reviewer roster, host frontmatter (model/effort/color, Codex reasoning effort,
Amp severity/tools), and plugin manifest metadata live in plugin.shared.json.
Wrappers under agents/, .codex/agents/, .agents/checks/, and both plugin
manifests are generated. Edit canonical references and plugin.shared.json,
then run a single command:
python3 scripts/regen.py
Regeneration also removes stale generated wrappers after role/check renames,
but only when the stale file still carries the Generated by scripts/regen.py
banner.
CI / pre-commit drift check (exits nonzero if any wrapper is out of sync or a
stale generated wrapper remains):
python3 scripts/regen.py --check
Full local validation:
python3 scripts/validate.py
That runner checks generated wrappers, manifests, Codex agent TOML, Python
scripts, shared metadata anchors and duplicate generated names, the Review
Crucible skill validator when available, and worktree and staged
whitespace-sensitive diffs.
Agent Compatibility
| Agent | How Review Crucible is used | Subagent behavior |
|---|
| Claude Code | Native plugin commands and auto-discovered agents | Plugin agents run as subagents |
| Codex | Reusable skill, .codex-plugin/plugin.json, and .codex/agents/*.toml | Uses Codex subagents/custom agents in current Codex app/CLI; otherwise sequential passes |
| Amp | AGENTS.md snippet plus .agents/checks/*.md review checks | Review checks run as separate review subagents |
See docs/COMPATIBILITY.md for details and host limits.
See docs/PARITY-AUDIT.md for source-plugin behavior
mapping.
Review Passes
- Project rules and local conventions.
- Two independent rule-compliance passes for important PRs.
- Diff-only bug hunting for obvious failures.
- History/context bug hunting with blame and PR discussion when useful.
- Prior PR comment review to avoid duplicate feedback and preserve unresolved
review context.
- Bug and regression hunting.
- Security and trust boundary review.
- Silent failure and error handling review.
- Test gap and brittle test review.
- Type, schema, and invariant design review.
- Comment and documentation drift review.
- Design challenge review for risky assumptions and unresolved decisions.
- Current-docs research for library, framework, SDK, API, CLI, and cloud-service
behavior.
- Rust-specific review through
rust-best-practices when that plugin or skill
is installed.
- Complexity and simplification review.
- Finding validation to filter weak or speculative comments.
Claude Code Installation
Install from the TailRocks marketplace:
/plugin marketplace add tailrocks/tailrocks-marketplace
/plugin install review-crucible@tailrocks-marketplace
For local development from a clone, add the clone path as a marketplace:
/plugin marketplace add /absolute/path/to/tailrocks-marketplace
/plugin install review-crucible@tailrocks-marketplace
/reload-plugins
This plugin does not ship its own marketplace manifest. Distribution is handled
by the TailRocks marketplace repository.
Run:
