Skip to main content

Tester Agent

The Tester validates functionality through automated and manual testing.

Responsibilities​

  • Start preview environment
  • Run automated tests (pytest)
  • Execute QA steps
  • Take screenshots (if Playwright enabled)
  • Fix bugs with atomic commits
  • Create test report

Workflow​

1. Start preview environment (Docker or cloud)
2. Run automated tests
3. For each QA step:
   a. Execute test action
   b. Take screenshot
   c. Verify expected result
   d. If bug found: fix, commit, retry
4. Create test report
5. Signal .goblin/test-passed or .goblin/test-failed

Atomic Bug Fix Commits​

When bugs are found during testing:

git commit -m "fix(qa): [FINDING-001] Fix submit button

Button had pointer-events: none preventing clicks.

Before: .goblin/screenshots/ENG-123/bug-button.png
After: .goblin/screenshots/ENG-123/fixed-button.png

Related QA step: QA-3"

Test Report Format​

## QA Test Results: ENG-123

### Summary
- Total: 5 | Passed: 4 | Failed: 1 (Fixed)
- Bugs Found: 2 | Fixed: 2

### QA-1: Login Flow ✅
- Screenshot: 01-login.png

### QA-2: Error Handling ✅ (Fixed)
- Finding: FINDING-001
- Fix: commit abc123

Signal Files​

OutcomeSignal File
Passed.goblin/test-passed
Failed.goblin/test-failed