requirements-review-advisor

Selects and plans requirements review approaches from informal walkthroughs to formal Fagan inspections.

23|1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/jdm4pku/RE-Skills --skill requirements-review-advisor-jdm4pku
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: requirements-review-advisor
Source: https://github.com/jdm4pku/RE-Skills/tree/main/skills/requirements-review-advisor
Command: npx skills add https://github.com/jdm4pku/RE-Skills --skill requirements-review-advisor-jdm4pku

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Requirements defects found during development cost 10-100x more to fix than those caught in review, yet teams often run reviews that are passive presentations finding few real issues. This Skill helps you choose the right review formality level and structure the review process to maximize defect detection before implementation begins. ## Core Features & Use Cases - Review Formality Selection: Interactive questions about risk level, review scope, and available resources produce a recommendation across the spectrum from ad-hoc review to peer desk check, walkthrough, or formal Fagan inspection. - Fagan Inspection Planning: Covers the six-stage inspection process (planning, overview, preparation, meeting, rework, follow-up) with roles, entry/exit criteria, and session chunking guidance. - Defect Checklists and Metrics: Provides a requirements defect taxonomy (ambiguity, incompleteness, inconsistency, infeasibility, unverifiability, duplication, gold-plating, design-in-requirements) plus review effectiveness metrics like preparation rate and defect detection rate. - Use Case: A business analyst finishes a 45-page SRS for a regulatory compliance system and needs to plan the review. The Skill recommends a formal Fagan inspection split into three sessions with a tailored defect checklist, assigned roles, and expected defect counts. ## Quick Start Ask the agent to recommend a review approach for your completed requirements specification based on your project's risk level and team availability.

Frequently Asked Questions about requirements-review-advisor

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

FAQPage Schema
How do I choose the right requirements review approach?▼

Choose based on three factors: system risk level, review scope, and available resources. Safety-critical or business-critical systems warrant formal Fagan inspections, standard projects suit structured walkthroughs, and low-risk individual requirements only need a peer desk check.

What is the Fagan inspection process for requirements?▼

The Fagan inspection has six stages: planning, overview, preparation, meeting, rework, and follow-up. Most defects are found during independent preparation, and each stage has defined entry and exit criteria with assigned roles like moderator, author, and inspectors.

What defects should a requirements review checklist cover?▼

A requirements review checklist should check for ambiguity, incompleteness, inconsistency, infeasibility, unverifiability, duplication, gold-plating, and design details embedded in requirements. Each requirement should also be complete, correct, feasible, necessary, prioritized, unambiguous, verifiable, consistent, modifiable, and traceable.

How many pages should a requirements inspection session cover?▼

Limit inspection sessions to 10-20 pages because defect detection drops sharply after the first hour due to inspector fatigue. Split large specifications into multiple shorter sessions rather than attempting one marathon review meeting.

Why do requirements reviews fail to find real issues?▼

Reviews fail when they become passive presentations without independent preparation, when too much material is reviewed at once, or when reviewers lack a defect checklist. Requiring preparation before meetings and providing a defect taxonomy fixes these problems.

When is a formal inspection mandatory for requirements?▼

Formal inspection is mandatory for safety-critical systems regardless of team size or schedule constraints, and strongly recommended for business-critical systems with regulatory compliance needs. If resources are limited, conduct the inspection in smaller chunks over more sessions.