g-review

Behavior

/g-review is a per-change quality gate. It is invoked internally by /g-implement and /g-fix — never directly by the user in v1 (the ad-hoc contract is deferred).

Contract

Inputs (five named arguments from the caller):

1. spec — what the change is supposed to do. For /g-implement, the full task entry from TASKS.md. For /g-fix, the bug description + approved fix approach.
2. agents_md_path — path to the project's AGENTS.md.
3. context_md_path — path to the project's CONTEXT.md (always passed by callers; the reviewer reads it at session start and applies the three-state axis matrix per its agent file).
4. diff_range — git revision range (e.g. {feature-name}...{feature-name}-slice-NN-{slug}).
5. output_path — where to write the review report.

Optional:

1. prior_review_path — when re-reviewing after a re-spawn, the existing review report path. The skill reads the prior "Current Review" into a "Review History" entry before overwriting with the new iteration.
2. extra_axis — extra project-specific axes to weight beyond the five standard axes. /g-implement passes scope-drift; /g-fix passes regression-test-presence. (The two new project-wide axes — glossary-alignment and context-md-spec-pollution — are baseline, not extra_axis; the reviewer applies them conditionally per the CONTEXT.md three-state matrix in its agent file.)

Output: a single review report file written to output_path, formatted per docs/templates/review-report.md.

Execution

Spawn the reviewing subagent:

cd into the worktree before spawning. The subagent inherits the orchestrator's cwd at invocation. Run this literally:

cd "$worktree_root"

Task tool invocation:

subagent_type: g-reviewer
description: Review {type} [NN] iter [N]
prompt: <<EOF
<!-- g-sdd:work-unit-type={type} -->
<!-- g-sdd:work-unit-number=[NN] -->
<!-- g-sdd:slice-branch={slice-branch} -->
<!-- g-sdd:worktree-path=/abs/path/to/worktree -->
<!-- g-sdd:feature-name={feature-name} -->
<!-- g-sdd:iteration=[N] -->