diff --git a/README.md b/README.md
index 414fc91..bc6b648 100644
--- a/README.md
+++ b/README.md
@@ -57,3 +57,5 @@ The CLI preserves the current Bridgeable Components production contract:
 - `*.twig` and `*.component.json` files are copied into the output.
 - Storybook-only files, fixture data, docs, build config, `node_modules`, `.git`, and previous build output are excluded.
 - Vite emits `manifest.json`, which the WordPress Bridgeable Components plugin uses to resolve hashed asset filenames.
+
+Static asset manifest keys use the original logical path from the source library. For example, `assets/logo/logo.svg` resolves to a hashed file such as `assets/logo/logo.[hash].svg` in production.