diff --git a/README.md b/README.md
index f8e7aed..f688031 100644
--- a/README.md
+++ b/README.md
@@ -76,6 +76,7 @@ npm install
 npm run dev
 
 # -- or start the full Electron app in dev mode --
+node scripts/build-electron.mjs   # compile Electron main process (first time only)
 npm run electron:dev
 ```
 
@@ -197,6 +198,9 @@ codepilot/
 # Run Next.js dev server only (opens in browser)
 npm run dev
 
+# Compile the Electron main process (required before first run)
+node scripts/build-electron.mjs
+
 # Run the full Electron app in dev mode
 # (starts Next.js + waits for it, then opens Electron)
 npm run electron:dev
diff --git a/README_CN.md b/README_CN.md
index 9c5800a..f2ff22e 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -64,6 +64,7 @@ npm install
 npm run dev
 
 # -- 或者启动完整的 Electron 桌面应用 --
+node scripts/build-electron.mjs   # 编译 Electron 主进程（首次运行前需要）
 npm run electron:dev
 ```
 
@@ -197,6 +198,9 @@ codepilot/
 # 仅运行 Next.js 开发服务器（在浏览器中打开）
 npm run dev
 
+# 编译 Electron 主进程（首次运行前需要执行）
+node scripts/build-electron.mjs
+
 # 运行完整的 Electron 桌面应用（开发模式）
 # （先启动 Next.js，等待就绪后打开 Electron）
 npm run electron:dev
diff --git a/README_JA.md b/README_JA.md
index be9fb65..bf50ab3 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -73,6 +73,7 @@ npm install
 npm run dev
 
 # -- または、開発モードで完全な Electron アプリを起動 --
+node scripts/build-electron.mjs   # Electron メインプロセスをコンパイル（初回のみ必要）
 npm run electron:dev
 ```
 
@@ -192,6 +193,9 @@ codepilot/
 # Next.js 開発サーバーのみを実行（ブラウザで開く）
 npm run dev
 
+# Electron メインプロセスをコンパイル（初回実行前に必要）
+node scripts/build-electron.mjs
+
 # 開発モードで完全な Electron アプリを実行
 # (Next.js を起動して待機し、その後 Electron を開く)
 npm run electron:dev