diff --git a/AGENTS.md b/AGENTS.md
index fb935f273..9b4778f3b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -8,6 +8,7 @@ Vue 3 + CanvasKit (Skia WASM) + Yoga WASM design editor. Tauri v2 desktop, also
 - `bun run format` — oxfmt with import sorting
 - `bun test ./tests/engine` — unit tests
 - `bun run test` — Playwright visual regression
+- `bun run tauri dev` — desktop app with hot reload
 
 ## Code conventions
 
@@ -16,6 +17,8 @@ Vue 3 + CanvasKit (Skia WASM) + Yoga WASM design editor. Tauri v2 desktop, also
 - No `!` non-null assertions — use guards, `?.`, `??`
 - Shared types (GUID, Color, Vector, Matrix, Rect) live in `src/types.ts`
 - Window API extensions (showOpenFilePicker, queryLocalFonts) live in `src/global.d.ts`
+- Use `culori` for color conversions — don't reimplement parseColor/colorToRgba
+- Use `@vueuse/core` hooks (useEventListener, etc.) — don't do manual addEventListener/removeEventListener
 - `src/kiwi/kiwi-schema/` is vendored — don't modify
 
 ## Rendering
@@ -25,6 +28,18 @@ Vue 3 + CanvasKit (Skia WASM) + Yoga WASM design editor. Tauri v2 desktop, also
 - `renderNow()` is only for surface recreation and font loading (need immediate draw)
 - Resize observer uses rAF throttle, not debounce — debounce causes canvas skew (old WebGL surface stretched into resized element)
 - Viewport culling skips off-screen nodes; unclipped parents are NOT culled (children may extend beyond bounds)
+- Selection border width must be constant regardless of zoom — divide by scale
+- Section/frame title text never scales — render at fixed font size, ellipsize to fit
+- Rulers are rendered on the canvas (not DOM), with selection range badges that don't overlap tick numbers
+
+## Scene graph
+
+- Nodes live in flat `Map<string, SceneNode>`, tree via `parentIndex` references
+- Frames clip content by default is OFF (unlike what you'd assume)
+- When creating auto-layout, sort children by geometric position first
+- Dragging a child outside a frame should reparent it, not clip it
+- Layer panel tree must react to reparenting — watch for stale children refs
+- Groups: creating a group must preserve children's visual positions
 
 ## Components & instances
 
@@ -38,20 +53,34 @@ Vue 3 + CanvasKit (Skia WASM) + Yoga WASM design editor. Tauri v2 desktop, also
 
 - `computeAllLayouts()` must be called after demo creation and after opening .fig files
 - Yoga WASM handles flexbox; CSS Grid blocked on upstream (facebook/yoga#1893)
+- Auto-layout creation (Shift+A) must recompute layout immediately to update selection bounds
 
 ## UI
 
-- Use reka-ui for UI components (Splitter, ContextMenu, etc.)
-- Tailwind 4 for styling — no component-level CSS
+- Use reka-ui for UI components (Splitter, ContextMenu, DropdownMenu, etc.)
+- Tailwind 4 for styling — no inline CSS, no component-level `<style>` blocks
 - Mac keyboards: use `e.code` not `e.key` for shortcuts with modifiers (Option transforms characters)
 - Splitter resize handles need inner div with `pointer-events-none` for sizing (zero-width handle collapses without it)
 - Number input spinner hiding is global CSS in `app.css`, not per-component
+- ScrubInput (drag-to-change number) — cursor and pointerdown on outer container, not inner spans
+- Icons: use unplugin-icons with Iconify/Lucide (`<icon-lucide-*>`) — don't use raw SVG or Unicode symbols
+- Sections are draggable by title pill, not by the area to the right of the title
 
 ## File format
 
 - .fig files use Kiwi binary codec — schema in `src/kiwi/codec.ts`
 - `NodeChange` is the central type for Kiwi encode/decode
-- showOpenFilePicker/showSaveFilePicker are File System Access API (Chrome/Edge), not Tauri-only — code has fallbacks for other browsers
+- Vector data uses reverse-engineered `vectorNetworkBlob` binary format — encoder/decoder in `src/engine/vector.ts`
+- showOpenFilePicker/showSaveFilePicker are File System Access API (Chrome/Edge), not Tauri-only — code has fallbacks
+- Tauri detection: `IS_TAURI` constant from `src/constants.ts` — don't use `'__TAURI_INTERNALS__' in window` inline
+- .fig export: compression with fflate (browser) or Tauri Rust commands
+- Test .fig round-trip by exporting and reimporting in Figma
+
+## Tauri
+
+- Tauri v2 with plugin-dialog, plugin-fs, plugin-opener
+- File system permissions must be configured in `desktop/tauri.conf.json` — "Internal error" on save means missing permissions
+- Dev tools: add a menu item to toggle, don't rely on keyboard shortcut
 
 ## Known issues