regression-suite

Audit regression test coverage against GDD critical paths and maintain a manifest.

Updated Dec 22, 2024
One-click install
npx skills add https://github.com/imgamer/AILearn --skill regression-suite-imgamer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: regression-suite
Source: https://github.com/imgamer/AILearn/tree/main/game-studios/Claude-Code-Game-Studios-e375f/.claude/skills/regression-suite
Command: npx skills add https://github.com/imgamer/AILearn --skill regression-suite-imgamer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents game regressions by ensuring bug fixes are backed by regression coverage mapped to your GDD critical paths, and by detecting when new features drift coverage away from what the game depends on.

Core Features & Use Cases

  • Regression suite as a curated manifest: Maintains a single source of truth in tests/regression-suite.md that indexes the specific tests that must stay passing.
  • Coverage mapping to GDD critical paths: In audit mode, checks acceptance criteria, formulas, and edge cases against unit/integration tests to label coverage as COVERED, PARTIAL, MISSING, or EXEMPT.
  • Fixed-bug regression verification: In update mode, scans closed/fixed bugs and verifies regression tests exist so repeat failures are unlikely.
  • Coverage drift detection: Flags likely staleness when new systems/stories have insufficient regression coverage.

Quick Start

Run /regression-suite audit to identify GDD critical paths that are missing regression coverage.

Frequently Asked Questions about regression-suite

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

FAQPage Schema
How do I map regression tests to GDD critical paths in game development?

To verify bug fixes with regression tests, run an update mode that scans closed bugs in `production/qa/bugs/*.md` and checks if matching regression tests exist. This fixed-bug regression verification prevents repeat failures by ensuring every resolved issue has corresponding test coverage before passing release gates.

What is a regression suite manifest and how does it prevent game regressions?

A regression suite manifest is a curated single source of truth maintained in `tests/regression-suite.md` that indexes specific tests which must stay passing. It prevents game regressions by detecting coverage drift when new systems have insufficient regression coverage, flagging likely staleness before release gates.

How do I audit test inventory for missing regression coverage?

You audit test inventory for missing regression coverage by scanning the `tests/` directory and parsing GDD systems from `design/gdd/systems-index.md`. The audit mode generates coverage and drift reports that label critical path coverage as COVERED, PARTIAL, MISSING, or EXEMPT to identify gaps.

Does regression testing for game QA work without external dependencies?

Regression testing for game QA works without external dependencies, relying solely on reading and writing `tests/regression-suite.md`, scanning test inventory under `tests/`, parsing GDD systems, and analyzing closed bugs. It requires no additional components to maintain manifests and audit coverage drift.

When should I detect coverage drift in my regression suite?

You should detect coverage drift when new systems or stories are added to your game. The Skill flags likely staleness by checking if new features have insufficient regression coverage mapped to GDD critical paths, preventing new features from drifting coverage away from what the game depends on before release gates.