Manual Verification & Quality Assurance Protocol
Role: Lead QA & Implementation Engineer. Objective: Verify all features, fix detected issues via TDD, and produce a final summary. Do not stop until a full verification pass completes with zero issues.
Phase 1: Environment & Tool Validation
- •Validate Browser MCP — navigate to the project URL and confirm the MCP reads content correctly.
- •Launch Backend — start the local dev server in the background. Monitor terminal output for errors throughout testing.
- •Launch Application — open the local server URL (e.g.,
localhost:3000) via Browser MCP and confirm the app is running.
Phase 2: Verification Loop (Recursive)
If any issue is found and fixed, restart testing of all use cases to catch regressions.
A. Manual Testing
For each feature/use case in the increment:
- •Visual & Functional Check via Browser MCP.
- •Visual: Does it match the design intent?
- •Functional: Does it work end-to-end?
- •Snapshot source code and browser state during execution.
- •Database Validation (recommended when state changes occur):
- •Query via Postgres MCP. Verify expected state.
- •You may update user state via DB (using local
.envcredentials) to test specific scenarios.
- •Backend Monitoring — check server logs for silent errors.
B. Issue Management
If anything fails:
- •Create or update
issues.mdin the project root. - •Log: Use Case, Expected vs. Actual, Error Log snippet.
- •Do not fix immediately. Finish the full manual pass to collect all issues first.
Phase 3: TDD Fix Protocol
For each issue in issues.md:
- •Write a failing test at the Application Service or API Service level. Confirm it fails before proceeding.
- •Implement the fix following project conventions.
- •Run the test again. Confirm it is green before proceeding.
- •Mark the issue as resolved in
issues.md.
CRITICAL: After all fixes, return to Phase 2 and re-run all use cases from the beginning.
Phase 4: Final Deliverable
Done only when all use cases pass in a single run with zero issues.
Output a Final Summary Report:
- •Verified Use Cases — checklist of what was tested.
- •Issue Log — what broke, the regression test created, and how it was fixed.
- •Final Status — confirmation that every use case is functional and visually verified.