AGENTS.md

@@ -18,30 +18,30 @@ Status: **Gate A freeze** · signed 2026-08-31 PT · docs cut to `main` 2026-09-
 | `docs/CONTENT-WOO.md` | Listing copy and Woo payload |
 | `docs/PROMPTS.md` | Call 1 / Call 2 prompt files |
 | `docs/DEPLOYMENT.md` | Compose, Caddy, secrets placement, ops |
-| `docs/UX.md` | Presentation: what the mill owner sees and does |
+| `docs/UX.md` | Presentation: what the mill owner sees and does (signed) |
+| `docs/UX-DESIGN.md` | Non-normative wireframes only. `docs/UX.md` wins on any conflict. |
 | `docs/TEST-SPEC.md` | Engineer test bar: pyramid cases, phased by gate, through PROD |
 | `docs/UAT-PRACTICE.md` | Walkable practice UAT for `SLAB-UAT-*` |
-| `docs/IMPL-PLAN.md` | Phases 0–6. Phase 2 is a deferred stub (offline PWA / OCR / ruler). |
+| `docs/IMPL-PLAN.md` | Phases 0–6, Gates A/B/C meanings, exit gates. Phase 2 is a deferred stub. |
+| `deploy/INVENTORY.md` | Host worksheet before port bind (Gate B) |
 | `README.md` | Orientation only |
 | `docs/archive/PRD-2026-08.txt` | Frozen archive. Not a source for new work. |
 
 Live docs agree. If two live files disagree, that is a docs bug: fix the files, then continue.
 
+Run `docs/checks/check-structure.sh` after doc structure edits. It pins ownership, calendar home, and lock phrases.
+
 ### Known open gaps
 
 - Issue #4: exact minimum browser version pins and deeper load-bearing API inventory. Phone + PC families are already locked in `docs/UX.md` / TECH-SPEC.
 
 ---
 
-## 0b. Gates (human map)
+## 0b. Gates and phases
 
-| Label | Human name | What it means |
-|---|---|---|
-| Gate A | Docs freeze | Product locks written into the repo |
-| Gate B | Run-host setup | Inventory the real host, deploy skeleton |
-| Gate C | First draft listing | One Woo draft listing with inference OFF |
+Gate A is the docs freeze (this tree). Gate B is host inventory plus the Phase 0 deploy skeleton. Gate C is the first Woo draft listing with inference OFF (early Phase 1).
 
-Phase map: **Phase 0 = Gates A+B.** **Gate C = early Phase 1** claimable publish slice. Call 1/2 after Gate C, still inside POC. Depth: `docs/IMPL-PLAN.md`.
+**Phase 0 = Gates A+B. Gate C = early Phase 1.** Call 1/2 only after Gate C is green, still inside POC. Gate meanings, phase deliverables, and exit gates live only in `docs/IMPL-PLAN.md`. Do not re-teach that map elsewhere.
 
 ### Freeze provenance (Gate A)
 
@@ -181,7 +181,7 @@ Slab `draft` is separate from Woo draft (`woo_create_status`).
 - No feature without a passing test and shown execution output (PR/commit message).
 - Deterministic core unit-tested before UI consumes it.
 - One phase = reviewable, shippable increment; Ty exit-gates phases.
-- Phase naming: Phase 0–6 stay delivery chapters. **Phase 0 = Gates A+B.** **Gate C = early Phase 1** claimable publish slice.
+- Phase and gate naming: follow `docs/IMPL-PLAN.md` only (§0b).
 - Secrets, real Woo application passwords, and AES keys stay out of the repo.
 
 ---

docs/IMPL-PLAN.md

@@ -18,6 +18,18 @@ Ground rules (from AGENTS.md):
 
 Test specification: `docs/TEST-SPEC.md` — pyramid cases, phased by gate, affirmative only.
 
+## Gates (human map)
+
+This file is the only place that defines Gate meanings and how they map onto phases. Other docs may name a gate; they must not restate this table.
+
+| Label | Human name | What it means |
+|---|---|---|
+| Gate A | Docs freeze | Product locks written into the repo |
+| Gate B | Run-host setup | Inventory the real host, deploy skeleton (`frontend/` + `backend/` + compose targets) |
+| Gate C | First draft listing | One Woo draft listing with inference OFF |
+
+**Phase 0 = Gates A+B.** **Gate C = early Phase 1** claimable publish slice. Call 1/2 after Gate C is green, still inside POC. Phase 2 is a deferred stub; do not build it next after Phase 1.
+
 ---
 
 ## Phase 0 — Hybrid skeleton and client deterministic core (= Gates A+B)

docs/UX-DESIGN.md

@@ -1,7 +1,8 @@
-# UX Design — SlabUploader Phone App
+# UX Design — wireframes (non-normative)
 
-Status: DESIGN · 2026-09-03 · SlabUploader
-Screens for the online-only POC flow. Mobile-first, 375px viewport.
+Status: DESIGN · non-normative · 2026-09-03 · SlabUploader
+
+**Not normative.** Signed presentation SoT is `docs/UX.md` (phone and PC browsers). If a wireframe here disagrees with `docs/UX.md`, AGENTS, or TECH-SPEC, follow those and ignore the wireframe. These ASCII screens are layout sketches for discussion, drawn at a 375px phone width; they do not lock mobile-only or override the phone+PC matrix.
 
 Functional rules live in `docs/UX.md`. Confidence gating: `AGENTS.md` §6.
 Data model and status machine: `docs/DATA-MODEL.md`.