Early PreviewJoin us on the road to v1.0 — help shape the future of specification engineering.Get Involved
SPECLAN mascotSPECLAN

QA Workflow

The QA workflow covers the final verification phase where the QA team validates completed development work and transitions specifications from under-test to released status. This process ensures that only properly verified features reach end users.

Overview

When development work reaches the under-test status, the QA team takes ownership of the validation process. After successful verification against acceptance criteria and test scenarios, the team transitions the specification to released status.

under-test  ──>  released

If testing fails, the work returns to an earlier status for correction.

Workflow Stages

Under-Test (Starting Point)

The development team has signaled that implementation is complete and the specification is ready for verification.

What the QA team receives:

  • A specification with clearly defined acceptance criteria
  • Implementation that the development team considers complete
  • Full traceability from the specification back to business goals
  • Visibility into what changed compared to previous versions

Testing in Progress

The QA team conducts validation activities.

Who owns it: QA team

What happens:

  • QA team members review the specification's acceptance criteria
  • Testing is performed against the implemented functionality
  • Test results are recorded
  • Issues found are documented and communicated

What QA team members can do:

  • View all work items currently in under-test status
  • Access the details of work items they need to test
  • Indicate when testing has passed or failed
  • Transition items to released when validation is complete

Released (Transition Target)

The specification has been verified and is available to end users.

Who performs the transition: Authorized QA team member

What this signals:

  • All acceptance criteria have been verified
  • The implementation meets the specification requirements
  • The feature is approved for production use

Key rules:

  • Only users with QA team authorization can transition items to released
  • Work items must be in under-test status before they can be released
  • The release transition must capture an audit trail of who approved the release
  • Work items cannot skip the under-test phase

Test Failure

When testing reveals issues that need correction.

What happens:

  • The QA team member indicates the test failure
  • The work item returns to an earlier status for rework
  • The development team addresses the issues
  • The item returns to under-test for re-verification

Transition Criteria

From To Requirements
under-test released All acceptance criteria verified; authorized QA team member approves
under-test (earlier status) Test failure documented; returned for rework

QA Team Responsibilities

  1. Review acceptance criteria -- understand exactly what needs to be verified
  2. Validate implementation -- test against the specification, not assumptions
  3. Document results -- record what was tested and the outcome
  4. Approve or reject -- make a clear decision on each work item
  5. Maintain the audit trail -- every decision should be traceable

Status History

Every QA transition is recorded with:

  • The QA team member who performed the action
  • A timestamp of the decision
  • Whether the item was released or returned for rework
  • Context or notes about the decision

Tips for QA Teams

  1. Start with the acceptance criteria -- they define the pass/fail boundaries
  2. Check the specification hierarchy -- understand the feature's context within goals
  3. Verify traceability -- ensure tests map back to acceptance criteria
  4. Communicate clearly when returning items for rework -- the development team needs to understand what failed
  5. Use the SPECLAN tree view to quickly see all items awaiting testing

Related Topics