docs: single Gates home and honest UX ownership

Move Gate A/B/C meanings to IMPL-PLAN. List UX-DESIGN as non-normative with
signed UX.md winning conflicts. List INVENTORY in AGENTS §0.
This commit is contained in:
grokbot_ty
2026-09-09 19:45:25 +00:00
parent bad96f944b
commit 8d65984936
3 changed files with 26 additions and 13 deletions
+10 -10
View File
@@ -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/CONTENT-WOO.md` | Listing copy and Woo payload |
| `docs/PROMPTS.md` | Call 1 / Call 2 prompt files | | `docs/PROMPTS.md` | Call 1 / Call 2 prompt files |
| `docs/DEPLOYMENT.md` | Compose, Caddy, secrets placement, ops | | `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/TEST-SPEC.md` | Engineer test bar: pyramid cases, phased by gate, through PROD |
| `docs/UAT-PRACTICE.md` | Walkable practice UAT for `SLAB-UAT-*` | | `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 | | `README.md` | Orientation only |
| `docs/archive/PRD-2026-08.txt` | Frozen archive. Not a source for new work. | | `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. 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 ### 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. - 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 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).
|---|---|---|
| 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 |
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) ### 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). - No feature without a passing test and shown execution output (PR/commit message).
- Deterministic core unit-tested before UI consumes it. - Deterministic core unit-tested before UI consumes it.
- One phase = reviewable, shippable increment; Ty exit-gates phases. - 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. - Secrets, real Woo application passwords, and AES keys stay out of the repo.
--- ---
+12
View File
@@ -18,6 +18,18 @@ Ground rules (from AGENTS.md):
Test specification: `docs/TEST-SPEC.md` — pyramid cases, phased by gate, affirmative only. 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) ## Phase 0 — Hybrid skeleton and client deterministic core (= Gates A+B)
+4 -3
View File
@@ -1,7 +1,8 @@
# UX Design — SlabUploader Phone App # UX Design — wireframes (non-normative)
Status: DESIGN · 2026-09-03 · SlabUploader Status: DESIGN · non-normative · 2026-09-03 · SlabUploader
Screens for the online-only POC flow. Mobile-first, 375px viewport.
**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. Functional rules live in `docs/UX.md`. Confidence gating: `AGENTS.md` §6.
Data model and status machine: `docs/DATA-MODEL.md`. Data model and status machine: `docs/DATA-MODEL.md`.