Menu
Dispatches an expert reviewer agent to critique workflow artifacts. Use when a roadmap, implementation, or step needs quality review before proceeding.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Cross-agent collaboration protocols, workflow handoff patterns, and commit message formats for TDD/Mikado/refactoring workflows
Orchestrates the full DELIVER wave end-to-end (roadmap > execute-all > finalize). Use when all prior waves are complete and the feature is ready for implementation.
Acceptance test creation methodology for the DISTILL wave. Domain knowledge for the acceptance designer agent: port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.
Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Use when planning implementation steps before execution.
Dispatches one unit of DELIVER work to a specialized agent for TDD execution. Runs a single roadmap.json step through the TDD cycle.
Deep knowledge for Outside-In TDD - double-loop architecture, ATDD integration, port-to-port testing, walking skeletons, and test doubles policy
| name | nw-review |
| description | Dispatches an expert reviewer agent to critique workflow artifacts. Use when a roadmap, implementation, or step needs quality review before proceeding. |
| user-invocable | true |
| argument-hint | [agent] [artifact-type] [artifact-path] - Example: @software-crafter task "roadmap.json" |
Wave: CROSS_WAVE Agent: Dynamic (nw-*-reviewer)
Dispatches expert reviewer agent to critique workflow artifacts. Takes base agent name, appends -reviewer, invokes with artifact. Reviewer agent owns all review methodology|criteria|output format.
Every review MUST embody Radical Candor — kind AND clear, specific AND sincere:
praise: per review.All findings MUST use Conventional Comments labels:
| Label | Purpose | Blocking? |
|---|---|---|
praise: | Highlight something done well (genuine, not filler) | No |
issue (blocking): | Must be resolved before proceeding | Yes |
issue (blocking, security): | Security vulnerability — maximum directness | Yes |
suggestion: | Propose improvement with reasoning | Mark (blocking) or (non-blocking) |
nitpick (non-blocking): | Trivial, preference-based | No |
question (non-blocking): | Seek clarification before assuming | No |
thought (non-blocking): | Idea sparked by the review | No |
Findings MUST be priority-ordered: blocking issues first, then suggestions, then nitpicks/praise.
| Verdict | Criteria |
|---|---|
| APPROVED | No blocking issues. Non-blocking feedback is advisory. |
| NEEDS_REVISION | Blocking issues exist. Author must address. Each blocking issue enumerated. |
| REJECTED | Fundamental design problems requiring significant rework. Rare — explain thoroughly, offer alternatives. |
/nw-review @{agent-name} {artifact-type} "{artifact-path}" [step_id={id}] [--dimensions=rpp] [--from=1] [--to=3]
Parameters:
@{agent-name} - Base agent (e.g., @nw-software-crafter). -reviewer suffix appended automatically.{artifact-type} - One of: baseline, roadmap, step, task, implementation{artifact-path} - Path to artifact file (resolved to absolute)step_id={id} - Required for step and implementation reviews--dimensions=rpp - Triggers RPP code smell scan alongside standard review (Dimension 4)--from=N / --to=N - RPP level range (default: 1-6). Requires --dimensions=rppBefore dispatching the reviewer agent, read rigor config from .nwave/des-config.json (key: rigor). If absent, use standard defaults.
review_enabled: If false, skip the review entirely. Output: "Review skipped per rigor profile (review_enabled=false)."reviewer_model: Pass as model parameter to Task tool. If "skip", skip the review. Overrides the default Haiku model.double_review: If true and called from deliver Phase 4, the caller is responsible for invoking review twice.| User provides | Reviewer invoked |
|---|---|
@nw-software-crafter | nw-software-crafter-reviewer |
@nw-solution-architect | nw-solution-architect-reviewer |
@nw-platform-architect | nw-platform-architect-reviewer |
Default model: Haiku (overridden by rigor.reviewer_model when set).
@ from agent name, resolve artifact path to absolute, extract optional step_id, dimensions, from/to range. Gate: all parameters parsed..nwave/des-config.json key rigor. If absent, use standard defaults. Gate: rigor profile loaded or defaults applied.review_enabled (skip if false), determine model from reviewer_model (default: haiku, skip if "skip"). Gate: execution decision made.subagent_type="{agent-name}-reviewer", resolved model, and prompt "Review {artifact-type}: {absolute-artifact-path} [step_id={id}]". Reviewer handles reading artifact, applying domain expertise, generating structured critique, updating original artifact with review metadata. Gate: Task tool invoked.@, check agent name against agent registry. Gate: agent found or return "Unknown agent: {name}. Check available agents with /nw-agents."step or implementation. Gate: step_id provided or return "step_id required for {type} reviews."/nw-review @nw-software-crafter step "docs/feature/auth-upgrade/execution-log.json" step_id=02-01
Invokes nw-software-crafter-reviewer with step review of execution log, step 02-01.
/nw-review @nw-solution-architect roadmap "docs/feature/auth-upgrade/roadmap.json"
Invokes nw-solution-architect-reviewer with roadmap review.
/nw-review @nw-platform-architect implementation "docs/feature/auth-upgrade/execution-log.json" step_id=01-01
Invokes nw-platform-architect-reviewer with implementation review of step 01-01.
/nw-review @nw-software-crafter implementation "src/des/" --dimensions=rpp --from=1 --to=3
Invokes nw-software-crafter-reviewer with implementation review + RPP L1-L3 code smell detection using cascade rule.
Handoff To: Depends on review outcome (rework or proceed) Deliverables: Updated artifact file with embedded review metadata
Updated artifact file (roadmap.json, execution-log.json, etc.) with reviews section