# Project Architecture Rules (Non-Obvious Only)

- Webview and extension communicate ONLY through `src/core/webview/webviewMessageHandler.ts` patterns
- React hooks required in webview - external state libraries break VSCode webview isolation
- Monorepo has circular dependency on types package (intentional design)
- `safeWriteJson()` mandatory for JSON writes - uses atomic writes with file locking
- Database operations require specific directory: must `cd packages/evals` before running migrations