diff --git a/AGENTS.md b/AGENTS.md
index 93e9f62907e6ce8d5672159897228e1dfe172a13..ac24c6a2c74063b1b7df569ebe7683caa36a39f3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,7 +2,7 @@
 
 ## Task Completion Requirements
 
-- Both `bun lint` and `bun typecheck` must pass before considering tasks completed.
+- All of `bun fmt`, `bun lint`, and `bun typecheck` must pass before considering tasks completed.
 - NEVER run `bun test`. Always use `bun run test` (runs Vitest).
 
 ## Project Snapshot
diff --git a/apps/web/src/main.tsx b/apps/web/src/main.tsx
index e4fe3eda58807e5d0434c02adc608545dd03cf19..fda5913c9772e55409ac70ecaaaf474b26d257a9 100644
--- a/apps/web/src/main.tsx
+++ b/apps/web/src/main.tsx
@@ -10,6 +10,7 @@ import { isElectron } from "./env";
 import { getRouter } from "./router";
 import { APP_DISPLAY_NAME } from "./branding";
 
+// Electron loads the app from a file-backed shell, so hash history avoids path resolution issues.
 const history = isElectron ? createHashHistory() : createBrowserHistory();
 
 const router = getRouter(history);