ssweber · ssweber · Jan 18, 2026 · Jan 17, 2026 · Jan 17, 2026 · Jan 17, 2026
diff --git a/ARCHITECTURE_PLAN.md b/ARCHITECTURE_PLAN.md
diff --git a/HANDOFF.md b/HANDOFF.md
diff --git a/HANDOFF2.md b/HANDOFF2.md
diff --git a/claude.md b/claude.md
@@ -1,5 +1,8 @@
 # CLAUDE.md
 
+**IMPORTANT: DON'T USE `cd` before commands. The working directory is already set to the project root.**
+**IMPORTANT: Always use `make` commands, not direct `uv run` commands.**
+
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
 ## Project Overview
@@ -20,10 +23,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Build & Development Commands
 
-**IMPORTANT: The working directory is already set to the project root. Do not use `cd` before commands.**
-
-**IMPORTANT: Always use `make` commands, not direct `uv run` commands.**
-
 ```bash
 # Install dependencies
 make install                    # or: uv sync --all-extras --dev

diff --git a/next-steps.md b/next-steps.md