qa-plan

Generate structured QA test plans from story files and GDD acceptance criteria.

Updated May 13, 2026
One-click install
npx skills add https://github.com/FrancisVarga/the-dream-machine --skill qa-plan-francisvarga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-plan
Source: https://github.com/FrancisVarga/the-dream-machine/tree/main/.claude/skills/qa-plan
Command: npx skills add https://github.com/FrancisVarga/the-dream-machine --skill qa-plan-francisvarga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

QA planning often happens too late, after implementation, which turns testing into a post-mortem instead of a proactive quality gate.

Core Features & Use Cases

  • Scope-driven QA planning: Generate a QA plan for a sprint, a feature, or a specific story by collecting the in-scope story files and their linked GDDs.
  • Test type classification: Classify each story into Logic, Integration, Visual/Feel, UI, or Config/Data based on declared Type: or inferred classification from acceptance criteria.
  • Actionable test artifacts: Produce a plan that specifies automated test file locations, manual verification steps, smoke test scope, and playtest sign-off requirements.

Quick Start

Run qa-plan with the argument sprint to generate a production-ready QA plan for the current sprint’s in-scope stories.

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 before implementation starts?

QA planning shifts left by reading story files and linked GDD acceptance criteria to classify tests into automated, manual, smoke, and playtest categories before implementation begins.

How do I structure sprint workflow test cases for smoke testing and manual verification?

Structure sprint test cases by classifying stories into Logic, Integration, Visual/Feel, UI, or Config/Data types, then outputting manual checklists, smoke test scope, and playtest sign-off paths.

What is scope-driven QA planning for a sprint or feature?

Scope-driven QA planning collects in-scope story files and their referenced GDD acceptance criteria to produce a complete test plan covering automated test requirements and manual verification steps for a sprint or feature.

Can I use GDD acceptance criteria to determine what to automate versus what to verify manually?

Yes, GDD acceptance criteria are read to classify each story and determine which requirements need automated test files, manual QA checklists, or playtest sign-off evidence paths.

Does test case design classification support both declared and inferred story types?

Test case design classification supports declared story types explicitly, and when undeclared, it infers classification into Logic, Integration, Visual/Feel, UI, or Config/Data from the acceptance criteria.