From 072ee80b8eca14583983f234407a3f0e895fc786 Mon Sep 17 00:00:00 2001
From: Shay <assetoverflow@icloud.com>
Date: Sat, 13 Jun 2026 03:38:26 -0700
Subject: [PATCH] docs(workbench): index proposal artifact substrate

---
 docs/workbench/README.md | 50 +++++++++++-----------------------------
 1 file changed, 14 insertions(+), 36 deletions(-)

diff --git a/docs/workbench/README.md b/docs/workbench/README.md
index 7193f473..c4b6e8d3 100644
--- a/docs/workbench/README.md
+++ b/docs/workbench/README.md
@@ -84,6 +84,20 @@ Defines:
 
 ---
 
+## Proposal Artifact Substrate
+
+- `proposal-artifact-substrate-v1.md`
+
+Defines:
+
+- the universal proposal artifact envelope
+- subject-specific proposal adapters
+- proposal-only vs ratification-enabled capability levels
+- safety, validation, affected-artifact, and checksum-impact report shapes
+- the migration path for math, cognition, CORE-Logos, packs, and future modalities
+
+---
+
 ## UI Component Map
 
 - `ui-component-map.md`
@@ -218,39 +232,3 @@ The correct operator reaction to the workbench should be:
 not:
 
 > “Cool chatbot.”
-
----
-
-# W-027 Frontend Shell Runbook
-
-Start the full local workbench (API + frontend):
-
-```bash
-# Terminal 1 — API
-uv run core workbench api               # http://127.0.0.1:8765
-
-# Terminal 2 — Frontend
-cd workbench-ui
-pnpm install
-pnpm dev                                # http://127.0.0.1:5173
-```
-
-Use a custom API URL:
-
-```bash
-VITE_WORKBENCH_API_URL=http://127.0.0.1:9000 pnpm dev
-```
-
-View the Branch 1 design baseline:
-
-```bash
-cd workbench-ui
-pnpm preview   # Navigate to /preview
-```
-
-Detect TypeScript ↔ Python schema drift:
-
-```bash
-uv run python scripts/dump-api-schemas.py
-cd workbench-ui && pnpm test
-```