qa-plan

Generate structured QA test plans from sprint story files and GDDs.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/easonlao/jiazi-game --skill qa-plan-easonlao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-plan
Source: https://github.com/easonlao/jiazi-game/tree/main/.claude/skills/qa-plan
Command: npx skills add https://github.com/easonlao/jiazi-game --skill qa-plan-easonlao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents late surprises by turning sprint or feature scope into a clear, structured QA plan that developers, QA, and designers can follow before implementation starts.

Core Features & Use Cases

  • Sprint/Feature/Story Scoping: Selects the right stories from production sprint files, epic indexes, or a specific story path, then summarizes how many stories are in scope.
  • Story-Type Classification: Classifies each story into Logic, Integration, Visual/Feel, UI, or Config/Data based on acceptance criteria and any provided Type field.
  • Test Plan Generation: Produces a plan covering automated test file paths, manual verification steps, smoke test scope, and playtest sign-off requirements, with guardrails about missing GDD formula references.

Quick Start

Ask the qa-plan skill with the argument sprint to generate a complete QA test plan for the current sprint and save it under production/qa/.

Frequently Asked Questions about qa-plan

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

FAQPage Schema
How do I generate a QA test plan from sprint scope and acceptance criteria?

To generate a QA test plan, parse in-scope story files and referenced GDDs to extract acceptance criteria, then classify stories into test types and output a structured markdown plan. This translates sprint scope into unit, integration, manual, smoke, and playtest verification steps.

What is the best way to translate story acceptance criteria into smoke testing and playtest sign-off steps?

Translating acceptance criteria into smoke testing and playtest sign-off steps requires classifying each story into Logic, Visual, or Config types. This classification maps criteria directly to specific automated test file paths and manual verification procedures.

Does qa-plan work with GDD formula references for test planning?

Yes, qa-plan works with GDD formula references by reading them during scope parsing. It includes guardrails in the test plan to flag any missing GDD formula references, ensuring accurate verification step generation for logic and integration stories.

How do I classify sprint stories into test types like Logic, Integration, or UI for automation coverage?

Classify sprint stories into Logic, Integration, Visual, UI, or Config/Data types by analyzing their acceptance criteria and any provided Type field. This story-type classification determines the appropriate automation coverage and manual verification paths needed.

Can I generate an individual story QA test plan instead of a full sprint test plan?

Yes, you can generate an individual story QA test plan by providing a specific story path instead of a sprint or epic scope. The plan reads that single story file and its referenced GDDs to output tailored verification steps.

What limitations exist when generating QA plans for projects without defined acceptance criteria?

Generating QA plans for projects without defined acceptance criteria limits the ability to classify stories into test types and map verification steps. The process relies on parsing these criteria to produce unit, integration, and smoke test coverage accurately.