diff --git a/DEAR_LLM.md b/DEAR_LLM.md
deleted file mode 100644
index 71a4298..0000000
--- a/DEAR_LLM.md
+++ /dev/null
@@ -1,68 +0,0 @@
-# DEAR_LLM.md for Sketch Repository
-
-## Repository Architecture
-
-Sketch is an agentic coding tool with a multi-layer architecture:
-
-1. **Outer Sketch**: The CLI command (`sketch`) running on the user's machine
-2. **Inner Sketch**: The binary running inside Docker containers
-3. **Container System**: Docker containers isolate work environments
-
-## Key Components
-
-### Outer Sketch (Host)
-
-- **cmd/sketch/main.go**: Entry point and CLI definitions
-- **dockerimg/**: Container management (building, configuration, orchestration)
-
-### Inner Sketch (Container)
-
-- **loop/agent.go**: Core agent logic and tool implementations
-- **loop/server/**: Server implementation inside containers
-
-### Shared Components
-
-- **webui/**: Web-based user interface components
-- **llm/**: Language model interaction
-
-## Development Workflows
-
-### Development Modes
-
-1. **Container Mode** (Default): `go run ./cmd/sketch -C /path/to/codebase`
-
-   - Creates Docker container for code analysis
-   - Safe and isolated environment
-
-2. **Unsafe Mode**: `go run ./cmd/sketch -unsafe -C /path/to/codebase`
-   - Runs directly on host OS without containerization
-   - Useful for quick testing during development
-
-### Source/Container Relationship
-
-- Target codebase: Copied into container via `COPY . /app`
-- Sketch itself: Binary built specifically for containers (`GOOS=linux`)
-- Container configuration: Generated based on target codebase detection
-
-## Common Gotchas
-
-1. **Container Caching**: Docker image caching may require `-force-rebuild-container` when the target codebase changes
-
-2. **Two Git Contexts**:
-
-   - Sketch's own repository (where outer and inner Sketch code lives)
-   - The target repository being analyzed by Sketch
-   - Keep these separate in your mental model
-
-3. **Inner/Outer Code Changes**:
-   - Changes to inner Sketch (loop/agent.go) are built into the Linux binary for containers
-   - Changes to outer Sketch (dockerimg/) affect how containers are created
-
-## Flags and Settings
-
-- `-unsafe`: Run without containerization
-- `-force-rebuild-container`: Force Docker image rebuilding
-- `-verbose`: Show detailed output and logs
-- `-C /path/to/repo`: Specify target codebase path
-
-See CONTRIBUTING.md for additional development guidance.
diff --git a/dear_llm.md b/dear_llm.md
new file mode 100644
index 0000000..f28603b
--- /dev/null
+++ b/dear_llm.md
@@ -0,0 +1,20 @@
+Sketch is an agentic coding tool with a two-layer architecture:
+
+1. Outer sketch: CLI command running on user's machine
+2. Inner sketch: Binary running inside Docker containers for isolated work
+
+Both layers use the same entrypoint (cmd/sketch). Outer sketch sets up containerization and starts inner sketch. Changes made in inner sketch are pushed via git to outer sketch.
+
+## Core Packages
+
+- termui, webui: Both interfaces operate at all times
+- loop: Central state machine that manages agent conversation flow
+- claudetools: Tool calls available to LLMs
+- llm: Common LLM interface and conversation management, with provider-specific integrations
+
+## Development Guidelines
+
+- Do NOT git add or modify .gitignore, makefiles, or executable binaries unless requested
+- When changing tool schemas, update both termui and webui
+- For unsafe/recursive development, use `-unsafe` flag
+- Unless explicitly requested, do not add backwards compatibility shims
diff --git a/webui/dear_llm.md b/webui/dear_llm.md
new file mode 100644
index 0000000..34ea0c4
--- /dev/null
+++ b/webui/dear_llm.md
@@ -0,0 +1,2 @@
+See webui/readme.md for build/run instructions.
+Use `npm run gentypes` to sync Go structs with TypeScript types.