Agent skill
tpm-spec-verify
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.
Install this agent skill to your Project
npx add-skill https://github.com/ozten/skills/tree/main/tpm-spec-verify
SKILL.md
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-generatorfirst if missing)
Workflow
- Audit for Quality Requirements — Identify missing non-functional concerns
- Add Q-nnn entries — Security, performance, accessibility, etc.
- Write Acceptance Criteria — Happy path, edge cases, error conditions for each R-nnnn
- 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
| Tag | Category | Questions to Ask |
|---|---|---|
[PERF] |
Performance | Response times? Throughput? Caching? |
[SEC] |
Security | Auth? Input validation? Data protection? |
[AVAIL] |
Availability | Uptime requirements? Failover? Recovery? |
[SCALE] |
Scalability | Concurrent users? Data volume limits? |
[ACCESS] |
Accessibility | WCAG level? Keyboard nav? Screen readers? |
[COMPAT] |
Compatibility | Browsers? Devices? Integrations? |
[I18N] |
Internationalization | Languages? Locales? RTL support? |
[API] |
API Standards | Versioning? Rate limits? Error formats? |
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
- Happy path — Normal successful flow
- Edge cases — Boundary conditions, limits, empty states
- Error handling — Invalid input, failures, recovery
- State transitions — Before/after, concurrent access
AC Format
**Acceptance Criteria:**
- AC-R0142-01: Form accepts valid email formats (user@domain.tld)
- 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
| Do | Don't |
|---|---|
| Specific, testable conditions | Vague ("works correctly") |
| One behavior per AC | Multiple behaviors combined |
| Observable outcomes | Implementation details |
| Include error states | Only happy path |
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:
| Requirement | Feature | Priority | Status | AC Count |
|---|---|---|---|---|
| R-0142 | F-014 | Must | Draft | 5 |
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.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ozten/skills
five-whys
Root cause analysis technique for self-improvement. Use after any failure, mistake, or suboptimal outcome to find systemic causes and actionable changes. Triggers: analyzing why something went wrong, debugging repeated failures, post-mortem analysis, retrospectives, understanding root causes, reflecting on what could be improved.
ozten/skills
nano-banana-image-gen
Generate images using the `imagen` CLI (Gemini and OpenAI models). Use when the user says "nano banana", "generate an image", "create an image", "make me a picture", "image gen", "draw", "illustrate", or wants to create images from text prompts.
ozten/skills
webdev-combobox-autocomplete
Foundational patterns for building accessible autocomplete/combobox components with state management, ARIA patterns, keyboard navigation, async suggestions, and framework-agnostic implementation. Use when building autocomplete inputs, command palettes, search inputs, select replacements, or any dropdown with keyboard navigation and suggestions.
ozten/skills
ui-design-iteration
Iterates on data-intensive UI designs to improve scannability, hierarchy, accessibility, and systematization. Use when improving an existing UI, reviewing a design for UX issues, or transforming a functional-but-flat interface into a polished product.
ozten/skills
find-bugs
Adversarial three-agent bug review pipeline. Runs search → adversary → judge to find high-confidence bugs with reduced false positives. Use: /find-bugs src/
ozten/skills
webdev-filter-query-builder
Domain-specific filter query building with AST representation, operator handling, query serialization, and field-type-specific inputs. Use when building advanced filter UIs for observability tools, data analytics, search interfaces, or any system requiring structured query construction with boolean logic, comparison operators, and URL/string serialization.
Didn't find tool you were looking for?