trw_prd_validate
Score a PRD against the V2 validation suite to determine readiness before implementation. Validates structure, content quality, compliance, and ambiguity to catch issues early.
Instructions
Score a PRD against the V2 validation suite before implementation.
Use when:
A PRD just landed and you need a READY / NEEDS-WORK verdict before coding.
You want ambiguity / completeness / traceability gates checked in one call.
Runs structure compliance, content quality, AARE-F compliance, and ambiguity analysis. Catches issues here that would otherwise cause rework.
Input:
prd_path: path to the PRD markdown file (required).
Output: ValidateResultDict with fields {total_score: float (0-100), quality_tier: str, grade: str, valid: bool, ambiguity_rate: float, completeness_score: float, traceability_coverage: float, improvement_suggestions: list[ImprovementSuggestionDict], failures: list[ValidationFailureDict], dimensions: list[DimensionScoreDict], path: str, sections_found: list[str], sections_expected: list[str], smell_findings: list[dict], ears_classifications: list[dict], readability: dict[str, float], section_scores: list[SectionScoreDict], effective_risk_level: str, risk_scaled: bool, status_drift_warnings: list[str], integrity_warnings: list[str], cache: dict}.
quality_tier values: "skeleton" | "draft" | "review" | "approved" (QualityTier enum; no "PRODUCTION" tier exists).
Example: trw_prd_validate(prd_path="docs/requirements-aare-f/prds/PRD-QUAL-074.md") → {"total_score": 87, "quality_tier": "approved", "grade": "A", "valid": true, "improvement_suggestions": []}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prd_path | No |