dogfood

1# Dogfood
2 
3Systematically explore a web application, find issues, and produce a report with full reproduction evidence for every finding.
4 
5## Setup
6 
7Only the **Target URL** is required. Everything else has sensible defaults -- use them unless the user explicitly provides an override.
8 
9| Parameter | Default | Example override |
10|-----------|---------|-----------------|
11| **Target URL** | _(required)_ | `vercel.com`, `http://localhost:3000` |
12| **Session name** | Slugified domain (e.g., `vercel.com` -> `vercel-com`) | `--session my-session` |
13| **Output directory** | `./dogfood-output/` | `Output directory: /tmp/qa` |
14| **Scope** | Full app | `Focus on the billing page` |
15| **Authentication** | None | `Sign in to user@example.com` |
16 
17If the user says something like "dogfood vercel.com", start immediately with defaults. Do not ask clarifying questions unless authentication is mentioned but credentials are missing.
18 
19Always use `agent-browser` directly -- never `npx agent-browser`. The direct binary uses the fast Rust client. `npx` routes through Node.js and is significantly slower.
20 
21## Workflow
22 
23```
241. Initialize    Set up session, output dirs, report file
252. Authenticate  Sign in if needed, save state
263. Orient        Navigate to starting point, take initial snapshot
274. Explore       Systematically visit pages and test features
285. Document      Screenshot + record each issue as found
296. Wrap up       Update summary counts, close session
30```
31 
32### 1. Initialize
33 
34```bash
35…