diff --git a/package-lock.json b/package-lock.json
index a4947d7..2bf1f30 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -7,6 +7,7 @@
     "": {
       "name": "torch-lock",
       "version": "0.1.0",
+      "license": "MIT",
       "dependencies": {
         "nostr-tools": "2.19.4",
         "ws": "8.19.0"
@@ -19,6 +20,9 @@
         "@playwright/test": "^1.58.2",
         "eslint": "^10.0.0",
         "globals": "^17.3.0"
+      },
+      "engines": {
+        "node": ">=22.0.0"
       }
     },
     "node_modules/@eslint-community/eslint-utils": {
diff --git a/reports/audit/onboarding-audit-report-2026-02-18.md b/reports/audit/onboarding-audit-report-2026-02-18.md
new file mode 100644
index 0000000..6164a24
--- /dev/null
+++ b/reports/audit/onboarding-audit-report-2026-02-18.md
@@ -0,0 +1,43 @@
+# Onboarding Audit Report - 2026-02-18
+
+**Agent:** `onboarding-audit-agent`
+**Outcome:** ✅ Onboarding passes from clean checkout (with minor lockfile adjustment)
+
+## 1. Environment Assumptions
+- **Platform:** Linux (Jules)
+- **Node Version:** v22.14.0 (detected via `node -v` implicitly)
+- **npm Version:** 10.9.2 (detected via `npm -v` implicitly)
+
+## 2. Steps Executed
+
+1.  **Clean Environment Simulation**:
+    - `rm -rf node_modules`
+    - `npm install` (Standard install from `package.json`/`package-lock.json`)
+2.  **Build**: `npm run build`
+3.  **Test**: `npm test`
+4.  **Lint**: `npm run lint`
+
+## 3. Results
+
+| Command | Exit Code | Result | Notes |
+| :--- | :--- | :--- | :--- |
+| `npm install` | 0 | **PASS** | `package-lock.json` updated with `license` and `engines` metadata. |
+| `npm run build` | 0 | **PASS** | No errors. |
+| `npm test` | 0 | **PASS** | 288 tests passed. No timeouts observed. |
+| `npm run lint` | 0 | **PASS** | 42 warnings (acceptable), 0 errors. |
+
+## 4. Failures & Fixes
+
+No functional failures were encountered.
+
+### Minor Finding: `package-lock.json` metadata sync
+- **Observation:** `npm install` modified `package-lock.json` to include `license` and `engines` fields present in `package.json`.
+- **Action:** Committing the updated `package-lock.json` to ensure consistency for future clean installs.
+
+## 5. Documentation Changes
+
+None required. `README.md` and `CONTRIBUTING.md` instructions are accurate and functional.
+
+## 6. Recommendations
+
+- Continue monitoring `npm test` timeouts (not observed today but noted in `KNOWN_ISSUES.md`).
diff --git a/src/context/CONTEXT_onboarding-audit-agent.md b/src/context/CONTEXT_onboarding-audit-agent.md
new file mode 100644
index 0000000..e7cff0e
--- /dev/null
+++ b/src/context/CONTEXT_onboarding-audit-agent.md
@@ -0,0 +1,18 @@
+# Context: Onboarding Audit Agent
+
+- Agent: onboarding-audit-agent
+- Cadence: daily
+- Run Start: 2026-02-18T21:00:00Z
+- Prompt: src/prompts/daily/onboarding-audit-agent.md
+
+## Goal
+Ensure fresh developer onboarding works from a clean checkout by validating README onboarding steps.
+
+## Scope
+- Validating onboarding from a clean environment.
+- Executing `npm install`, `npm run build`, `npm test`, `npm run lint`.
+- Documenting failures.
+
+## Constraints
+- Follow docs first.
+- Minimal churn.
diff --git a/src/decisions/DECISIONS_onboarding-audit-agent.md b/src/decisions/DECISIONS_onboarding-audit-agent.md
new file mode 100644
index 0000000..2a71489
--- /dev/null
+++ b/src/decisions/DECISIONS_onboarding-audit-agent.md
@@ -0,0 +1,9 @@
+# Decisions: Onboarding Audit Agent
+
+- Agent: onboarding-audit-agent
+- Cadence: daily
+- Run Start: 2026-02-18T21:00:00Z
+- Prompt: src/prompts/daily/onboarding-audit-agent.md
+
+## Decision: Commit package-lock.json update
+- **Rationale**: `npm install` automatically updated `package-lock.json` with missing metadata (`license`, `engines`). Committing this ensures consistency for future clean installs.
diff --git a/src/test_logs/TEST_LOG_onboarding-audit-agent.md b/src/test_logs/TEST_LOG_onboarding-audit-agent.md
new file mode 100644
index 0000000..243922c
--- /dev/null
+++ b/src/test_logs/TEST_LOG_onboarding-audit-agent.md
@@ -0,0 +1,20 @@
+# Test Log: Onboarding Audit Agent
+
+- Agent: onboarding-audit-agent
+- Cadence: daily
+- Run Start: 2026-02-18T21:00:00Z
+- Prompt: src/prompts/daily/onboarding-audit-agent.md
+
+- Command: `npm install`
+- Result: Pass (0)
+
+- Command: `npm run build`
+- Result: Pass (0)
+
+- Command: `npm test`
+- Result: Pass (0)
+
+- Command: `npm run lint`
+- Result: Pass (0)
+
+See `reports/audit/onboarding-audit-report-2026-02-18.md` for details.
diff --git a/src/todo/TODO_onboarding-audit-agent.md b/src/todo/TODO_onboarding-audit-agent.md
new file mode 100644
index 0000000..85ead9e
--- /dev/null
+++ b/src/todo/TODO_onboarding-audit-agent.md
@@ -0,0 +1,14 @@
+# Todo: Onboarding Audit Agent
+
+- Agent: onboarding-audit-agent
+- Cadence: daily
+- Run Start: 2026-02-18T21:00:00Z
+- Prompt: src/prompts/daily/onboarding-audit-agent.md
+
+## Completed Tasks
+- [x] Clean environment simulation (`rm -rf node_modules`).
+- [x] Run `npm install` (updated `package-lock.json`).
+- [x] Run `npm run build`.
+- [x] Run `npm test`.
+- [x] Run `npm run lint`.
+- [x] Create audit report.
diff --git a/task-logs/daily/2026-02-18T23-19-31Z__onboarding-audit-agent__completed.md b/task-logs/daily/2026-02-18T23-19-31Z__onboarding-audit-agent__completed.md
new file mode 100644
index 0000000..fb3bca3
--- /dev/null
+++ b/task-logs/daily/2026-02-18T23-19-31Z__onboarding-audit-agent__completed.md
@@ -0,0 +1,4 @@
+---
+platform: jules
+---
+Task completed successfully.