From 2f87e09c16f36a608d58f3d5a2d6b6c52c03dc55 Mon Sep 17 00:00:00 2001
From: grokbot_ty <grokbot_ty@gitea.local>
Date: Wed, 2 Sep 2026 00:28:07 +0000
Subject: [PATCH] docs(#8): Call 1 pre-populates review taxonomy when inference
 on

State that Call 1 vision results fill species, character, tags, and attributes
on the review screen; manual entry remains authoritative; assist-only.
---
 docs/ARCHITECTURE.md | 8 ++++++--
 docs/PROMPTS.md      | 6 ++++++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md
index 518a5d7..e3c8bd7 100644
--- a/docs/ARCHITECTURE.md
+++ b/docs/ARCHITECTURE.md
@@ -39,7 +39,7 @@ flowchart TB
     P4[Length axis overlay — rotate / confirm]
     P5[User length + thickness + SKU]
     P6[sqft, bdft, 6in widths, 3:4 PNGs]
-    P7[Review Call 1 fields]
+    P7[Review: Call 1 pre-fill or manual taxonomy]
     P8[Tap Generate text]
     P9[Review title / desc — publish]
   end
@@ -84,7 +84,11 @@ flowchart TB
    on slab create **only if** `inference_enabled` is true. If disabled, Call 1
    is skipped; user can manually fill taxonomy and still trigger Call 2. Body:
    all originals downscaled to 1024 + Woo taxonomy snapshot + SKU/length/thickness.
-   Timeout 45s → error + retry on the phone. User reviews/corrects results.
+   Timeout 45s → error + retry on the phone. When inference is on, Call 1 results
+   **pre-populate** the review screen: species, wood categories, edge/figure/grade
+   attributes, `fig-*`/`feat-*` tags (from character/inclusions/voids/checks), with
+   confidence. User reviews and overrides. Manual entry stays authoritative;
+   Call 1 is assist-only.
 5. **Call 2** does not auto-fire. User taps Generate text. Server sends curated
    Call 1 results (or manually-entered taxonomy if Call 1 failed) + deterministic
    numbers + brand/GEO for prose generation; assembles title/description/short
diff --git a/docs/PROMPTS.md b/docs/PROMPTS.md
index ba81a44..9286f2b 100644
--- a/docs/PROMPTS.md
+++ b/docs/PROMPTS.md
@@ -93,6 +93,12 @@ Return valid JSON matching this schema:
   maps them to Woo `feat-*` product tags after the call returns. WooCommerce
   is the authoritative source for feat-* tag definitions; the design does not
   duplicate them.
+- **Pre-population (when `inference_enabled`):** Call 1 results are the primary
+  source that fills the review screen for species, character, wood categories,
+  figure/edge/grade attributes, and mapped `fig-*`/`feat-*` tags. The user
+  confirms or overrides. Manual entry always wins. Call 1 does not gate publish.
+- Confidence threshold behavior (≥0.7 pre-fill vs <0.7 empty + gate) is locked
+  in AGENTS §6.
 
 ---