ptp-review-prd

Reviews epic PRD documents against a severity-classified rubric before planning.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-review-prd-almogmaayan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ptp-review-prd
Source: https://github.com/AlmogMaayan/ptp/tree/main/skills/ptp-review-prd
Command: npx skills add https://github.com/AlmogMaayan/ptp --skill ptp-review-prd-almogmaayan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Thin or placeholder PRDs silently produce thin implementation plans. This Skill audits an epic's PRD (openspec/changes/<id>/prd.md) before it feeds the planning stage, catching missing sections, vague acceptance criteria, and scope inconsistencies early. ## Core Features & Use Cases - Read-only PRD audit: Checks the PRD against a 7-point rubric covering schema completeness, requirement traceability, testable acceptance criteria, and scope/non-goal consistency, without editing any file. - Severity-classified verdicts: Classifies findings as Critical/High/Medium/Low and issues PASS, WARN, or FAIL verdicts gated by a configurable review.minSeverity threshold. - Dual-agent dispatch: Runs the review in-session with Claude or as a read-only codex exec dispatch depending on the resolved roles.main configuration. - Use Case: After authoring a PRD with /ptp:prd for an epic, run the review to confirm the PRD is complete and testable before handing it to /ptp:plan. ## Quick Start Ask the agent to review the PRD for an epic by running the ptp-review-prd pass with a selector such as epic:0001 or no argument to review all active epics.

Frequently Asked Questions about ptp-review-prd

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

FAQPage Schema
How do I review a PRD before planning an epic?▼

Run the review with a selector like epic:0001, story:NN, or a bare change id; omitting the argument reviews all active epics. The pass reads openspec/changes/<id>/prd.md, applies a 7-check rubric, and reports a PASS, WARN, or FAIL verdict with findings grouped by severity.

What does the PRD review rubric check?▼

The rubric checks that the PRD file exists and is non-placeholder, all schema sections are present, requirements split into functional and non-functional and trace to goals, acceptance criteria are testable, scope matches non-goals, goals are measurable, and dependencies, risks, and open questions contain real content.

Can the PRD review run with Codex instead of Claude?▼

Yes. When roles.main resolves to codex, the review runs as a read-only codex exec -s read-only dispatch using the same rubric. The codex binary must be on PATH; if absent, the pass stops and tells you to install codex or set roles.main back to claude.

Does the PRD review edit or fix the PRD file?▼

No. The review is strictly read-only: it edits nothing, runs no git, no branch guard, and no openspec validate. On WARN or FAIL it recommends re-running /ptp:prd to revise the document rather than hand-editing it.

What happens when the PRD file is missing?▼

A missing prd.md is reported as a Critical finding, which always produces a FAIL verdict regardless of the configured severity threshold. The recommended next step is to author the PRD first with /ptp:prd before planning.

How does the review.minSeverity threshold affect the verdict?▼

The threshold, resolved from layered ptp config with default low, determines which findings block. Findings below the threshold are still listed but marked non-blocking; only actionable Critical findings cause FAIL and actionable High findings cause WARN.