tomevault-io Resolve Failed E2E Test
Analyze a failed E2E test, fix the underlying issue, and verify the fix.
Variables
test_result: $ARGUMENTS - JSON object from /test-e2e command with failed test details
Input Format
Expects a JSON object from the /test-e2e command:
{
"test_name": "Basic Query Execution",
"status": "failed",
"screenshots": [
"screenshots/01_initial_state.png",
"screenshots/02_query_input.png"
],
"error": "Step 8 failed: Results did not appear within 5 seconds"
}
Instructions
1. Analyze the E2E Failure
Review the test result:
- test_name: Which user journey failed
- error: The specific step that failed
- screenshots: Visual evidence of state before failure
Extract key information:
- Which step number failed
- What was the expected behavior
- What actually happened
- Visual clues from screenshots
2. Locate the Test Specification
Read the original test specification to understand:
- The full user story
- All test steps
- Success criteria
- Context around the failing step
3. Analyze Screenshots
Review captured screenshots to:
- Understand application state at failure
- Identify visual anomalies
- Determine if UI elements are present/missing
- Check for error messages on screen
4. Identify Root Cause
Common E2E failure causes:
| Symptom | Likely Cause |
|---|---|
| Element not found | Selector changed, slow load |
| Wrong text | Logic error, data issue |
| Timeout | Performance issue, missing element |
| Unexpected redirect | Auth issue, error state |
| Missing element | Component not rendering |
5. Fix the Issue
Apply fixes based on root cause:
- UI issue: Fix component rendering
- Logic issue: Fix business logic
- Timing issue: Add proper waits/loading states
- Data issue: Fix data handling
IMPORTANT: Fix the application, not the test (unless test is genuinely incorrect).
6. Re-run E2E Test
Execute the original E2E test again:
/test-e2e {original_test_file}
Success criteria: Test status is "passed"
7. Verify No Regressions
Run related E2E tests to ensure fix doesn't break other flows.
Output Format
Report your resolution:
## E2E Resolution Complete
### Failure Analysis
- **Test**: {test_name}
- **Failed Step**: [step number and description]
- **Root Cause**: [what caused the failure]
- **Screenshot Evidence**: [observations from screenshots]
### Fix Applied
- **File(s) Modified**: [list of files]
- **Change Summary**: [brief description]
- **Type of Fix**: [UI/Logic/Performance/Data]
### Validation
- **E2E Test**: PASS
- **Related Tests**: PASS/FAIL
- **New Screenshots**: [paths to verification screenshots]
### Notes
[Any observations or recommendations]
Retry Logic
If the fix doesn't work:
- Review new screenshots for clues
- Consider timing/async issues
- Check for environment-specific problems
- Apply alternative fix
Maximum 2 retry attempts before escalating (E2E tests are slower).
Integration with Closed Loop
This command is the RESOLVE phase for E2E:
/test-e2e {spec} → [failure JSON] → /resolve-failed-e2e-test {result} → /test-e2e
↓
[verify fix]
Converted and distributed by TomeVault — claim your Tome and manage your conversions.