From 5f3c1c9ec3504a815e15a3704e36c9d3db779195 Mon Sep 17 00:00:00 2001 From: Kevin Reznicek Date: Wed, 5 Aug 2026 19:38:42 -0700 Subject: [PATCH] docs: lead README with the control model, not the domain The README opened on "Human-Approved Ecommerce Agent" and a trend-discovery pipeline, which frames the project as a storefront tool. The engineering substance is the control model: fail-closed integration guards, idempotency-keyed external operations, and human approval gates that nothing advances past on its own. Lead with that and let ecommerce be the domain it operates in. Also surfaces the stack, which was previously only discoverable from the Quick Start section. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01MsdCEGcdkrPXhckCgPxfWQ --- README.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) 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