From c72afcf2b2f87fba4795e580e142bed8fa2207a3 Mon Sep 17 00:00:00 2001
From: Ty <tybala@outlook.com>
Date: Mon, 27 Jul 2026 16:09:03 +0000
Subject: [PATCH] structure: sync docs/INSTALL.md

---
 docs/INSTALL.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 docs/INSTALL.md

diff --git a/docs/INSTALL.md b/docs/INSTALL.md
new file mode 100644
index 0000000..f07d308
--- /dev/null
+++ b/docs/INSTALL.md
@@ -0,0 +1,31 @@
+# Install
+
+**Status:** Outline from approved design. Scripts stubbed until **build**.
+
+## Stages
+
+| Stage | Where | Outcome |
+|-------|--------|---------|
+| S0 | Human | Host per [DEPLOYER_HOST.md](DEPLOYER_HOST.md) |
+| S0b | Host script | Docker installed if missing |
+| S1 | Host script | Repo env, `.env` from `.env.example` |
+| S2 | Host script | Main + aux vision config; vision smoke |
+| S3–S5 | Host → Compose / `nemohermes` | Stack, sandbox, policy, skills |
+| S6 | Host script | Doctor green |
+| S7 | Owner + operator connect helpers | Name assistant; connect **their** SaaS/channels |
+
+## Platform commands (normative)
+
+All mutations: `nemohermes` / `openshell` (see [design/research/platform-notes.md](../design/research/platform-notes.md)).
+
+## Intended entrypoints
+
+```bash
+./scripts/bootstrap.sh
+./scripts/install.sh
+./scripts/doctor.sh
+```
+
+## After install
+
+[SETUP_UX.md](SETUP_UX.md) · [design/scenarios.md](../design/scenarios.md) (S1–S5).