diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index bcbe9f6f..0e00cdde 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -105,6 +105,12 @@ To set up the project locally:
    npm ci
    ```
 
+   If you plan to run smoke tests or visual tests, install the Playwright browsers:
+
+   ```bash
+   npx playwright install
+   ```
+
 3. **Start the Application**:
 
    ```bash
diff --git a/README.md b/README.md
index fae65d49..f26eaabb 100644
--- a/README.md
+++ b/README.md
@@ -149,6 +149,12 @@ To run **bitvid** locally:
    npm ci
    ```
 
+   If you plan to run smoke tests or visual tests, install the Playwright browsers:
+
+   ```bash
+   npx playwright install
+   ```
+
 3. Start the application:
 
    ```bash
diff --git a/docs/agents/task-logs/daily/2026-02-15_11-56-17_onboarding-audit-agent_completed.md b/docs/agents/task-logs/daily/2026-02-15_11-56-17_onboarding-audit-agent_completed.md
new file mode 100644
index 00000000..2e3602c6
--- /dev/null
+++ b/docs/agents/task-logs/daily/2026-02-15_11-56-17_onboarding-audit-agent_completed.md
@@ -0,0 +1,41 @@
+# Onboarding Audit Agent - Completed
+
+**Date:** 2026-02-15
+**Agent:** onboarding-audit-agent
+**Status:** Completed
+
+## Report
+
+### Headline
+⚠️ Onboarding failures found (resolved)
+
+### Environment
+- Node: v22.22.0
+- OS: Linux
+
+### Steps Executed
+1. `npm ci`
+2. `npm run build`
+3. `npm run test:unit:shard1`
+4. `npm run test:smoke`
+5. `npm run format`
+6. `npm run lint`
+
+### Results
+- `npm ci`: PASS
+- `npm run build`: PASS
+- `npm run test:unit:shard1`: PASS
+- `npm run test:smoke`: FAIL (initially), PASS (after fix)
+- `npm run format`: PASS
+- `npm run lint`: PASS
+
+### Failures
+#### 1. Missing Playwright Browsers
+**Command**: `npm run test:smoke`
+**Error**: `browserType.launch: Executable doesn't exist ... Please run ... npx playwright install`
+**Cause**: The documented setup instructions did not include the step to install Playwright browsers, which are required for smoke and visual tests.
+**Fix**: Updated `README.md` and `CONTRIBUTING.md` to include `npx playwright install` in the setup instructions.
+
+## Changes
+- Updated `README.md` to add `npx playwright install`.
+- Updated `CONTRIBUTING.md` to add `npx playwright install`.