diff --git a/README.md b/README.md
index defaaef..232827d 100644
--- a/README.md
+++ b/README.md
@@ -73,8 +73,12 @@ and `.dark`. Keep all shadcn-vue token names intact.
 
 ## Image discipline
 
-All images live under `public/images/<project>/`. The build pipeline
-expects:
+All project images live under `src/assets/projects/<slug>/` and flow
+through Vite's asset pipeline: `src/data/projects.ts` resolves each
+file via `import.meta.glob`, so every image lands in `dist/assets/`
+with a content-hashed filename (`08-abc123.jpg`). Any swap changes the
+hash, which busts the deploy's `cache-control: immutable` header
+automatically — no manual cache-clear, no version query strings.
 
 - Filenames are sequence-numbered (`01.jpg`, `02.jpg`, …) — never
   leak addresses, neighborhood names, or owner identities in the
@@ -92,7 +96,7 @@ expects:
 
 ## Adding a project
 
-1. Drop sequence-numbered images into `public/images/<slug>/`.
+1. Drop sequence-numbered images into `src/assets/projects/<slug>/`.
 2. Add a new `Project` entry in `src/data/projects.ts` (typed) with
    `slug`, `name`, `eyebrow`, `intro`, `cover`, `coverAlt`, and an
    `images[]` array. Each image takes a `feature` tag