docs: add development workflow documentation to knowledge.md

Author: brandonkachen

knowledge.md

@@ -63,6 +63,39 @@ eval "$(codebuff shims env)"
 base-lite "fix this bug"             # Works right away!
 ```
 
+## Development Workflow
+
+### Starting the Development Environment
+
+```bash
+# Full development environment (services + CLI)
+bun dev                    # Starts db, studio, sdk, web, then CLI
+                           # Ctrl+C stops everything
+
+# Or run services and CLI separately
+bun start-services         # Start services in background, exits when ready
+bun start-cli              # Start CLI in foreground
+bun stop-services          # Stop background services
+```
+
+**Services started:**
+- `db` - PostgreSQL database (via Docker)
+- `studio` - Drizzle Studio for database inspection
+- `sdk` - SDK build (one-time)
+- `web` - Next.js web server
+
+**Logs:** All service logs are written to `debug/console/`:
+- `db.log`, `studio.log`, `sdk.log`, `web.log`
+
+**Worktree Support:** Each worktree can run on different ports. Create `.env.development.local` with:
+```
+PORT=3001
+NEXT_PUBLIC_WEB_PORT=3001
+NEXT_PUBLIC_CODEBUFF_APP_URL=http://localhost:3001
+```
+
+The `stop-services` command is worktree-safe - it only kills services on the port configured for that worktree.
+
 ## Package Management
 
 - Use Bun for all package management operations