diff --git a/hive-sh4re/src/assets.rs b/hive-sh4re/src/assets.rs
index 7f6d04bf..2db24e1d 100644
--- a/hive-sh4re/src/assets.rs
+++ b/hive-sh4re/src/assets.rs
@@ -12,8 +12,17 @@
 //! HIVE_ASSETS_DIR=$(pwd)/dev-assets cargo run ...
 //! ```
 //!
-//! where `dev-assets/` mirrors the nix output's `branding/` + `prompts/`
-//! layout.
+//! where `dev-assets/` is laid out the same as the nix output:
+//!
+//! ```text
+//! dev-assets/
+//!   branding/
+//!     hyperhive.{svg,png}
+//!     agent-configs.{svg,png}
+//!   prompts/
+//!     system.md
+//!     claude-settings.json
+//! ```
 //!
 //! Each crate that wants a specific asset goes through one of the
 //! typed helpers (`branding_svg()`, `prompt_template()`, …) so the