plugins/nw/skills/nw-diverger-review-criteria/SKILL.md
Review criteria for the nw-diverger-reviewer — validates JTBD rigor, research quality, option diversity, taste application correctness, and recommendation coherence in DIVERGE wave artifacts
npx skillsauth add nwave-ai/nwave nw-diverger-review-criteriaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are reviewing DIVERGE wave artifacts. Your job is adversarial: assume artifacts have problems until you prove they don't. Flag issues before the team commits to a design direction.
Four artifact files to review:
docs/feature/{id}/diverge/job-analysis.mddocs/feature/{id}/diverge/competitive-research.mddocs/feature/{id}/diverge/options-raw.mddocs/feature/{id}/diverge/taste-evaluation.mddocs/feature/{id}/diverge/recommendation.mdRequirement: Job must be at strategic or physical level, not tactical.
FAIL signals (quote from artifact when found):
PASS signal: Job statement answers "what progress is being made?" without specifying how.
Requirement: Evidence of 5-Why or abstraction-layer navigation.
FAIL signals:
PASS signal: At least one level of elevation documented, from the raw request to the extracted job.
Requirement: ODI-format outcome statements (Minimize + metric + object).
FAIL signals:
PASS signal: Each statement starts with "Minimize the [time/likelihood/effort]..." and is solution-agnostic.
Requirement: Competitive research cites real products, real behaviors, real data.
FAIL signals:
PASS signal: Each competitive insight names a real product or cites a real behavior/metric.
Requirement: Research covers at least 3 existing solutions to the validated job.
FAIL signals:
PASS signal: Research includes at least one surprising or non-obvious alternative (a different category that does the same job).
Requirement: 6 options, each structurally different (different mechanism, different assumption, different cost profile).
FAIL signals:
PASS signal: Applying the 3-point diversity test to each pair of options — they differ in at least 2 of 3 dimensions (mechanism, assumption, cost).
Requirement: Options were generated before evaluation (separation principle).
FAIL signal: Options-raw.md contains evaluative language ("This is the best because...", "This won't work because...") mixed with generation content.
PASS signal: options-raw.md is purely descriptive; evaluation appears only in taste-evaluation.md.
Requirement: The HMW question doesn't embed a solution.
FAIL signals:
PASS signal: HMW question can be answered by options that don't share the same technology or UI pattern.
Requirement: All four taste criteria (Subtraction, Concept Count, Progressive Disclosure, Speed-as-Trust) applied to all surviving options.
FAIL signals:
PASS signal: Full scoring matrix present for all post-DVF-filter options with all criteria scored.
Requirement: Weights locked before scoring begins; recommendation follows from scores.
FAIL signals:
PASS signal: Recommended option has highest or second-highest weighted total; if second-highest, reason for not recommending top is documented.
Requirement: Scores justified against rubric, not assigned freely.
FAIL signals:
PASS signal: Each score accompanied by one sentence referencing the specific rubric level.
Requirement: Recommendation traceable to JTBD → Research → Scores.
FAIL signal: Recommendation could be made without reading job-analysis.md or taste-evaluation.md.
PASS signal: Recommendation references the validated job, cites competitive research findings, and derives from the highest-scoring option(s).
Requirement: "Runner-up" case documented — which option almost won and why.
FAIL signal: Only the winning option discussed in recommendation.
PASS signal: recommendation.md includes a "dissenting case" section naming the runner-up and the margin.
Requirement: Recommendation ends with a clear decision statement for the DISCUSS wave.
FAIL signal: Recommendation ends with "both options are viable" or "the team should decide."
PASS signal: Explicit decision statement: "Proceed with [option], assuming [key risk] is acceptable."
review_result:
artifact_path: "docs/feature/{id}/diverge/"
review_date: "{timestamp}"
reviewer: "nw-diverger-reviewer"
jtbd_rigor:
status: "PASSED|FAILED"
issues: [{check, location, quoted_evidence, remediation}]
research_quality:
status: "PASSED|FAILED"
issues: [{check, location, quoted_evidence, remediation}]
option_diversity:
status: "PASSED|FAILED"
issues: [{check, location, quoted_evidence, remediation}]
taste_application:
status: "PASSED|FAILED"
issues: [{check, location, quoted_evidence, remediation}]
recommendation_coherence:
status: "PASSED|FAILED"
issues: [{check, location, quoted_evidence, remediation}]
approval_status: "approved|conditionally_approved|rejected_pending_revisions"
blocking_issues: []
recommendations: []
Approval thresholds:
approved: all dimensions PASSEDconditionally_approved: no FAILED dimensions, minor issues onlyrejected: any dimension FAILED, with specific remediation requiredtesting
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.
development
Cross-agent collaboration protocols, workflow handoff patterns, and commit message formats for TDD/Mikado/refactoring workflows
development
Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Use when planning implementation steps before execution.
testing
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.