diff --git a/README.md b/README.md
index 1508592..c3983e5 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,22 @@
-# Human-Approved Ecommerce Agent
+# workshop
 
-Python 3.12 MVP for a reviewable Etsy and Printful product workflow:
+An agent pipeline where every action that reaches the outside world stops and waits
+for a person.
+
+The control model is the point. Real provider calls are blocked by a configuration
+guard that fails at startup rather than falling back to live mode, every external
+operation is idempotency-keyed against a database-level unique constraint, and
+publishing is exclusively human-triggered. The default configuration is fully
+mocked; touching anything real requires opting in per integration.
+
+The domain happens to be ecommerce. Three of the nine stages below are human gates
+(design approval, listing copy approval, manual publish); nothing advances past them
+on its own:
 
 `trend discovery -> optional research report -> design -> design approval -> listing copy approval -> Printful product -> Etsy draft -> manual publish -> monitoring`
 
+Python 3.12, FastAPI, Postgres with Alembic, Streamlit, Docker Compose.
+
 Etsy supports authenticated draft-listing workflows. Printful supports real catalog
 reads and an operator-driven Workshop for curation, mockups, and sync-product
 creation; all real writes require separate safeguards. OpenAI image generation and