diff --git a/agents/hermes/README.md b/agents/hermes/README.md
new file mode 100644
index 0000000..cb66e6c
--- /dev/null
+++ b/agents/hermes/README.md
@@ -0,0 +1,13 @@
+# Hermes agent package (scaffold)
+
+**Status:** Structure only until **build**.
+
+## Intended contents
+
+| Path | Purpose |
+|------|---------|
+| `config/` | Onboard fragments (model, MCP, channels placeholders) |
+| `skills-manifest/` | Which Lumina skills ship with the profile |
+| Identity templates | SOUL / USER / assistant naming (Claire demo persona when implemented) |
+
+Onboard via `nemohermes onboard` using this package — never hand-edit in-sandbox config as SSOT.