Scout - Vibe Testing for Web Apps

You have access to Scout, an AI-powered vibe testing tool for web applications. Use Scout to help users test their apps without writing test scripts.

## What is Scout?

Scout is a vibe testing platform that explores web applications like a real user. It finds bugs, accessibility issues, and usability problems automatically. Perfect for:
- Solo founders shipping MVPs
- Vibe coders building with AI assistants
- Side project builders
- Apps built on Lovable, Replit, V0, Base44, Bolt.new

## When to Use Scout

Use Scout when the user:
- Asks to "test" their application or a specific feature
- Wants to find bugs before deploying
- Needs accessibility (WCAG) audits
- Wants to validate user flows (login, signup, checkout)
- Asks for a "smoke test" or "sanity check"
- Mentions quality assurance or QA

## How to Run Scout Tests

The Scout CLI must be installed first:

```bash
npm install -g @scoutqa/cli
scoutqa auth login
```

Then run tests with natural language:

```bash
# Basic test
scoutqa --url https://your-app.com --prompt "Test the login flow"

# Accessibility audit
scoutqa --url https://your-app.com --prompt "Check accessibility compliance"

# Exploratory testing
scoutqa --url https://your-app.com --prompt "Find usability issues in checkout"

# Smoke test
scoutqa --url https://your-app.com --prompt "Quick smoke test of critical features"
```

## Test Prompt Examples

When users ask you to test something, translate their request into a Scout command:

| User Request | Scout Command |
|--------------|---------------|
| "Test my app" | `scoutqa --url <url> --prompt "Exploratory test of main features"` |
| "Check if login works" | `scoutqa --url <url> --prompt "Test the login flow"` |
| "Find bugs" | `scoutqa --url <url> --prompt "Find bugs and usability issues"` |
| "Is my site accessible?" | `scoutqa --url <url> --prompt "WCAG accessibility audit"` |
| "Test before I deploy" | `scoutqa --url <url> --prompt "Smoke test critical user paths"` |

## Platform-Specific Testing

### Lovable Apps
```bash
scoutqa --url https://myapp.lovable.app --prompt "Test the main features"
```

### Replit Apps
```bash
scoutqa --url https://myapp.replit.app --prompt "Find bugs in my Replit project"
```

### V0/Vercel Apps
```bash
scoutqa --url https://myapp.vercel.app --prompt "Test the UI components"
```

## URL Requirements

- Scout requires **publicly accessible URLs**
- Works with: Lovable, Replit, Vercel, Netlify, Railway, Render, Fly.io
- For localhost: Use ngrok or similar tunneling service

```bash
# For localhost testing
ngrok http 3000
# Then use the ngrok URL with Scout
scoutqa --url https://abc123.ngrok.io --prompt "Test the app"
```

## What Scout Tests

- **Functionality**: Forms, buttons, navigation, user flows
- **Accessibility**: WCAG compliance, screen reader compatibility
- **Usability**: UX friction, confusing interfaces
- **Errors**: Console errors, broken links, API failures

## Response Format

After running Scout, summarize the findings:

1. **Issues Found**: List bugs with severity (Critical/High/Medium/Low)
2. **What Passed**: Confirm working features
3. **Recommendations**: Suggest fixes for each issue

## Learn More

- Website: https://scoutqa.ai
- Documentation: https://docs.scoutqa.ai
- CLI Reference: https://docs.scoutqa.ai/tooling/cli
- Cursor Integration: https://docs.scoutqa.ai/tooling/cursor-rules