mp-prd-review

Review PRD implementation diffs and generate a PHASE_END document with categorized findings.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-prd-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mp-prd-review
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-prd-review
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-prd-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reduces risk at the end of a PRD phase by systematically reviewing the full PRD implementation across code changes, architecture, cleanup, security, performance, and documentation.

Core Features & Use Cases

  • Automated PRD-end review: Pulls the PRD sub-issues, their merged PRs, aggregates diffs, and analyzes cross-PR patterns.
  • Parallel expert scanning: Runs multiple targeted analyses (spec alignment, code quality, best practices, security, performance, error handling, architecture, dead code/cleanup, documentation, unresolved items).
  • Actionable synthesis + HITL gate: Deduplicates findings, categorizes by severity, writes a PHASE_END document, and waits for user approval before executing fixes.

Quick Start

Run mp-prd-review for PRD issue number 42 to generate a prioritized set of review findings and an optional execution plan after you confirm.

Frequently Asked Questions about mp-prd-review

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

FAQPage Schema
How do I review a PRD implementation for code quality and security gaps?

To review a PRD implementation, you can aggregate merged PRs and sub-issues to compute a diff against the merge base, then run parallel scans for code quality, security, and architecture gaps. This identifies cross-PR patterns and classifies findings by severity.

What is a PRD phase-end quality gate and when do I need it?

A PRD phase-end quality gate is a comprehensive review process that validates spec coverage, checks cross-PR patterns, and identifies security or documentation gaps. You need it during PRD wrap-ups to systematically reduce risk before closing a development phase.

How do I generate a PHASE_END review document from GitHub issues?

You generate a PHASE_END review document by collecting PRD sub-issues and merged PRs, running parallel sub-analyses on the aggregate diff, and synthesizing findings into Critical, Important, and Minor categories before waiting for user approval.

Can I run automated spec coverage validation against merged PRs?

Yes, you can run automated spec coverage validation by pulling PRD sub-issues and their merged PRs, computing an aggregate diff against the correct merge base, and scanning for unresolved items to ensure the implementation aligns with the specification.

What is the best way to identify dead code and cleanup needs after a PRD phase?

The best way to identify dead code and cleanup needs is by running targeted parallel sub-analyses on the aggregate diff of merged PRs. This scans for architecture gaps, dead code, and cleanup requirements, deduplicating findings into a prioritized review document.

Does the PRD review process require manual approval before executing fixes?

Yes, the PRD review process requires a user-confirmed Human-in-the-Loop (HITL) gate before executing fixes. After generating the PHASE_END review document and classifying findings by severity, the system waits for your explicit approval to proceed.