diff --git a/docs/HERMES_MODELS.md b/docs/HERMES_MODELS.md
new file mode 100644
index 0000000..44a21cd
--- /dev/null
+++ b/docs/HERMES_MODELS.md
@@ -0,0 +1,13 @@
+# Hermes model configuration
+
+**Status:** Outline from approved design.
+
+| Slot | Requirement |
+|------|-------------|
+| **Main** | OpenAI-compatible chat + tools; endpoint **may be outside Docker** |
+| **Auxiliary `vision`** | **Required** for media social; install smoke test |
+| **Other aux** | Default to same base/main endpoint unless overridden |
+
+Configured via NemoClaw inference + generated Hermes config (`nemohermes inference set` / sealed config), not owner terminal editing.
+
+See [design/DESIGN_PLAN.md](../design/DESIGN_PLAN.md) and [Hermes Configuring Models](https://hermes-agent.nousresearch.com/docs/user-guide/configuring-models).