Docs: Call 1 must pre-populate review attributes, tags, and categories #8

Closed
opened 2026-09-01 22:06:00 +00:00 by Ty · 3 comments
Owner

On main, the intended workflow is that the first inference call (Call 1) pre-populates the review screen's attributes, tags, and categories so the user mostly confirms rather than types. The refactor branch's ARCHITECTURE swimlane and clarifications still show Call 1 results landing in P7 as "Review Call 1 fields," but CONTENT-WOO.md's auto-assign section only describes deterministic name-matching for categories/tags/attributes and does not explicitly state that Call 1's vision results are the primary pre-population source for species, character, fig/feat tags, and the five locked attributes.

Please make the docs explicit: when inference is enabled, Call 1 results pre-fill species, character, tags, and attributes (with confidence); the user overrides in review; manual entry remains authoritative. Keep Call 1 assist-only and non-gating.

On main, the intended workflow is that the first inference call (Call 1) pre-populates the review screen's attributes, tags, and categories so the user mostly confirms rather than types. The refactor branch's ARCHITECTURE swimlane and clarifications still show Call 1 results landing in P7 as "Review Call 1 fields," but CONTENT-WOO.md's auto-assign section only describes deterministic name-matching for categories/tags/attributes and does not explicitly state that Call 1's vision results are the primary pre-population source for species, character, fig/feat tags, and the five locked attributes. Please make the docs explicit: when inference is enabled, Call 1 results pre-fill species, character, tags, and attributes (with confidence); the user overrides in review; manual entry remains authoritative. Keep Call 1 assist-only and non-gating.
Ty added this to the POC milestone 2026-09-01 23:49:49 +00:00
Author
Owner

The docs on refactor-v2 correctly state that Call 1 pre-populates review fields and that manual entry is authoritative. However, the same rule is repeated in 7 places (AGENTS, ARCHITECTURE, CONTENT-WOO, UX, PROMPTS, IMPL-PLAN, OPENAPI). This needs a cleanup pass to consolidate into a single canonical owner with references elsewhere. The issue cannot close until the duplication is resolved. See issue #5 comment for the pattern.

The docs on refactor-v2 correctly state that Call 1 pre-populates review fields and that manual entry is authoritative. However, the same rule is repeated in 7 places (AGENTS, ARCHITECTURE, CONTENT-WOO, UX, PROMPTS, IMPL-PLAN, OPENAPI). This needs a cleanup pass to consolidate into a single canonical owner with references elsewhere. The issue cannot close until the duplication is resolved. See issue #5 comment for the pattern.
Author
Owner

Consolidation complete. All duplicates replaced with references to CONTENT-WOO §2.3.

Changes:

  • AGENTS §6: replaced confidence rule with "Confidence gating: see CONTENT-WOO §2.3"
  • ARCHITECTURE §3.4: replaced confidence rule with "Call 1 prefill behavior: docs/CONTENT-WOO.md §2.3"
  • DATA-MODEL ready status: replaced with "Call 1 prefill per CONTENT-WOO §2.3"
  • UX.md: replaced "If vision is on..." paragraph with "Call 1 prefill behavior: see CONTENT-WOO §2.3"
  • IMPL-PLAN Phase 3: replaced Call 1 UI description with "Call 1 prefill per CONTENT-WOO §2.3"
  • IMPL-PLAN Phase 5: replaced gate description with "Call 1 prefill per CONTENT-WOO §2.3"
  • OPENAPI POST /slabs: replaced persistence note with "Call 1 persistence per CONTENT-WOO §2.3"
  • PROMPTS Notes: replaced full confidence gate with "Confidence gating: see CONTENT-WOO §2.3"

Test cases needed once implementation exists:

  1. Call 1 prefill >= 0.7 — Call 1 returns taxonomy with confidence >= 0.7; review fields are pre-populated; fields are mutable and overridable.
  2. Call 1 empty < 0.7 — Call 1 returns taxonomy with confidence < 0.7; review fields start empty; user must fill manually.
  3. Manual entry authoritative — user overrides a pre-filled value; the override sticks.
  4. Inference OFF — full manual taxonomy and content path works; no inference network calls are made.
Consolidation complete. All duplicates replaced with references to CONTENT-WOO §2.3. Changes: - AGENTS §6: replaced confidence rule with "Confidence gating: see CONTENT-WOO §2.3" - ARCHITECTURE §3.4: replaced confidence rule with "Call 1 prefill behavior: docs/CONTENT-WOO.md §2.3" - DATA-MODEL ready status: replaced with "Call 1 prefill per CONTENT-WOO §2.3" - UX.md: replaced "If vision is on..." paragraph with "Call 1 prefill behavior: see CONTENT-WOO §2.3" - IMPL-PLAN Phase 3: replaced Call 1 UI description with "Call 1 prefill per CONTENT-WOO §2.3" - IMPL-PLAN Phase 5: replaced gate description with "Call 1 prefill per CONTENT-WOO §2.3" - OPENAPI POST /slabs: replaced persistence note with "Call 1 persistence per CONTENT-WOO §2.3" - PROMPTS Notes: replaced full confidence gate with "Confidence gating: see CONTENT-WOO §2.3" Test cases needed once implementation exists: 1. **Call 1 prefill >= 0.7** — Call 1 returns taxonomy with confidence >= 0.7; review fields are pre-populated; fields are mutable and overridable. 2. **Call 1 empty < 0.7** — Call 1 returns taxonomy with confidence < 0.7; review fields start empty; user must fill manually. 3. **Manual entry authoritative** — user overrides a pre-filled value; the override sticks. 4. **Inference OFF** — full manual taxonomy and content path works; no inference network calls are made.
Owner

Closed: resolved along the way to M3. Docs now reflect Call 1 as the primary pre-population source.

Closed: resolved along the way to M3. Docs now reflect Call 1 as the primary pre-population source.
Sign in to join this conversation.
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Ty_Tech/SlabUploader#8