diff --git a/AGENTS.md b/AGENTS.md
index 9a745101..d91045fd 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -39,6 +39,10 @@ Heartbeat Monitor (`Next.js 15 + React 19`) for local website/app heartbeat trac
 - Keep live refresh behavior and avoid long single-column list regressions.
 
 ## Dev Workflow
-- Start: `npm run dev`
+- Start (port `3005`): `npm run dev -- --port 3005`
+- Restart dev service:
+  - In the running terminal: `Ctrl + C`
+  - If port `3005` is busy: `lsof -ti :3005 | xargs kill`
+  - Start again: `npm run dev -- --port 3005`
 - Build check: `npm run build`
 - Keep TypeScript build green before merging.