QA Test Planner

name: qa-test-planner description: Generate comprehensive test plans, manual test cases, regression test suites, and bug reports for QA engineers. Use when creating test strategy for a feature, building regression suites, writing manual test cases with step-by-step instructions, or documenting bugs. Includes Figma design validation support. tags: [qa, test-plan, regression, manual-testing, bug-report]

QA Test Planner

Comprehensive QA engineering toolkit for creating test plans, generating manual test cases, building regression suites, validating designs, and documenting bugs.

When to Use

• Creating test strategy for a new feature or epic
• Writing manual test cases with step-by-step instructions
• Building regression test suites (smoke, full, targeted)
• Comparing implementation against Figma designs
• Documenting bugs with reproducible steps

Quick Reference

Workflow

Your Request
    |
    v
1. ANALYZE
   - Parse feature/requirement
   - Identify test types needed
   - Determine scope and priorities
    |
2. GENERATE
   - Create structured deliverables
   - Apply templates and best practices
   - Include edge cases and boundary values
    |
3. VALIDATE
   - Check completeness
   - Verify traceability to requirements
   - Ensure steps are actionable
    |
    v
QA Deliverable Ready

1. Test Plans

A test plan defines the strategy, scope, and approach for testing a feature.

Structure

# Test Plan: {Feature Name}

## Scope
- **In Scope**: [What will be tested]
- **Out of Scope**: [What will NOT be tested]

## Test Strategy
- **Functional Testing**: [Approach]
- **Integration Testing**: [Approach]
- **Performance Testing**: [If applicable]
- **Security Testing**: [If applicable]

## Environment Requirements
- Browser/OS matrix
- Test data requirements
- External service dependencies

## Entry Criteria
- [ ] Feature code complete and deployed to staging
- [ ] Test data prepared
- [ ] Test accounts created

## Exit Criteria
- [ ] All critical test cases pass
- [ ] No open P0/P1 bugs
- [ ] Regression suite passes
- [ ] Performance benchmarks met

## Risk Assessment
| Risk | Impact | Mitigation |
|---|---|---|
| [Risk description] | High/Med/Low | [Mitigation plan] |

## Timeline
| Phase | Duration | Owner |
|---|---|---|
| Test case creation | X days | QA |
| Execution | X days | QA |
| Bug fix verification | X days | QA + Dev |

2. Manual Test Cases

Each test case must be unambiguous and reproducible by someone unfamiliar with the feature.

Structure

## TC-{ID}: {Test Case Title}

**Priority**: P0/P1/P2/P3
**Type**: Functional / Integration / Edge Case / Negative
**Preconditions**:
- User is logged in as {role}
- {Data setup requirements}

### Steps

| Step | Action | Expected Result |
|---|---|---|
| 1 | Navigate to {URL/page} | {Page} is displayed |
| 2 | Enter "{value}" in {field} | Value is accepted |
| 3 | Click "{button}" | {Expected behavior} |
| 4 | Verify {element} | Shows "{expected text/state}" |

**Test Data**: {Specific test data needed}
**Notes**: {Edge cases or special considerations}

Test Case Types

3. Regression Suites

Smoke Tests (15-30 min)

Critical path tests that verify the application is stable enough for deeper testing.

## Smoke Test Suite

**Execution time**: ~20 minutes
**When to run**: Every deployment, every build

| # | Test | Steps | Expected | Priority |
|---|---|---|---|---|
| 1 | App loads | Open homepage | Page loads <3s, no errors | P0 |
| 2 | Login works | Login with valid creds | Dashboard displayed | P0 |
| 3 | Core feature works | [Primary user action] | [Expected result] | P0 |
| 4 | Logout works | Click logout | Redirected to login | P0 |

Full Regression (2-4 hours)

Comprehensive test execution covering all features.

Targeted Regression (30-60 min)

Tests focused on areas affected by a specific change.

Execution Order

1. Smoke tests (stop if any fail)
2. Authentication & authorization
3. Core business flows
4. Integration points
5. Edge cases & boundary values
6. UI/UX validation
7. Performance checks

4. Figma Design Validation

Compare implementation against Figma designs component by component.

Validation Checklist

## Design Validation: {Page/Component Name}

**Figma**: [Figma URL]
**Implementation**: [Staging URL]

### Layout
- [ ] Component positioning matches design
- [ ] Spacing between elements matches (check padding/margin)
- [ ] Responsive breakpoints match design specs

### Typography
- [ ] Font family correct
- [ ] Font sizes match at all breakpoints
- [ ] Font weights match
- [ ] Line heights match
- [ ] Letter spacing matches

### Colors
- [ ] Background colors match
- [ ] Text colors match
- [ ] Border colors match
- [ ] Hover/active state colors match

### Interactive States
- [ ] Default state matches
- [ ] Hover state matches
- [ ] Active/pressed state matches
- [ ] Focus state matches (keyboard)
- [ ] Disabled state matches
- [ ] Loading state matches
- [ ] Error state matches
- [ ] Empty state matches

### Assets
- [ ] Icons correct and sized properly
- [ ] Images have correct aspect ratios
- [ ] SVGs render correctly

5. Bug Reports

Structure

## BUG-{ID}: {Specific title describing the issue}

**Severity**: P0 (Blocker) / P1 (Critical) / P2 (Major) / P3 (Minor)
**Component**: {Affected component/module}
**Environment**: {Browser, OS, device, staging/prod}
**Reporter**: {Name}
**Date**: {YYYY-MM-DD}

### Description
{One sentence describing the bug}

### Steps to Reproduce
1. {Exact step}
2. {Exact step}
3. {Exact step}

### Expected Result
{What should happen}

### Actual Result
{What actually happens}

### Evidence
- Screenshot: {link}
- Console errors: {paste}
- Network requests: {relevant details}

### Workaround
{If known, describe workaround}

### Additional Context
{Browser console errors, related tickets, recent changes}

Severity Guide

Anti-Patterns

Verification Checklist

Test Plan:

• Scope clearly defined (in/out)
• Entry/exit criteria specified
• Risks identified with mitigations
• Timeline realistic

Test Cases:

• Each step has expected result
• Preconditions documented
• Test data available
• Priority assigned

Bug Reports:

• Reproducible steps (tested twice)
• Environment documented
• Evidence attached
• Severity/priority set

References

• Based on softaworks/agent-toolkit qa-test-planner (MIT License)