Code Review bundle overview

The Code Review bundle (nold-ai/specfact-code-review) extends the shared specfact code command group with review workflows: governed review runs, reward ledger history, and bundled code-review skill management through the rules command.

Use it together with the Codebase bundle (import, analyze, drift, validate, repro) on the same code surface.

Prerequisites

  • specfact module install nold-ai/specfact-code-review — the manifest bundle_dependencies list includes nold-ai/specfact-codebase, so SpecFact CLI will automatically install the Codebase bundle alongside this one for the full shared specfact code command surface (import, analyze, drift, and related commands live there).
  • Optional tool installs (Ruff, Radon, Semgrep, Pyright, etc.) as described in command help

specfact code review — nested commands

Command Purpose
run Execute a governed review (scope, JSON output, --fix, TDD gate, etc.)
ledger Inspect and update review reward history
rules Manage the bundled code-review skill (show, init, update)

ledger subcommands

Subcommand Purpose
update Update ledger entries
status Show ledger status
reset Reset ledger state

rules subcommands

Subcommand Purpose
show Show current rules configuration
init Initialize rules/skill assets
update Update rules content

Bundle-owned skills and policy packs

House rules and review payloads ship inside the bundle (for example Semgrep packs, the specfact/clean-code-principles policy-pack manifest, and the specfact-code-review skill). They are not core CLI-owned resources. Use specfact code review rules init --ide codex or the matching IDE target to install the reusable skill instead of copying prompt templates by hand.

Quick examples

specfact code review run --help
specfact code review ledger status --help
specfact code review rules show --help

See also