qa-plan

Generates structured QA test plans from sprint stories and game design documents.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill qa-plan-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qa-plan
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/qa-plan
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill qa-plan-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often start a sprint without knowing what testing work is required, leading to untested features and post-mortem test plans. This Skill reads story files and GDDs upfront and produces a concrete QA plan covering automated tests, manual checks, smoke scope, and playtest sign-offs. ## Core Features & Use Cases - Story Classification: Classifies each story as Logic, Integration, Visual/Feel, UI, or Config/Data based on acceptance criteria, respecting any declared Type field. - Test Plan Generation: Produces a structured plan with automated test specs (file paths, formulas, edge cases), manual QA checklists, smoke test scope, and playtest requirements. - Story Back-filling: Optionally writes test case specs back into each story file's QA Test Cases section for traceability with dev-story and code-review workflows. - Use Case: Before a sprint begins, run the skill against the current sprint to get a complete QA plan telling developers exactly which unit and integration tests to write and which stories need playtester sign-off. ## Quick Start Ask the AI to generate a QA plan for the current sprint using the qa-plan skill and write it to the production/qa directory.

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 for a game development sprint?

Run the qa-plan skill with a sprint, feature, or story scope argument. It reads the story files and referenced GDDs, classifies each story by test type, and writes a structured plan to production/qa covering automated tests, manual checks, and playtest requirements.

How are stories classified by test type in a QA plan?

Stories are classified as Logic, Integration, Visual/Feel, UI, or Config/Data based on their acceptance criteria. If a story already declares a Type field, that value is accepted as authoritative; otherwise the type is inferred and flagged as a gap.

What happens if a story has no GDD formula reference?

The plan flags the missing formula instead of inventing test cases. Test cases must then be derived directly from the acceptance criteria, and the plan notes that the GDD Formulas section should be reviewed before writing tests.

Can the QA plan back-fill test cases into story files?

Yes. With user approval, the skill writes generated test case specs into each Logic and Integration story's QA Test Cases section, and manual verification steps for Visual/Feel and UI stories, enabling traceability with dev-story and code-review.

When should a QA plan be created during a sprint?

The plan should be generated before the sprint begins so the team knows the testing work upfront. A test plan written after implementation is treated as a post-mortem rather than a plan.