From 1b715d10d6a52d8f081fb1aab5982bf9a7422a21 Mon Sep 17 00:00:00 2001
From: Ty <tybala@outlook.com>
Date: Mon, 27 Jul 2026 15:39:41 +0000
Subject: [PATCH] docs: product README for Lumina Salon_Assistant

---
 README.md | 32 ++++++++++++++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 1ae12b6..424f9ee 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,31 @@
-# Salon_Assistant
+# Salon_Assistant (Lumina)
 
-Lumina — salon/spa NemoClaw Hermes assistant (design + product)
\ No newline at end of file
+Docker-based **NemoClaw + Hermes** personal ops assistant for a salon/spa owner-operator.
+
+## Status
+
+- Design plan: approved and checked in as [`docs/DESIGN_PLAN.md`](docs/DESIGN_PLAN.md)
+- Implementation: **not started** until an explicit build order
+
+## Product planes
+
+| Plane | Role |
+|-------|------|
+| Scheduling | Owner Vagaro and/or Square |
+| Books | Owner QuickBooks Online (read-heavy) |
+| Owner messaging | WhatsApp, Email, Telegram |
+| Client / social drafts | Draft only; owner sends/posts |
+| Social craft | Owner photos/video + vision aux |
+| Setup / ops | Install, connect SaaS, automatic updates (on by default) |
+
+## Platform-first rule
+
+All sandbox, policy, credential, channel, and inference mutations go through **`nemohermes` / `openshell`**. Product scripts wrap those CLIs. No parallel control API.
+
+## Non-goals
+
+Agent payments; silent client send or social publish; iMessage bot; holographic memory.
+
+## Next
+
+See `docs/DESIGN_PLAN.md` for full architecture, MCP strategy, update lifecycle, and workstreams W1–W16.