diff --git a/README.md b/README.md
index 4d1255b5..c173e348 100644
--- a/README.md
+++ b/README.md
@@ -30,7 +30,7 @@
 
 ## What is AgentCompany?
 
-AgentCompany is a cross-platform desktop app that turns a single goal into a fully autonomous AI company. You provide a company name, description, and mission. A CEO agent self-organizes departments, hires specialists, delegates tasks, and delivers real results — code, content, research, business plans, and more — while you observe through a Slack-style command hub. Inspired by **[Paperclip](https://github.com/paperclipai/paperclip)**
+AgentCompany is a cross-platform desktop app that turns a single goal into a coordinated AI team. You provide a company name, description, and mission. A CEO agent self-organizes departments, delegates tasks, and produces deliverables — code, content, research, business plans, and more — while you observe and approve through a chat-based command hub. Inspired by **[Paperclip](https://github.com/paperclipai/paperclip)**
 
 ### Supported AI Runtimes
 
@@ -52,7 +52,7 @@ Your AI CEO builds the org chart — recruiting specialists, creating department
 </p>
 
 ### Real-Time Agent Communication
-Agents coordinate through Slack-style channels and direct messages. Watch strategic decisions unfold in real time.
+Agents coordinate through channel and direct-message threads. Watch decisions unfold in real time.
 
 <p align="center">
   <img src="screenshots/AI-Internal-Realtime-Message.jpeg" width="700" alt="Real-time messaging between AI agents" />
@@ -122,9 +122,9 @@ pnpm build:verify
 ## Packaging
 
 ```sh
-pnpm build        # Compile + package for current platform → /build/release
-pnpm build:dir    # Compile + unpackaged directory
-pnpm build:all    # Build for all platforms
+pnpm build         # Compile + package for current platform → /build/release
+pnpm build:dir     # Compile + unpackaged directory
+pnpm build:current # Build for current host platform (see note below for other OS)
 pnpm release:local # Signed/uploading release pipeline (see docs/release/local-r2.md)
 ```
 
@@ -155,7 +155,7 @@ packages/
 
 - **Local-first:** SQLite database, secrets in OS keychain, no external services required
 - **Security:** `contextIsolation: true`, `nodeIntegration: false`, Zod-validated IPC, JWT agent tokens
-- **Real autonomy:** Agents communicate, delegate, escalate, and produce deliverables without manual prompting
+- **Agent coordination:** Agents delegate tasks, escalate blockers, and produce deliverables through the orchestration runtime
 
 ---
 
@@ -168,7 +168,7 @@ packages/
 | Language | TypeScript 5.9 (strict) |
 | UI | React 19, Tailwind CSS 4, Framer Motion |
 | Build | electron-vite, Vite 7, electron-builder |
-| Database | SQLite (WAL mode, 25+ tables) |
+| Database | SQLite (WAL mode, schema in `src/main/database/`) |
 | Validation | Zod 4 |
 | Testing | Vitest, Playwright |
 
diff --git a/package.json b/package.json
index 5458dd5e..0483515a 100644
--- a/package.json
+++ b/package.json
@@ -15,18 +15,18 @@
     "build:verify": "electron-vite build",
     "build": "electron-vite build && node scripts/build-desktop.mjs",
     "build:dir": "electron-vite build && node scripts/build-desktop.mjs --dir",
-    "build:all": "node scripts/build-all-platforms.mjs",
+    "build:current": "node scripts/build-all-platforms.mjs",
     "release:cloudflare": "node scripts/release-public-cloudflare.mjs && node scripts/release-boss.mjs",
     "release:cloudflare:public": "node scripts/release-public-cloudflare.mjs",
     "release:boss": "node scripts/release-boss.mjs",
     "release:local": "node scripts/release-local.mjs",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "test": "node scripts/run-vitest.mjs run",
+    "test": "node --disable-warning=ExperimentalWarning ./node_modules/vitest/vitest.mjs run",
     "typecheck": "tsc --noEmit",
     "typecheck:all": "pnpm -r typecheck",
-    "test:unit": "node scripts/run-vitest.mjs run --config vitest.config.ts tests/unit",
-    "test:integration": "node scripts/run-vitest.mjs run --config vitest.config.ts tests/integration",
+    "test:unit": "node --disable-warning=ExperimentalWarning ./node_modules/vitest/vitest.mjs run --config vitest.config.ts tests/unit",
+    "test:integration": "node --disable-warning=ExperimentalWarning ./node_modules/vitest/vitest.mjs run --config vitest.config.ts tests/integration",
     "test:e2e": "node --no-warnings ./node_modules/@playwright/test/cli.js test -c tests/e2e/playwright.config.ts",
     "test:run": "pnpm test:unit && pnpm test:integration && pnpm test:e2e",
     "verify": "pnpm typecheck && pnpm lint && pnpm typecheck:all && pnpm test:unit && pnpm test:integration && pnpm test:e2e",
diff --git a/scripts/build-all-platforms.mjs b/scripts/build-all-platforms.mjs
index def863fc..594a32b8 100644
--- a/scripts/build-all-platforms.mjs
+++ b/scripts/build-all-platforms.mjs
@@ -111,7 +111,7 @@ const otherPlatforms = Object.entries(PLATFORM_NAMES)
 if (otherPlatforms.length > 0) {
   console.log(`\n[build-all] NOTE: Build on these platforms for full D-07 coverage:`);
   for (const name of otherPlatforms) {
-    console.log(`  - ${name}: run 'pnpm build:all' on a ${name} host`);
+    console.log(`  - ${name}: run 'pnpm build:current' on a ${name} host`);
   }
 }