name: tpm-spec-verify
description: Enrich a Phase Sepc/PRD with Quality Requirements (Q-nnn) and Acceptance Criteria (AC-nnnn). Use when user wants to add QA perspective, define test criteria, identify non-functional requirements, add verification steps, or prepare a Phase PRD for test planning.

PRD QA Enricher

Add Quality Requirements and Acceptance Criteria to a Phase PRD, preparing it for test planning.

Inputs Required

• Phase PRD — With R-nnnn requirements (use prd-phase-generator first if missing)

Workflow

1. Audit for Quality Requirements — Identify missing non-functional concerns
2. Add Q-nnn entries — Security, performance, accessibility, etc.
3. Write Acceptance Criteria — Happy path, edge cases, error conditions for each R-nnnn
4. Update traceability — Link ACs to requirements

Step 1: Quality Requirements Audit

Review the Phase PRD and ask: what cross-cutting concerns are missing?

Quality Categories Checklist

Writing Quality Requirements

Q-007 [COMPAT]: The system shall support Chrome, Firefox, Safari, and Edge (latest 2 versions)

**Applies to:** F-001, F-002, F-003
**Priority:** Must

Each Q-nnn should:
- Have a category tag in brackets
- List which features it applies to
- Be testable and specific

Step 2: Acceptance Criteria

For each R-nnnn, write AC-nnnn entries covering:

Coverage Categories

1. Happy path — Normal successful flow
2. Edge cases — Boundary conditions, limits, empty states
3. Error handling — Invalid input, failures, recovery
4. State transitions — Before/after, concurrent access

AC Format

**Acceptance Criteria:**
- AC-R0142-01: Form accepts valid email formats ([email protected])
- AC-R0142-02: Form rejects invalid emails with inline error message
- AC-R0142-03: Form requires non-empty name field
- AC-R0142-04: Form preserves input on validation failure
- AC-R0142-05: Submit button disabled until required fields populated

AC Writing Guidelines

Typical AC Count

• Simple requirement: 2-3 ACs
• Standard requirement: 3-5 ACs
• Complex requirement: 5-8 ACs

If a requirement needs >10 ACs, recommend splitting the requirement.

Step 3: Update Traceability

After adding ACs, update the Traceability Matrix:

Quality Requirements Numbering

Q-nnn is sequential across the entire product (like R-nnnn). Check previous Phase PRDs for last used Q-nnn.

Reference

See references/naming-conventions.md for ID format details and category tags.