speckit.spex-deep-review.run

Deep Review: Multi-Perspective Code Review

Overview

This command orchestrates a multi-perspective code review using five specialized review agents. Each agent analyzes code from a distinct angle (correctness, architecture, security, production readiness, test quality). Findings are merged, deduplicated, and classified by severity. Critical and Important findings trigger an autonomous fix loop (up to 3 rounds). Results are documented in review-findings.md.

This command is invoked by speckit-spex-gates-review-code when the deep-review extension is enabled, or via the after_implement hook.

Prerequisites

The caller (review-code or ship) may provide these values. When not provided, the deep-review command resolves them itself:

1. Stage 1 result: spec compliance score (or null if no spec)
2. Invocation context: superpowers or manual
3. Hint text: optional focus area from user (or null)
4. External tool settings: {coderabbit: true/false, copilot: true/false} (see resolution below)
5. Spec path: path to spec.md (or null, see Spec Resolution below)
6. Feature directory: path to the spec directory for artifact output

Spec Resolution

If the caller does not provide a spec path, attempt branch-based resolution:

.specify/scripts/bash/check-prerequisites.sh --json --paths-only 2>/dev/null

If this succeeds (outputs JSON with FEATURE_SPEC), use the resolved spec path and feature directory. If this fails (not on a feature branch, no matching spec directory), proceed without a spec (spec compliance checks will be skipped).

External Tool Settings Resolution

If external tool settings are provided by the caller, use them directly. If not (e.g., when invoked directly by speckit-spex-ship or manually), resolve from config:

# Read config defaults from deep-review extension config (all default to true if key is missing)
DEEP_REVIEW_CONFIG=".specify/extensions/spex-deep-review/deep-review-config.yml"
DEFAULT_CODERABBIT=$(yq -r '.external_tools.coderabbit // true' "$DEEP_REVIEW_CONFIG" 2>/dev/null)
DEFAULT_CODERABBIT=${DEFAULT_CODERABBIT:-true}
DEFAULT_COPILOT=$(yq -r '.external_tools.copilot // true' "$DEEP_REVIEW_CONFIG" 2>/dev/null)
DEFAULT_COPILOT=${DEFAULT_COPILOT:-true}