---
name: spec-review
description: Review spec-kit specifications and plans using multi-model AI consensus (orch) before phase transitions. Use when working with spec-kit projects and need to validate specs, evaluate architecture decisions, or gate phase transitions.
---

# Spec Review

Multi-model review of spec-kit artifacts. Uses orch to get diverse AI perspectives that catch blind spots a single model might miss.

## When to Use

- Before `/speckit.plan` - review the spec for completeness
- Before `/speckit.tasks` - evaluate architecture decisions in the plan
- Before `bd create` - review task breakdown before committing to issues
- At any phase transition - go/no-go gate check

## Quick Start

**Review a spec**:
```bash
orch consensus --mode critique --temperature 0.8 \
  --file specs/{branch}/spec.md \
  "$(cat ~/.claude/skills/spec-review/prompts/spec-critique.txt)" \
  flash deepseek gpt
```

**Review a plan** (devil's advocate):
```bash
orch consensus --mode open --temperature 1.0 \
  --file specs/{branch}/plan.md \
  "$(cat ~/.claude/skills/spec-review/prompts/plan-review.txt)" \
  flash:for deepseek:against gpt:neutral
```

**Review tasks** (before bd create):
```bash
orch consensus --mode critique --temperature 0.7 \
  --file specs/{branch}/tasks.md \
  "$(cat ~/.claude/skills/spec-review/prompts/tasks-review.txt)" \
  flash deepseek gpt
```

**Gate check**:
```bash
orch consensus --mode vote --temperature 0.5 \
  --file specs/{branch}/spec.md \
  "$(cat ~/.claude/skills/spec-review/prompts/gate-check.txt)" \
  flash deepseek gpt
```

## Detailed Processes

- [REVIEW_SPEC.md](references/REVIEW_SPEC.md) - Full spec review process
- [REVIEW_PLAN.md](references/REVIEW_PLAN.md) - Plan evaluation with stances
- [REVIEW_TASKS.md](references/REVIEW_TASKS.md) - Task breakdown review before bd
- [GATE_CHECK.md](references/GATE_CHECK.md) - Go/no-go consensus

## Model Selection

**Default (fast, cheap, diverse)**:
- `flash` - Gemini 2.5 Flash
- `deepseek` - DeepSeek v3
- `gpt` - GPT 5.2

**Thorough review**:
- `gemini` - Gemini 3 Pro
- `r1` - DeepSeek R1 (reasoning)

## Why Multi-Model?

Different models catch different issues:
- Different training data → different blind spots
- Stances (for/against/neutral) force opposing viewpoints
- Higher temperature → more divergent thinking

## Requirements

- `orch` CLI in PATH
- API keys: GEMINI_API_KEY, OPENAI_API_KEY, OPENROUTER_KEY
- Working in a spec-kit project (has `specs/` directory)
