Step 8: End-to-End Tests (FINAL GATE)

Prerequisites

□ GATE 7 PASSED (UI tests complete)
□ All UI tests passing
□ Backend running
□ Database accessible

Process

1. Load Context (FINAL REVIEW)

cat specs/{type}/{feature-name}.md           # Spec (source of truth)
cat api-contracts/{feature}.yaml             # API contract
cat tests/unit/services/{feature}*.test.ts   # Backend unit tests
cat tests/integration/{feature}*.test.ts     # API tests
cat tests/unit/components/{feature}/*.tsx    # Frontend unit tests
cat tests/ui/{feature}/*.spec.ts             # UI tests
cat skills/test-patterns-ui.md               # UI/E2E test patterns
cat skills/ux-patterns.md                    # UX patterns (a11y, responsive, forms)
cat skills/gate-8-e2e.md                     # Gate 8 criteria

2. Map Acceptance Criteria

Criterion	Test File	Status
AC1: GIVEN... WHEN... THEN...	e2e/happy-path.spec.ts	□
AC2: GIVEN... WHEN... THEN...	e2e/error-handling.spec.ts	□

3. Delegate to Test Writer

Use Task tool with test-writer agent:

Write E2E tests for {feature-name}:
- Complete user journeys (full stack)
- Use data-testid for element selection
- Every acceptance criterion from spec
- Every edge case from spec
- Database state verification after actions
- Follow test-patterns-ui skill
- Follow ux-patterns skill (accessibility, responsive, forms)

4. Key Requirements

Element Selection:

• data-testid first priority
• id second priority
• No CSS/XPath selectors

Full Stack Verification:

• Frontend → API → Database
• Data persists correctly
• Auth/session works
• All integrations working

Edge Cases:

• Empty input tested
• Invalid input tested
• Network failure + recovery
• Session timeout + re-auth

Stability:

• Run 3x → all pass
• No flaky tests
• Total runtime < 5 minutes

5. Database Verification

// After each mutation, verify DB state
const res = await request.post('/api/users').send(data);
const dbUser = await db.users.findById(res.body.id);
expect(dbUser.email).toBe(data.email);

6. Validate Gate (FINAL)

Use Task tool with gate-keeper agent:

Validate GATE 8 for {feature-name}

See gate-8-e2e skill for all 18 criteria.

Completion

When GATE 8 passes:

## {feature-name}
- [x] Step 1-8: All GATES PASSED ✓

STATUS: ✅ COMPLETE

Feature ready for: code review → merge → deploy

Output

• E2E tests: tests/e2e/{feature}/
• Final validation report
• Progress update: COMPLETE