workflow-test.md 2.1 KB


name: acceptance-test description: Test the implementation against the specification

borrows_from: Phase 5 T

Acceptance Test

Goal: Validate the implementation against the specification's acceptance criteria before deploying.


INITIALIZATION

Design Log

Read {output_folder}/_progress/00-design-log.md. Check Current and Backlog for context.

Steps

Step 1: Load Test Context

Gather everything needed for testing:

  1. Read specification from [D] Design Solution
  2. Read scenario from [S] Scope Improvement
  3. Review implementation diff from [I] Implement
  4. Extract acceptance criteria into a test checklist

Step 2: Prepare Test Environment

Ensure the implementation is running and testable:

  1. Confirm branch is checked out: evolution/[scenario-name]
  2. Start local development server if needed
  3. Navigate to the affected page/view
  4. Note the URL and any required test data

Step 3: Execute Tests

For each acceptance criterion:

# Criterion Steps Expected Actual Pass?
1 [From spec] [How to test] [Expected result] [What happened] Y/N
2 ... ... ... ... ...

Also test:

  • Responsive: Check all breakpoints defined in spec
  • Edge cases: Empty states, long content, error states
  • Regression: Verify nothing else broke on the page
  • Cross-browser: If specified in project requirements

Step 4: Document Results

Create test report at {output_folder}/evolution/test-reports/:

# Test Report: [Scenario Name]

## Summary
[X/Y criteria passed]

## Results
[Test table from Step 3]

## Issues Found
[List any failures with severity and description]

## Recommendation
[Pass / Pass with notes / Fail — needs rework]

Step 5: Handle Failures

If tests fail:

  • Minor issues → Fix in the same branch, retest
  • Design issues → Route back to [D] Design Solution
  • Scope creep → Log as separate improvement target for next cycle

AFTER COMPLETION

  1. Update design log
  2. Suggest next action
  3. Return to activity menu