# Check Prd Alignment

> Compare current code changes against a PRD to find gaps, deviations, and opportunities. Use before opening a PR, after finishing a feature, or to verify requirement coverage. Use when this capability is needed.

- Skill: `tomevault-io/check-prd-alignment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/check-prd-alignment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/check-prd-alignment/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/check-prd-alignment

---


# Check PRD alignment

## Trigger

User wants to verify their implementation matches the product requirements and find opportunities to better achieve the PRD's goals.

## Workflow

1. Identify what changed — run `git diff` against the base branch to see all modifications.
2. Find the relevant PRD:
   - Ask the user which PRD to check against.
   - Search ChatPRD documents using `search_documents` with keywords from the branch or commit messages.
   - Also check the local `prd/` directory for saved specs.
3. Fetch the full PRD using `get_document`.
4. Extract all requirements, acceptance criteria, and — critically — the user and business goals the PRD is trying to achieve.
5. For each requirement, assess:
   - **Covered**: implemented and matching the spec
   - **Partial**: started but incomplete or missing edge cases
   - **Missing**: not addressed in the current changes
   - **Deviated**: implemented differently than specified
6. Review the implementation through the lens of the PRD's stated goals. For each goal, identify **Opportunity** items — places where the UX or implementation could be improved to better achieve the goal. Examples:
   - A flow that technically meets the spec but adds unnecessary friction
   - An edge case where a better error message or fallback would improve the experience
   - A place where the implementation could be more delightful or intuitive than what was specced
   - A data model or API design choice that would better support the stated business goal
7. Produce a coverage report with:
   - Requirement-by-requirement status
   - Specific code references for covered items
   - Actionable notes for gaps and deviations
   - **Opportunity** items tied back to specific PRD goals

## Guardrails

- Be specific — cite file paths and line ranges, not vague summaries.
- Distinguish between intentional trade-offs and accidental omissions.
- Don't flag requirements that are explicitly marked as out-of-scope or future work in the PRD.
- Keep **Opportunity** items grounded and actionable — tie each one to a specific PRD goal and explain the concrete improvement.

## Output

- Alignment report (covered / partial / missing / deviated)
- **Opportunity** items with goal references and suggested improvements
- Specific gaps with suggested next steps
- Summary of overall coverage

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/chatprd) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->

