diff --git a/CLAUDE.md b/CLAUDE.md
index bbe76d0..b69713d 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -40,20 +40,22 @@ tessera/
 ```bash
 cd ~/projects/tessera
 cp .env.example .env   # Edit DATABASE_URL to point to postgres://tessera:***@127.0.0.1:5433/tessera
-bun run src/index.ts   # Starts on port 9876
+npm run dev:backend   # Starts API on port 9876
 ```
 
 ### Run migrations
 ```bash
-bun run src/db/migrate.ts
+npm run db:migrate
+npm run db:seed      # Optional demo data for UI review
+npm run db:seed:reset # Reset local app data, then recreate demo data
 ```
 
 ### Start frontend
 ```bash
 cd web
 npm install        # Use npm, NOT bun (bun has compatibility issues with Next.js dev server)
-npx next build     # Production build
-npx next start --port 5173   # Production server
+npm run build      # Production build
+npm run start      # Production server on 127.0.0.1:3100
 ```
 
 **Note:** `bun run dev` (Turbopack) has WebSocket HMR issues in this environment. Use production mode only.
@@ -103,7 +105,7 @@ OpenCode server: `opencode serve --port 4096` (Gjermund attaches with `opencode
 
 After OpenCode makes changes:
 1. `cd web && npx next build` — verify zero errors
-2. `npx next start --port 5173` — restart production server
+2. `npm run start` — restart production server on 127.0.0.1:3100
 3. `git push` — push to origin
 
 ## Common Issues