qa-test-management

Automate QA test file naming, directory structure, and status transitions.

14|1|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/jpoutrin/product-forge --skill qa-test-management
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-test-management
Source: https://github.com/jpoutrin/product-forge/tree/main/plugins/product-design/skills/qa-test-management
Command: npx skills add https://github.com/jpoutrin/product-forge --skill qa-test-management

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves?

Managing QA test cases with consistent naming, structured organization, clear status transitions, and traceability to requirements is crucial for effective quality assurance. Without proper management, tests can become disorganized and difficult to track. This Skill ensures consistent QA test organization.

Core Features & Use Cases

  • Naming Conventions: Automatic application of standard naming for QA test files (QA-YYYYMMDD-###-feature-name.md).
  • Directory Structure: Maintenance of an organized qa-tests/ structure with draft/, active/, executed/, and archived/ subdirectories.
  • Status Lifecycle: Enforcement of a clear test status workflow (DRAFT → ACTIVE → EXECUTED → ARCHIVED) with validation of transitions.
  • Required Metadata: Ensures all test files include essential information like Test ID, Feature, Application, URL, Status, and Priority.
  • PRD Traceability: Establishes clear links between QA tests and Product Requirements Document (PRD) sections.
  • Use Case: Creating a new QA test plan for a feature, moving a test from DRAFT to ACTIVE, logging test execution results, linking tests to PRD requirements, or archiving outdated tests.

Quick Start

Use the qa-test-management skill to generate a template for a new QA test file, including all required metadata and sections.

Frequently Asked Questions about qa-test-management

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

FAQPage Schema
How do I organize and track QA test cases with consistent naming and status workflow?

QA test management automates consistent naming (QA-YYYYMMDD-###-feature-name.md), organized directory structure (draft, active, executed, archived), and enforced status transitions (DRAFT → ACTIVE → EXECUTED → ARCHIVED). This ensures traceability, prevents disorganization, and maintains clear test lifecycle tracking across your quality assurance process.

What metadata should QA tests include for traceability and requirements linkage?

QA tests require essential metadata: Test ID, Feature, Application, URL, Status, and Priority. The Skill enforces these fields and establishes PRD traceability links, enabling you to connect tests directly to Product Requirements Document sections and maintain audit-ready documentation of test-to-requirement relationships.

Can I automate test lifecycle management from draft through archival?

Yes. The Skill enforces strict status transitions and validates workflow progression, automatically applying naming conventions and directory placement as tests move through draft, active, executed, and archived states. You can log execution results, capture evidence, and apply archival rules without manual state management.

Do I need documentation standards for effective test case management?

Standardized documentation is essential for test traceability and team collaboration. This Skill applies required metadata fields and naming conventions to eliminate ambiguity, ensure consistent test organization, and make execution history and evidence capture retrievable across your QA lifecycle.

How do I link QA tests to product requirements for full traceability?

The Skill establishes PRD traceability by including requirement linkage in test metadata, enabling you to connect each test case to specific Product Requirements Document sections and create bidirectional traceability for compliance and impact analysis.

What happens when test cases become outdated or no longer needed?

The Skill implements standardized archival rules that move executed or obsolete tests to the archived directory while preserving execution history and evidence. This maintains a clean active test set while keeping historical records for audit and reference purposes.