qa-plan

Generates structured QA test plans from game design documents and story files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a QA plan after implementation turns it into a post-mortem rather than a plan. This Skill reads sprint stories and their referenced GDDs before work begins, classifies each story by test type, and produces a concrete plan covering automated tests, manual verification, smoke test scope, and playtest sign-off requirements. ## Core Features & Use Cases - Story Classification: Assigns each story a type (Logic, Integration, Visual/Feel, UI, Config/Data) based on its declared Type field or inferred from acceptance criteria. - Test Plan Generation: Produces a structured plan with automated test file paths, edge cases from GDD Formulas and Edge Cases sections, manual QA checklists, and a Definition of Done. - Story Back-filling: Optionally writes test case specs back into each story file's QA Test Cases section for traceability with code review and story completion workflows. - Use Case: Before a sprint starts, run the Skill against the current sprint to get a plan telling developers exactly which unit and integration tests to write, which stories need designer sign-off, and what the smoke test must cover. ## Quick Start Ask the AI to generate a QA plan for the current sprint using the qa-plan skill.

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 argument. It reads the in-scope story files and referenced GDDs, classifies each story by test type, and writes a plan to production/qa/ covering automated tests, manual checks, and smoke test scope.

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

Stories with a declared Type field in their header are accepted as-is. Otherwise the type is inferred from acceptance criteria: formulas and state transitions indicate Logic, cross-system interactions indicate Integration, animation and feel indicate Visual/Feel, and menus or HUD elements indicate UI.

What happens if a story has no GDD reference or formula?

The plan notes the gap but does not block. Test cases are then derived from acceptance criteria alone, and the plan flags that the GDD Formulas section should be reviewed before writing tests rather than inventing formulas.

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 code review and story completion workflows.

When should a QA plan be created in a sprint workflow?

Before the sprint begins or when starting a major feature. A plan written after implementation is a post-mortem; creating it upfront tells developers which test files to create before stories can be marked done.