| name | tracking-regression-tests |
| description | Track and manage regression test suites across releases.
Use when performing specialized testing.
Trigger with phrases like "track regressions", "manage regression suite", or "validate against baseline".
|
| allowed-tools | Read, Write, Edit, Grep, Glob, Bash(test:regression-*) |
| version | 1.26.0 |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| license | MIT |
| tags | ["testing","tracking-regression"] |
| compatibility | Designed for Claude Code, also compatible with Codex and OpenClaw |
Regression Test Tracker
Overview
Track, manage, and maintain regression test suites across releases to ensure previously fixed bugs stay fixed and existing features remain stable. Maps regression tests to bug tickets, monitors test health over time, and identifies gaps where fixed bugs lack corresponding regression tests.
Prerequisites
- Test framework with tagging or marking support (
@tag, pytest.mark, JUnit @Tag)
- Bug tracking system with issue IDs (GitHub Issues, Jira, Linear)
- Git history accessible for correlating bug fixes with test additions
- Existing test suite with named test cases
- CI pipeline producing test result artifacts (JUnit XML or JSON)
Instructions
- Scan the codebase with Grep for bug-fix commits by searching commit messages for patterns like
fix:, bugfix, closes #, or Jira ticket IDs.
- For each bug-fix commit, check whether a corresponding regression test exists:
- Search test files for the bug ticket ID in test names, comments, or tags.
- Verify the test exercises the specific code path that was fixed.
- Flag fixes without regression tests as coverage gaps.
- Create a regression test inventory file (
regression-tests.json or regression-tests.md) mapping:
- Bug ticket ID to test file and test name.
- Severity of the original bug (critical, high, medium, low).
- Date the regression test was added.
- Current test status (passing, failing, skipped).
- Tag existing regression tests with metadata for traceability:
- Jest: Add
// @regression BUG-123 comments or use describe.each with ticket data.
- pytest: Apply
@pytest.mark.regression and @pytest.mark.bug("BUG-123") markers.
- JUnit: Use
@Tag("regression") and @DisplayName("BUG-123: description").
- Generate a regression coverage report showing:
- Total bugs fixed vs. bugs with regression tests (coverage percentage).
- Untested regressions ranked by severity.
- Tests that have become flaky or were disabled.
- Set up a CI check that fails the build if a bug-fix PR does not include at least one regression test.
- Schedule periodic audits (weekly or per-release) to verify all regression tests still pass and remain relevant.
