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/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.
---