QA and Eval
Purpose
Prove the important behavior works and the important risks are covered. Make verification practical, visible, and tied to acceptance criteria.
Change context
- Collect requirements, acceptance criteria, changed files, and risk notes.
- Identify the minimum test set that covers the behavior and highest risks.
- Separate automated checks from manual smoke checks.
- Decide what cannot be verified in this environment and how to report it honestly.
Change method
- Map each acceptance criterion to a validation method.
- Run existing tests before inventing new ones when that gives useful signal.
- Add focused tests when behavior changed and no existing test covers it.
- For UI work, verify real rendering and main workflows when possible.
- For migrations or data changes, verify rollback or safe failure behavior.
- Summarize pass/fail evidence with commands, scenarios, and residual risk.
Engineering constraints
- Use Context7 MCP for current library, framework, platform, API, CLI, and configuration documentation whenever the task depends on external technology behavior.
Evidence
- Validation plan
- Commands run
- Acceptance evidence
- Bugs or regressions found
- Release readiness recommendation
Ready when
- Do not treat compilation as full QA.
- Do not hide skipped checks.
- Tie every critical risk to a test, smoke check, or explicit residual risk.
- Keep bug reports reproducible.
Handoff
Hand off evidence, failures, skipped checks, and release recommendation to PR review or release docs.
References
references/eval-plan.md: Use this for test and eval planning.