Testing Code

Testing Code

Core Workflow

Test writing follows a systematic approach: determine scope, understand patterns, map to requirements, write tests, verify coverage.

1. Determine Test Scope

Read project documentation:

• docs/user-stories/US-###-*.md for acceptance criteria to test
• docs/feature-spec/F-##-*.md for technical requirements
• docs/api-contracts.yaml for API specifications
• Existing test files to understand patterns

Choose test types needed:

• Unit tests: Individual functions, pure logic, utilities
• Integration tests: Multiple components working together, API endpoints
• Component tests: UI components, user interactions
• E2E tests: Complete user flows, critical paths
• Contract tests: API request/response validation
• Performance tests: Load, stress, benchmark testing

2. Understand Existing Patterns

Investigate current test approach:

• Test framework (Jest, Vitest, Pytest, etc.)
• Mocking patterns and utilities
• Test data fixtures and setup/teardown
• Assertion styles

Use code-finder agents if unfamiliar with test structure.

3. Map Tests to Requirements

Convert 3-5 acceptance criteria to specific test cases across test types:

Example mapping:

## User Story: US-101 User Login