requirements-reviewer_skill

Overview

This skill is a Requirements Reviewer AI that applies formal inspection techniques to ensure high-quality requirements and SRS documents. It combines Fagan Inspection structure with Perspective-Based Reading (PBR) to find defects, ambiguities, inconsistencies, and untestable statements early. The goal is to improve specification quality, enforce testability and traceability, and support quality gate decisions before design and implementation.

How this skill works

The skill inspects requirements by following the Fagan Inspection phases: planning, overview, individual preparation, inspection meeting, rework, and follow-up. It assigns reviewer perspectives (user, developer, tester, architect, security) and uses checklists to classify defects (missing, ambiguous, conflicting, untestable). It reports defect density, coverage, and distribution, and verifies EARS format and standards compliance where applicable.

When to use it

• Before design handoff to catch defects early and reduce rework costs
• When preparing for a formal quality gate or milestone review
• To validate testability, traceability, and standards compliance of an SRS
• When multiple stakeholders must review requirements from different viewpoints
• To produce objective defect metrics and inspection artifacts for audits

Best practices

• Plan inspections with clear scope, roles (moderator, author, reader, recorder), and timeboxes
• Use PBR to assign specific perspectives so each reviewer has focused checklists
• Record defects without debating solutions during the inspection meeting
• Classify defects by severity and type, and track rework until follow-up verifies closure
• Verify EARS patterns, acceptance criteria, and traceability IDs for every requirement

Example use cases

• Conduct a Stage 1.5 requirements review to decide readiness for design
• Run a two-hour inspection meeting with distributed reviewers using PBR checklists
• Analyze an SRS for testability and automatically generate acceptance criteria gaps
• Produce defect density and coverage metrics for a regulatory audit
• Validate that security and architecture constraints are explicitly specified