skills.rest
jeremy-newhouse
jeremy-newhouseCOMMUNITY
Explore all skills by this author →
GitHub

wa:spec-review

Validate Spec-phase FRD artifacts for completeness and testability.

Updated Mar 26, 2026
Search Tags:#testability#acceptance criteria#quality gate#spec review#product planning#e2e lifecycle#blocking questions
One-click install
npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-spec-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wa:spec-review
Source: https://github.com/jeremy-newhouse/eck-e2e-weather-app/tree/main/.claude/skills/spec-review
Command: npx skills add https://github.com/jeremy-newhouse/eck-e2e-weather-app --skill wa-spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents moving forward with incomplete or untestable Spec-phase artifacts by running a quality gate that checks FRD completeness, acceptance-criteria testability, and unresolved blocking questions.

Core Features & Use Cases

  • Validates Spec artifacts for readiness: Confirms FRD presence and evaluates whether required sections and criteria exist.
  • Ensures Acceptance Criteria quality: Verifies each AC-ID is active, observable, and backed by a supported verification method.
  • Resolves blocking questions: Detects blocking markers in FRD (and DISCOVERY if present) and requires they are resolved before progressing.
  • Produces a review verdict report: Writes pass/fail (plus warnings) to docs/{feature}/SPEC-REVIEW.md and records the gate result in the lifecycle.

Quick Start

Run wa:spec-review with your feature description by typing "/spec-review <feature-description>" and follow the confirmation step to proceed to the Design phase.

Frequently Asked Questions about wa:spec-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate acceptance criteria for testability before design?▼

Spec review validates acceptance criteria testability by scanning FRD artifacts to ensure each AC-ID is active, observable, and backed by a supported verification method. It blocks progression if criteria lack testable qualities.

What is a quality gate for spec readiness in product planning?▼

A spec readiness quality gate prevents moving forward with incomplete artifacts by checking FRD completeness, acceptance criteria testability, and unresolved blocking questions before allowing the design phase to proceed.

How do I handle blocking questions in an FRD before moving to design?▼

Spec review detects blocking markers within the FRD and DISCOVERY artifacts, requiring them to be fully resolved before the lifecycle can progress to the design phase.

Can I use spec review for e2e feature lifecycle gating workflows?▼

Yes, spec review applies specifically to e2e feature lifecycle workflows where it validates Spec artifacts after the spec phase and records the gate verdict before entering the design phase.

What does spec review check for FRD completeness in product planning?▼

Spec review checks FRD completeness by confirming the document's presence and evaluating whether all required sections and acceptance criteria exist before generating a SPEC-REVIEW.md verdict report.

Related Skills

Explore More Product & Management Skills→
codigodoleocodigodoleo
13

superpowers-sage:architecture-discovery

Map WordPress, Sage, Acorn, and Lando codebases into approved architecture specs.

Official
Advanced
handsomelong922handsomelong922

brainstorming

Facilitate collaborative brainstorming to convert ideas into validated design plans.

Community
Advanced
SpreadWorksSpreadWorks
2

sdd-forge.flow-impl

Orchestrate the SDD implementation workflow with gate checks and progress tracking.

Official
Advanced
LerianStudioLerianStudio
205

dev-validation

Automate development completion validation with acceptance criteria checks and explicit user approval.

Official
Advanced