From 7a285cd60d85bde13ebada6cd7f235490691a3db Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Sun, 15 Feb 2026 14:40:57 +0000
Subject: [PATCH] docs(ai): update onboarding steps (onboarding-audit-agent)

- Added `npx playwright install` instruction to `README.md` and `CONTRIBUTING.md` as it is required for smoke, visual, and e2e tests.
- Created audit report `docs/agents/task-logs/daily/2026-02-15_14-39-43_onboarding-audit-agent_completed.md`.

Co-authored-by: PR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
---
 CONTRIBUTING.md                               |  6 ++++
 README.md                                     |  6 ++++
 ...-39-43_onboarding-audit-agent_completed.md | 30 +++++++++++++++++++
 3 files changed, 42 insertions(+)
 create mode 100644 docs/agents/task-logs/daily/2026-02-15_14-39-43_onboarding-audit-agent_completed.md

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.