diff --git a/AGENTS.md b/AGENTS.md index 2f1d47b..bf5e59c 100644 --- a/AGENTS.md +++ b/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. --- diff --git a/docs/IMPL-PLAN.md b/docs/IMPL-PLAN.md index 05df2bd..7dd2597 100644 --- a/docs/IMPL-PLAN.md +++ b/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) diff --git a/docs/UX-DESIGN.md b/docs/UX-DESIGN.md index 1dedda5..f359aac 100644 --- a/docs/UX-DESIGN.md +++ 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`.