reviewing-requirements

Validate requirements documents against codebase and documentation across three review modes.

2|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/lwndev/lwndev-marketplace --skill reviewing-requirements
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-requirements
Source: https://github.com/lwndev/lwndev-marketplace/tree/main/plugins/lwndev-sdlc/skills/reviewing-requirements
Command: npx skills add https://github.com/lwndev/lwndev-marketplace --skill reviewing-requirements

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, git, gh, and includes scripts (resource) components.

What problem does it solve?

Validates requirement documents against the codebase and docs, ensuring alignment across the lifecycle from planning to PR review. It coordinates three activation modes and provides actionable findings to keep requirements synchronized with implementation.

Core Features & Use Cases

  • Validates requirements before QA planning (standard review) to catch drift early.
  • Reconciles test plans after QA (test-plan reconciliation) to ensure bidirectional traceability.
  • Performs code-review reconciliation after PR review to surface drift and gaps.
  • Accepts a document path or an ID, detects the appropriate mode, and outputs structured findings for follow-up.

Quick Start

Provide a path to a requirements document (or a FR/AC ID) and I will run the appropriate review workflow.

Frequently Asked Questions about reviewing-requirements

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

FAQPage Schema
How do I validate requirements against my codebase to prevent drift?

To validate requirements and prevent drift, you provide a requirements document path or an ID. The tool loads the document, extracts references, verifies alignment, and outputs a structured findings report for remediation.

How do I reconcile test plans with requirements after QA?

Reconciling test plans with requirements uses the test-plan reconciliation mode to ensure bidirectional traceability. It cross-references requirement artifacts against test plans after QA execution to identify coverage gaps.

Can I check requirement alignment during a pull request code review?

Yes, you can check requirement alignment during a code review using the code-review reconciliation mode. It surfaces drift and gaps by cross-referencing the evolving software changes against the original requirements.

Do I need git and gh installed to review requirements in my repository?

Yes, you need git and gh installed along with jq to review requirements. These dependencies are required for the scripts to extract references, verify documents, and cross-reference codebase artifacts.

What is the best way to ensure documentation stays aligned with evolving software?

The best way to keep documentation aligned with evolving software is running standard, test-plan, and code-review reconciliation workflows. This validates requirements across the lifecycle from planning to PR review.

Why does requirement verification fail when cross-referencing a specific ID?

Requirement verification cross-referencing a specific ID fails when the corresponding document or artifact cannot be loaded or located. The tool requires a valid file path or an exact ID to extract and verify references.