diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index bcbe9f6f..8de762e2 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, visual, or end-to-end tests, install the Playwright browsers:
+
+   ```bash
+   npx playwright install
+   ```
+
 3. **Start the Application**:
 
    ```bash
diff --git a/README.md b/README.md
index fae65d49..6f4a4be1 100644
--- a/README.md
+++ b/README.md
@@ -149,6 +149,12 @@ To run **bitvid** locally:
    npm ci
    ```
 
+   If you plan to run smoke, visual, or end-to-end 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_14-39-43_onboarding-audit-agent_completed.md b/docs/agents/task-logs/daily/2026-02-15_14-39-43_onboarding-audit-agent_completed.md
new file mode 100644
index 00000000..a07df556
--- /dev/null
+++ b/docs/agents/task-logs/daily/2026-02-15_14-39-43_onboarding-audit-agent_completed.md
@@ -0,0 +1,30 @@
+# Onboarding Audit Report
+
+**Date:** 2026-02-15
+**Agent:** onboarding-audit-agent
+**Result:** PASSED with fixes
+
+## Headline
+⚠️ Onboarding failures found (and fixed)
+
+## Environment
+- OS: Linux (simulated)
+- Node: v22.22.0
+- NPM: 10.9.1
+
+## Steps Executed
+1. `npm ci` - PASSED
+2. `npm run build` - PASSED
+3. `npm run test:unit:shard1` - PASSED
+4. `npm run test:smoke` - FAILED initially (missing browsers), PASSED after fix.
+5. `npm run format` - PASSED
+6. `npm run lint` - PASSED
+
+## Failures & Fixes
+- **Failure:** `npm run test:smoke` failed with "Executable doesn't exist".
+- **Root Cause:** Playwright browsers were not installed in the fresh environment.
+- **Fix:** Added `npx playwright install` instruction to `README.md` and `CONTRIBUTING.md`.
+
+## Docs Changes
+- `README.md`: Added `npx playwright install` step.
+- `CONTRIBUTING.md`: Added `npx playwright install` step.